ai-exchange/docs/AI_ICT_分析助手主线增强开发计划_2026-05-14_v1.md

AI_ICT 分析助手主线增强开发计划 2026-05-14 v1

1. 目标

本计划只围绕当前“分析助手”主线推进，不展开真实交易、OKX live submit、默认自动下单、live adapter 开闸。

本轮增强的目标是把当前已经可用的 Decision Assistant，从“有基础闭环的工作台”进一步推进为：

• 可配置
• 可检索
• 可对比
• 可聚焦
• 可连续日常使用

重点只覆盖以下 5 个方向：

1. 独立偏好设置面
2. archive 深度检索与任意对比
3. candidate-scoped 连续工作区重算
4. 外部上下文 provider 与视觉化增强
5. workflow archive 运营化能力

2. 边界

本计划明确不做：

• 真实交易执行
• OKX live submit
• 默认自动下单
• risk governor / trust bucket / operator confirmation protocol 逻辑变更
• execution_allowed / real_live_ready 开闸

本计划只做：

• 分析助手体验增强
• 只读数据组织增强
• 历史检索与比较增强
• 工作台聚焦与连贯性增强

3. 当前基线

当前代码已具备的基础：

• digest preferences 持久化
• digest history archive / workflow history archive
• latest-two compare 基础能力
• focus candidate 持久化基础版
• continuous workspace / loop queue / watchlist / replay / notes 入口
• 外部上下文基础卡片
• external chart read-only provider 基础版

因此本轮开发不是从零搭建，而是做“产品层增强”。

4. 总体推进顺序

建议按以下顺序推进：

Phase A

• 独立偏好设置面

Phase B

• archive 深度检索与任意对比

Phase C

• candidate-scoped 连续工作区重算

Phase D

• 外部上下文 provider 与视觉化增强

Phase E

• workflow archive 运营化能力

原因：

• A 和 B 能最快提升日常可用性
• C 能把现有 cockpit 从“看板”推进成“工作区”
• D 和 E 更偏增强深度，适合在前 3 项稳定后推进

5. Phase A: 独立偏好设置面

5.1 目标状态

从当前“通过内联按钮和 action bar 保存偏好”，升级到独立的 Preferences 工作区。

用户应能：

• 查看当前 profile
• 新建 / 复制 / 重命名 / 删除 profile
• 调整 digest mode
• 调整 preferred history kind
• 调整 global importance threshold
• 单独编辑 importance template threshold
• 配置 history window
• 明确保存 / 重置 / 撤销

5.2 交付范围

后端：

• profile 管理 API
• profile 新建 / 复制 / 删除
• payload schema 稳定化
• profile label 唯一性与回退规则

前端：

• 新增独立 Preferences section
• profile selector
• profile actions
• threshold editor
• save / reset / duplicate / delete controls
• dirty state 提示

数据层：

• 继续复用 decision_assistant_preferences
• 增补 payload 规范：
  • profile_label
  • history_window_hours
  • importance_templates
  • focus_candidate_id
  • 后续可拓展字段占位

5.3 建议切片

A1 profile list + selector

• GET /trading/alerts/digest-preferences/profiles
• 前端独立展示当前 profile
• UI 不再只靠 action bar

A2 profile create / duplicate / rename / delete

• 后端加管理 route
• 前端支持 profile 级管理动作

A3 threshold editor

• global threshold
• template threshold
• reset to default

A4 dirty state + explicit save/revert

• 未保存提示
• 手动保存
• 取消修改

5.4 验收标准

• 不进入 digest 主卡片，也能完整管理偏好
• 新 profile 能创建并立即生效
• 修改 template threshold 后刷新仍保留
• 删除 profile 不影响默认 local_operator

5.5 focused validation

• repository / API unit tests
• test_api_server
• test_operator_workspace_service
• test_api_static_server
• node --check src/web/app.js

6. Phase B: archive 深度检索与任意对比

6.1 目标状态

从当前“latest-two compare + 基础 limit/offset”，升级到真正可用的 archive 工作流。

用户应能：

• 按 profile 检索
• 按日期范围检索
• 按 digest mode / history kind / workflow phase 检索
• 从列表中任意选择两条 snapshot 做 compare
• 查看 compare 差异摘要

6.2 交付范围

后端：

• digest archive query 扩展
• workflow archive query 扩展
• compare route 支持任意 snapshot id 对
• 支持时间过滤与 profile 过滤

前端：

• archive filter toolbar
• archive result list
• dual-selection compare UI
• clear filter / clear compare
• compare summary card

6.3 建议切片

B1 query 扩展

• created_after / created_before
• profile_key
• workflow phase / artifact kind

B2 archive result browser

• 筛选器
• 分页或“加载更多”
• 当前检索上下文可见

B3 arbitrary compare

• 勾选两条 snapshot
• compare route 取差异
• compare summary / changed fields / count delta

B4 compare drill-down

• digest：title/body/reminder delta
• workflow：phase brief/body delta

6.4 验收标准

• 可以不依赖“最新两条”，手动选任意两条 archive compare
• 日期过滤可稳定返回结果
• digest 和 workflow 两条线都能检索和对比

6.5 focused validation

• repository query tests
• archive compare tests
• API route tests
• dashboard JS syntax

7. Phase C: candidate-scoped 连续工作区重算

7.1 目标状态

从当前“focus persistence + 局部联动”，升级到真正围绕一个 candidate 重算工作区。

当用户选中一个 focus candidate 后：

• Evidence 只展示该 candidate 相关证据链
• Digest 只展示与该 candidate 强相关提醒
• Replay 优先展示该 candidate 对应 setup/session 学习面
• Notes 默认带入该 candidate 的结构化上下文

7.2 交付范围

后端：

• candidate-scoped evidence builder
• candidate-scoped digest reminder builder
• candidate-scoped replay learning rollup
• focus-aware review entry defaults

前端：

• focus candidate 明确可见
• clear focus / switch focus
• 焦点切换后 section 结果一致刷新

7.3 建议切片

C1 focus-aware evidence chain

• evidence 过滤与重算
• evidence source path 继续保持可解释

C2 focus-aware digest

• reminders 以当前 focus candidate 为第一优先级
• 当前 focus 不相关提醒降级

C3 focus-aware replay

• setup / session / market state 统计优先围绕当前 focus

C4 focus-aware notes

• 新 note 默认带入：
  • candidate_id
  • session_code
  • model_code
  • focus title

7.4 验收标准

• 切换 focus candidate 后，Evidence / Digest / Replay / Notes 明显随之变化
• focus 状态刷新页面后仍保留
• “清除 focus” 后退回默认全局视角

7.5 focused validation

• test_operator_workspace_service
• test_api_server
• front-end interaction smoke
• remote field smoke for focus-aware sections

8. Phase D: 外部上下文 provider 与视觉化增强

8.1 目标状态

从当前“有基础 provider 和 reference 卡片”，升级到更丰富的外部上下文层。

用户应能：

• 查看多个外部上下文源
• 知道当前 source freshness / status / degrade state
• 在需要时看到可视化的外部 context 证据

8.2 交付范围

后端：

• 多 provider external chart source 抽象
• 宏观/新闻 provider 扩展
• 交易所状态页 / 异常页 source 扩展
• 外部 context visual evidence 元数据

前端：

• provider list
• source state / freshness / fallback tag
• chart reference card 增强
• 可选 screenshot / embed 入口

8.3 建议切片

D1 multi-provider registry

• binance_public_chart_reference 之外增加 provider 抽象
• provider selection / fallback order

D2 macro/news provider enrichment

• 丰富事件类型
• provider freshness 统一摘要

D3 exchange anomaly surface enrichment

• 多交易所只读状态页
• source cards 中统一展示

D4 visual evidence extension

• 外部 chart/image 仅作为只读可视证据
• 不改变主分析链路

8.4 验收标准

• external context 至少支持多 provider registry
• UI 能显示 provider 状态差异
• screenshot / embed 失败不会阻塞主分析

8.5 focused validation

• provider tests
• exchange status tests
• workbench static smoke
• remote route field smoke

9. Phase E: workflow archive 运营化能力

9.1 目标状态

从当前“能看 archive 条目”，升级到“可用于盘前/盘中/盘后运营回看”的 archive 视图。

用户应能：

• 按日历日回看 workflow
• 按 session 回看 workflow
• 查看某天完整 pre/intraday/post 流转
• 对比多天 workflow drift

9.2 交付范围

后端：

• day/session grouped workflow archive query
• workflow daily summary builder
• workflow drift compare summary

前端：

• 按天浏览
• 按 session 浏览
• workflow timeline summary
• multi-day compare card

9.3 建议切片

E1 grouped archive query

• day bucket
• session bucket
• item counts / status counts

E2 daily summary view

• 某天 pre/intraday/post 摘要串联

E3 drift compare

• 多日 artifact count / pending/update drift
• 多日 body 变化摘要

E4 export / replay handoff

• 为后续复盘导出预留结构

9.4 验收标准

• 用户能按天看 workflow
• 用户能看出多天之间 workflow 差异
• archive 不再只是条目列表，而是运营回看面

9.5 focused validation

• workflow history service tests
• API tests
• front-end render tests
• remote smoke for grouped workflow archive

10. 推荐排期

如果按最稳的开发节奏推进，建议分 5 轮：

Round 1

• Phase A1-A4

Round 2

• Phase B1-B4

Round 3

• Phase C1-C4

Round 4

• Phase D1-D4

Round 5

• Phase E1-E4

11. 每轮统一闭环要求

每一轮都必须完成：

1. 锚点读取
2. 最小闭环切片实现
3. focused validation
4. 必要质量门
5. 必要时远端 deploy/smoke
6. 回写 SESSION.md / TASKS.md

12. 最终结论

这 5 个方向不是新的大重构，而是围绕当前分析助手主线的连续增强计划。

推荐默认从 独立偏好设置面 开始，原因是：

• 对日常使用提升最大
• 风险最低
• 与后续 archive / focus 深化天然衔接
• 不触碰延期项与实盘权限边界