跳到主要内容

Checkpoint: publish-closure

日期：2026-05-14
Controller：Labs-FinTecAI Admin
Lane：knowledge-refactor
状态：Proposed

1. 本批完成​

本 checkpoint 固化 Batch 3 / 4 / 5A / 5B / 5C / 5D 的发布闭环结果。

截至 2026-05-14 00:00 HKT：

  • 本地 HEAD 与 origin/main 一致；
  • 远端 main 指向 3e662ca2f1ab12b30a7b662ef011d87b3d10a603；
  • GitHub Actions Docs workflow 已成功；
  • 公开站点已吸收 controller-pickup-closeout；
  • docs-manifest.json、llms.txt、Pagefind 和新 checkpoint 页面均已通过线上烟测。

2. 发布证据​

项目证据
Git commit3e662ca2f1ab12b30a7b662ef011d87b3d10a603
GitHub ActionsDocs run 25810502667，status completed，conclusion success
Local / remote alignmentgit rev-parse HEAD 与 git rev-parse origin/main 均为 3e662ca2f1ab12b30a7b662ef011d87b3d10a603
Public homehttps://fin-tec-ai.up.railway.app/ 返回 HTTP 200
Public manifesthttps://fin-tec-ai.up.railway.app/docs-manifest.json?ts=... 返回 HTTP 200，包含 controller-pickup-closeout
Public llmshttps://fin-tec-ai.up.railway.app/llms.txt?ts=... 返回 HTTP 200，包含 Controller pickup closeout
New checkpoint pagehttps://fin-tec-ai.up.railway.app/controllers/labs-fintecai-admin/checkpoints/2026-05-13-controller-pickup-closeout/ 返回 HTTP 200
Pagefindhttps://fin-tec-ai.up.railway.app/pagefind/pagefind-entry.json 返回 HTTP 200

3. 已观察到的非阻断事项​

GitHub Actions 输出 Node.js 20 actions 弃用警告：

  • actions/checkout@v4
  • actions/setup-node@v4
  • actions/upload-artifact@v4

该警告没有阻断本次发布，但应作为后续独立 tooling cleanup 处理，避免在 GitHub runner 默认切换到 Node.js 24 后产生兼容性风险。

4. 后续动作​

  1. workflow-node24-compat-cleanup：检查 .github/workflows/*.yml 的 actions 版本和 Node.js 24 兼容策略；
  2. scope-guard-required-check：将 scope guard 纳入 GitHub required check；
  3. published-site-verify-script：考虑把线上 docs-manifest.json、llms.txt、关键页面和 Pagefind 检查固化为 npm run verify:published-site。

5. 不做事项​

  • 不继续修改项目正文；
  • 不重开 Batch 3 核心入口；
  • 不把 GitHub Actions 的 Node.js 20 警告混入本轮知识库事实源重构；
  • 不把本 checkpoint 作为产品事实源。

6. 验证​

  • git diff --check：通过。
  • node -e "JSON.parse(require('fs').readFileSync('docs-manifest.json','utf8')); console.log('docs-manifest JSON parse OK')"：通过。
  • DOC_CHANGE_SCOPE=ecosystem,public-entrypoints,controllers,packets,tooling npm run verify:change-scope：通过，4 个变更文件均在允许范围内。
  • npm run build：通过，Docusaurus build 成功，Pagefind 索引 139 pages / 6216 words。