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

## 0. 当前硬性约束

本计划是历史增强计划，后续继续使用时必须服从：

- `docs/ICT交易全书_出版终校版.md`
- `docs/AI_ICT_硬性主线约束_必须遵循ICT交易全书_2026-05-21_v1.md`
- `docs/AI_ICT_主线纠偏与功能裁剪方案_2026-05-20_v1.md`

若本计划中的 archive、external context、workflow、digest、handoff 等增强方向与《ICT交易全书》主线冲突，或者不能直接服务 `Range / Draw / Location -> Liquidity / Sweep / Path -> Displacement / MSS / FVG / Retest / Session -> backtest -> plan -> intraday focus/no-trade -> journal feedback`，则不得继续作为交易员主界面开发任务。

## 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 深化天然衔接
- 不触碰延期项与实盘权限边界