根目录 > source

内容源模块文档

模块职责

source/ 是 Hexo 的内容根目录，负责承载三类内容：

• 手写内容：文章、页面、草稿材料
• 结构化数据：Readwise / Maimemo / Bangumi / 豆瓣等 JSON
• 站点静态资源：CSS、JS、图片、robots.txt、manifest.json

当前目录结构

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

source/
├── _posts/                    # 已发布文章
├── _data/                     # 关于页、标签库、相册等数据
├── about/                     # 关于页
├── chat/                      # AI 聊天页
├── dashboard/                 # 仪表盘页
├── highlights/                # Readwise 页面
├── opinion/                   # 闲言碎语页
├── tools/                     # 工具页
├── css/ / js/ / img/          # 自定义静态资源
├── bangumis*.json             # 追番数据快照
├── douban-*.json              # 观影/书籍快照
├── readwise*.json             # Readwise 原始与轻量数据
├── readwise-ai-digest*.json   # Readwise AI 摘要与点评
├── maimemo-study*.json        # 墨墨学习快照与 digest
└── robots.txt / manifest.json

关键页面

根级数据文件

这些文件通常由脚本生成或刷新，不建议手改内容本体：

• readwise.json
• readwise-lite.json
• readwise-ai-digest.json
• readwise-ai-digest-lite.json
• maimemo-study.json
• maimemo-study-weekly.json
• maimemo-study-ai-digest.json
• maimemo-study-lite.json
• bangumis.json
• bangumis-watching.json
• douban-books.json
• douban-movies.json
• opinion-lite.json

更新规则

• 文章内容改 source/_posts/
• 页面内容改各目录下 index.md
• 结构化配置优先改 source/_data/
• 自动生成 JSON 优先通过脚本刷新，不直接手改
• 静态资源统一放在 source/css/、source/js/、source/img/

特别说明

• 仓库里存在 source/draft/ 目录，这是手工整理的草稿/资料目录，不等同于 Hexo 默认的 source/_drafts/
• _config.yml 中 skip_render 已对部分 JSON 做了透传配置，改文件前先确认它是不是被直接发布到站点根路径

验证方法

1
2

npx hexo generate
npm run server

如果修改的是 Readwise / Maimemo 等生成数据，再补：

1
2
3
4

npm run readwise
npm run readwise:digest
npm run maimemo:sync
npm run maimemo:digest

最后更新：2026-03-31