开发手册
7 章,面向定制者与贡献者:改动地图、加栏目与加语言、换主题与改首页、功能开关总表、CI 门禁与安全、同步上游与贡献回流、让 AI 替你运营(anvilwiki-ops 命令行与 MCP)。
7 章
- 1 开发 1 · 先看这张地图:改哪里,不改哪里 AnvilWiki 分三层:代码层(几乎别动)、配置层(每游戏改一次)、内容层(天天加)。用改动决策树 30 秒定位任何需求该落在哪,附数据流和 Astro 5 的六个坑。
- 2 开发 2 · 加栏目与加语言 两个最常见定制需求的分步操作:加导航栏目(三处一致,配 AI 提示词)、加一种语言(脚手架生成骨架 + 界面翻译与文章翻译提示词)。查询手册,按需翻。
- 3 开发 3 · 换主题色与改首页 换主题色的规矩(8 行变量一起换,漏了会残留旧色相)和改首页文案的正确姿势(只动语言 JSON 的 home 段,附 AI 出稿提示词),以及给文章登记卡加新字段的进阶流程。
- 4 开发 4 · 功能开关总表:广告、评论、统计 所有可选功能共用一套开关机制(变量空着=不渲染,保住开箱满分),全部变量的总表和填写位置,以及 wrangler.toml 的进阶玩法(保留它=设置全以它为准)。
- 5 开发 5 · CI 门禁与安全底线 三条自动流水线分别替你把什么关(八道门禁的 CI、每周保鲜提醒、初始化清理),以及模板内置的安全底线——结构化数据转义、赞助链接标记、同意前不追踪、零 JS 框架。
- 6 开发 6 · 跟上官方更新,和把好东西贡献回去 官方仓库的新功能怎么安全合并进你的站(冲突时永远保留你自己的游戏配置和文章),版本号的兼容承诺,以及给 AnvilWiki 提改进、上展示墙的完整路径。
- 7 开发 7 · 让 AI 替你运营:anvilwiki-ops 与 MCP 一行 npx 给你的 AI 助手装上运营工具:体检配置、拉 GSC 与 Cloudflare 真实数据、自动产出按优先级排序的优化清单、把新内容校验后开 PR 上线——写操作只走 PR 一条路,合并权永远在你手里。