HexoDeck 是一个 Hexo 博客的桌面管理工具，把写作、预览、发布、配置整个流程搬进图形界面 —— 不用碰命令行。

它不会要求你改变现有的站点结构：直接使用你已有的 Hexo 目录，站点里的配置、主题、插件、文章原样读入；应用只做增量编辑，改配置时注释与键顺序都完整保留。

下载安装

↓ 下载 HexoDeck 前往 GitHub Releases 获取最新版（安装版 / 绿色版）

打开下载页面后，选择其中一个即可：

版本 文件名 说明
安装版（推荐） HexoDeck-Setup-x.y.z.exe 向导式安装，可选安装目录；支持自动更新
绿色版 HexoDeck-x.y.z-win.zip 解压即用，零安装、秒启动，可放 U 盘

绿色包请先解压再运行，不要在压缩包里直接双击。解压后启动不到 1 秒。

环境要求：Windows 10 / 11（64 位）。

无需安装 Node.js —— 应用内嵌了 Hexo 引擎；站点里已有的 hexo 与插件会优先使用，与你的原有环境保持一致。

文档目录

本指南分为以下几个部分，建议按顺序阅读：

  1. 快速开始 —— 添加站点、认识界面、发布第一篇文章
  2. 写作功能 —— 文章、草稿、编辑器工具栏、图片、全文搜索
  3. 页面与文集 —— 独立页面管理，以及把任意文件夹当作文章库
  4. 主题与站点配置 —— 主题安装切换、站点配置、配置文件直编
  5. 发布与部署 —— 本地预览、生成、一键部署到 GitHub Pages
  6. 常见问题 —— 疑难解答与已知限制

三分钟上手

  1. 安装并启动 HexoDeck
  2. 点击「添加站点」，选择你的 Hexo 博客根目录（含 _config.yml 的文件夹）
  3. 在「文章」页点「新建文章」，写完自动保存
  4. 在「预览」页点「启动预览」，实时查看主题渲染效果
  5. 在「发布」页点「部署上线」，推送到你的仓库

就这五步。下面各篇会展开说明每个环节的细节与技巧。

核心特点

  • 零侵入：不改变你的站点结构，配置改动保留注释与键顺序，首改自动备份
  • 多站点隔离：可管理多个博客，站点信息、文集、参数定义、配置路径记忆全部按站点隔离
  • 本地可见即可得：内嵌 iframe 预览真实渲染效果，文件一变自动刷新
  • 部署不假成功：自动识别 git 推送失败并明确报错，部署前自动生成最新内容
  • 玻璃拟态界面：深空霓虹（暗）/ 冰白清新（亮）双主题，支持跟随系统

写作增强

除了常规的 Markdown 编辑，有几个专为中文博客设计的能力：

  • 自定义参数（三种类型）：键值式（文本）、开关式（勾选框，写 YAML 布尔）、结构化（YAML 编辑框，支持嵌套对象与对象数组）。写游戏资源卡、多网盘链接这类复杂 front-matter 时，可以一键套用内置模板，改值即可 —— 详见写作功能
  • 自定义插入片段：把常写的版权声明、更新时间做成工具栏按钮，点一下插入光标处，支持 {{date}} 自动替换为当天日期
  • 自定义文集：把站点里任意文件夹变成独立的文章管理入口（如把 source/_dynamics 做成「说说」）—— 详见页面与文集
  • 站点图标：站点页点头像或拖入图片即可设置，写入站点 source/favicon.*，你的网站也会用上
  • 路径可点击：文章 / 页面 / 文集的文件路径与目录都能点，直接在资源管理器打开并选中