跳到主要内容

FinClaw 改名为 FinBayes 并完成项目迁移合并

目标

将 FinClaw 正式改名为 FinBayes,完成从旧项目目录到新项目目录的迁移合并,并同步更新生态级文档和跨项目引用,消除当前两个项目目录并存导致的事实源分裂。

背景

当前仓库中 FinClaw 和 FinBayes 处于并存状态:

  • projects/finbayes/ 已存在完整的产品定义与基线改造设计包,frontmatter 状态为 draft,明确声明"不继承旧 FinClaw 文档链作为约束"。
  • projects/finclaw/ 仍标记为 active,包含战略白皮书、产品体验蓝图、V1 产品规格、V1 工程落地理解地图等完整文档体系。
  • ecosystem/object-registry.mdecosystem/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.mdFinClaw 条目改名为 FinBayes,项目入口指向 projects/finbayes/,阶段状态更新
ecosystem/current-baseline.md3+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/ 多个目录。

建议执行顺序

  1. 生态级文档更新:先更新 object-registry.md 和 current-baseline.md,确立 FinBayes 为正式名称。
  2. FinBayes 项目目录升级:将 projects/finbayes/ 的 status 从 draft 改为 active。
  3. FinClaw 项目目录弃用:将 projects/finclaw/ 标记为 deprecated,README 加 Replaced-by 指向。
  4. 跨项目资产处理:决定 commons 下的 finclaw 命名资产是改名还是保留并标注。
  5. 派生脚本验证:运行 derive-agent-pack.mjs,确认 Agent 包正确反映新结构。
  6. 全仓库引用扫描:grep 所有 .md 文件中的 FinClaw / finclaw 引用,逐一处理。
  7. verify-kb 校验:运行 verify-kb 确认无断链、无 frontmatter 异常。

待讨论问题

  1. commons/references/finclaw/ 是否改名? 这些参考资料是在 FinClaw 时期产生的,改名可能导致 git 历史追溯困难;保留原名则需要在 README 中说明 finclaw 是 FinBayes 的历史名称。
  2. FinClaw 的 V1 工程落地文档是否迁入 FinBayes? FinBayes README 明确声明不继承旧文档链,但 FinClaw 的产品体验蓝图、V1 规格等文档可能仍有参考价值。建议作为归档证据保留在 _archive/ 而非迁入。
  3. 生态 3+2 结构是否因此调整? 如果 FinBayes 完全继承 FinClaw 的生态位(认知层前台产品),则 3+2 结构不变,只是名称替换。如果 FinBayes 的定位有实质变化,需要同步更新生态战略白皮书。

回写位置

  • 生态级结论回写 ecosystem/object-registry.mdecosystem/current-baseline.md
  • 项目级结论回写 projects/finbayes/README.mdprojects/finclaw/README.md
  • 弃用后的 FinClaw 文档按 change-protocol §5 保留 30 天后评估归档至 _archive/projects/finclaw/