HexoHub

中文文档 | English | 发布指南 | Tauri 开发指南

一个Hexo博客管理桌面应用程序，提供图形化界面来替代传统的命令行操作

告别繁琐的传统命令行方式（我已经厌倦了hexo xxxx🫠），以更优雅的方式管理您的hexo博客。

特点

• 小巧：选择tauri框架下的发行版（推荐），安装包仅为 5.8MB，安装后应用程序大小仅为 20MB
• 轻量：基于Next.js ，React ，TypeScript ，Tauri ，轻量且高效
• 快速：快速启动，快速响应，无冗余设计
• 简洁：简洁的UI设计，专注于博客
• 智能：集成了AI功能，辅助您的创作

功能

文章管理

在本应用程序中，您可以可视化的：创建新文章，查看文章列表 ，编辑文章，实时预览，启动本地预览，生成并推送静态文件，删除文章

图片拖入

这或许是本应用程序的一大亮点，当您开启了hexo的资源文件夹后（这是什么？），您就可以使用{% asset_img example.jpg %}标签，将本地的图片在博客中进行引用。
但是，频繁的输入{% asset_img example.jpg %}显然是不尽如人意的（特别是当图片文件名很复杂的时候），所以在本应用程序中，您只需要将图片拖入编辑窗口，就能自动将图片复制到hexo资源文件夹下，并填入{% asset_img example.jpg %}标签，省去了输入文件名和操作文件的烦恼

Hexo 操作

命令执行：图形化执行常用 Hexo 命令，包括：

• hexo clean - 清理缓存文件
• hexo generate - 生成静态文件
• hexo deploy - 部署到远程服务器
• hexo se - 启动本地预览
  实时反馈：显示命令执行结果和错误信息

配置管理

基本设置：网站标题、副标题、作者、语言
高级设置：URL 配置、永久链接格式
YAML 编辑：支持直接编辑原始配置文件
导入/导出：配置文件的备份和恢复，更加方便您主题的迁移

快速开始

使用

如果您只需“使用”本应用程序：

• 操作系统: Windows 10 或更高版本
• 存储: 建议 200MB 可用空间
• Hexo：https://hexo.io/
• Npm：npm>10 👉https://www.npmjs.com/
• Node.js：nodejs>20 👉https://nodejs.org/zh-cn/

随后到Releases下载最新版本。

开发

如果您需要"开发"本应用程序，以下是额外的需求：

• Git：https://git-scm.com/
• nodejs：TypeScript>4.5，React>19，Next.js>15

⚠️ 出于速度考虑，我在开发过程中使用的是cnpm，并且修改了部分package.json内容，请您在使用时酌情考虑，如果要使用cnpm，请执行：

npm install -g cnpm --registry=http://registry.npm.taobao.org

随后即可用cnpm代替npm

📦 自动化发布流程

项目已配置 GitHub Actions 自动化发布流程。维护者在准备发布新版本时，只需推送版本标签即可自动构建和发布 Windows、Linux 安装包。详细步骤请参考 📦 发布指南。

技术栈

• Next.js 15 - React 全栈框架
• React - 用户界面库
• TypeScript - 类型安全的 JavaScript
• Tailwind CSS - CSS 框架
• Electron - 跨平台桌面应用框架 (主分支)
• Tauri - 轻量级桌面应用框架 (tauri 分支)
• Rust - 系统编程语言 (Tauri 后端)
• electron-builder - Electron 应用打包工具
• NSIS - Windows 安装程序制作工具
• remark-gfm - GitHub 风格 Markdown 扩展
• Hexo - 静态博客生成器

贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 创建 Pull Request

---

我在开发过程中遇到了许多问题，如果您可以加入这个项目，成为志同道合的朋友，我会万分感激，给您点杯咖啡！☕ 可以通过以下方式联系我：

• 邮箱3316703158@qq.com
• 我的博客https://2am.top
• github

国际化（i18n）

本项目使用next-i18next进行国际化处理，您可以在i18n.js中配置您的语言包，旨在帮助您的项目轻松支持多语言，让全世界的用户都能无障碍使用。

• 多语言支持：轻松切换不同语言
• 简单集成：快速上手，兼容主流框架
• 可扩展：自定义翻译和语言包

# 安装模块
npm install your-i18n-module

// 初始化
import i18n from 'your-i18n-module';

i18n.init({
  defaultLanguage: 'en',
  supportedLanguages: ['en', 'zh', 'es', 'fr']
});

代码规范

没有规范（实际上本人代码一团糟👻），只要您写的东西是人类语言即可

LICENSE

本项目采用 MIT 许可证，请您在使用本项目时遵守相关法律法规。

更改日志

更多日志请移步release查看

v3 (2025-08-16)

新功能：

• 在“文章列表”界面加入右键逻辑，实现快速操作
• 左侧加入“标签云图”

BUG 修复：

• 修复了hexo配置下，“网站标题”设置失败的问题
• 修复了“按文章名排序”时，偶发的排序混乱问题
• 修复了当“作者”为空时，生成静态文件报错的问题

v2 (2025-08-13)

新功能：

• 重构”文章列表“功能，将其放在右侧主窗口
• 加入“按标签/分类显示文章”功能
• 加入文章批量处理功能（批量删除/添加标签/添加分类）
• 添加国际化支持

BUG 修复：

• 修复了部分明暗转换异常

v1 (2025-08-10)

• 首次构建
• 基本命令，文章按日期/名称排序
• 基本功能实现