Roadmap 已冻结并迁入 FinBayes Atlas
当前阶段、任务、负责人、依赖和状态统一在 FinBayes Atlas 维护;正在跳转。
FinBayes 改造任务主线(Roadmap)
这是团队成员与 Coding Agent 协作时唯一的任务状态来源。
- 人:在这里看主线全貌、看谁在做什么、依赖卡在哪;讨论/补意见/拍板去对应的 GitHub Issue / Discussion(每个任务一条),结论回填到这里。
- Agent:上工先读本表知全局与自己车道,收工把交付状态回写本表(随 PR)。
- 更新方式:状态随实现它的 PR 一起改。合入后才完成的任务写成“本 PR 合入即完成”的条件事实,不能让 PR 合入后仍显示“待 PR”,也不能把脏工作树或实验切片写成已交付。
- FinBayes 的整体目标架构、当前已知改造范围、条件项/未知项、阶段依赖与旧方案处置统一从
docs/design/finbayes-strong-agent-reference-map.html(FinBayes Atlas)进入;每条任务的具体设计理由/细节再下钻docs/design/与对应 Issue。本表只管状态、归属、依赖、门控,不重复设计正文。
分工(谁负责哪块代码)
| 归属 | 负责范围 | 代码目录 |
|---|---|---|
| 核心组 | FinBayes 内核 / 整体架构 / 数据层 / 多端支撑 / 对外服务模式 | finbayes/**、docs/**、对外契约 (docs/api/) |
| Web 组 (M.T) | 网页前端的迭代与优化 | web/** |
状态图例
- 未开始 — 尚未动工
- 进行中 — 有人正在做
- 待合入 — 实现与本地验收完成,已有明确 PR,合入后才成为主线事实
- 已完成 — 已落地 + 门禁绿 + 合入 main
- 阻塞 — 等某个决策或前置任务(见「依赖/门控」列)
任务接入约定
- 新增或实质改写任务时,直接写清要解决的问题与用户/系统结果、目标模块、文件所有权、真实依赖、明确非目标和适合该任务的验收方式。需要时链接 Atlas 中可读的阶段或架构域名称;内部坐标和历史波次不是必填项。
- 只有替换旧实现的任务才说明应迁移的消费者和应删除的旧调用路;这是该任务的正常实现范围,不另建退役台账。
- 内部重构验证稳定行为和接口;用户功能验证代表性使用场景;生产变更验证真实运行边界。不要让所有任务套同一张检查表。
- 生产故障、安全问题或用户阻塞可先处理,不能因 Atlas 定位延迟止血;后续工作再回到正确阶段与任务。不要另开任务台、审计台或对账表。
验证强度与全量测试触发
- 测试数量本身不是优化目标。当前 Python 全量约一分钟量级,优先减少重复运行和无效测试接缝,而不是为缩短数字删除行为覆盖。
- 文档/状态类:只跑相关渲染、语法、链接、派生物新鲜度检查;不要求本地全量 Python/Web,除非修改了可执行生成器、契约或测试发现配置。
- 局部 Module:聚焦测试 + 相关静态检查;修改跨包依赖时再跑 import contracts。
- 共享 Runtime / Provider / Config / Persistence / Session / API/schema/generated contract / 跨端行为:先聚焦测试,再在 PR 前只跑一次受影响技术栈的全量套件。
- 依赖、CI、安全或跨 Python/Web 的广泛变更:跑完整受影响栈、build 与安全门禁。
- 同一代码状态不重复跑全量测试;全量后只改 Roadmap/说明文字时,以相关文档检查 + 最终 CI 为准。测试不得访问生产网络;只有确认行为重复且失败信号不变时才合并或删除用例。
- 大切片收口:在自动化验收之外,还需 owner 授权的真机代表性验收(真 provider 端到端,按场景 3–6 回合)——依据是 #186 验收以真机跑出了 3 个自动化盲区缺陷的实证。
当前执行焦点
当前产品主线:S3 多端与能力平面收口已完成,S4 实施尚未启动。 S0–S3 与进入 S4 前的仓库瘦身均已完成。当前进行 S4「B/S 服务与商业化产品化」总体方案讨论:先收敛服务化底座、资源边界、durable run、部署运维与计量接缝,再据此形成阶段总目标、议题与候选任务;讨论和评审本身不构成实施授权,也不预先固定付费模式。
Atlas 执行快照
本节是 Atlas“当前进展”的唯一状态数据源;Atlas 只读投影,不手填第二份任务状态。任务状态变化时先改这里,再运行
python3 scripts/sync_atlas_execution_snapshot.py。
| 执行事实 | 当前状态 |
|---|---|
| 当前阶段 | S3 · 多端与能力平面收口已完成(S4 方案设计进行中,实施尚未启动) |
| 当前车道 | S4 总体方案讨论与评审:形成阶段总目标、核心契约、议题清单、候选任务与实施切片 |
| 当前产品任务 | 收敛 B/S 服务产品化底座:账户(映射现有 principal_id)/ Tenant / Membership、持久 Run、权威存储、身份接入、部署运维、真实用量与权益判定;付费模式与定价后置。 |
| 最近产品交付 | S0 主线收口、S1 Agent Runtime 窄腰、S2 生命周期/状态/统一协议,以及 S3 的多端 Adapter、Capability Catalog、Capability Settings、金融数据入口和第一方金融能力合同均已进入主线。 |
| 下一产品动作 | 完成 S4 总体方案讨论草案的 owner / 团队评审;在阶段目标、首个垂直交付切片与验收边界获批后,再把候选任务转成独立 Issue 并启动实施。 |
| Atlas 维护 | Atlas 是 Roadmap 的只读投影,不是产品任务、第二任务台或验收流水账。 |
| 阶段 / 任务 | 状态 | 已完成 | 未完成 / 下一步 |
|---|---|---|---|
| S0 · 主线收口与干净交付 | 已完成 | 唯一任务源、干净基线、旧迁移/对账主线收缩 | 无阶段遗留;历史说明不再参与当前调度 |
| S1 · Agent 内核与骨架 | 已完成 | 中性 AgentRuntime、Run Snapshot、统一模型—工具 Loop、Result/Finalization、同核 Subagent |
后续仅按真实缺陷深化,不重建固定金融流程或第二 Runtime |
| S2 · 后端、状态与统一协议 | 已完成 | Conversation/Turn/Run 生命周期、RunEvent/RunResult、Conversation/Working Context/Memory 分离、Surface Adapter 接缝 | B/S 的多租户、durable run 与服务端运维属于 S4,不倒灌 S2 |
| S3 · 多端 Adapter | 已完成 | CLI、Chat Channels、local Web/API 与后台触发复用同一 Runtime;各端只保留输入、流式与呈现差异 | 不要求各端 UI 同构;新增端必须通过同一 Runtime Interface |
| S3 · Tool / Skill Run 快照 | 已完成 | Tool schema/handler 与合格 Skill 在首次采样前共同冻结;skill_read 只读取当前 Run 已合格的冻结正文,不扩大文件权限 |
无本阶段遗留 |
| S3 · MCP / Cron 生命周期 | 已完成 | MCP 逐服务器启动和资源清理均有有限时限;Cron 已修复“刷新替换对象后在跑任务完成态丢失”的已知竞态,并保留外部已落盘的任务配置 | Cron 不是多进程事务存储;本阶段不为尚未承诺的多写者场景新增锁、台账或对账层 |
| S3 · Loop 与呈现边界 | 已完成 | Loop 只发结构化 Tool 事件;端侧 Adapter 决定文案;固定失败展开、固定审计/空模板、run_binding、伪后台参数及虚假 Web“任务进度”面已删除 |
有真实消费者的富呈现、判断和演化留到 S5 按金融场景决定,不成为每回合固定链 |
| S3 · 代表场景验收 | 已完成 | 89 项代表场景离线合同与全量回归通过;当前生产配置旗舰模型的深度研究、财报分析、组合分析三个真实用户回合均完成,并如实披露不可取得的数据与估算边界 | 不建立永久评分榜、验收台账、旧版本对比或每回合固定复核链;真实运行暴露的延迟和数据供给改进按独立问题处理 |
| S4 开工前工程准入 · 仓库瘦身与基线净化 | 已完成 | 已删除无引用历史产物、旧 Web/Python Workbench、非核心资产、零消费者依赖、旧 Evolution/CEE 工作台、退役治理材料、重复 Agent Skill、旧 Package-C 结果、固定阶段 Runbook、固定评测流水线、默认运行时不可达的 ai-exposure Skill,以及 27 项封闭的旧 worklist/ledger 实现与文档。Python wheel/sdist、隔离安装、CLI、Web 与 docs-site production build、主线全量 CI 和 76 项代表能力合同均通过;最后一项 Web 截图边界已收口(5 张旧验收截图物理删除、历史设计稿引用改写),瘦身后的统一终验(production build + Python/Web 回归 + 类型检查 + freshness + import contracts + 真实浏览器)全绿 |
无阶段遗留。Git 历史重写按计划 DEFERRED,待收益测量后单独决策,不默认 force-push |
| S4 · B/S 服务与商业化产品化 | 未开始(方案设计进行中) | 复用 S1–S3 的 Runtime 与协议边界;已议定商业模式中立、账户 / Tenant / Membership 边界、持久 Run 最小语义、完整 RunEvent 首版进入 PostgreSQL、local profile 保留文件 Adapter,以及邮箱验证码 / Google 登录与本地免登录 | 继续收敛 Web / API 资源合同、部署运维、真实用量与权益判定、安全与数据权利、首个垂直切片;对象存储的权威结果边界与保留策略仍需在既有方向上补充限定;付费模式与定价后置 |
| S5 · 条件性高级能力 | 未开始 | 富呈现、判断对象与可选 EvidenceArtifact 仍有真实消费者;旧 Evolution 子系统已经完整删除 | 未来能力改进系统必须由明确金融场景和产品价值重新设计;不恢复旧评分/回放/治理工作台,也不得成为每回合固定链 |
已完成切片与当前阶段
- S0 · 主线状态复位(已完成):PR #112 /
d5bd2c38已把已合入能力、未开始任务和条件能力分开,并修正 #106–#108 与 Atlas 事实;PR #114 /5bdd2cdb已收口与新产品定义冲突的运行默认;治理仓 PR #23 已发布新派生页,并完成 Railway origin 与自定义域读取确认。 - S1 已交付切片 · 最小 Run Snapshot(#107):PR #117 /
25f86ede已在首次采样前捕获调用方消息副本、当前 Run/Turn 请求身份与同一ToolSetSnapshot;内层 Loop 使用自己的可变消息列表,外部后续修改不影响本次运行。现有 Session/Context/附件行为保持不变,也未预建 Home Workspace、Conversation move、Cross-workspace Analysis 或新 Memory 产品。 - S1 已交付切片 · Result / Finalization(#108):PR #118 /
f89eaf80交付 surface-neutralCanonicalRawResult与基础 finalization seam;PR #119 /91aaeecd分离必要档案与失败隔离的可选消费者;PR #120 /0a8f1717让 Web 有限重试无事件的初始订阅竞态,并移除核心 Dashboard wait。已有事件后的致命断流仍如实失败。 - S2 · 后端、状态与统一协议(已完成):生命周期标识、RunEvent / RunResult、多端 Turn/Run 适配、Context / Memory 寿命分离、rich turn 重试确定性与基础层旁路清理均已交付。交互端不依赖 Loop 内部实现,Memory 不混同 Session,重复状态持久化旁路已移除。
- S3 多端与能力平面收口已完成:多端 Adapter、按需工具暴露、共享 Capability Inventory、Cron/MCP 生命周期、Tool/Skill 同一 Run 快照和 Loop/呈现边界清理均已交付;离线回归与三个真实旗舰模型代表回合已通过。S4 尚未启动,不把 S3 关闭自动解释为 B/S 产品化开工。
当前整改任务
| 任务 | 状态 | 归属 | 依赖 / 门控 |
|---|---|---|---|
| 形成并评审 S4「B/S 服务与商业化产品化」总体方案讨论草案 | 进行中 · 方案讨论与收敛 | Product / Architecture | 本任务只形成阶段总目标、概要架构、议题、模块、候选任务、参考对象与阶段验收,不授权实现。已议定:付费模式和定价后置,但真实用量与权益判定不后置;客户空间业务状态按 Tenant 强制隔离;产品层账户映射现有身份信封的 principal_id,不另造平行身份;浏览器断开不终止 Run,无法继续时如实标记 interrupted,显式重试创建新 Run;首版完整 RunEvent 进入 PostgreSQL;local profile 保留文件 Adapter、固定 local Tenant、不引入 SQLite;联网服务首版采用邮箱验证码与 Google 登录,本地版免登录。下一议题是 Web / API 资源合同与一次性切换;随后收敛部署运维、真实用量与权益、安全与数据权利及首个垂直切片。团队评审通过后,候选任务才分别建立 Issue 并进入实施。 |
| 修复 local Web 用户可见回退(贴底 / 可选解读 / 报告库) | 已完成 · 真实浏览器终验通过 | Web Surface / Workbench | 三项均已收口:报告库根因是删旧 schema 读路后旧库读不出,现以 library_legacy_schema 如实报错(owner 判定旧库无需救回);贴底状态机缺陷(解除钉住后 pinned 无路径置回)已修并在 hook 单测确定性复现(PR #262);解读本轮 390/768/1440 三档全部成功。2026-08-19 终验对着跑着的产品做:production build 由 gateway 伺服、真 provider、真行情、真报告库,6 轮真实回合,覆盖流式贴底 / 上滚释放 / 回底恢复 / pin-unpin / 新问题 / 解读成功 / 受控停止后重试成功 / 报告保存 / 服务重启后重开 / 刷新 / 断流续传 / 报告库 / 返回门面。报告见 docs/plan/web-regression-final-acceptance-2026-08-19.md。观察到一次、未能稳定复现的一项(390 对话内追问出示诚实失败卡而服务端日志有回答)按计划出口不进补丁,已如实记入报告。 |
| Web 客户端对齐整改后的服务端契约 | 进行中 · 接口文档已合并为一份,四项待 Web 组决策 | Web Surface | 接口文档见 docs/api/handbook/(生成页 docs/api/index.html、文档站 docs-site/;原 docs/api/web-integration-guide.md 已并入并删除)。待决策四项:①回答正文读不到时拆两句文案并在 404 分支隐藏重试;②刷新/断流后是否先查回合状态再决定是续流还是拉快照;③bad_request / content_invalid 是否单独出文案;④报告库列表是否先标出无回看内容的旧记录。贴底与解读两个回退不在此列——根因未知、未复现,不进补丁。 |
| 契约补齐稳定错误码,并建立服务端↔契约对账闸 | 已完成 | 核心组 / 对外契约 (docs/api/) |
docs/api/openapi.json 逐操作新增 x-error-codes:报告库读/写/内容回看与原始回答、解读两个 live 读面按状态列出可能返回的稳定错误码,只回描述性说明的状态如实标空(不编码)。新增 scripts/check_api_error_codes.py,从端点语法树与运行时状态表派生服务端能发的码集,与契约声明双向对账,已接进 CI 闸 4;覆盖边界(逐路由归属靠人写、注入式 resolver 只单向校验、传输层字面量不入闸)写在脚本开头。另修正 handbook/recipes.md 里已不存在的 evolution/artifacts/... 投影示例。 |
| 契约字段级真话校正,并把响应字段接进对账闸 | 已完成 | 核心组 / 对外契约 (docs/api/) |
逐 schema 追到服务端真正的构造点(端点处理器、live 读面、报告库/报告存储、行情服务、run/解读事件序列化器)对拍响应字段。删掉服务端从不发的 ErrorResponse.catalog_revision(它声称的触发码 catalog_changed 全仓不存在);补上解读事件流 404 真会回声的 case_id;report_id 说明删去已不存在的"旧库迁移受阻"分支;取投影读面的 projection 说明整段改写为服务端真正装配的形状(顶层字段 + 视图集合逐条列明、artifacts 恒空、已撤除的 widget_board 投影盘及其部件/行情序列描述删去)。同步修正 handbook/projections.md 的视图表(删掉全仓不存在的 audit_display / cognitive_sovereignty 与已撤除的 widget_board)。新增 scripts/check_api_response_fields.py 接进 CI 闸 4:键集静态可判的 8 条路由双向精确对拍,其余 16 条如实跳过并逐条列名,另加一道弱死字段筛;覆盖边界(只判顶层键、不判取值、变量载荷路由不在精确项内)写在脚本开头。遗留未修:web 客户端仍读 views.get("widget_board")(web/src/projectionModel.ts:621),服务端永不发该视图,整条 widgetBoard 供给链是死读——归 Web 组决定删除范围,不在本 PR 动。 |
| 重写对外 API 手册,补图与错误分支 | 已完成 | 核心组 / 对外契约 (docs/api/) |
owner 判定旧手册「看不懂、黑话与自创术语过多、缺图、不像合格 API 文档」。手册章节重排为 快速开始 / 核心概念 / 认证与会话 / 典型流程 / 错误处理 / 事件流 / 接口参考(生成) / 变更记录;删去产品定位与设计理念叙述,自创术语(投影、判断书、认知包、读面/写面、指针级、真话字段闸、治理闸、认知资产主权等)全部换成有字段可指的说法(结果快照、原始回答、解读、报告…),用词与 docs/api/web-integration-guide.md 一致。新增 5 张 SVG 图(handbook/diagrams/),markdown 里是普通图片、生成页构建期内联(零外链、离线可读),生成器拒收含外链或脚本的 SVG。撤掉手写权限总表(其 spec↔代码对账已由契约测试覆盖),改为错误码总表与 x-error-codes 双向对账,并由生成器渲染「码 → 声明它的操作」。遗留:openapi.json 里取投影读面的说明仍指向已撤销的章名《投影与判断卡》,改它要动契约(升修订号 + 重新生成 web/src/generated/api.d.ts),本 PR 不动。 |
| 对外接口文档合一并清除自创术语 | 已完成 | 核心组 / 对外契约 (docs/api/) |
owner 四条要求:只留一份文档、人和 Agent 读都不歧义、不用自创术语、按其它强 AI Agent 的 API 实践对齐。落地:①删除 docs/api/web-integration-guide.md,其独有内容(行情三态、监测 execution_status、开发期 /workbench/model)并入新增的 handbook/endpoints.md,对外只剩 handbook/ 一份源、两种呈现(单文件生成页 + 文档站)。②术语归零不止手册:openapi.json 里 110 处说明文字(路由摘要/描述、字段说明、响应说明)与全部 31 条变更记录重写为普通说法——参考区此前仍整篇是内部方言,是「看不懂」的主因;分组标签重命名(投影与清单→结果读取、任务与通知→通知、能力设置→能力清单),api.d.ts 重新生成后零类型变化,只有注释变。③新增 handbook/chapters.json 作章节清单单一来源(此前生成器、docs-site/scripts/sync.mjs、sidebars.ts 各存一份),侧栏漂移由 sync --check 钉住。④修掉三处生成缺陷:参考分组曾按路径前缀归组、未命中的落进「其它」兜底(行情/报告库/能力清单一直在里面);说明文字整段 escape,规范里写的 **加粗** 原样带星号显示、段落被压成一行;变更记录 0.17.3 被插到数组头,页面上显示成最旧一条。规范升 0.18.0,接口行为不变。 |
| 接口文档补图、补范例、矫正分组,并盘出接口层缺口 | 已完成 | 核心组 / 对外契约 (docs/api/) |
owner 三条:可视化偏少、分类不够正确且 API 不够全(点名会话管理/Memory/上下文/文件/设置/自选股)、缺一键可复制的调用范例。落地:①图从 5 张加到 9 张,新增「调用方与能力边界」「编号之间的关系」「会话生命周期」「错误分支决策」;②新增 handbook/examples.md,同一件事三份完整可跑程序(命令行 curl+jq / 浏览器 TypeScript / Python 标准库,含保存报告与追问);③分组矫正:对话从「结果读取」独立成组(它不是某次提问的结果),偏好与能力清单合成「设置」,规范升 0.19.0。关于「API 不够全」的核查结论:自选股、组合、长期记忆、文件读写在仓库里是 finbayes/agent/tools/ 下的 Agent 工具(watchlist.py / portfolio.py / memory_query.py / filesystem.py,落在工作区 markdown),不是没做,是没有 HTTP 面——命令行与聊天渠道也走进程内总线用同一批工具。这条边界此前文档里一个字没写,现已写进「哪些能力在接口上,哪些不在」并配图。 |
| 补版本自证与开发端点留痕(三阶段收尾) | 已完成 | 核心组 / Workbench + Web Surface | GET /health 增加 api_version(端点实现的契约版本,契约测试钉住它 == 规范 info.version);web 的 dev 启动器此前只探「端口有没有人听」就 attach,现在还要问一次 /health 的版本,对不上(含旧后端根本不回这个键)就不接、改为当场拉起临时内核并说清原因——2026-08-17/18 那批「Web 端功能一起坏」最像的总因就是一个整改前起的常驻 gateway 静默接管了新前端,两边都发现不了。同批把 trace 记录器挂到开发端点当场拉起的内核上:此前 trace 只在 finbayes gateway 里挂,而用户碰到「解读持续失败」走的正是这个临时内核,失败现场一点没留下,查不下去。同批修掉 WP-A 读码确认的贴底缺陷:useStickToBottom 在钉住时把 pinned 置假、却没有任何路径把它置回,解除钉住后贴底永久失效;现在按解除那一刻的真实视口位置重算(与 handleScroll 同一判据),两条回归测试分别钉「人在底部→恢复跟随」与「人在上面读历史→不跟随」,前者在修复前确实红。规范升 0.20.0。 |
| Web 端失败文案与等待措辞整改 | 已完成 | Web Surface | owner 在 S3 收尾后的真实使用中撞到:本地服务没在跑时,界面报的是「分析失败 / 本次未能生成可靠结论」——分析质量的说法,真实原因是后端不可达,于是对着一个没在跑的服务反复点重跑,每点一次还追加一条一模一样的文案。PR #264 按原因码分流:失败卡标题改「服务未连接」、正文与回复直说先跑 finbayes gateway;重跑去重改为跨用户气泡回溯(重跑会先补一条用户气泡,只看末尾根本不触发去重——实测连点三次仍多出三条),解释性文字由 4 条降到 1 条而每次尝试的失败卡照常在。同批修两处不诚实措辞:续接声明的「暂不可见」改为「服务端记得这段对话,页面不恢复此前 N 轮的内容」;回答已闭环、只剩解读在整理时不再写「分析进行中」,改为「回答已完成 · 正在整理成结论与图表」并告知右侧回答已可读。窄屏(≤640px)续接声明改为参与布局,此前绝对定位在 390 下会盖住「来源问题」那行。新增 8 条回归(4 条已验证修复前为红);未改报告库标题链接——查证那是有注释的刻意设计、真链接且键盘可达,无缺陷证据。 |
| 终验覆盖补齐 + 续接声明遮挡按类修 | 已完成 | Web Surface | 首轮终验全套只在 1440 跑过,本轮把贴底族(流式贴底 / 主动上滚释放 / 回到底部恢复)与受控停止后重试补到 768 与 390,并按 owner 要求改用过去 TG 频道内测里真实用户问过的三条提问(BTC 日线结构与 CHoCH 传导、USDCNY 三个月内破 7 的概率、上周 BTC/ETH ETF 流入流出),不用编造问句。同轮修正一个判据错误:上滚释放此前用「scrollTop 一动不动」判,在 768 上判成失败;内容在视口上方增长时浏览器滚动锚定会同步 scrollTop,那是对的行为,正确判据是距底距离不塌成 0。查出并修掉:续接声明与「来源问题」行几何重叠在 768 上同样成立,而上一轮只按 ≤640px 修了 390 —— 只修了看到的那一个、没修这一类;现改为始终参与布局、不依赖断点,遮挡在结构上不可能发生,并加一条结构性守卫测试。pin/unpin 三档结论如实记入验收报告:1440 通过,768 机制启用但本轮答案未产出可对上的锚(未被证伪),390 按细指针闸设计不适用。 |
| 团队成员复测三项报错的分诊与修复 | 已完成(PR #268) | Web Surface | 成员拉最新代码复测报三项:左盘「解读未生成」必现、右盘「服务未连接」偶现、报告库接口 500。分诊结论:①报告库 500 是设计内的诚实报错(library_legacy_schema:该机器上的库是 8/15 之前的旧版本),解法是把 ~/.finbayes/workspace/report_library.json 移走或删掉;但控制台在这个永久错误上还给了「重试」按钮 —— 按我们自己的错误表这是永久失败,点多少次都一样,已改为永久码不给重试、只留可执行的提示。②「服务未连接」是我在 #264 引入的回归:驱动层那个宽 catch 被挂上了很具体的标签,服务端答了但这一步被拒/出错(有 HTTP 状态码)也会被说成连不上,而重启服务解决不了 —— 新增 LiveTransportRejection(带状态码)与 channel_rejected 码,两类失败各说各的。③「解读未生成」的原因只在服务端日志里:三个失败码(invalid_output / interpret_error / aborted)此前共用一句通用文案,必现失败因此无从下手;现按码分流成三句(仍不渲染裸 wire 串)。新增 5 条回归。该成员那台机器的解读为何必现失败仍需其日志确认,未猜修。 |
| 按根因整改:客户端失败不再被就地吞掉 | 已完成(PR #269) | Web Surface / 对外契约 | 上一轮按症状修了三处文案,这一轮修病根。病根不是某句话说错,而是失败在各个边界被就地吞掉:web/src 里十几处 catch {} 各自决定咽下去,于是任何一次报错到用户嘴里都只剩「报错了」,原因既问不出也交不出来。新增唯一留痕口 foundation/lib/diagnostics.ts(有界环形缓冲 + 控制台一行 + __finbayes.diagnostics() 一句可复制,凭证从不进缓冲),并把四处真正丢诊断的 catch 接上:回合提交、投影落 chrome、投影重取、原始回答读取。由此顺带修掉一处一直没解的用户可见缺陷:原始回答的永久 404(回合已不在这个进程里)与暂时失败此前挤在同一个 failed 态,界面对一条永远读不到的正文照样给「重新读取」——现在按 404 判永久,收起重试入口并说清「重新提问可得新的一份,已保存报告不受影响」。手册补一节把这条纪律写给外部调用方(status 是不是 null 本身就在回答「是不是连不上」)。成员那台机器的解读必现失败:用其原话「目前BTC的市场情况如何?」在本机复跑未复现(9 件、结论正常),排除问题形状因素,指向其环境/模型差异 —— 仍需其日志确认,未猜修。 新增 6 条回归。 |
| 断流不再冒充「解读被中止」 | 已完成(PR #270) | Web Surface | 同一根因的第三处:实时流接不上(404 已逐出 / 4xx / 网络断)时,客户端伪造一条 code="aborted" 的服务端事件塞进 reducer。此前三个码共用一句通用文案,这句假话看不出来;#268 给每个码配了各自的说法之后,它变成了言之凿凿的「解读被中止」—— 而根本没人中止过。改法:reducer 增一栏 failureOrigin(server / transport),客户端失败直接推状态而不伪造 wire 事件,契约里那三个码保持只属于服务端;界面对 transport 来源说「接不上解读的实时流……解读本身没有失败」。这一条正好覆盖成员那台机器最可能的表现:若其解读流 404,旧版本会告诉他「被中止」,他会去找一个不存在的中止动作。新增 3 条回归。 |
| 单次输出上限的继承默认值修正 | 已完成(PR #271) | Agent Runtime / Config | 成员用 DeepSeek V4 Pro 复测,解读必现「解读未生成」,其反馈指向模型推理链占满原 max_tokens=8192 后正文截断。默认值已提至 32768;正常调用仍按实际用量计费,整场 50 万 token 累计硬顶与配置覆盖继续有效。边界补充:更高上限和截断后的第二次调用会增加最坏情况下的 token、延迟与费用,hosted profile 不得只依赖本地 RunBudget,必须纳入 Tenant 用量事实、并发和资源策略。截断识别与诚实错误已由 PR #278 补齐。 |
| Kimi Code 订阅适配器 | 已完成(PR #272) | Provider Runtime | owner 的 Kimi K3 付费订阅走本机 Kimi CLI 托管 OAuth。新增 KimiCodeProvider:OpenAI 兼容直调订阅端点,支持工具调用、流式和推理档;凭证由 Kimi CLI 管理,适配器只读令牌文件并让 CLI 自行刷新,令牌进入脱敏层而不进配置。离线合同测试与 owner 机器真实订阅冒烟均通过。边界补充:这是 local / on-prem 的个人订阅接入,不自动进入多租户 hosted Provider 池;hosted 凭证所有权、租户隔离和供应商合同需另行设计。 |
| Provider 接入中心(本地版) | 未开始 | Provider Runtime / CLI | owner 方向已认可:订阅模式与 API key 模式并列为一等接入类别。现状盘点:registry 19 家 + 钥匙串引用 + 弹性故障转移已在,缺的是把「订阅(cli_subscription)」抽成显式类别的配置面,以及一条 finbayes providers 体检/配置命令(凭证有效性免费探测、通道存活一览——2026-08-20 排障时手搓过一次,应产品化)。多租户 Provider 配置中心归 S4(草案 §6 已预留 Tenant 级 Provider 选择)。 |
| 报告导出长图(#273) | 已完成(PR #274) | Web Surface | owner 真实使用中产生:结构化报告值得分享,一键导出长图。设计已定:不截实况界面,同一份报告数据渲染导出专用海报排版(定宽 800,头=品牌+来源问题+完成时刻,尾=免责+署名,动画静止化终态入图);浏览器本地 2x 成图零服务端;文件名日期取服务端完成时刻,展示层不造时间;live 盘与回看页各一入口(回看页按 #102 归页面级外围)。真机验收:真实报告导出 1600×4052 PNG,全部 widget 与 K 线入图。过程中发现并修掉隐藏标签页 rAF 挂起缺陷;成图库解码在隐藏页顺延到可见再完成为已知边界。云端分享链接/公开页归 S4。 |
| 进程内分析历史入口(原“对话即历史索引”)(#275) | 已完成(PR #276) | Web Surface / 对外契约 | owner 真实使用中产生:此前只能看到最后一轮报告,当前进程内已完成的多轮报告缺少入口。落地:案指针清单行补 question 与回合身份字段,新增按案回看路由、对话气泡“查看报告”和报告库“分析历史”区。边界钉死:这不是完整 Conversation / Turn 历史;当前只保留本进程有界 live case,服务重启即清空,只有带富投影的 case 进入列表,同一 case 重试以最新 turn 为准。跨重启、全回合持久历史属于 S4。真机满链路验收通过。 |
| 路由回访恢复会话形态 | 已完成(PR #277) | Web Surface | #276 上线后 owner 即时反馈:从报告库返回落回重置后的主界面而非会话现场。根因:会话数据在全局 store 里活着,但页面形态闩是本地 state,路由重挂载即回 rest。修法:形态闩初始值从 store 派生,有会话内容直接以会话形态挂载;空 store 照常英雄屏,Esc 重置流不受影响。真机验证通过,2 条回归。 |
| 版本漂移根治:生产面版本自证闸 + 截断识别自愈 | 已完成(PR #278) | Web Surface / Judgment / 对外契约 | 成员机排障复盘出两个结构性根因。①web/dist 不进 git,成员只拉后端时前端产物可能静默滞后;现由构建版本戳、页面与 /health 比对、gateway 启动警告三处自证。②解释器此前不识别 finish_reason=length,截断被误报为结构错误;现识别截断并至多放宽额度重试一次,仍不足则以 output_truncated 诚实失败。契约升至 0.22.0,自动化与真机错配验收通过。边界补充:第二次模型调用是真实资源消耗,S4 hosted 必须把它计入 Tenant 用量、并发与资源策略。 |
| S4 Claude→Codex 接管收口 | 进行中 · 文档对齐分支已建立 | Product / Architecture / Knowledge Governance | 已核对 Claude 期间 PR #270–#279、主线 23805f35、阶段四草案与公网投影;确认 S4 实施仍未启动。收口范围:统一草案 / Roadmap / Atlas 状态,明确账户映射现有 principal_id,限定存储保留与对象存储边界,区分进程内历史与持久历史,并把 Kimi 订阅适配器限定为 local / on-prem。完成知识治理评审并合入后再标记完成。 |
| 无盘完赛:投影缺席不再冒充「服务未连接」 | 已完成(PR #279) | Web Surface | 成员必现 bug 的最终根修:「本周有哪些宏观经济数据/事件公布?」回答完整输出后仍报「服务未连接」。本机最新版确定性复现,客户端留痕口直指真因——终局带案指针被当成必有仪表盘投影,宏观日历类回合本就无投影,诚实 404 被抛成整回合失败又误标成「服务未连接」。修法:回答是回合的权威结果——通道层投影回取失败一律降级留痕,驱动层新增无盘完赛分支(封答案+登记原文入口+左盘不画+不报失败)。真机同问题复跑验证:404 照发、回合正常闭环。 |
| 接口层四个缺口(owner 决策) | 待决策 | 核心组 / 对外契约 + Web Surface | 本轮对齐 review 查出、未在文档里粉饰的四项:①GET /workbench/conversations 是死路——只回编号与时间戳,没有配套的「读某个对话下的回合」接口,CaseListItem 也不带 conversation_id,客户端拿到列表点不开;②四条已发布接口 web 端零调用:/workbench/conversations、/workbench/preferences、/workbench/capabilities、/workbench/cases(列表)——要么 Web 接上,要么承认是投机面;③会话没有登出/撤销,也没有「还能用多久」的读法,客户端只能等 401;④/workbench/model 仍在契约外且不要会话(见 #260)。另有 PR #260 评论里的三条对标缺口(错误码两义、SSE 靠键缺席判别、无请求追踪 id)同属待决策。 |
| 进入 B/S 产品化前完成仓库瘦身与基线净化 | 已完成 · 工程准入标记完成 | Repository / Engineering | 最后一项(Web 截图边界)已收口:handoff-anchors/artifacts/ 下 5 张 2026-06 旧验收截图物理删除,两份历史设计稿里的引用改写为指向当日重跑的验收报告,不建新截图档案、不留兼容层。同批完成瘦身后的统一终验:Web production build、Python/Web 回归、类型检查、API/Atlas freshness、import contracts 全绿,并对着跑着的产品做完真实浏览器终验。门槛 7 复查:未恢复默认富归档、固定 Judgment/CRP 链、旧 Evolution、版本兼容壳、迁移台账或审计/对账面(仓库内 富归档 字样只余说明「已删除」的注释,CompletedTurnArchive / RichArchive / 迁移台账 零命中)。Git 历史重写仍按计划 DEFERRED,不默认 force-push。 |
| 稳定 Run Profile 与唯一 Run 能力解析 Module | 已完成 | Agent Runtime / Financial Capability | 已交付 Run 能力绑定、父子能力收窄、MCP 状态和运行档合同;S3 在此基础上补齐 Tool/Skill 同一 Run 快照。 |
| 装配并验证默认第一方金融能力包 | S3 范围已完成 | Agent Runtime / Financial Capability | Cron、MCP、Skill 冻结读取、Tool 事件与 Surface 边界已通过独立复核;虚假任务面和固定审计/空模板已物理删除。深度研究、财报分析与组合分析三个真实旗舰模型用户回合均完成,失败数据源和估算边界在答案中如实披露。 |
| 重新设计条件监测与主动提醒 | 未开始 | Background Runs / Financial Continuity | 必须由用户显式启用;不得恢复默认 heartbeat、判断台账、固定复盘或自动演化链。 |
| 专家团 Profile | 未开始 | Agent Runtime / Financial Capability | 仅在明确产品场景与合同后实现;复用同核 child Agent,不另建第二 Loop。 |
| 树级 token 调用粒度残差 | 未开始 | Agent Runtime | 当前仅在工具调用结束后结算;需要真实超额案例后再决定是否增加更细的预留,不作为 S3 关闭前置。 |
| Run 事件 sink 的多运行顺序合同 | 未开始 | Agent Runtime / Protocol | 只有消费者要求根/子 Run 全局严格排序时才实施;当前各 Run 内顺序已成立。 |
| 机器触发主体权限收窄 | 未开始 | Security / Background Runs | 当前受信 system 主体可运行;最小权限必须由真实部署角色和动作需求驱动,不预设复杂策略。 |
| CLI 凭证发现与 provider 取值路径统一 | 未开始 | Provider Runtime | CODEX_HOME 与实际 OAuth token 读取路径尚未统一;独立于 S3 能力平面验收。 |
已完成任务的逐轮缺陷、调用次数、旧方案改口和验收过程只保留在既有 Issue、PR 与 Git 历史中,不再复制到 Roadmap。Roadmap 只回答当前阶段、当前任务、依赖与状态。
Atlas 维护(不属于 FinBayes 产品整改)
| 维护项 | 状态 | 说明 |
|---|---|---|
| 修正 Atlas 当前阶段并建立首批 S2 任务切片(Issue #130) | 已完成(PR #135 / 602b8814) |
已将主线从错误的 S3 表述纠正为 S2,并建立“生命周期标识”“RunEvent / Result 合同”“多端协议适配”“Context / Memory 寿命分离”四项任务的阶段、依赖、状态与验收映射;未改变 FinBayes Runtime 或产品阶段完成度。 |
| #127 Atlas 显示当前阶段、任务状态与 Issue/PR 交付关系 | 已完成(PR #128 / 64ef3604) |
已修正 Atlas #01/#02 的信息架构与 Roadmap 只读投影;未改变 FinBayes 产品、Runtime、能力或阶段完成度。PR #126 是此前状态文档收口,也不计作 #124 的产品实现交付。 |
遗留未完成项的当前处置
下表是对历史工作线中仍带“未开始 / 进行中 / 阻塞 / 待裁”语义条目的唯一当前处置。它不是第二任务表:继续执行的工作必须进入上方「当前整改任务」并链接 Issue;标为条件、合并、暂停或待状态确认的条目不得仅凭历史描述直接开工。
| 遗留项 | 当前处置 | 所属阶段 / 模块 | 优先级与真实依赖 |
|---|---|---|---|
| #61 接管恢复基线 | 已由 #94 收口 | 主线收口 / 历史与结果 | 不再单独实施;未迁移旧 52 回合 |
| 记忆后台整理按用户分开 | 条件保留 | B/S 与高级持续能力 / Memory | 多用户产品边界与状态接口成立、且用户明确启用后再启动 |
| Run / 实时流状态外置 | 条件保留 | B/S / Run 与事件 | 仅 B/S 横向扩展需要;先完成跨端协议与运行所有权 |
| 计量层(credit + 判断×深度) | 暂停并重定义 | B/S / 商业化 | “判断×深度”不再是产品本体;先有商业模式与计量对象决策 |
| 一套代码分档 | 条件保留 | B/S / 配置与部署 | B/S / 私有部署边界明确后,以配置和 Adapter 实现 |
| 统一数据模型与存储接口 | 历史范围已完成 | 后端 / Conversation、Run、Memory | 当前各 JSONL 日志已复用 persistence/jsonl_log.py 的版本头与分档读取;更广的 Conversation / Run / Memory / storage-neutral 接口另按新目标推进,不续开旧总项 |
| 社媒情绪数据源 + 情绪表盘 | 合并为外部能力接入 | Web 与金融数据 | 等 Data Horizon 端点契约;FinBayes 不造假值或内化上游采集 |
| 费率 / 持仓量改为 Data Horizon 优先 | 外部阻塞 | 金融数据 | DH 生产部署后做 FinBayes smoke,再切优先源 |
| 内容决定展示形态选择器 | 重定义后再做 | Web 呈现 | 只能是呈现 Adapter 的场景选择,不得成为 Agent 固定认知阶段 |
| 输入框回车发送 | 保留为独立交互优化 | CLI / Web 交互 | 无共享内核依赖;进入实施时新建小 Issue,可与不重叠工作并行 |
| 盘面完成时间显示为“—” | 先诊断 | Web / 事件与呈现 | 先确认服务端事件是否缺字段,再决定后端或前端修复 |
| 仪表盘流式管线 | 历史主链已完成 | 协议与 Web | 后端事件缓冲、SSE、前端 reducer / hook 与终局降级链均在;呈现反向耦合已由 #108 / PR #120 收口,不延续旧总计划 |
| 分析完成后的整理等待 | 已由 #108 完成 | Agent Loop / Web | PR #120 已迁移 Web 初始订阅竞态并移除核心回答等待 |
| 内容帧入端校验 | 保留为安全加固 | 跨端协议 | 稳定事件协议后实施;它是传输边界,不是 Agent 骨架或每轮审计 |
| Chart K 线端点与周期切换 | 等待相关环境验收 | Web 与金融数据 | 代码已完成;仅阻塞该能力,不阻塞共享内核和协议 |
| 真实问答评测与改进提案 | 旧机制已删除,未来条件性重设计 | 条件性高级能力 | 不继续维护旧评分、回放、治理、提案与复验工作台;只有明确用户价值与真实消费信号后才在 S5 新建最小方案 |
| 判断校准数据积累 | 条件保留 | 高级能力 / 用户启用的连续性 | 只有用户明确保存并跟踪判断、且有真实结果消费者时才启动;不作为当前主线前置 |
历史说明
A–F 旧工作线、旧提案与旧拍板过程已从当前操作面移除,继续由 Git 历史及对应 Issue 保存。仍有效但尚未完成的工作已在上方“遗留未完成项的当前处置”中归类;要重新启动时必须进入“当前整改任务”并链接 Issue,不能从历史描述直接开工。
访问与更新(本表怎么部署给团队)
- 公网执行视图:
https://labs.curvaturex.io/projects/finbayes/roadmap/。 它只能是本表的派生 Adapter,不得手工维护另一份 LANES / DECISIONS / ARCH 数据。 当前公网视图已由scripts/render_roadmap_page.py从本表生成,并于 2026-08-14 完成治理合入和公网新鲜读取;它仍是本表的只读投影,不得手工维护任务数据。 - 生成方式:
uv run --no-sync --with markdown python scripts/render_roadmap_page.py docs/plan/roadmap.md <输出.html> [commit_sha]。 当前仓库没有自动跨仓发布工作流;生成、发布和部署是三个不同结果,未另立任务完成管线前不得声称自动同步。 - 仓库原文:有仓库读权限的成员也可直接看
https://github.com/Curvature-Lab/FinBayes/blob/main/docs/plan/roadmap.md(GitHub 原生渲染)。 - 更新走 PR:完成一件任务,在实现它的同一个 PR 里把状态改「已完成」;新需求/bug 加一行即可。真源只有这一份,别另开平行表。
- 讨论走 Issue:每条任务/决策一条 GitHub Issue(标题带任务名),结论回填本表;本表只放状态与结论,不放讨论过程。
- 后续若要看板视图,可开 GitHub Projects 把 Issue 拖进列——那是本表的视图,不是第二个真源(有人愿意维护再开)。
关联
- 整体产品、目标架构、当前已知改造范围、条件项/未知项、阶段依赖与强 Agent 参考:
docs/design/finbayes-strong-agent-reference-map.html(FinBayes Atlas)。 - 任务设计理由与实施细节只下钻任务相关的
docs/design/或 ADR;旧工作分解和公网架构页均是历史输入,不与 Atlas 并列。 - 边界归属机器化:
.github/CODEOWNERS。 - 门禁(合入前四闸):
.github/workflows/ci.yml。 - 本地开发与产品运行方式:
web/README.md(gateway 伺服门面 +npm run dev单轨)。