写 Hexo 博客久了,总在重复同一套动作:打开编辑器写 Markdown → 切到终端 hexo generate → 再 hexo deploy → 回到浏览器刷新看效果。中间任何一步出错,都要在终端日志里翻半天。

于是我做了 HexoDeck —— 一个 Hexo 博客的桌面管理工具,把这些动作全搬进图形界面。

它解决什么问题

不用碰命令行。写作、预览、生成、部署、改配置,都在一个窗口里点几下完成。

不改变你的站点。直接用它管理你现有的 Hexo 目录,站点里的配置、主题、插件、文章原样读入。改配置时用行级替换,注释和键顺序完整保留,首次修改还会自动备份。

部署不再「假成功」。这是我自己踩过的坑:hexo deploy 在 git 推送失败时不会返回非零退出码 —— 终端看起来一切正常,实际上什么都没推上去。HexoDeck 会从输出里识别真正的失败原因(仓库不存在、认证失败、分支为空、推送被拒等)并明确报错,还会在部署前自动生成一次,避免推上旧内容。

主要功能

写作

CodeMirror 6 编辑器,Markdown 语法高亮、格式化工具栏、Ctrl+F 查找替换。图片可以直接粘贴或拖拽,自动存到 source/images/ 并插入链接。自动保存、分栏实时预览、全文搜索。

页面与自定义文集

「页面」页管理 about、friends 这类独立页面,新建时路径即文件夹(填 about 就创建 about/index.md)。

更有意思的是「自定义文集」—— 可以把站点里任意文件夹变成独立的文章管理入口。比如我把 source/_dynamics 做成侧栏的「说说」,点进去就能像管理文章一样管理短动态。文集可以加多个,名称和图标都能自定义(内置 15 种矢量图标,也能导入自己的图片)。

站点配置

基础配置表单化(标题、作者、语言、URL、永久链接、分页……),也可以直接编辑 _config.yml 原文,带 YAML 高亮和语法校验。

站点图标可以直接拖图片设置,会写进 source/favicon.* —— 所以你的网站也会用上这个图标。

主题与插件

主题压缩包拖进窗口就能安装(自动识别并规整目录结构),已装主题一键切换,8 款热门主题可直接从市场安装。插件列表带中文说明,点「设置」直达配置键位置。

预览

整屏 iframe 显示主题渲染后的真实页面,文件一变自动刷新 —— 边写边看。预览可含草稿。

统计

文章数、草稿数、总字数、写作天数、最近 12 个月趋势、标签与分类排行、最长最短文章……

一些设计上的取舍

多个博客互不干扰:所有自定义内容(文集定义、参数配置、配置路径记忆)都按站点隔离,切换站点时自动重新加载。

配置文件不自动定位:第一次编辑 _config.yml 或主题配置时,会弹窗让你指定文件。这是刻意的 —— 有些项目用 _config.xxx.yml 之类的多配置结构,自动猜测可能改错文件。

开关参数写布尔值:自定义参数支持「开关式」,写入的 true/false 是 YAML 布尔而非字符串。因为字符串 'false' 在主题模板里会被当成真值 —— 这个坑我想替使用者避开。

获取与文档

安装很简单:

  • 安装版(HexoDeck-Setup-x.y.z.exe)—— 向导式安装,支持自动更新,日常首选
  • 绿色版(HexoDeck-x.y.z-win.zip)—— 解压即用,零安装、秒启动

绿色包记得先解压再运行。应用内嵌了 Hexo 引擎,无需在本机装 Node.js。

完整的使用说明我整理成了文档,建议从 使用指南 开始看,包含:

最后

目前只有 Windows 版本(10 / 11 64 位),界面为中文。代码开源在 GitHub,MIT 协议,欢迎提 issue 或 PR。