Official Docs Map

Official-Docs-Map

本仓工作区里有一份 Firefly 官方中文配置文档镜像：docs/official/（约 31 篇，gitignore 不入库）。
路由索引（入库）：docs/knowledge/official-docs.tree.json。
上游在线版：https://docs-firefly.cuteleaf.cn

一句话：官方文档 = 主题出厂说明书；本站在工程里做了删减与增添，Wiki 优先写 delta，不把 31 篇整份搬上来。

区块	路径	内容
入门	`01-入门/`	快速开始、编写文章、部署、更新主题
基础配置	`02-基础配置/`	站点、设置面板、资料、壁纸、导航、侧栏、小组件
功能配置	`03-功能配置/`	字体、代码块、评论、封面、加密、音乐、Mermaid、PlantUML
页面配置	`04-页面配置/`	动态、友链、相册、追番、打赏、番组
扩展	`05-扩展功能/`	特效、公告、页脚、广告、许可证、Live2D/Spine

主题	官方出厂常见主张	本站现行	Wiki
评论	`type: "none"`	`waline`	Comments-Waline · ADR-0001
音乐	`mode: "meting"`	`local`	Music-Player · ADR-0002
主题模式	常 `system`	`time`（按时段）	Configuration-Overview
公告	静态 title/content	+ `loveLetter` 礼盒	Sidebar-Widgets
看板娘	`pioConfig` Live2D/Spine	桌宠 `petConfig`；pio 关	Sprite-Pets
壁纸	mode/banner/carousel	+ `atmosphere` 氛围层	Wallpaper-and-Atmosphere
草稿	仅 FM `draft: true`	+ `_draftbox/` 本地箱	Writing-Posts
合集	（官方无专章）	`collectionsConfig` 一/二级	Writing-Posts
番组计划	可开	本站常 `pages.bangumi: false`	关页面即可
部署	多平台长文	默认 Vercel	Deploy-Vercel
更新主题	upstream merge	已 standalone，合并冲突面大	Contributing

字体 · 代码块 · 封面 · 文章加密 · Mermaid/PlantUML · 友链/相册/打赏 · 页脚/广告/许可证 · 设置面板开关

→ 直接读 docs/official/ 对应篇；本站若有小改动，在 Configuration-Overview 或 FAQ 点一句即可。

能力	入口
氛围层 `atmosphere`	Wallpaper-and-Atmosphere
草稿箱 `_draftbox/`	Writing-Posts
合集嵌套	`src/config/collectionsConfig.ts`
Agent 发文双路径	仓库 `AGENTS.md`（勿贴全文）
节日礼盒交互	Sidebar-Widgets
站点问答助手（MaxKB）	Ask-and-LiveChat