开发手册
面向定制者与贡献者:改动地图、加栏目与加语言、换主题与改首页、功能开关总表、CI 门禁与安全、同步上游与贡献回流、让 AI 替你运营(GSC API 接入、anvilwiki-ops 与 MCP)。
9 课
- 1 先看这张地图:改哪里,不改哪里 AnvilWiki 分三层:代码层(几乎别动)、配置层(每游戏改一次)、内容层(天天加)。用改动决策树 30 秒定位任何需求该落在哪,附数据流和 Astro 5 的六个坑。
- 2 加栏目与加语言 两个最常见定制需求的分步操作:加导航栏目(三处一致,配 AI 提示词)、加一种语言(脚手架生成骨架 + 界面翻译与文章翻译提示词)。查询手册,按需翻。
- 3 功能开关总表:广告、评论、统计 所有可选功能共用一套开关机制(变量空着=不渲染,保住开箱满分),全部变量的总表和填写位置,以及 wrangler.toml 的进阶玩法(保留它=设置全以它为准)。
- 4 改完怎么自证:验证清单与门禁 每次改动后、提交前的自证清单:七条本地命令各守什么、CI 八道门禁怎么读、三条自动流水线各自把什么关,以及安全与性能底线——定制时别拆模板内置的防线。
- 5 同步上游:把官方更新安全搬进来 三行命令合并官方更新,冲突口诀「配置和内容保留我的,代码听官方的」;版本号三段式承诺(字段只加不改名/新功能默认关闭/locale 缺条目英文兜底)决定你要不要升。
- 6 贡献回流:把好东西交回官方 给 AnvilWiki 提改进的五步路径(先开 issue→分支开发→自验→PR→配测试补文档),以及把你的站提上官网展示墙——真实的成功站是模板最有说服力的广告。
- 7 让 AI 替你运营:GSC 数据接入、metrics 与 MCP GSC API 五分钟接入(Google 群组中转授权)与 CF 令牌写进 .env 后,doctor 体检、metrics 拉 28 天真实数据、insights 出带证据的行动清单,MCP 接入后自然语言指挥 AI 运营——写操作只走 PR,合并权在你。
- 8 内容管道:关键词清单变草稿 PR Actions 页粘一份关键词 CSV,管道自动:确定性生成器建草稿→八道质量门禁→只有全绿才开 draft PR。CI 里没有任何 AI key——AI 在本地会话里填内容,人审后 merge。
- 9 多站管理:一套工具管 N 个站 从第二个站开始:多站注册表 sites.toml 登记名字和路径(凭据永不入表),一条命令巡检全部——audit/metrics/insights 都支持 --all 和 --site;AI 引用追踪看趋势。submit 刻意拒绝 --all。