FinClaw 改名为 FinBayes 并完成项目迁移合并
目标
将 FinClaw 正式改名为 FinBayes,完成从旧项目目录到新项目目录的迁移合并,并同步更新生态级文档和跨项目引用,消除当前两个项目目录并存导致的事实源分裂。
背景
当前仓库中 FinClaw 和 FinBayes 处于并存状态:
projects/finbayes/已存在完整的产品定义与基线改造设计包,frontmatter 状态为 draft,明确声明"不继承旧 FinClaw 文档链作为约束"。projects/finclaw/仍标记为 active,包含战略白皮书、产品体验蓝图、V1 产品规格、V1 工程落地理解地图等完整文档体系。ecosystem/object-registry.md和ecosystem/current-baseline.md仍将 FinClaw 列为独立前台产品,3+2 结构中的认知层对象名称为 FinClaw。commons/references/finclaw/和commons/frameworks/evaluation/finclaw/下的跨项目资产以 finclaw 命名。for-agents/projects/下 finclaw 和 finbayes 各有独立的 context.json。
这种并存状态使得新接入者无法判断"认知层产品"的正式名称和权威事实源是哪个目录。
影响范围
生态级文档(L3 触发点)
| 文件 | 变更内容 |
|---|---|
ecosystem/object-registry.md | FinClaw 条目改名为 FinBayes,项目入口指向 projects/finbayes/,阶段状态更新 |
ecosystem/current-baseline.md | 3+2 结构表中 FinClaw 改名为 FinBayes,边界描述同步更新 |
ecosystem/whitepaper.md | 如有 FinClaw 引用,改为 FinBayes |
项目级文档
| 路径 | 变更内容 |
|---|---|
projects/finclaw/ | 整体标记为 deprecated;README.md 加 Replaced-by: ../finbayes/;按弃用协议保留 30 天后评估归档 |
projects/finbayes/ | 确认为认知层产品的唯一正式项目目录;frontmatter status 从 draft 更新为 active |
跨项目资产
| 路径 | 变更内容 |
|---|---|
commons/references/finclaw/ | 评估是否改名为 commons/references/finbayes/,或保留原名并在 README 中说明历史对应关系 |
commons/frameworks/evaluation/finclaw/ | 同上 |
Agent 派生包
| 路径 | 变更内容 |
|---|---|
for-agents/projects/finclaw/ | 派生脚本停止为 finclaw 生成独立 context.json |
for-agents/projects/finbayes/ | 成为认知层项目的唯一 Agent 消费入口 |
scripts/derive-agent-pack.mjs | 确认派生脚本能正确处理 finclaw 弃用后的目录结构 |
其他文件中的引用
仓库内其他文件中出现的 FinClaw 文本引用、相对路径链接(如 ../finclaw/、projects/finclaw/)需要逐一更新或标注。
变更级别
L3。理由:变更涉及 ecosystem/ 下的对象注册表和生态基线,改变了 3+2 结构中一个前台对象的名称和项目入口;同时跨越 projects/、commons/、for-agents/ 多个目录。
建议执行顺序
- 生态级文档更新:先更新 object-registry.md 和 current-baseline.md,确立 FinBayes 为正式名称。
- FinBayes 项目目录升级:将
projects/finbayes/的 status 从 draft 改为 active。 - FinClaw 项目目录弃用:将
projects/finclaw/标记为 deprecated,README 加 Replaced-by 指向。 - 跨项目资产处理:决定 commons 下的 finclaw 命名资产是改名还是保留并标注。
- 派生脚本验证:运行 derive-agent-pack.mjs,确认 Agent 包正确反映新结构。
- 全仓库引用扫描:grep 所有 .md 文件中的 FinClaw / finclaw 引用,逐一处理。
- verify-kb 校验:运行 verify-kb 确认无断链、无 frontmatter 异常。
待讨论问题
- commons/references/finclaw/ 是否改名? 这些参考资料是在 FinClaw 时期产生的,改名可能导致 git 历史追溯困难;保留原名则需要在 README 中说明 finclaw 是 FinBayes 的历史名称。
- FinClaw 的 V1 工程落地文档是否迁入 FinBayes? FinBayes README 明确声明不继承旧文档链,但 FinClaw 的产品体验蓝图、V1 规格等文档可能仍有参考价值。建议作为归档证据保留在
_archive/而非迁入。 - 生态 3+2 结构是否因此调整? 如果 FinBayes 完全继承 FinClaw 的生态位(认知层前台产品),则 3+2 结构不变,只是名称替换。如果 FinBayes 的定位有实质变化,需要同步更新生态战略白皮书。
回写位置
- 生态级结论回写
ecosystem/object-registry.md和ecosystem/current-baseline.md - 项目级结论回写
projects/finbayes/README.md和projects/finclaw/README.md - 弃用后的 FinClaw 文档按 change-protocol §5 保留 30 天后评估归档至
_archive/projects/finclaw/