写 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。
评论