Sync: Labs-FinTecAI Knowledge Architecture Audit
日期：2026-05-13 来源项目 / 材料：治理仓库和知识库重构启动批次 提交人 / 责任人：Labs-FinTecAI Admin 当前状态：Draft
1. 触发背景
本审计是知识库重构的 Batch 0 启动审计，并已接入 Batch 1 轻量 inventory。它只回答第一层问题：当前仓库需要怎样被轻量覆盖、分批盘点和分流，才能既覆盖整个治理仓库和知识库，又避免上下文爆炸和无目的重构。
本审计不是全仓库深度阅读报告，也不是项目内容评审。
2. 当前轻量盘点范围
本批通过文件枚举和入口协议读取建立初始范围：
| 范围 | 轻量计数 |
|---|---|
Markdown 文件总数，排除 node_modules、.portal-build、build | 138 |
纳入 IA 盘点的文档 / 配置文件，含 docs-manifest.json、llms.txt、sidebars.js、docusaurus.config.js、mkdocs.yml | 145 |
主要目录分布：
| 目录 | Markdown 数量 | 初始角色判断 |
|---|---|---|
baseline/ | 3 | 生态事实源 |
contexts/ | 1 | 领域语言恢复入口 |
controllers/ | 14 | Controller 恢复状态和 checkpoint |
evaluation/ | 10 | 评测、case library、运行与报告入口 |
governance/ | 12 | 治理协议、协同规则、知识平台和变更闭环 |
packets/ | 32 | sync / escalation / handoff / 协同证据 |
projects/ | 35 | 项目级事实源、定义、设计支撑和参考体验 |
references/ | 11 | 外部参考、竞品、反例和复核材料 |
registry/ | 1 | 生态对象注册表 |
source/ | 4 | 内部来源和预对齐材料 |
agent-context/ | 1 | Agent / dynamic context 辅助层 |
docs/ | 3 | Agent 工作约定辅助文档 |
Batch 1 已形成独立 inventory：packets/sync/labs-fintecai-document-inventory-2026-05-13.md。该 inventory 覆盖 140 个治理知识库源文件和入口配置对象，排除生成目录、依赖目录和工具安装源码，只读取标题、声明状态、用途行、前 45 行和入口暴露面。
本审计保留 Batch 0 的初始范围计数作为启动证据；后续执行以 Batch 1 inventory 的 140 个对象作为分流依据。
3. 已确认的结构事实
- Markdown 源文件仍是事实源；Docusaurus、Pagefind、manifest 和图谱层只展示、检索或路由。
- 人类入口、Agent 入口、Controller 恢复入口和项目入口已经存在，但需要进一步变成角色化任务流。
controllers/保存恢复状态，不替代正式产品事实。packets/是协同信号和回写入口，不替代正式事实源。- 当前工作树存在其他 Controller / Agent 的未提交变更，Batch 0 不吸收、不裁决这些内容。
4. 初始 IA 问题分类
| 问题类型 | 当前判断 | 下一步 |
|---|---|---|
| 入口过多但角色不同 | 已确认 | Batch 1 标记每个入口的读者和任务 |
| 事实源、证据层、参考层、packet、Controller 状态容易混读 | 已确认 | Batch 1 给每个文档标注 intended role |
| 项目细节可能进入 Admin 长上下文 | 高风险 | 只用项目 Controller packet 分发 |
| 旧过程材料可能继续被搜索和 Agent manifest 暴露 | 待核验 | Batch 1 检查 manifest / sidebar / inbound links |
| 约束停留在自然语言，未下推到可执行物 | 已确认 | Batch 4 建 Constraint Migration Table |
| 为重构而重构 | 高风险 | 使用动作判定矩阵，风格问题不动 |
5. Batch 1 Inventory 字段
下一批不读取正文全文，按以下字段建立 inventory：
| 字段 | 含义 |
|---|---|
path | 文件路径 |
title | 文档标题 |
declared_status | 文档声明状态 |
current_role | 当前实际承担的角色 |
intended_role | 重构后应承担的角色 |
owner_layer | ecosystem / project / evidence / controller / tooling |
reader_task | 读者打开它应完成什么任务 |
canonical_status | canonical / support / evidence / reference / sync / recovery / deprecated |
inbound_surface | README / INDEX / sidebar / manifest / packet / none |
outbound_refs | 主要外链或继承对象 |
action | keep / rewrite / relink / demote / archive / no-op |
reason | 动作理由 |
6. 第一批不处理事项
- 不重写项目 PRD、MVP、设计包或参考体验正文。
- 不决定任何项目产品边界。
- 不清理其他 Controller 的 checkpoint。
- 不统一提交当前工作树所有变更。
- 不把
site-architecture的营销站点指标照搬为治理知识库指标。
7. 当前建议
以 packets/sync/labs-fintecai-knowledge-refactor-operating-plan-2026-05-13.md 作为执行控制面，进入 Batch 1：全仓库轻量 Document Inventory。
Batch 1 应优先输出 inventory，而不是马上改 README.md、INDEX.md 或项目正文。
8. 后续观察点
docs-manifest.json与sidebars.js是否仍暴露已降级材料为正式入口；INDEX.md与ACCESS_GUIDE.md是否存在读者任务重复或顺序冲突；controllers/*/state.md与 checkpoint 是否需要统一吸收规则；packets/sync/中哪些文件已吸收但仍像 active 入口；- 每个项目是否需要单独的 Controller Refactor Packet。
9. 是否需要转 escalation
当前不需要。若 Batch 1 发现正式事实源互相冲突，或某项目入口已无法由 Admin 判断，应创建对应 escalation。
10. 吸收状态
Batch 1 inventory 已生成，待 FinTec AI admin 会话复核后决定哪些内容进入正式治理文档、哪些保留为 sync 追溯。下一步进入 Batch 2：目标知识架构和入口分层设计。