左栏组件

个人名片

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

profile:
  enable: true
  avatar: /images/avatar.jpg
  avatar_size: 72px
  name: Echo
  title: 万物之时
  title_icon: /favicon.png
  badge: LV.5
  badge_title: 潜水爱好者
  bio: 分享影视、游戏与各类资源，也折腾博客和 Mod 汉化。
  social_title: 找到我
  icon_size: 19
  social:
    - name: github
      url: https://github.com/
      title: GitHub
    - name: bilibili
      url: https://space.bilibili.com/
      title: 哔哩哔哩
    - name: telegram
      url: https://t.me/
      title: Telegram
    - name: mail
      url: mailto:you@example.com
      title: 邮箱
    - name: rss
      url: /atom.xml
      title: RSS

外观类配置项

社交链接

• social[].name 决定图标，可用：github / bilibili / telegram / mail / rss / link。
• social[].title 同时作为图标的 title 与无障碍标签，鼠标悬停可见。
• avatar 加载失败时会自动回退到主题自带的占位头像。
• 不写 name 和 bio 时，会回退到站点 _config.yml 的 author 和 description。
• 想省掉社交区，直接把 social 整体注释掉即可，标题和分隔线会一并隐藏。

头像与角标尺寸用的是 CSS 变量（--avatar-size / --icon-size）实现，因此改动后无需改动任何样式文件。

音乐播放器

单曲模式：

1
2
3
4
5
6
7

music:
  enable: true
  title: 音乐
  src: 'https://example.com/song.mp3'
  name: 曲目名
  artist: 艺术家
  cover: /images/covers/hexo-theme.svg

歌单模式（填了 playlist 就优先用它）：

1
2
3
4
5
6
7
8
9
10

music:
  enable: true
  playlist:
    - name: 曲目一
      artist: 歌手
      src: https://example.com/a.mp3
      cover: /images/covers/hexo-theme.svg
    - name: 曲目二
      artist: 歌手
      src: https://example.com/b.mp3

播放器支持播放/暂停、上一首、下一首、随机、循环和音量。

浏览器通常禁止自动播放，需要访客手动点一次播放键。
src 必须是直链（以 .mp3 / .m4a 结尾），网盘分享页不能直接播放。

分类与标签

1
2
3
4
5
6
7
8
9

category:
  enable: true
  title: 分类
  limit: 8      # 最多显示几个，0 表示不限

tags:
  enable: true
  title: 标签
  limit: 16

显示顺序按内容数量从多到少，数量为 0 的分类不会出现。

左栏分类是跟随页面上下文的：

• 首页、归档页：显示全部分类；
• 文章页（文章总页、文章详情页、文章分类页）：只显示含有文章的分类；
• 资源页（资源总页、类型页、资源详情页）：只显示含有资源帖的分类。

这样文章读者不会被资源分类干扰，资源访客也看不到纯文章分类，两侧列表都更短、更聚焦。

右栏组件

站点统计

1
2
3
4
5
6
7
8
9
10
11

stats:
  enable: true
  title: 统计
  show:
    - posts        # 文章数
    - categories   # 分类数
    - tags         # 标签数
    - words        # 总字数
    - runtime      # 运行时长
    - updated      # 最后活动
  since: 2024-01-01

show 数组控制显示哪些行以及顺序，删掉哪一项就不显示哪一项。
运行时长从 since 开始计算。

日历

1
2
3

calendar:
  enable: true
  title: 日历

日历支持翻月，当天有描边标记，有文章的日期会显示小圆点，
下方列出最近更新的 3 篇内容。

站点信息

1
2
3
4
5
6
7

siteinfo:
  enable: true
  title: 站点信息
  build: Hexo
  version: Echo 1.0
  license: CC BY-NC-SA 4.0
  domain: ''      # 留空则使用站点 url

页脚

1
2
3
4
5
6
7

footer:
  since: 2024
  powered: true
  beian:
    enable: false
    text: 粤ICP备00000000号
    link: https://beian.miit.gov.cn/

页脚会显示 © 2024 - 2026 这样的年份区间，起始年份取 since。
开了 beian 之后会额外显示一条备案链接。

接入评论

主题内置 Giscus（基于 GitHub Discussions），在 _config.yml 里填好参数即可：

1
2
3
4
5
6
7
8
9

comments:
  enable: true
  provider: giscus
  giscus:
    repo: 用户名/仓库名
    repo_id: R_kgDOxxxxxx
    category: Announcements
    category_id: DIC_kwDOxxxxxx
    mapping: url          # 用页面 URL 关联 discussion

前置条件：目标仓库必须是 public，并已安装 giscus 应用、开启 Discussions。

• 评论框在正文上方（input_position: top），深浅色跟随站点主题切换。
• 换成 Waline / Twikoo 等其它服务：改 layout/_partial/comments.ejs 里的脚本即可，
  文章页的引入位置不用动。

入场动画

卡片滚动进入视口时会淡入上移，由 echo.js 里的 IntersectionObserver 实现，默认开启。
想关掉的话，删除 source/js/echo.js 中「Reveal on scroll」那一段即可。

常见问题

菜单点了打不开 / 页面空白

先看终端有没有报错。最常见的原因是模板里引用了不存在的变量，
或者生成器返回的 page.posts 被当成了 Query 对象处理。

1

npx hexo clean && npx hexo generate

重新生成时终端会直接指出出错的文件和行号。

改了配置不生效

分三种情况：

改了 colors.accent 却没变？主色是在 head.ejs 里注入的，
如果你改的是编译后的 public/css/echo.css，下次生成会被覆盖——
要改就改 themes/echo/_config.yml，然后 hexo clean && hexo generate。

浅色主题下横幅还是原来的深色 / 灰色

自己写浅色覆盖规则时，最容易踩的两个坑：

1. 选择器优先级不够。主题里深色状态的横幅用的是
   .page-banner.has-banner .page-banner-card（三个 class），
   而 [data-theme='light'] .page-banner-card（一个属性 + 一个 class）压不过它。
   写浅色规则时必须带上 .page-banner / .has-banner 上下文，把优先级提上去。
2. 横幅大图写在 HTML 内联样式里。.page-banner 的
   style="background-image:url(...)" 是模板输出的内联属性，
   普通 CSS 盖不住，需要在浅色规则里用 background: ... !important 压制。

另外浅色规则要同时照顾两个属性：data-theme（head.ejs 里的运行时 JS 写入）
和 data-theme-hint（layout.ejs 直接输出的配置值，用于 JS 尚未执行时防闪帧）。

验证时如果无头浏览器也跟着系统深色渲染，可以临时做一个强制
data-theme="light" 的验证页截图确认，改完记得删掉。

排查口诀：改完 CSS → hexo clean && hexo generate → 停掉旧 server 换端口重启 → 浏览器强刷。
只改源文件就断定”没生效”是最常见的原因，因为运行中的 server 会一直供旧 CSS。

窄屏展开菜单后白底白字（浅色主题）

如果你是照着上一条 FAQ 给自己写浅色规则时遇到的，八成是踩了同一个坑：
首页 Hero 的导航是透明悬浮在深色大图上的，所以浅色规则会主动排除它
（:not(.has-hero)），让白字保留。可是窄屏展开的抽屉菜单是
自带实底浮层（background: var(--bg-elev)，浅色下为纯白），
它的链接同样继承了白字 —— 于是白底白字。

判断原则：看这个元素自己有没有底色。

• 有自己的实底（抽屉、卡片、弹窗）→ 文字必须跟随主题色，用 var(--text) / var(--text-soft)
• 透明悬浮在大图上（首页顶栏）→ 固定用白字，任何主题都一样

主题里对应的修法（≤900px 生效）：

1
2
3

@media (max-width: 900px) {
  [data-theme='light'] .site-nav .nav-link { color: #1e293b; }
}

抽屉在深色主题下本来就是深底白字，所以这条只需要覆盖浅色。

资源没出现在资源库

按顺序检查：

1. front-matter 里 resource.enable 是不是 true
2. resource.type 的值是否与站点 _config.yml 里 resources.types[].key 一致
3. 文章文件是否放在 source/_posts/ 下
4. 有没有执行过 hexo clean

侧栏收起后目录不见了

这是预期行为：右栏在 1280px 以下会收起，
此时目录会转移到正文顶部的可折叠区块，不会丢失。

封面图不显示

• 确认路径以 / 开头，且文件真实存在于 source/images/ 下。
• 路径是相对站点 source，不是相对文章文件。
• 没有封面时卡片会显示渐变占位块，属于正常回退。

导航栏挡住锚点

主题已通过 scroll-padding-top 处理锚点偏移，
滚动到标题时不会贴在导航栏下面。如果你自定义了导航高度，
记得同步调整 --header-h 变量。

进阶定制

改配色

主题所有颜色都走 CSS 变量，定义在 echo.css 顶部的 :root：

1
2
3
4
5
6
7
8
9
10
11
12

:root {
  --accent: #5b8cff;
  --bg: #f6f7fb;
  --bg-elev: #ffffff;
  --text: #1b1f2a;
  --border: #e4e7f0;
}
[data-theme='dark'] {
  --bg: #0f1117;
  --bg-elev: #171a23;
  --text: #e8eaf1;
}

深色模式只需覆盖 [data-theme='dark'] 里的同名变量。

加一个侧栏组件

1. 在 layout/_rail/ 下新建 your-widget.ejs
2. 在 layout/_partial/rail-left.ejs 或 rail-right.ejs 里引入
3. 在主题 _config.yml 里加对应的 enable 开关

组件外层用 rail-card 类就能自动继承卡片样式：

1
2
3
4

<section class="rail-card">
  <h3 class="rail-card-title"><%- echo_icon('box', 16) %> 标题</h3>
  <p>内容</p>
</section>

发布主题前要清理什么

• 主题 _config.yml 里的个人信息、头像、社交链接
• source/images/ 下你自己上传的图片
• 演示文章（source/_posts/ 里的示例内容）
• public/ 与 .deploy_git/ 之类的构建产物

想改某个字段的中文名 / 显示逻辑

资源字段（版本 / 平台 / 大小 / 语言 / 更新日期）的映射与过滤统一在
scripts/helper.js：

1
2

const RESOURCE_FIELD_LABELS = { version: '版本', platform: '平台', /* ... */ };
hexo.extend.helper.register('echo_resource_fields', function (extra) { /* ... */ });

改这里会同时影响资源卡片、资源详情页摘要、普通文章卡片三处，不用逐个模板改。
其他 helper 也都集中在同一个文件底部注册，模板里通过 echo_xxx 调用。

主题代码里哪些是「公开 API」，改动需谨慎

反过来，下面这些不要依赖：

• 纯为视觉服务的状态类（has-hero / is-scrolled / is-compact 等），
  它们会随主题实现调整
• .ab-*（卡片网格）、.hd-*（下载区）这类给 Markdown 手写内容用的组件类，
  虽然保留但版式可能微调

系列总结

六篇下来，你应该已经掌握：

1. 主题的架构与目录职责
2. 安装启用与两套配置文件的区别
3. 三栏布局、响应式收栏与首页大图
4. 资源帖写法、网盘链接与配色
5. 写作规范、代码块与文章页开关
6. 侧栏组件、页脚与问题排查

后续计划：资源排序与筛选增强、磁力链接支持、评论系统开箱接入。

新建一篇文章

1

npx hexo new post "文章标题"

文件会生成在 source/_posts/ 下，然后按下面的格式补 front-matter。

front-matter 全字段

1
2
3
4
5
6
7
8
9
10
11
12

---
title: 文章标题
date: 2026-10-06 11:00:00
updated: 2026-10-07 10:00:00
categories:
  - 建站笔记
tags:
  - Hexo
  - 前端
description: 一段 50~120 字的描述，会用在卡片摘要和 SEO。
cover: /images/covers/hexo-theme.svg
---

关于 cover

1

cover: /images/covers/movie.svg

• 路径以 / 开头，相对于站点 source 目录。
• 不写 cover 时，卡片会渲染一个带标题首字的渐变占位块，不会开天窗。
• 推荐比例 16:9，尺寸 800×450 以上。
• 也可以用 photos 字段代替，取第一张：

1
2

photos:
  - /images/covers/game.svg

摘要与 <!-- more -->

在正文里插入 <!-- more -->，它之前的内容就是摘要：

1
2
3
4
5

这是一段导语，会出现在首页卡片上。

<!-- more -->

## 正文从这里开始

规则优先级：

1

front-matter 的 description  →  <!-- more --> 之前的内容  →  自动截断正文

代码块

主题的代码块是 macOS 窗口风格：左上角三个圆点、右上角语言角标、右上角复制按钮。

1
2
3
4
5

```javascript
function hello(name) {
  console.log(`hello, ${name}`);
}
```

代码块样式由主题内置，无需额外配置：mac 风格窗口三色圆点、右上角复制按钮、语言角标。

支持的语言角标包含 JavaScript、TypeScript、Python、Go、Rust、Java、C/C++、PHP、
Shell、PowerShell、YAML、JSON、HTML、CSS、SCSS、Vue、SQL、Dockerfile、Nginx 等，
未收录的语言会显示大写名称。

行内代码

用反引号包裹即可，例如 resource.enable，会自动应用等宽字体与浅底色。

文章目录

1
2
3
4

toc:
  enable: true
  title: 目录
  depth: 3

• depth: 3 表示收录到三级标题（###）。
• 目录显示在右栏，滚动时会自动高亮当前章节。
• 窗口窄于 1280px（右栏收起）时，目录会以可折叠形式出现在正文顶部。

如果你不想让某篇文章显示目录：

1
2
3
4

---
title: 一篇不需要目录的文章
toc: false
---

文章页其它开关

1
2
3
4
5
6
7
8

post:
  toc: true              # 全局目录开关
  toc_depth: 3
  copyright: true        # 底部版权声明
  updated: true          # 显示更新日期
  words_per_minute: 300  # 阅读时长计算基准
  prev_next: true        # 上一篇 / 下一篇
  intro: true            # 正文前的简介

阅读时长 = 正文字数 ÷ words_per_minute，向上取整，最小显示 1 分钟。

导航菜单

1
2
3
4
5
6

menu:
  首页: /
  文章: /articles/
  资源库: /resources/
  归档: /archives/
  关于: /about/

• menu 是全部菜单项，顺序即显示顺序，全部平铺在导航栏顶层。
• 菜单项自带图标（按名称自动匹配，如 首页→home、文章→file-text），无需额外配置。
• 资源类型（影视 / 游戏 / MOD / 汉化）不出现在导航栏里——它们入口在资源库页面顶部的类型筛选导航中。

文章分类导航

文章总页（/articles/）和文章分类页顶部有一排分类导航（与资源库顶部的类型筛选同一套视觉）：
「全部」+ 各文章分类（带篇数），点击即可在分类之间切换。

只有属于文章轨（含非资源帖）的分类才会出现；纯资源分类不会混进来。

内容排序

front-matter 里可以用两个字段控制列表排序：

1
2
3
4
5

---
title: 我的一篇文章
order: 1              # 全局排序：决定在 /articles/ 或 /resources/ 总列表里的位置
category_order: 2     # 分类内排序：决定在分类页（或资源类型页）里的位置
---

• 数值越小越靠前；带排序值的文章置顶于按时间排序的文章之前。
• order 作用于文章总页与资源总页；category_order 作用于文章分类页与资源类型页。
• 两个字段都可以省略：省略 category_order 时回退到 order，再回退到按时间倒序。
• 资源帖同理——order 控制它在 /resources/ 总列表的位置，category_order 控制它在所属类型页的位置。

上一篇 / 下一篇

文章页底部有「上一篇 / 下一篇」导航，文章与资源库分开串：

• 打开普通文章，只会在文章里找相邻篇，不会跳到资源帖。
• 打开资源帖，只会在资源里找相邻篇（样式上带资源标识）。
• 相邻关系按上面说的 order 排序计算（未设 order 时按时间倒序），
  所以给系列文章排了 order，上下篇就会按你的顺序走。

开关：

1
2

post:
  prev_next: true

站点图标

1
2

# 站点 _config.yml
favicon: /favicon.png

• 浏览器标签栏、收藏夹、桌面快捷方式都用这张图（favicon.png / favicon.ico / favicon.svg 都支持，
  会自动识别正确的 MIME 类型）。
• 同一个值也会作为导航栏网站名左侧的品牌图标。
• 想让品牌图标用另一张图，在站点 _config.yml 里单独指定：

1
2

header:
  logo: /images/brand.png

• 三级回退顺序：header.logo（站点）→ favicon（站点）→ favicon（主题，默认 /images/favicon.svg）→ 主题内置线条标识。
• 建议尺寸 180×180 以上的正方形图片，主题会自动按 34×34 圆角展示。

独立页面

除了文章，还可以建独立页面（关于、友链、留言板等）：

1

npx hexo new page about

会生成 source/about/index.md：

1
2
3
4
5
6
7

---
title: 关于
date: 2026-10-06 12:00:00
description: 关于本站。
---

正文内容……

独立页面使用 page.ejs 模板，带内页横幅，但不显示阅读时长、目录和上下篇。

站内搜索

主题在构建时会生成 search.json（由 scripts/resource.js 输出），
内容包含标题、链接、日期、分类、标签、是否资源以及一段摘要。

点击导航栏的放大镜或按 / 键可以唤起搜索框，
输入关键词后会实时匹配标题、分类、标签和摘要。

搜索索引在构建时生成，所以新文章需要重新 generate 之后才能被搜到。

下一篇

最后一篇讲侧栏组件、页脚、评论接入和常见问题排查。

最小的资源帖

只要在 front-matter 里加 resource 字段，普通文章就变成资源帖：

1
2
3
4
5
6
7
8
9
10

---
title: 某某电影 4K 蓝光原盘
date: 2026-10-02 14:00:00
categories:
  - 影视资源
cover: /images/covers/movie.svg
resource:
  enable: true
  type: movie
---

type 的取值由站点 _config.yml 里 resources.types 的 key 决定，
常见的有 movie / game / mod / translation / software / other。

完整字段

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

---
title: 演示：游戏 MOD《示例模组》v3.1.4
date: 2026-10-04 15:20:00
categories:
  - 游戏MOD
tags:
  - MOD
  - 玩法扩展
description: MOD 类资源演示，展示多版本、多网盘链接的呈现。
cover: /images/covers/mod.svg
resource:
  enable: true
  type: mod
  version: v3.1.4
  platform: Windows
  size: 1.8 GB
  language: 简体中文
  updated: 2026-10-04
  links:
    - name: 蓝奏云
      url: https://wwi.lanzouq.com/example-mod
      password: echo
      size: 1.8 GB
      note: 不限速
    - name: 百度网盘
      url: https://pan.baidu.com/s/example-mod
      password: 1234
      size: 1.8 GB
---

字段说明：

网盘链接

links 是一个数组，每一项就是一张网盘卡片：

1
2
3
4
5
6
7
8
9
10
11

links:
  - name: 百度网盘
    url: https://pan.baidu.com/s/xxxx
    password: abcd
    size: 42.6 GB
    note: 需要客户端
  - name: 夸克网盘
    url: https://pan.quark.cn/s/xxxx
    password: ''
    size: 42.6 GB
    note: 在线解压

几个实用技巧：

• 多版本：同一资源的多个版本，建议每篇一个版本，用 version 区分，方便单独更新链接。
• 多网盘：同一版本放多个网盘，全部写进 links，访客可以自己选。
• 失效链接：直接把对应条目删掉重新发布即可，不用改正文。

网盘配色

每个网盘卡片会按名称自动取色。内置了这些：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

resource:
  pan_colors:
    百度网盘: '#2932e1'
    阿里云盘: '#ff6a00'
    夸克网盘: '#2f7dff'
    天翼云盘: '#0090ff'
    123云盘: '#1677ff'
    迅雷云盘: '#2f6bff'
    蓝奏云: '#3ba0ff'
    微云: '#12b7f5'
    奶牛快传: '#ffb02e'
    Google Drive: '#34a853'
    OneDrive: '#0f6cbd'
    Mega: '#d9272e'
    磁力链接: '#7a5cff'
    BT 种子: '#f59e0b'

要加新网盘，直接补一行；名称要和 links[].name 完全一致（包括空格）。
没匹配到的网盘会使用主题主色。

资源卡片显示哪些字段

1
2
3
4
5
6

resource:
  show_fields:
    - version
    - platform
    - size
    - language

• 可用字段只有这四个，顺序即卡片上的展示顺序。
• 字段的中文名（版本 / 平台 / 大小 / 语言）由主题内置映射，
  想改名要改 scripts/helper.js 里的 RESOURCE_FIELD_LABELS。
• 卡片上最多显示 3 个（写死的，避免卡片高度参差），多余的折叠掉；
  详情页不受此限制，配置的字段 + 「更新日期」都会展示。
• 字段值留空时自动跳过，四个都没写则显示一个「资源 / 查看详情」的占位。

字段映射与过滤逻辑统一在 helper.js 的 echo_resource_fields helper 里，
三处模板（资源卡片、详情页摘要、普通卡片）共用同一份实现。

版权提示与密码显示

1
2
3

resource:
  show_password: true
  notice: '资源仅供学习交流，请在下载后 24 小时内删除。'

• show_password: false 可以全局隐藏提取码（如果你用其它方式发放），
  隐藏时显示为 ••••，但复制按钮仍然可用。
• notice 显示在下载区块上方，留空则不显示。

资源详情页的结构

一篇资源帖从上到下依次是：

1. 字数 / 阅读时间 / 资源类型标签
2. 标题与分类、标签、日期
3. 简介（取 description 或摘要）
4. 字段表格：版本 / 平台 / 大小 / 语言 / 更新日期
5. 正文（安装方法、注意事项等）
6. 下载区块：网盘卡片列表 + 提取码复制按钮
7. 版权提示、上一篇 / 下一篇

正文里不需要再手写「版本：v3.1.4」这类信息，交给字段就好。

图标清单

resources.types[].icon 和 Hero 按钮的 icon 都从这个内置集合里取值：

填错名字不会报错，会回退成通用的盒子图标。

下一篇

下一篇讲写作：front-matter 全部字段、代码块、目录、摘要与封面。

三栏布局是怎么组成的

页面主体是「左栏 / 正文 / 右栏」的弹性布局：

1
2
3
4
5
6

┌──────────┬────────────────────┬──────────┐
│  左栏     │       正文          │   右栏    │
│ 个人名片  │   文章 / 资源列表    │  统计     │
│ 音乐      │                    │  目录     │
│ 分类/标签 │                    │  日历     │
└──────────┴────────────────────┴──────────┘

用 flex 而不是 grid，好处是任意一栏隐藏时，正文会自动补位，
不需要为每种组合单独写一套布局规则。

宽度相关的四个参数

都在主题 _config.yml 的「外观」区块：

1
2
3
4
5
6
7
8

# 三栏总宽度
layout_width: 1440px
# 三栏之间的间距
layout_gap: 36px
# 中栏最大宽度
main_width: 820px
# 左右侧栏宽度
rail_width: 240px

它们的关系是：

1

layout_width ≥ 左栏宽 + 右栏宽 + main_width + layout_gap × 2

以默认值为例：260 + 260 + 820 + 36 × 2 = 1412，小于 1440，留了一点余量。

如果你把 main_width 调得比可用空间还大，正文会被压缩而不是溢出——这是刻意的，
保证小屏下不会出现横向滚动条。

想给正文更大空间

两种做法，任选其一：

1
2
3
4
5
6

# 做法一：加大总宽度（屏幕够宽时推荐）
layout_width: 1600px
main_width: 900px

# 做法二：收窄侧栏
rail_width: 220px

单独设置左右栏宽度

rail_width 是全局值，也可以在 rail 区块里分开设置：

1
2
3
4
5

rail:
  left:
    width: 280px
  right:
    width: 240px

响应式收栏顺序

窗口变窄时，主题按「先收右栏，再收左栏」的顺序处理：

右栏先收起是因为它承载的是辅助信息（统计、日历、站点信息），
而左栏的个人名片和分类导航对站点辨识度更重要。

这两个断点写在 themes/echo/source/css/echo.css 里：

1
2
3
4
5
6
7
8
9

/* 先收起右栏 */
@media (max-width: 1280px) {
  .rail-right { display: none; }
  .layout-main { max-width: none; }
}
/* 更窄后再收起左栏 */
@media (max-width: 1024px) {
  .rail-left { display: none; }
}

右栏收起后，文章目录不会丢：正文顶部会出现一个可折叠的内嵌目录。

侧栏组件开关

rail 区块是总开关，各组件可以独立关闭：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

rail:
  enable: true      # 总开关，false 则左右栏都不渲染
  left:
    enable: true
  right:
    enable: true

profile:
  enable: true      # 个人名片
music:
  enable: false     # 音乐播放器
category:
  enable: true      # 分类
tags:
  enable: true      # 标签
stats:
  enable: true      # 站点统计
calendar:
  enable: true      # 日历
siteinfo:
  enable: true      # 站点信息

关掉组件后，同一栏里剩下的组件会自动上移，不会留下空白。

侧栏分类按页面自动过滤

侧栏的「分类」组件会根据当前页面自动切换分类范围，不用手动配置：

这样在资源库里不会再看到一堆跟资源无关的文章分类，侧栏始终和当前内容相关。

深色模式

配色模式三选一：

1
2

# auto 跟随系统 / dark 强制深色 / light 强制浅色
color_scheme: auto

选 auto 时，导航栏右侧会出现一个太阳/月亮按钮，访客可以手动切换，
选择会记在 localStorage 里，下次访问保持。

改主题配色

配色统一写在 themes/echo/_config.yml 的 colors 段里。
只填你真正想改的项，其余全部由 accent 自动派生：

1
2
3

colors:
  accent: '#5b8cff'
  # secondary: '#8f6bff'

改 accent 一个值，下面这些会一起变：

也就是说，不需要去 CSS 里逐个替换颜色。

想更精细地微调，就显式覆盖对应变量（值写任意合法 CSS 颜色）：

1
2
3
4

colors:
  accent: '#e0454f'
  secondary: '#ff8a5c'          # 渐变第二色
  accent-glow: 'rgba(224, 69, 79, .35)'

colors 里出现过的任何键都会输出成同名 CSS 变量，
所以自定义变量（如 warn: '#f59e0b'）也能在这里配。

兼容性：老写法 accent: '#5b8cff' 仍然有效，等价于 colors.accent。

首页顶部大图（Hero）

首页顶部是一块整幅大图，导航透明悬浮在图上：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

hero:
  enable: true
  # 背景图：相对 source 的路径，或完整 URL
  image: /images/hero.svg
  # 高度，可写 520px / 60vh
  height: 520px
  # 暗色遮罩，越大文字越清晰
  overlay: 0.42
  title: ''
  subtitle: ''
  buttons:
    - text: 进入资源库
      url: /resources/
      icon: layers
      primary: true
    - text: 浏览归档
      url: /archives/
      icon: archive
      primary: false

几点说明：

• image 留空会回退到 header.banner，方便你复用同一张图。
• title / subtitle 留空时，自动取 index.banner_title 与 index.banner_subtitle。

内页横幅（page-banner）

/articles/、/archives/、分类页、标签页、资源库、独立页面顶部共用同一套横幅，
直接复用 header.banner 的图和遮罩：

1
2
3

header:
  banner: /images/covers/hexo-theme.svg
  overlay: 0.72

横幅图通常比页面底色深，主题会在横幅底部铺一段渐隐，
让它溶进正文底色，避免浅色主题下出现「上深下浅」的硬边。

渐隐高度通过 CSS 变量调节（写在 head.ejs 注入的自定义样式里，或直接改主题 CSS）：

1

:root { --banner-fade: 104px; }

值越大过渡越长。不想让横幅图片参与配色时，把 header.banner 留空即可——
横幅会退化成主色浅底渐变，与页面自然一体。

浅色主题下横幅自动换色

深色大图和深色蒙层压在浅色页面上会又闷又割裂，所以浅色主题下横幅不使用大图，
改用明亮的浅蓝配色：

想换成别的浅色（如薄荷绿、浅粉），改 colors.banner_light 即可：

1
2
3
4

colors:
  banner_light: '#dbeafe'    # 浅蓝（默认）
  # banner_light: '#d1fae5'  # 浅绿
  # banner_light: '#fce7f3'  # 浅粉

主题会自动派生描边色与渐变尾色，所以只填一个色值即可。
文字颜色固定为深色系，在任何浅底上都能看清。

深色主题不受影响，仍使用完整大图 + 蒙层。
想让浅色主题也保留大图，把 header.banner 保持不变的同时，
在 source/css/echo.css 里删掉 [data-theme='light'] .site-header-bg 与
[data-theme='light'] .page-banner 的 background-image: none !important; 这两行即可。

浅色样式同时挂在 [data-theme='light'] 和 [data-theme-hint='light'] 两个选择器上。
后者是 layout.ejs 直接输出到 <html> 的配置值（color_scheme 为 light/dark 时生效），
目的是让配色在 JS 执行前就正确，避免深色大图先闪一下再变浅蓝。
改动浅色专属样式时，两个选择器都要一起改，否则手动切换主题时会出现闪帧。

首页大图上的导航栏（例外说明）

首页 Hero 是唯一「大图 + 透明导航」的状态，导航文字必须是白色才能在深色大图上看清，
所以浅色主题的换色规则会主动排除它：

1

[data-theme='light'] .site-header:not(.has-hero):not(.is-scrolled) .nav-link { ... }

也就是说浅色规则只在「导航有实底」时生效。两种情况对照：

这也是为什么浅色主题下首页顶部看不到那条浅蓝描边——它本来就该是”无边框悬浮”。

如果你把 header.banner 或 hero 关掉，导航变成常驻实底，
此时浅色规则会重新生效，导航自动变为深色文字，这是预期行为。

横幅标题图标的颜色

横幅标题（.page-banner-title）里的图标跟随标题文字色（currentColor），
不使用主色蓝，这样标题整体是一个视觉单元。
想单独给图标上色，改 echo.css 里的 .page-banner-title .icon 即可。

换一张自己的图

把图片放进 source/images/，然后：

1
2

hero:
  image: /images/your-banner.jpg

建议尺寸 1920×1080 以上、横向构图，主体内容尽量偏中间，
这样在窄屏下裁切时不会把重点切掉。

• 按钮上可以放 icon，取值见第四篇的图标清单。
• enable: false 时首页会退回原来的「简介卡片 + 按钮」样式。

导航的固定行为

首页导航是固定在顶部的：在顶部时透明悬浮在大图上（白字），
向下滚动过大图后自动变成实底并恢复当前主题的文字色，保证在任何位置都清晰可读。
这一点在浅色主题下同样成立——首页大图始终是深色的，所以悬浮时始终用白字。

内页（文章、归档、资源库）的导航则是吸顶显示，配一条细横幅背景。

内页横幅

内页顶部的横幅共用同一个背景图配置：

1
2
3

header:
  banner: /images/covers/hexo-theme.svg
  overlay: 0.72      # 遮罩透明度 0~1

留空 banner 则不显示图片，只保留纯色渐变背景。

下一篇

下一篇讲资源板块：resource 字段的完整写法、网盘链接、提取码与配色。

环境要求

检查当前环境：

1
2

node -v
npx hexo version

安装主题

把主题文件夹放进站点的 themes/ 目录，然后修改站点根目录的 _config.yml：

1
2

# --- 主题 ---
theme: echo

如果主题目录名不是 echo，theme: 的值要跟目录名一致。

接着安装必要依赖（主题用到了 hexo-pagination 做分页）：

1

npm install hexo-pagination --save

常用命令

1
2
3
4
5
6
7
8
9
10
11

# 本地预览，默认 http://localhost:4000
npx hexo server

# 指定端口（端口被占用时很有用）
npx hexo server -p 4000

# 清缓存后重新生成
npx hexo clean && npx hexo generate

# 生成并部署
npx hexo clean && npx hexo generate --deploy

改完主题文件后，如果是 hexo server 正在运行，通常会自动热更新；
改了 _config.yml 或 scripts/ 下的生成器，必须重启 server 才会生效。

站点配置：资源板块

资源库的类型、路径和分页在站点 _config.yml 里配置（不是主题配置里）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# --- 资源板块 ---
resources:
  path: resources          # 访问路径：/resources/
  per_page: 12             # 每页显示多少个资源
  types:                   # 资源类型，决定筛选条和图标
    - key: movie
      name: 影视资源
      icon: film
    - key: game
      name: 游戏资源
      icon: gamepad
    - key: mod
      name: 游戏 MOD
      icon: puzzle
    - key: translation
      name: MOD 汉化
      icon: language
    - key: software
      name: 软件工具
      icon: app
    - key: other
      name: 其他资源
      icon: box

几个要点：

• key 要和文章 front-matter 里 resource.type 的值一致，否则会被归到「其他资源」。
• icon 取自主题内置图标集（见第四篇的图标清单）。
• per_page 同时作用于资源库和文章列表。

站点配置：文章板块

1
2
3
4
5

# --- 文章板块 ---
# 只收录「普通文章」（不含 resource.enable 的资源帖）
articles:
  path: articles
  per_page: 12

站点配置：固定链接

主题默认按「分类 / 年 / 月 / 标题」组织链接，这样资源帖的 URL 天然带分类信息：

1
2
3
4

permalink: :category/:year/:month/:title/
pretty_urls:
  trailing_index: true
  trailing_html: true

改 permalink 会导致已有链接全部失效，如果站点已经上线过，建议先做跳转再改。

主题配置总览

主题自己的配置在 themes/echo/_config.yml，该文件已按功能分好 14 个区块、
每一项都带中文注释（含可填值与「站点配置可覆盖」的说明），可以直接当参考手册用。

覆盖优先级

配置读取一律按这个顺序，前者覆盖后者：

1

站点 _config.yml  >  主题 _config.yml  >  代码内置默认值

所以想换成自己的图片、宽度、配色，优先写到站点 _config.yml 里（同名同层级即可），
不用动主题文件 —— 这样更新主题时不会冲突。目前支持站点覆盖的常用项：

首次运行检查清单

改完配置后，按这个清单过一遍：

• theme: echo 已设置
• resources.types 里的 key 与文章 resource.type 对应
• 站点 url 改成你自己的域名（影响 RSS 与站点地图）
• 站点 favicon 换成自己的图标
• 主题 profile.avatar、社交链接换成自己的
• footer.since 改成建站年份
• stats.since 与建站日期一致
• comments.giscus.repo 换成你自己的公开仓库
• hero.image 换成 1920×1080 以上的横向图

下一篇

下一篇讲三栏布局、宽度调节、深色模式与首页大图。

这是一套为「资源分享 + 技术博客」混合站点设计的 Hexo 主题。和常见主题最大的区别是：
它把文章和网盘资源当成两种一等公民，而不是让资源去硬凑文章的排版。

这套主题解决什么问题

现成的 Hexo 主题大多假设你的内容都是文字。但资源分享站点需要的东西完全不同：

核心设计原则只有一句话：资源就是带有 resource 字段的文章。你不用学第二套写法，
只要在 front-matter 里加一段配置，同一篇文章就会自动进入资源库。

三个内容入口

主题把内容分成三条互不干扰的流：

1. 首页 / —— 顶部大图 + 资源分类入口 + 最新发布（文章与资源混排）
2. 文章 /articles/ —— 只收录普通文章，不出现资源帖
3. 资源库 /resources/ —— 只收录资源帖，可按影视 / 游戏 / MOD / 汉化筛选

判断规则非常简单：

1
2

resource.enable === true   →  资源帖，进资源库
resource.enable 不存在/为假  →  普通文章，进文章页

所以你不会遇到「同一篇内容在两个列表里重复出现」的问题。

目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

themes/echo/
├── _config.yml              # 主题配置（所有开关都在这里）
├── layout/                  # EJS 模板
│   ├── layout.ejs           # 全站骨架
│   ├── index.ejs            # 首页
│   ├── article-index.ejs    # 文章列表页
│   ├── resource-index.ejs   # 资源库列表页
│   ├── post.ejs             # 文章 / 资源详情页（两者共用）
│   ├── page.ejs             # 独立页面
│   ├── archive.ejs          # 归档
│   ├── category.ejs         # 分类
│   ├── tag.ejs              # 标签
│   ├── _partial/            # 可复用组件（导航、卡片、分页…）
│   └── _rail/               # 左右侧栏的各个小组件
├── scripts/                 # 生成器与模板辅助函数
│   ├── helper.js            # 所有 echo_* helper（图标、日期、配色派生…）
│   ├── resource.js          # 资源库与搜索索引生成器
│   ├── articles.js          # 文章列表生成器
│   └── category.js          # 分类页生成器
└── source/                  # 静态资源
    ├── css/echo.css         # 全站样式
    ├── js/echo.js           # 交互脚本
    └── images/              # 主题自带图片

各部分职责

_config.yml 是你唯一需要经常改的文件。配色、宽度、导航菜单、侧栏组件开关
全在这里，每个配置项都带中文注释。

layout/ 决定页面长什么样。_partial/ 放的是被多个页面复用的片段，
比如 post-card.ejs（文章卡片）、pagination.ejs（分页）；
_rail/ 放的是侧栏小组件，比如 profile.ejs、calendar.ejs。
注意资源详情页和文章详情页共用 post.ejs —— 靠 front-matter 里
有没有 resource.enable 来决定渲染成哪种形态。

scripts/ 是 Hexo 的扩展点。resource.js 负责把带 resource 字段的文章
聚合成 /resources/ 下面的各个页面，同时输出 search.json 供站内搜索使用。
helper.js 集中定义所有模板可调用的 echo_* 函数，改它会影响全部模板。

source/ 是纯静态资源，构建时会原样复制到 public/。

内容与主题的边界

一个容易被搞混的点：文章内容放在站点根目录的 source/_posts/，而不是主题里。

1
2
3
4
5
6
7

F:\Echo\
├── source/                  # ← 你的内容在这里
│   ├── _posts/              # 文章与资源帖（Markdown）
│   ├── about/               # 独立页面
│   └── images/covers/       # 封面图
├── themes/echo/             # ← 主题（可以整个替换/分享）
└── _config.yml              # 站点配置

这样做的好处是：主题可以打包分享给别人，内容完全跟着你自己走。

下一篇

下一篇讲安装与启用，以及站点配置 _config.yml 里每一项的含义。

这篇记录我如何把链接从「超长乱码」改成「简短固定」的完整过程，包含原理、三种方案对比和踩坑细节。

问题：中文标题进 URL 会怎样

Hexo 默认的永久链接格式是这个：

1

permalink: :year/:month/:day/:title/

:title 会用文章标题作为路径。英文标题看着挺正常：

1

https://example.com/2026/10/06/hello-world/

但中文标题就出问题了。我写了一篇《HexoDeck 使用指南》，生成的链接是：

1

https://example.com/2026/10/06/HexoDeck-给Hexo找个顺手的桌面客户端/

浏览器会把它编码成：

1

https://example.com/2026/10/06/HexoDeck-%E7%BB%99Hexo%E6%89%BE%E4%B8%AA%E9%A1%BA%E6%89%8B%E7%9A%84%E6%A1%8C%E9%9D%A2%E5%AE%A2%E6%88%B7%E7%AB%AF/

一个标题变成 150 多个字符的乱码。这带来三个实际问题：

1. 复制分享很难看 —— 发到聊天软件、论坛、社交媒体里，整屏都是 %E7%BB%99
2. 容易出错 —— 手动复制时漏掉一个字符就 404；有些平台不允许这种字符
3. 改标题就断链 —— 标题改了，URL 跟着变，之前所有的外链、搜索引擎收录、别人收藏的书签全部失效

第三条是最致命的。URL 应该稳定不变，而文章标题常常会改。

三种解决方案对比

缩短结构只是把日期段去掉，中文编码问题依然存在 —— 不解决问题。

拼音方案可读性最好，还对 SEO 友好（URL 里有关键词）。但长标题会变得非常冗长，比如《HexoDeck —— 给 Hexo 找个顺手的桌面客户端》会变成：

1

/posts/hexodeck-gei-hexo-zhao-ge-shun-shou-de-zhuo-mian-ke-hu-duan/

而且多音字可能转换错误，改标题链接还是会变。

短码方案是中文博客最常用的做法，也是我最终选的。链接短、绝对不会有编码问题，最关键的是链接写入文章元数据后永久不变。

代价是不可读、URL 里没有关键词。但对个人博客来说，链接稳定比关键词更重要 —— 你不会希望读者收藏的文章链接某天失效。

实施：改用 abbrlink

第一步：安装插件

1

npm install hexo-abbrlink --save

第二步：修改站点配置

打开站点根目录的 _config.yml，找到 URL 那一段，修改 permalink 并加上 abbrlink 配置：

1
2
3
4
5
6
7
8
9
10
11
12
13

# URL
url: https://你的域名
permalink: posts/:abbrlink/
permalink_defaults:
pretty_urls:
  trailing_index: false   # 去掉链接尾部的 /index.html
  trailing_html: false    # 去掉链接尾部的 .html

# abbrlink 配置
abbrlink:
  alg: crc32    # 算法：crc32（默认）或 crc16
  rep: hex      # 进制：hex（默认）或 dec
  drafts: false # 是否也给草稿生成

关于格式的说明：

• permalink: posts/:abbrlink/ —— posts/ 前缀是我自己加的，让链接看起来有层次。你也可以直接用 :abbrlink/ 让链接更短
• 如果按日期分目录可以用 :year/:month/:day/:abbrlink/，但短链的意义就在于短，一般不加
• trailing_index: false / trailing_html: false 建议一起改，去掉链接尾部多余的 /index.html

关于算法的说明：

• crc32 生成十六进制短码（如 461fc5c1、686a239 —— 最多 8 位，前导零会省略），crc16 只有 4 位（如 a1b2）
• crc16 更短，但碰撞概率高（不同文章可能算出同一个码，导致链接冲突），建议用 crc32
• rep: dec 会生成纯数字（如 1176357825），比 hex 长，一般不用

第三步：重新生成

1
2

hexo clean
hexo generate

必须执行 hexo clean —— 否则 Hexo 的增量缓存不会重新计算链接，旧的中文目录还会留在 public/ 里。

生成时日志会显示每篇文章分配到的短码：

1
2

INFO  Generate link [461fc5c1] for post [source/_posts/HexoDeck-给Hexo...md]
INFO  Generated: posts/461fc5c1/index.html

第四步：验证

打开 public/posts/ 目录，应该看到短码命名的文件夹：

1
2
3

public/posts/
├── 461fc5c1/
└── 9daba997/

启动预览确认链接可以访问，旧的中文长链接目录已经消失。

关键机制：链接写进了文章里

这一步很重要 —— abbrlink 会把生成的短码写入每篇文章的 front-matter：

1
2
3
4
5

---
title: 测试
date: '2026-10-05 08:24:34'
abbrlink: 9daba997     # ← 插件自动写入
---

这意味着：

• 链接从此固定 —— 以后改标题，URL 仍然是 9daba997，外部引用不会失效
• 短码可手动指定 —— 想给某篇重要文章一个好看的自定义短码？直接改 front-matter 里的 abbrlink 值即可（注意别和其他文章重复）
• 不要手动删除 —— 删掉后下次生成会重新计算，可能得到不同的码，导致链接变化

踩过的坑

改完链接后必须 clean

我第一次改完配置直接 hexo generate，结果 public/ 里新旧目录同时存在 —— 新的短码目录生成了，旧的中文目录却没被删除。原因是 Hexo 的增量生成只处理变化的文件，不会清理已废弃的路径。

所以改 permalink 后一定要先 hexo clean。

别忘了同步改 url

站点配置里的 url 默认为 http://example.com，这个必须改成你的真实域名。它影响：

• sitemap.xml 里的链接
• RSS 订阅里的链接
• 社交分享时的卡片链接
• 各种 SEO 元信息

如果 url 是错的，搜索引擎抓到的是 example.com，得不偿失。

已经有文章的话要注意

如果站点已经上线并且有外链，改 permalink 会导致所有旧链接 404。这时有两个选择：

1. 在服务器配 301 重定向 —— 把旧链接永久重定向到新链接，保住已有权重
2. 保持原样 —— 如果外链很少、影响不大，可以接受

我的站点还在建设阶段，没有外链负担，所以直接改了。如果你也刚开始写，越早做越好。

小结

改完之后链接从 150 多字符的乱码变成 posts/461fc5c1/，复制分享干净多了，而且以后再改标题也不怕断链。

如果你用的是图形化工具管理博客，这些配置同样可以直接编辑 —— 比如 HexoDeck 的「设置 → 高级」页就能直接改 _config.yml，改完预览自动重启。

于是我做了 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。

返回 使用指南总览

安装与启动

Q：需要先安装 Node.js 吗？

日常使用不需要。应用内嵌了 Hexo 引擎，写作、预览、生成、部署都能跑。

只有两个场景需要本机 Node.js：新建站点（要装依赖）和安装 / 卸载插件（走 npm）。

Q：绿色版双击没反应？

确认是解压后再运行，不要在压缩包预览窗口里直接双击。压缩包内运行会因为解压慢而看起来”没反应”。

Q：启动时提示找不到站点？

上次打开的站点目录可能被移动或删除了。重新点「添加站点」选择正确位置即可。

站点与数据

Q：HexoDeck 会修改我的站点文件吗？

只在你主动执行操作时修改，且都是最小改动：

• 保存配置 → 行级替换，保留注释与键顺序，首改自动备份
• 编辑文章 → 只改你编辑的那个文件
• 设置站点图标 → 写入 source/favicon.*

应用本身不往站点里写任何自己的状态文件。

Q：我的站点数据存在哪？

应用自己的数据（最近站点、文集定义、配置路径记忆、应用设置）都存在 %APPDATA%/hexodeck/hexodeck.json，不进站点目录。

如果删掉这个文件，只会丢失应用记忆（最近站点、文集入口等），站点文件不受影响。

Q：多个博客会混在一起吗？

不会。所有自定义内容都按站点隔离：

切换站点时界面会自动重新加载对应的数据。

写作相关

Q：文章保存在哪？

• 正式文章 → 站点 source/_posts/
• 草稿 → 站点 source/_drafts/
• 文集文章 → 你指定的目录

都是普通的 Markdown 文件，可以直接用其他编辑器打开。

Q：删除文章能恢复吗？

可以。删除是移入系统回收站，从回收站还原即可。

Q：开关式参数写了 false 但主题还显示评论？

这是最容易踩的坑 —— 检查 front-matter 里写的是布尔还是字符串：

1
2

comments: false      # ✅ 布尔，主题能正确识别
comments: 'false'    # ❌ 字符串，在模板里是真值

HexoDeck 的开关式参数会写布尔值，所以用开关式添加的参数不会有这个问题。如果你手动在 YAML 里写，注意别加引号。

Q：结构化参数能写多复杂？提取码为什么变成了数字？

结构化参数支持任意深度的嵌套对象与对象数组 —— 键值对、列表、列表里再套对象都可以，层数不受限制。

要注意的是 YAML 的类型推断：

1
2
3
4

password: 1234        # ❌ 被解析成数字
password: "1234"      # ✅ 字符串
code: 001234          # ❌ 前导零丢失，变成 1234
code: "001234"        # ✅ 保留前导零

提取码、验证码、卡号这类「号码」都建议加引号。HexoDeck 会保留你写的引号，但如果你手写时漏了，YAML 规范层面它就已经是数字了 —— 某些主题模板做字符串比较时会因此出错。

Q：字数统计是怎么算的？

中文按字计，英文按单词计（汉字/假名/谚文逐字算，拉丁字母连成词算一个）。全应用统一这个口径：编辑器状态栏、文章列表、统计页都一致。

预览与部署

Q：预览显示不出来？

1. 确认站点能正常生成 —— 去「发布」页点「生成静态页面」看有没有报错
2. 检查端口占用 —— 预览会用 4000 起的空闲端口，一般不会冲突
3. 如果预览页面空白，看「发布」页日志区有没有 hexo 报错

Q：部署显示成功但网站没变？

先确认是不是真成功 —— 看日志区有没有报错。HexoDeck 会识别 git 推送失败并明确报错，如果日志里没有错误提示，说明推送确实成功了。

那么检查方向转向 GitHub 侧：

• 仓库的 commit 时间是否更新
• GitHub Pages 的构建状态（仓库 Settings → Pages）
• 浏览器缓存（强制刷新试试）

Q：部署提示”分支为空”？

去「设置 → 部署」把分支填上（GitHub Pages 一般是 main），旁边有一键填入按钮。

Q：仓库地址要加 .git 吗？

建议加。https://github.com/用户名/仓库 这种形式在某些情况下会被 git 当成路径而非仓库，应用会提示你补全。

已知限制

• 仅支持 Windows（10 / 11，64 位）。macOS / Linux 暂无打包版本。
• 界面语言为中文，暂无多语言支持。
• 安装 / 卸载插件需要本机 Node.js —— 日常写作、预览、生成、部署都不需要。
• 文集内容是否被生成到博客取决于 Hexo 配置 —— 下划线开头的目录（如 source/_dynamics）Hexo 默认跳过；想让内容上线，放进 source/ 下的常规目录。

反馈问题

使用中遇到问题或有建议，欢迎在 GitHub 提 issue：

返回 使用指南总览

本地预览

「预览」页提供整屏的本地预览：

• 用 iframe 显示主题渲染后的真实博客页面（不是简化的 Markdown 预览）
• 站点文件一有变化，预览自动刷新
• 顶部显示当前访问地址与运行状态

控制项

预览使用随机可用端口（从 4000 起找空闲端口），不会和别的服务冲突。

关闭站点或切换站点时，预览会自动停止。

构建与部署

「发布」页有三个操作：

顶部会显示当前部署目标（仓库地址 + 分支），未配置时提示你去设置页填写。

部署会自动先生成

点「部署上线」后，流程是：

1. 先执行一次 hexo generate —— 确保推送的是最新内容，而不是上次生成的旧产物
2. 生成成功后才执行 hexo deploy 推送

为什么这样做：hexo deploy 本身不会自动生成。如果只跑 deploy，推上线的是 public/ 目录里已有的内容 —— 你新写的文章如果没手动生成过，就不会被推上去。

部署失败会被识别

这是 HexoDeck 相比手动部署的一个重要改进：

hexo deploy 在 git 推送失败时不会返回非零退出码，所以命令行里看起来是「成功」，实际上什么都没推上去 —— 这种「假成功」很容易让人困惑。

HexoDeck 会从命令输出里识别真正的失败原因并明确报错：

失败时不会给出「部署完成」的假提示，并且日志区能看到完整输出。

运行日志

页面底部的日志区实时显示每条命令的输出，可用于排查问题。日志支持一键清空，同时也会落地到日志文件（「设置 → 应用」可打开日志文件夹）。

首次部署 GitHub Pages 的完整流程

以「用户名.github.io」仓库为例：

1. 创建仓库

在 GitHub 创建一个名为 用户名.github.io 的公开仓库。

2. 配置部署信息

在「设置 → 部署」里填：

• 部署方式：Git
• 仓库地址：https://github.com/用户名/用户名.github.io.git
• 分支：main（点快捷填入按钮）

3. 确认插件

如果提示缺少 hexo-deployer-git，点「一键安装」。

4. 执行部署

回到「发布」页，点「部署上线」。

5. 首次可能需要输入凭据

第一次推送时 git 会要求认证。推荐用 Personal Access Token 代替密码：

1. GitHub → Settings → Developer settings → Personal access tokens
2. 生成一个带 repo 权限的 token
3. 推送时用户名填 GitHub 用户名，密码填这个 token

或者改用 SSH 地址（git@github.com:用户名/仓库.git）并配置好 SSH 密钥。

6. 等待站点生效

推送成功后，GitHub Pages 需要一两分钟构建。之后访问 https://用户名.github.io 即可看到你的博客。

排查部署问题

部署后网站没更新？

1. 检查日志区有没有报错
2. 确认部署目标仓库地址与分支正确
3. 登录 GitHub 看仓库最近的 commit 时间，确认推送是否真的成功

推送一直失败？

• 检查网络能否访问 GitHub
• 检查凭据是否有效（token 可能过期）
• 确认仓库存在且你有写权限

想重新开始？

点「清理缓存」清除 public/ 和缓存，再点「生成静态页面」全量重建。

下一步：常见问题 → 常见问题

返回 使用指南总览

基础配置

「设置 → 基础配置」以表单形式管理 _config.yml 的常用项：

站点标题、副标题、描述、作者、语言、时区、网站 URL、根路径、永久链接格式、每页文章数、文章资源文件夹。

也可以在这里设置站点图标 —— 选一张图片（支持 ico / png / jpg / svg / webp），也可以直接把图片拖到左侧方块上。

图标会写入站点 source/favicon.*，所以 Hexo 生成后你的网站也会用上这个图标 —— 不只是应用里显示。

写入安全性

保存配置时，HexoDeck 采用行级替换：

• 只改动目标键所在的那一行
• 注释、空行、键的顺序全部原样保留
• 保存前做 YAML 语法校验，写坏文件会被拦下
• 首次修改自动备份为 _config.yml.hexodeck.bak

所以可以放心用 ── 你的配置注释不会丢。

高级：直接编辑配置文件

「设置 → 高级」提供 _config.yml 的原文编辑：

• YAML 语法高亮
• Ctrl+F 查找替换
• 保存前语法校验

适合表单没覆盖的字段，或者某些插件的个性化配置。

配置文件路径需要你指定

应用不会自动定位配置文件。第一次打开「高级」页时，会弹窗让你指定要编辑的 _config.yml：

• 浏览选择 —— 自己挑文件
• 使用默认位置 —— 一键采用站点根的 _config.yml

指定后会按站点记住，之后再打开不再询问。想换文件，点面板头部的「自定义路径」；想清空记忆重新询问，在弹窗里点「清除记录」。

这样设计是为了避免误改 —— 有些项目会用 _config.xxx.yml 之类的多配置结构，自动定位可能改错文件。

部署配置

「设置 → 部署」配置推送到哪里：

配置不完整会提前提示：

• 分支为空 → 明确警告（空分支会导致 git 推送失败）
• 仓库地址缺 .git 后缀 → 建议补全
• 未安装 hexo-deployer-git → 提供「一键安装」按钮

主题管理

「设置 → 主题」集中管理主题。

从压缩包安装

把主题压缩包拖进窗口，或点「浏览文件」选择。支持格式：

.zip / .tar / .tar.gz / .tgz

解压后应用会自动识别主题目录（判断依据是含 _config.yml 或 layout/），并规整到站点的 themes/ 目录 —— 单层或多层包裹都会自动处理，不会出现 themes/xxx/xxx 这种嵌套。

同名目录会被拒绝，避免覆盖你已有的主题。

主题列表

列出所有已安装主题（检测 themes/ 目录 + npm 包 hexo-theme-*），点「一键切换」即可更换。切换后预览会自动重启。

主题配置

主题配置文件同样不自动定位 —— 第一次编辑某个主题的配置时会弹窗让你指定：

• 可以是站点根的覆盖文件（_config.主题名.yml，推荐做法）
• 也可以是主题自带的配置（themes/主题名/_config.yml）

路径按「站点 + 主题」分别记忆 —— 换主题后各自有各自的配置路径，不会混。

编辑器带 YAML 语法高亮，保存前做语法校验。

主题市场

内置 8 款热门主题，点「安装」即通过 npm 装到站点里：

Butterfly、NexT、Fluid、Shoka、Stellar、安知鱼、Keep、Volantis

插件管理

「设置 → 插件」列出站点 package.json 里的所有 hexo-* 依赖：

• 显示版本号与中文说明
• 安装 —— 输入包名（如 hexo-generator-feed）点安装
• 卸载 —— 带二次确认（渲染器类插件卸载后站点可能无法生成，会特别提醒）
• 设置 —— 点击直达该插件在配置文件里的配置键位置

底部的「插件配置键」区域可以搜索插件名 / 配置键 / 说明，点击即可在配置文件里定位或插入配置模板。

插件安装 / 卸载需要本机有 Node.js。

下一步：发布与部署 → 发布与部署

返回 使用指南总览

页面

「页面」页管理 Hexo 的独立页面 —— 比如「关于」「友链」「留言板」这类不属于文章列表的页面。

它们存放在 source/ 下，不属于 _posts/ 或 _drafts/ 目录，可以放在任意层级的子目录里。

新建页面

点「新建页面」，填写三项：

路径即文件夹：填 about 就会创建 source/about/index.md；填 docs/guide 则创建 source/docs/guide/index.md。

参数会自动去重：如果初始参数里也写了 title，表单里的标题优先；写了 date 则沿用你填的日期，否则自动填当前时间。不需要手动避开。

页面编辑器

页面编辑器与文章编辑器体验一致（分栏预览、自动保存、Ctrl+S），区别是：

• 没有分类和标签（页面通常不需要）
• front-matter 用 YAML 输入框直接编辑 —— 包括标题和日期都在框里改，带语法高亮与实时校验
• 顶部只读展示当前标题、日期与路径

因为标题也在这个框里，所以页面编辑器顶部不再有独立的标题输入框 —— 同一份数据只在一处可编辑，不会出现两处不同步的问题。

页面列表

列表显示每页的标题、路径、日期与字数。路径可以点击 —— 会直接在资源管理器中打开所在文件夹。

自定义文集

文集是 HexoDeck 的特色功能：把站点里的任意文件夹变成独立的文章管理入口。

典型用法：你有 source/_dynamics 用来放短动态、有 source/notes 放学习笔记 —— 把它们各自做成侧栏入口，点进去就像管理「文章」一样管理它们。

添加文集

点侧栏的「+ 自定义」，填写三项：

1. 名称 —— 最多 8 个字（侧栏显示空间有限，超出会省略）
2. 图标 —— 15 种内置矢量图标可选，或点最右侧的虚线格子导入自己的图片（≤200KB）
3. 目录 —— 点「选择文件夹」，选中站点里的任意文件夹

目录可以是站点根目录本身、其子目录、或任意更深层级。选中站点外的文件夹会被拒绝，并有明确提示。

多个文集

可以添加任意多个文集。每添加一个，侧栏就多一个独立入口，各有自己的名称、图标和目录。文集定义按站点记忆 —— 切换站点时只显示该站点的文集。

管理文章

点侧栏的文集入口，进入该文集的文章列表：

• 新建 —— 点右上角「新建<文集名>」，标题输入后创建并打开编辑器
• 编辑 —— 与文章编辑器一致（分栏预览 / 自动保存 / 自定义参数），但没有分类标签
• 删除 —— 移入系统回收站
• 刷新 —— 重新读取目录里的文件

列表里每篇文章显示标题、完整路径、日期与字数，路径可点击跳转到所在文件夹。

编辑与移除文集

在文集页顶部，标题右侧有「编辑」和「移除」两个按钮：

• 编辑 —— 修改名称和图标（目录创建后不可更改）
• 移除 —— 从侧栏移除这个入口

移除文集不会删除任何文件。目录和里面的 Markdown 原样保留，只是不再显示侧栏入口。重新添加即可恢复。

与「文章」的区别

提醒：文集里的 Markdown 是否会被 Hexo 生成到博客，取决于目录位置与你的 Hexo 配置。比如 source/_dynamics 以下划线开头，Hexo 默认会跳过；如果希望内容出现在博客上，请放进 source/ 下的常规目录。

下一步：主题与站点配置 → 主题与站点配置

返回 使用指南总览

文章与草稿

「文章」页管理两类内容：

列表里每篇文章显示标题、状态、路径、日期、标签、分类、字数。点标题或「编辑」进入编辑器。

草稿转正式：在编辑器顶部点「转为正式文章」，文件会从 _drafts/ 移到 _posts/。

删除：删除的文章会移入系统回收站，可以恢复；误删了去回收站找回来即可。

编辑器工具栏

编辑器顶部有两行格式化工具栏：

第一行：标题（H1–H4）、加粗、斜体、代码块、引用、有序列表、无序列表、任务列表

第二行：链接、图片、表格、分割线、清除格式、撤销、重做、＋（自定义片段）

选中文本后点对应按钮即可套用格式。所有按钮都有中文悬停提示。

自定义插入片段

写文章时常要重复输入同样的内容 —— 版权声明、更新时间、标准结尾。第二行末尾的「＋」可以把这些做成一键插入的按钮：

1. 点「＋」打开「自定义插入片段」
2. 填按钮名称（限 6 字，如「版权」「更新」）与要插入的内容
3. 添加后工具栏立刻出现该按钮，写文章时点一下即插入光标处

内容支持 {{date}} 占位符，插入时自动替换为当天日期 —— 适合做「本文更新于 2026-01-01」这类模板。

片段的编辑与删除都在同一个弹窗里完成。它是全局共用的（不像文集和参数定义按站点隔离），因为版权声明这类内容换站点时通常也要用。

图片处理

三种方式都能插图，都会自动保存到站点 source/images/ 并插入正确的 Markdown 链接：

1. 直接粘贴 —— 截图后 Ctrl+V 即插入
2. 拖拽 —— 把图片文件拖进编辑区
3. 选择文件 —— 用工具栏的图片按钮浏览选择

图片文件名会自动处理（空格转连字符、加时间戳去重），避免中文名导致的路径问题。

自动保存与分栏预览

• 自动保存：停止输入后自动存盘，延迟可在「设置 → 应用」调整（0.5–10 秒）
• 分栏预览：编辑器右侧实时渲染 Markdown 效果，开关状态会记住
• Ctrl+F：在正文中查找替换
• 状态栏：底部显示字数与保存状态（有未保存改动时会提示）

全文搜索

「文章」页顶部的搜索框支持全文检索：

• 搜标题、标签、分类 —— 立即匹配
• 搜正文 —— 稍等片刻，命中结果会显示上下文摘录

文章参数

编辑器右侧的「文章参数」侧栏（默认收起，点顶部按钮展开）包含：

分类与标签 —— 输入后回车即可新建，支持多级分类。

自定义参数 —— 给文章加任意 front-matter 字段。参数有三种类型：

添加参数时可以选择类型、填中文显示名与英文键名。开关式还能自定义选中/取消时写入的值（默认 true / false）。

关于开关式参数：写入的 true / false 是 YAML 布尔值而不是字符串。这点很重要 —— 字符串 'false' 在主题模板里会被当成真值，导致开关失效。

结构化参数：写资源卡这类复杂字段

游戏资源、网盘分享类文章常有这样的 front-matter —— 一个 resource 键，里面既有标量字段，又有多条下载链接：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

resource:
  enable: true
  type: mod
  version: v3.1.4
  platform: Windows
  size: 1.8 GB
  language: 简体中文
  links:
    - name: 蓝奏云
      url: https://example.com
      password: echo
      note: 不限速
    - name: 百度网盘
      url: https://example.com
      password: "1234"

这种嵌套结构用普通文本输入框写不了（会被压成字符串而丢失数据），所以「结构化」类型提供一个带语法高亮的 YAML 编辑框，直接写或粘贴即可。

模板一键套用：点参数卡片上的「模板」按钮，内置 5 个骨架可选 ——

点一下即填入，改值就行。也可以把当前填好的内容存为自己的模板，下次直接套用。

自动识别：打开已有文章时，只要某个字段的值是嵌套对象或对象数组，就会自动按结构化类型处理 —— 不用手动改类型，也不会被写坏。

语法校验：YAML 写错时输入框标红、暂停自动保存并在状态栏提示，不会把坏数据写进文件。

小提示：提取码、验证码这类值建议加引号（password: "1234"）。YAML 规范里裸写的 1234 会被解析成数字，加引号才是字符串 —— 否则某些主题模板做字符串比较时会出错。

参数定义按站点记忆：在 A 站配置的参数不会跑到 B 站；同一站点里，新文章会自动带上本站在用的参数名，你只需要逐篇填值。

其他元数据

侧栏底部还有「其他元数据」区域，只读展示 front-matter 里的其余字段（比如主题注入的 layout、comments），避免误改这些由主题或插件控制的键。

下一步：页面管理与自定义文集 → 页面与文集

返回 使用指南总览

一、添加站点

首次启动 HexoDeck，会看到欢迎页。点击「添加站点」，在文件选择器里选中你的 Hexo 博客根目录 —— 也就是包含 _config.yml 的那个文件夹。

选中后应用会校验这个目录：

• 找不到 _config.yml → 会明确提示”所选目录不是 Hexo 站点”
• 校验通过 → 站点信息（标题、副标题、文章数）立刻显示在界面里

添加过的站点会记住。下次启动会自动打开上次使用的站点。

二、认识界面

界面分为三个区域：

侧边栏底部有两个按钮：主题切换（亮色 / 暗色 / 跟随系统三态循环）和收起侧边栏。

窗口顶部是自绘的标题栏，会显示当前站点的图标与名称。按住它拖动可以移动窗口，双击可最大化。

三、写第一篇文章

1. 左侧导航点「文章」
2. 点右上角「新建文章」，输入标题，回车
3. 自动进入编辑器，开始写作

编辑器右侧可以随时开启：

• 预览面板（顶部「◨ 预览已开」）—— 分栏看渲染效果
• 参数侧栏（顶部「▥ 参数已关」）—— 填分类、标签、自定义参数

写作内容会自动保存（默认停止输入 1.5 秒后），也可以随时按 Ctrl+S 手动保存。

四、看效果

左侧导航点「预览」，点「启动预览」：

• 整屏显示主题渲染后的真实博客页面
• 你在编辑器里的改动一保存，预览自动刷新
• 想看得更大，点「浏览器打开」用系统浏览器查看

如果文章还没写完，勾上「包含草稿」也能预览（切换后预览会自动重启使其生效）。

五、发布上线

左侧导航点「发布」：

1. 先确认顶部显示的部署目标是否正确（仓库地址 + 分支）
2. 如果显示「未配置部署目标」，去「设置 → 部署」填写仓库地址与分支
3. 点「部署上线」，确认后开始

部署流程会自动先生成静态页面，再推送到远端 —— 所以不用担心推上去的是旧内容。

首次使用 Git 部署如果提示缺少 hexo-deployer-git 插件，在「设置 → 部署」页点「一键安装」即可。

六、下次打开

再次启动 HexoDeck 会自动打开上次的站点，直接继续写作即可。想切换博客，点右栏站点卡片的「切换站点」，在列表里点另一个站点。

下一步：了解完整的写作功能 → 写作功能

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

下载安装

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

绿色包请先解压再运行，不要在压缩包里直接双击。解压后启动不到 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.*，你的网站也会用上
• 路径可点击：文章 / 页面 / 文集的文件路径与目录都能点，直接在资源管理器打开并选中

汉化说明

本补丁为 《示例模组》v3.1.4 的完整汉化，覆盖 UI、任务、物品与提示文本。

汉化范围

安装方法

1. 先安装原版 MOD v3.1.4
2. 将汉化包内的 Localization 文件夹覆盖到 MOD 根目录
3. 在游戏设置里把语言切换为「简体中文」
4. 重启游戏生效

如果游戏更新导致 MOD 版本变化，请等待对应版本的汉化更新，不要跨版本覆盖。

MOD 简介

这是一个玩法扩展 MOD，新增了 40+ 建筑、12 条任务线，并重做了经济系统。

主要改动

• 新增 40 个建筑与 15 种科技
• 重做经济系统，削弱后期滚雪球
• 新增 12 条支线任务
• 修复原版 30 余个已知 BUG

安装方法

1. 确认游戏版本为 v1.9.x
2. 解压 MOD 包到 Documents/My Games/游戏名/Mods
3. 启动器内勾选启用
4. 新建存档（旧存档可能不兼容）

兼容性

版本说明

已整合全部 DLC 与官方简体中文，解压即玩，无需安装。

配置要求

安装步骤

1. 下载全部分卷，放在同一个文件夹
2. 右键第一个分卷解压到当前目录
3. 进入 Binaries 目录，双击主程序运行
4. 如果提示缺少运行库，请安装目录下的 _CommonRedist

解压密码：echo

影片信息

资源说明

本资源为 4K 蓝光原盘 Remux，保留完整音轨与字幕，适合大屏观看。

• 视频：HEVC 10bit，码率约 45 Mbps
• 音轨：国语 DTS-HD MA 5.1、英语 AC3 5.1
• 字幕：简中、繁中、中英双语

播放建议

推荐使用 PotPlayer 或 MPV 播放，显卡硬解支持 HEVC 10bit 即可流畅播放。

注意：本页仅为排版演示，网盘链接为占位地址。

为什么要自己写主题

现成的 Hexo 主题大多是为「纯文字博客」设计的，而我的站点里有一大半内容是网盘资源。
资源需要的字段和文章完全不同：版本号、平台、文件大小、语言、提取码、多个网盘链接……

这些用普通文章硬凑也能写，但排版会很难看，维护起来也很痛苦。所以我干脆自己写一个主题，
让「文章」和「资源」成为两种一等公民。

资源是怎么定义的

核心思路非常简单：资源就是带有 resource 字段的文章。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

---
title: 某某游戏 v1.2.0 整合版
categories:
  - 游戏资源
resource:
  enable: true
  type: game
  version: v1.2.0
  platform: Windows
  size: 42.6 GB
  language: 简体中文
  links:
    - name: 百度网盘
      url: https://pan.baidu.com/s/xxxx
      password: abcd
---

只要 resource.enable 为 true，主题就会：

1. 把它归入 /resources/ 资源库
2. 按 type 自动进入对应分类（movie / game / mod / translation …）
3. 在详情页渲染出网盘下载区块和复制提取码按钮

目录结构

1
2
3
4
5
6

themes/echo/
├── layout/          # EJS 模板
│   ├── _partial/    # 卡片、导航、下载区块等组件
│   └── _widget/     # 侧边栏小组件
├── scripts/         # 生成器与辅助函数
└── source/          # CSS / JS / 图片

下一步

• 接入评论系统
• 资源页加上排序和搜索
• 支持磁力链接和 BT 种子