Roadmap 已冻结并迁入 FinBayes Atlas
当前阶段、任务、负责人、依赖和状态统一在 FinBayes Atlas 维护;正在跳转。

FinBayes 改造任务主线(Roadmap)

这是团队成员与 Coding Agent 协作时唯一的任务状态来源。

分工(谁负责哪块代码)

归属 负责范围 代码目录
核心组 FinBayes 内核 / 整体架构 / 数据层 / 多端支撑 / 对外服务模式 finbayes/**、docs/**、对外契约 (docs/api/)
Web 组 (M.T) 网页前端的迭代与优化 web/**

状态图例

任务接入约定

验证强度与全量测试触发

当前执行焦点

当前产品主线: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 子系统已经完整删除 未来能力改进系统必须由明确金融场景和产品价值重新设计;不恢复旧评分/回放/治理工作台,也不得成为每回合固定链

已完成切片与当前阶段

  1. S0 · 主线状态复位(已完成):PR #112 / d5bd2c38 已把已合入能力、未开始任务和条件能力分开,并修正 #106–#108 与 Atlas 事实;PR #114 / 5bdd2cdb 已收口与新产品定义冲突的运行默认;治理仓 PR #23 已发布新派生页,并完成 Railway origin 与自定义域读取确认。
  2. S1 已交付切片 · 最小 Run Snapshot(#107):PR #117 / 25f86ede 已在首次采样前捕获调用方消息副本、当前 Run/Turn 请求身份与同一 ToolSetSnapshot;内层 Loop 使用自己的可变消息列表,外部后续修改不影响本次运行。现有 Session/Context/附件行为保持不变,也未预建 Home Workspace、Conversation move、Cross-workspace Analysis 或新 Memory 产品。
  3. S1 已交付切片 · Result / Finalization(#108):PR #118 / f89eaf80 交付 surface-neutral CanonicalRawResult 与基础 finalization seam;PR #119 / 91aaeecd 分离必要档案与失败隔离的可选消费者;PR #120 / 0a8f1717 让 Web 有限重试无事件的初始订阅竞态,并移除核心 Dashboard wait。已有事件后的致命断流仍如实失败。
  4. S2 · 后端、状态与统一协议(已完成):生命周期标识、RunEvent / RunResult、多端 Turn/Run 适配、Context / Memory 寿命分离、rich turn 重试确定性与基础层旁路清理均已交付。交互端不依赖 Loop 内部实现,Memory 不混同 Session,重复状态持久化旁路已移除。
  5. 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,不能从历史描述直接开工。


访问与更新(本表怎么部署给团队)

关联

渲染于 2026-08-20 09:13(UTC) · 主仓提交 284260cb
真源:主仓库 docs/plan/roadmap.md —— 本页只是生成的只读 Adapter;生成不等于发布或部署。