📝 Hexo博客自动发布工具 v3.0

一个功能强大的Hexo博客自动发布工具，支持两种工作模式，让博客管理更加高效。

🚀 新版本特性

v3.0 新增功能

• 双模式支持：模式1（原有功能）+ 模式2（不添加Front Matter,可批量处理）
• 模式切换：顶部一键切换工作模式
• 批量处理：支持同时选择多个文件进行处理
• 智能链接：模式2直接创建软链接，不修改源文件

🔄 两种工作模式

📝 模式1：添加Front Matter并创建链接

• 功能：在源文件开头添加Front Matter（标题、分类、标签）
• 适用场景：需要为文章添加元数据的场景
• 工作流程：选择源文件 → 填写标题/分类/标签 → 添加Front Matter → 创建软链接

📦 模式2：批量处理，直接创建链接

• 功能：直接创建软链接，不修改源文件内容
• 适用场景：批量处理已有Front Matter的文件，强烈建议搭配Obsidian的template使用
• 工作流程：选择多个源文件 → 批量创建软链接 → 可选发布

🛠️ 系统要求

• Windows 10/11
• Python 3.6+
• Node.js 和 npm
• Hexo CLI（全局安装：npm install -g hexo-cli）

📋 安装步骤

1. 克隆或下载项目

   git clone [项目地址]
   cd auto-Publish

2. 安装依赖

   pip install -r requirements.txt

3. 运行程序

   python main.py

⚙️ 配置说明

首次使用前，请在设置中配置：

• 博客文章目录：Hexo博客的 source/_posts 目录
• 博客根目录：Hexo博客的根目录（包含 _config.yml 的目录）

💡 使用指南

模式1使用步骤

1. 选择"📝 模式1: 添加Front Matter并创建链接"
2. 选择源笔记文件
3. 填写文章标题、分类、标签
4. 选择是否发布到博客
5. 点击"🚀 添加Front Matter并创建链接"

模式2使用步骤

1. 选择"📦 模式2: 批量处理，直接创建链接"
2. 点击"📁 添加文件"选择多个源文件
3. 管理文件列表（添加/删除/清空）
4. 选择是否发布到博客
5. 点击"🚀 批量创建软链接"

🔧 功能特性

• 智能文件检测：自动检测源文件是否已有Front Matter
• 软链接创建：使用Windows软链接，节省磁盘空间
• 批量处理：支持同时处理多个文件
• 实时日志：显示详细的执行过程和结果
• 管理员权限：自动获取管理员权限以创建软链接
• Hexo集成：支持一键发布到Hexo博客

🚨 注意事项

• 程序需要管理员权限来创建软链接
• 模式2会直接使用原文件名，请确保文件名不重复
• 建议在操作前备份重要文件
• 确保Hexo环境配置正确

📝 更新日志

v3.0 (2025-8-12)

• ✨ 新增双模式支持
• ✨ 新增批量文件处理功能
• ✨ 新增模式切换界面
• 🔧 优化用户界面和交互
• 🐛 修复hexo命令执行问题

v2.0 (之前版本)

• ✨ 支持Front Matter模板
• ✨ 软链接创建功能
• ✨ Hexo发布集成

🚀 Hexo博客自动发布工具 v2.0

一款用Python开发的GUI工具，用于将Markdown笔记软链接为Hexo博客文章并发布。

📁 项目结构

auto-Publish/
├── main.py                 # 主程序文件
├── template.md             # 博客文章模板
├── config.json             # 配置文件
├── requirements.txt        # Python依赖
├── build.bat              # 构建exe可执行文件
├── clean.bat              # 清理构建文件
├── run.bat                # 启动程序
├── README.md              # 说明文档
└── tests/                 # 测试文件夹
    ├── diagnose_dll.py    # DLL诊断工具
    └── ...                # 其他测试文件

🎯 主要功能

• 配置管理：一次配置，永久保存博客目录和模板设置
• 文件选择：直观的文件浏览器选择源笔记文件
• 标题自定义：支持自定义文章标题或默认使用文件名
• 分类标签：支持添加文章分类(categories)和标签(tags)
• 智能Front Matter处理：直接在源文件开头添加YAML元数据
• 软链接创建：自动获取管理员权限，在博客目录创建指向源文件的软链接
• 一键发布：可选择是否执行hexo g && hexo d命令发布博客
• exe程序：可打包成独立的exe文件，无需Python环境

🔄 工作流程

1. 选择源笔记文件 → 2. 添加Front Matter到源文件 → 3. 创建软链接到博客目录 → 4. 可选发布博客

这样的好处是：

• 源笔记文件本身包含博客元数据，便于管理
• 博客目录中只是软链接，节省空间
• 修改源文件内容会自动同步到博客

🎨 界面特色

• 中文界面，操作简单直观
• 实时执行结果显示，带emoji图标
• 响应式布局，支持窗口缩放
• 独立的设置窗口，配置更清晰
• 自动管理员权限提升

📦 快速开始

🚀 一键启动（推荐）

start.bat

启动脚本会提供菜单选择：

• 运行Python程序
• 运行exe程序
• 构建exe程序

方式一：使用exe文件

如果已有exe文件，直接运行：

dist\HexoPublisher.exe

如需构建exe文件：

build.bat

构建脚本已解决已知的DLL问题，支持Anaconda和标准Python环境。

方式二：运行Python程序

python main.py

⚙️ 首次配置

1. 点击程序右上角的 "⚙️ 设置" 按钮
2. 配置以下路径：
   • 📁 博客文章目录：你的Hexo博客的 source/_posts 目录
   • 🏠 博客根目录：你的Hexo博客根目录
   • 📄 模板文件：选择 scaffolds/post.md 或使用提供的 template.md
3. 点击 "💾 保存" 按钮

📝 发布文章

1. 选择源文件：点击 "📁 浏览" 选择你的Markdown笔记文件
2. 设置标题：输入文章标题，或点击 "📝 使用文件名"
3. 添加分类：在分类框中输入分类，用空格分隔（如：技术 编程）
4. 添加标签：在标签框中输入标签，用空格分隔（如：Python Hexo 博客）
5. 选择发布：勾选 "🚀 发布到博客" 如果要立即发布
6. 执行：点击 "🚀 添加Front Matter并创建链接" 按钮

程序会：

• 在源文件开头添加Front Matter（如果已存在会询问是否替换）
• 在博客目录创建软链接指向源文件
• 可选执行hexo发布命令

🤝 贡献

欢迎提交Issue和Pull Request来改进这个工具！

许可证

本项目采用MIT许可证。