我们的自动化如何运作
透明度页面:这里展示了帮助 AILmanac 以最少维护者投入保持内容新鲜、高质量的机制。贯穿始终的原则是:自动化只是把工作呈现出来供人类审批——它从不悄悄发布未经核实的内容。
构建门禁(已启用)
每一次改动都会以 onBrokenLinks: 'throw' 的方式构建,因此失效的内部链接或损坏的 MDX 都会在合并前让构建失败。这是最有价值的一项检查——它让导航始终值得信赖。
CI 工作流
工作流文件位于
ci-workflows分支,当仓库拥有具备workflow权限范围的令牌后即可启用(参见 README)。在此之前,站点从gh-pages分支部署。
build-check— 构建每一个 PR(链接失效则失败)。这是一项必需检查。deploy— 在推送到main时构建并发布到 GitHub Pages。link-check—lychee每周以及在 PR 上运行;遇到失效的外部链接时,它会开一个跟踪 issue(标签为link-rot),而不是只是变红。
新鲜度自动化(规划中/分阶段)
- 发布监视器 — 一个定时任务,轮询 Anthropic 的文档/更新日志以及变动最快的消费端界面(应用、语音、移动端、市场)。一旦发生变化,它会开一个标记为
upstream-change+needs-verification的 issue/PR,指向可能受影响的页面。由人类来撰写更新。 - 模型表校验器 — 将
data/models.json与官方模型列表做差异比对,发生漂移时开一个 PR。模型表会显示一个“最近核实”日期。 - 陈旧度巡检 — 标记那些
lastVerified早于阈值的易变页面。
为什么要人类参与其中
:::tip 自动化且诚实 > 自动化但出错 一个会自动把“新闻”提交到参考站点的 AI 有发布幻觉内容的风险——这与值得信赖恰恰相反。所以我们的自动化只提议(issue/PR);由人类来核实并合并。参见事实核实。 :::
想为自动化出一份力?
改进这些工作流是一项很棒的进阶贡献——参见 .github/workflows(位于 ci-workflows 分支)以及参与贡献。