知识平台集成方案
状态：Active / 轻量部署基线
最后更新：2026-05-11
范围：Labs-FinTecAI-Gov 作为 FinTec AI Ecosystem 知识库 / 治理库的人类门户、Agent 接入层与上下文预备层
本文档记录当前知识平台方案。目标不是把仓库迁移成协作平台，也不是引入完整 RAG / workflow runtime，而是在保持 Markdown Git 仓库作为正式事实源的前提下，补齐“人可读、Agent 可接入、后续上下文层可演进”的基础能力。
当前团队在线门户：
1. 当前结论
当前正式组合是：
| 组件 | 定位 | 当前状态 |
|---|---|---|
Markdown Git repo | 唯一正式事实源 | 主体 |
Docusaurus | 面向人类和团队协作者的静态知识门户 | 主入口 |
Pagefind | 静态全文检索 | 主入口的一部分 |
llms.txt / docs-manifest.json | 面向个人域 Agent、团队域 Agent 和 Program Controller 的低上下文接入层 | 主入口 |
Graphiti-ready contract | 后续动态实体 / 决策 / packet / 项目记忆上下文层输入契约 | 预备，不部署服务 |
不在当前阶段引入：
- 自动静态图谱产物；
- 重型 RAG 应用平台；
- 本地模型或 GPU 依赖；
- 图数据库运行时；
- open-cowork 的当前迭代运行时；
- issue / PR / 日常任务管理系统。
2. 为什么移除自动静态图谱产物
自动静态图谱工具能快速生成一次性图谱，但在本仓库当前场景中会形成误干扰项：
- 它容易把生态治理关系误标为代码调用、实现或引用关系；
- 它生成的是模型推断图，不是正式事实源；
- 团队成员和个人域 Agent 容易误以为图谱是权威入口；
- 它增加了一组需要维护、刷新、解释和排除的产物。
因此当前仓库不再保留自动静态图谱配置、依赖、说明文档和生成产物。关系理解回到两类稳定入口：
- 正式关系：以 生态关系注册表 和对应事实源为准；
- Agent 路由：以
llms.txt、docs-manifest.json和 Agent Context Layer 为准。
3. 部署链路
当前发布链路：
main分支仍是 Markdown 事实源；- Docusaurus 从
portal/symlink 入口读取正式文档； npm run build执行 Docusaurus 构建，并在build/中生成 Pagefind 索引；- GitHub Actions 使用 Node 22 执行
npm ci和npm run build，上传build/构建产物； - Dockerfile 使用 Node 22 构建站点，并通过 Nginx 发布
build/； - Railway / 服务端部署继续使用 Dockerfile，不需要模型密钥。
本流程不运行大模型抽取，不运行图谱生成，也不运行 Graphiti 服务。
4. 本地使用
安装依赖：
npm ci
本地开发预览：
npm start
生产构建与 Pagefind 索引：
npm run build
本地查看生产构建：
npm run serve
5. Agent 接入
Agent 不应从目录树开始全量扫描。
默认读取顺序：
llms.txtdocs-manifest.jsonACCESS_GUIDE.md- 与本轮任务对象相关的 3 到 5 份 Markdown 文件
docs-manifest.json 只负责路由，不替代正式文档。稳定结论仍必须回写到 baseline/、registry/、projects/、governance/、source/、references/ 或 packets/ 中的合适位置。
6. Graphiti-ready 当前定位
Graphiti-ready 当前只定义未来动态上下文层的事件契约：
- 不运行 Graphiti 服务；
- 不保存图数据库；
- 不要求本地模型；
- 不作为事实源；
- 只消费稳定文档、packet、评测结论和 Program Controller handoff。
相关文档：
7. 维护原则
- Markdown 是唯一正式事实源；
- 站点、搜索、manifest 和 Graphiti-ready 都是接入层；
- 不把来源材料或参考分析直接升级为产品定义；
- 不把工程仓库事实直接写成生态事实；
- 不把 open-cowork 当前迭代状态作为本仓库部署依赖；
- 不重新引入自动静态图谱作为团队或 Agent 的正式入口；
- 每次更新知识库主入口后，必须构建站点并确认 Pagefind 索引生成。