跳到主要内容

ADR-0001 FinClaw 项目改名为 FinBayes 并归档原 FinClaw 项目目录

背景​

2026-05-23 由 governance/proposals/inbox/2026-05-23--finclaw-finbayes-migration.md 提出，识别到：

  • projects/finclaw/ 标记为 active，projects/finbayes/ 标记为 draft 但已有完整产品定义包
  • ecosystem/object-registry.md 与 ecosystem/current-baseline.md 将认知层对象登记为 FinClaw
  • projects/finbayes/README.md 明确声明"不继承旧 FinClaw 文档链作为约束"
  • 两个项目目录并存使新接入者（人 + Agent）无法判断"认知层产品"的权威名称和唯一事实源

2026-05-25 FinBayes 战略白皮书完成（version v2-implementation-polish, status active），定位与产品体系稳定到足以替换原 FinClaw 在生态中的位置。

决策​

接受迁移提案，正式将 FinTec AI Ecosystem 的认知层产品命名为 FinBayes：

  1. ecosystem/ 全量同步*：object-registry / current-baseline / whitepaper / recovery-anchor / glossary 中所有 FinClaw 项目引用替换为 FinBayes，按 FinBayes 战略白皮书的定位口径重写描述（个人投资者金融认知层 AI Native 应用、核心用户 L1-L3、第一阶段市场 Crypto + US Stocks、三能力"懂金融 / 懂用户 / 懂判断"）。

  2. object-registry.md 新增 stage 枚举：「产品定义就绪 / 工程实施前置」——战略基线与产品定义稳定可被工程承接，但工程仓尚未进入 V1 实施。FinBayes 当前位于此阶段。

  3. projects/finbayes/：状态保留 draft（项目内部 frontmatter 由 FinBayes 项目 agent 维护），作为认知层唯一活跃项目目录。

  4. projects/finclaw/ 整体归档：git mv projects/finclaw _archive/projects/finclaw/2026-05-24-finbayes-rename，附 ARCHIVE-NOTE.md 说明历史关系。仅作历史追溯与 FinBayes 设计源流参考用，不再作为活跃事实源。6 个月后（约 2026-11-24）评估是否物理删除。

  5. 跨链接修复：

    • projects/README.md 项目表移除 FinClaw 行，加历史说明指向归档
    • docusaurus.config.js footer 链接 FinClaw → FinBayes，exclude 列表移除 finclaw run-logs 项（已归档不需要单独 exclude）
    • sidebars.js LABELS 删除 finclaw 条目
    • projects/finbayes/README.md 内部对 projects/finclaw/ 的链接改指 _archive/.../2026-05-24-finbayes-rename/

  6. commons/references/finclaw/ 命名保留：内容是第三方参考项目（含 martinpmm-Finclaw 等）的源码分析，与 FinClaw 项目无关；改名会破坏 git 追溯。后续在该目录 README 内补一段历史说明即可（不在本 ADR 范围）。

  7. for-agents/* 自动重生：跑 npm run derive 让派生包自动跟上新结构（manifest 移除 finclaw pack）。

结果​

  • 仓库内"认知层产品"口径统一为 FinBayes（唯一权威），无并存项目目录
  • 公开站点 https://labs-fintecai-gov.topquant.org/ 同步更新
  • FinBayes 进入"产品定义就绪 / 工程实施前置"阶段
  • 历史 FinClaw 内容可追溯但与活跃事实源解耦

备选方案​

A. 两者并存（FinClaw 与 FinBayes 都作为活跃项目，各自占独立生态位）。否决理由：FinBayes 明确声明不继承 FinClaw 文档链作为约束，两者实际是同一生态位（认知层）的迭代关系；并存只会让消费者无所适从，违背"知识治理库的核心职责是面向人/团队/Agent 的对齐"。

B. 暂缓 FinBayes（FinClaw 继续作为认知层主线）。否决理由：FinBayes 已完成基线改造设计、产出完整战略白皮书与产品定义；推翻本轮工作的成本远高于完成迁移。

关联​