跳到主要内容

Checkpoint: core-entrypoint-3d

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

1. 本批完成​

Batch 3D 已完成机器路由和门户导航同步。

本批保持 3C checkpoint 与 recovery checkpoint 定义的边界，只修改路由、导航和恢复控制面，不进入项目正文、FinClaw 设计包、PRD、评测、参考体验或运行日志。

2. 改动文件​

  • docs-manifest.json
  • sidebars.js
  • llms.txt
  • packets/sync/labs-fintecai-core-entrypoint-refactor-plan-2026-05-13.md
  • controllers/labs-fintecai-admin/state.md
  • controllers/labs-fintecai-admin/checkpoints/2026-05-13-core-entrypoint-3d.md
  • controllers/labs-fintecai-admin/checkpoints/2026-05-13-core-entrypoint-3d-recovery.md

3. 路由与导航调整​

3.1 docs-manifest.json​

  • repository_start 增加 INDEX.md，让 Agent 初次进入时能直接识别文档状态索引；
  • external_reference_layer 扩展为 evidence / reference 入口，加入 evaluation 和 first-batch reference report；
  • 新增 knowledge_refactor entrypoint，集中暴露本轮 operating plan、audit、document inventory、target architecture、core entrypoint plan 和 3D recovery checkpoint。

3.2 sidebars.js​

  • 总览 只保留四个核心入口：README、ACCESS_GUIDE、INDEX、CONTEXT-MAP；
  • 治理 调整为 治理与协同，并把 packet README、sync README、escalation README 放在协议层；
  • 同步与升级 调整为 同步记录，只放具体 sync 记录和本轮知识库重构控制包；
  • 平台与 Agent 支撑材料从 总览 下移到 同步记录 末尾，避免被误读为正式入口。

3.3 llms.txt​

  • recommended agent entry 增加 INDEX.md；
  • 明确 INDEX.md 是文档状态索引；
  • 增加 coordination boundaries：controllers/ 是 recovery surface，不是 product authority；packets/ 是 coordination surface，不是 canonical fact source；
  • 增加本轮 knowledge refactor control plane 的最小入口清单。

4. Reader Testing 结果​

测试当前结果
新 Agent 首次进入docs-manifest.json 和 llms.txt 均指向 README.md、ACCESS_GUIDE.md、INDEX.md、CONTEXT-MAP.md
人类从门户浏览sidebar 总览 不再混入平台实现细节，核心入口更清晰
Controller 恢复manifest 保留 controller_recovery，sidebar 保留 Controller 状态
知识库重构续接manifest 暴露 knowledge_refactor，sidebar 暴露本轮控制包
防止事实源漂移llms.txt 明确 controllers/ 和 packets/ 不是正式事实源

5. 验证​

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

6. 下一步​

Batch 3 核心入口重构已完成 3A / 3B / 3C / 3D。

后续建议进入 Batch 4：按 Document Inventory 和 Target Knowledge Architecture 处理 Controller 分发包或 relink/demote 候选。Batch 4 不应重新打开核心入口正文，除非有新的 reader testing 失败证据。