ai-exchange/docs/AI_ICT_实盘辅助分析决策助手使用说明_2026-05-18_v1.md

# AI_ICT 实盘辅助分析决策助手使用说明 2026-05-18 v1

## 0. 使用边界与主线

本系统的使用必须严格遵循 `docs/ICT交易全书_出版终校版.md` 和 `docs/AI_ICT_硬性主线约束_必须遵循ICT交易全书_2026-05-21_v1.md`。

交易员使用时只应把它当作《ICT交易全书》主线的只读辅助工具：

```text
Range / Draw / Location
-> Liquidity / Sweep / Path
-> Displacement / MSS / FVG / Retest / Session
-> backtest evidence
-> plan
-> intraday focus or no-trade
-> journal feedback
```

如果页面输出不能帮助你回答“现在是否值得看、为什么、等什么确认、风险在哪里、历史是否有优势”，就不应把它作为盘中决策依据。

## 1. 文档目的

本文档面向系统 operator，说明如何使用 AI_ICT 进行只读实盘辅助分析决策。

当前系统的上线定位是：

```text
只读实盘辅助分析工作台，默认入口是 Trader Mode 首屏速读。
```

它可以帮助 operator：

- 在首屏用一句结论、一个候选、三条原因判断当前该观察、复核还是暂停。
- 检查系统是否具备当日看盘分析条件。
- 汇总实时行情状态、候选结构、确认缺口和 no-trade 理由。
- 整理 external context、历史 archive、workflow digest、复盘证据。
- 记录 shadow observation、operator feedback、weekly review 草稿。
- 辅助 operator 做“是否继续观察、是否暂停、是否进入人工复核”的判断。

它不能做以下事情：

- 不能自动下单。
- 不能代替 operator 做最终交易决定。
- 不能把候选、目标位、止损位或 narrative 当成直接买卖指令。
- 不能绕过人工确认、风控、trust bucket、risk governor。
- 不能作为任何资产买入、卖出、加仓、减仓的保证或承诺。

## 2. 使用前红线

每次使用前先确认四条红线：

1. `live_analysis_assistant_ready=true` 只表示可以用于看盘分析、证据整理和复盘。
2. `decision_support_ready=false` 时，系统还不能被视为完整可信的辅助决策源。
3. `execution_assist_ready=false` 时，系统不能用于准备真实执行。
4. `real_live_ready=false` 时，系统不能执行任何真实交易。

如果 UI 或 smoke 输出中出现以下字段，含义如下：

| 字段 | 正确理解 |
| --- | --- |
| `must_not_trade=true` | 输出不能作为买卖指令。 |
| `No order submission` | 系统不会也不应提交订单。 |
| `Not a buy/sell instruction` | 任何分析结论都只是辅助判断。 |
| `Execution remains disabled` | 执行能力仍关闭。 |
| `trade_permission_required=false` | 当前阶段不需要 OKX trade permission。 |
| `submit_cancel_or_live_execution_called=false` | smoke 未触发 submit / cancel / live execution。 |

## 3. 访问入口

当前内部部署入口：

```text
http://192.168.3.90:8000/
```

如果部署地址变化，以实际部署环境为准。

盘中默认入口是 `/trader-mode`；根路径 `/` 保留为完整 trading workbench 和 drill-down 工作台。常用入口如下：

| 用途 | 入口 |
| --- | --- |
| Trader Mode 盘中速读 | `/trader-mode` |
| 工作台 UI | `/` |
| 健康检查 | `/health` |
| runtime 状态 | `/trading/runtime-status` |
| 上线 readiness | `/trading/launch-readiness?instrument_id=1&timeframe=1m` |
| review packet / 决策上下文 | `/trading/review-packet?instrument_id=1` |
| shadow/paper 采样状态 | `/trading/shadow-paper-validation?instrument_id=1&timeframe=1m` |
| 候选列表 | `/trading/candidates?instrument_id=1&limit=5` |
| weekly review | `/trading/research/weekly-review?instrument_id=1` |

## 4. 每天开盘前检查

开盘前不要直接看候选。先做上线可用性检查。

### 4.1 运行只读上线 smoke

在 `D:\ai-exchange` 执行：

```powershell
$env:NO_PROXY='*'
$env:no_proxy='*'
.\.venv\Scripts\python.exe scripts\run_readonly_live_analysis_smoke.py --base-url http://192.168.3.90:8000 --attempts 2 --timeout-seconds 30
```

通过时应看到类似结论：

```text
Read-only live analysis smoke status: passed
ready_for_readonly_live_analysis: True
must_not_trade: True
Blocked reason: none
```

如果使用 JSON 输出：

```powershell
$env:NO_PROXY='*'
$env:no_proxy='*'
.\.venv\Scripts\python.exe scripts\run_readonly_live_analysis_smoke.py --base-url http://192.168.3.90:8000 --attempts 2 --timeout-seconds 30 --output-json
```

必须重点确认：

- `status=passed`
- `ready_for_readonly_live_analysis=true`
- `must_not_trade=true`
- `real_trade_required=false`
- `trade_permission_required=false`
- `submit_cancel_or_live_execution_called=false`
- `blockers=[]`

### 4.2 如果 smoke 不通过

按 `blocked_reason` 处理：

| blocked reason | 处理方式 |
| --- | --- |
| `health` | 服务不可用，先恢复 API / 数据库。 |
| `runtime_status` | runtime 不可用，检查 scheduler / supervisor。 |
| `launch_readiness` | 不进入实盘分析，先看 readiness blocker。 |
| `review_packet` | 不使用 cockpit 结论，先恢复 review packet。 |
| `trader_mode_payload` | Trader Mode 摘要缺字段或边界不安全，不开放盘中首屏。 |
| `shadow_paper_validation` | 可以看盘，但不要声称运营证据闭环完整。 |
| `weekly_review` | 可以看盘，但复盘入口未闭环。 |
| `static_app` | UI 边界文案缺失，不建议给 operator 使用。 |
| `trader_mode_page` / `static_trader_mode` | 独立 Trader Mode 页面或脚本缺失，先重新部署。 |

只要 `ready_for_readonly_live_analysis=false`，当天不应把系统作为实盘分析工作台使用。

## 5. Trader Mode 首屏速读

打开 `/trader-mode` 后，只先看独立 Trader Mode 首屏。交易员盘中目标是在 5-10 秒内回答三个问题：

1. 现在能不能看这个系统的盘面结论。
2. 当前有没有唯一值得人工复核的候选。
3. 下一步是继续观察、记录证据，还是暂停使用。

首屏字段只按下面方式理解：

| 字段 | 盘中含义 |
| --- | --- |
| `Review Now` | 数据可用，且只有一个候选值得人工复核；仍然不是买卖指令。 |
| `Observe Only` | 可以看盘，但没有干净候选，继续观察并记录原因。 |
| `Do Not Use` | 数据 stale、runtime 离线或风险口径有阻塞，暂停使用本页结论。 |
| `Decision Now` | 一句话结论，优先级高于其他复杂面板。 |
| `Focus` | 当前唯一候选；如果显示 `no clean opportunity`，不要强行找交易。 |
| `Three Reasons` | 只看前三条关键原因，避免盘中被长列表拖住。 |
| `Next Action` | 下一步动作，例如等待确认、记录 no-trade、补 shadow/paper 证据。 |
| `Market Last Updated` | 行情/候选最后更新时间。 |
| `Review Packet Updated` | 决策上下文最后更新时间。 |
| `Runtime Online` | runtime 是否在线。 |
| `Stale Seconds` | 超过阈值会冻结为 `Do Not Use`。 |
| `Trade Action` | 必须保持 `not_a_buy_sell_instruction`。 |
| `Boundary` | 必须包含只读分析、禁止下单、非买卖指令、执行关闭。 |

如果 Trader Mode 是 `Review Now`，正确动作是：

```text
只做人工复核和记录，不把它当成下单指令。
```

如果 Trader Mode 是 `Observe Only`，正确动作是：

```text
继续观察，记录缺口或 no-trade 理由，不为了交易而交易。
```

如果 Trader Mode 是 `Do Not Use`，正确动作是：

```text
暂停使用 cockpit 结论，先恢复 readiness / runtime / 行情新鲜度。
```

首屏可以直接记录盘中动作：

| 动作 | 作用 |
| --- | --- |
| `Agree` | 记录 operator 同意当前只读结论。 |
| `Disagree` | 记录 operator 不同意当前只读结论。 |
| `No Trade` | 记录不交易/站外观察，不创建真实交易。 |
| `Need More Evidence` | 记录还需更多证据。 |
| `Write Quick Note` | 写入 trader-mode operator note。 |

P1 盘中速读能力：

- `Profile` 会记住交易员自己的 instrument、timeframe、session 和 setup filter。不同交易员可以只看 BTC/ETH、London/NY，或只看 sweep/MSS/FVG 组合。
- `Why This Focus` 必须用一句话回答：结构是什么、还在等什么确认、为什么不能贸然行动。
- `Recovery` 在 `Do Not Use` 或 stale 时直接给恢复动作；先按 runtime、market feed、review packet 的提示修复，再重新看首屏。
- 快捷键：`R` 复核/刷新 focus，`N` 记录 No Trade，`A`/`D` 记录 Agree/Disagree，`Space` 暂停或恢复自动刷新。输入框里不会触发快捷键。

P2 后续增强能力：

- `Fast Queue`：先看 BTC/ETH/SOL 哪个是 `Review Now`，哪个只需观察，哪个不能使用。它是速读优先级，不是买卖信号。
- `Chart Bridge`：内部 `/candles` 是主证据，外部 chart provider 只是 reference-only；TradingView MCP/CDP 未接入时，不要把外部图表当成权威实时源。
- `Duty Panel`：开盘前看 `Use Today`、runtime smoke、maintenance、recent errors；只要变成不可用，就先恢复数据/runtime，再继续看盘。
- `After-Close Draft`：盘中的 Agree/Disagree/No Trade 会沉淀为复盘草稿，收盘后点击 `Save Draft Note` 保存为 operator note，再进入 weekly review。

复杂面板只在需要追问时打开。完整 workbench 的 drill-down 对应：

| Drill-down | 什么时候打开 |
| --- | --- |
| `Read-only Live Analysis` | 需要确认行情、runtime、账户上下文是否可用。 |
| `Watchlist: Review Now` | Trader Mode 给出唯一 focus 时，才查看候选细节。 |
| `No-Trade Reasons` | `Review Now` 之外的状态，优先看为什么不能行动。 |
| `Evidence` | 需要把结论写入 shadow/paper/operator feedback 时打开。 |
| `External Context` | 需要核对外部图表、公告、宏观事件时打开。 |
| `Review Entry` | 需要沉淀笔记、模板或盘后复盘时打开。 |

## 6. 盘前分析流程

建议按照以下顺序做盘前准备。

### 6.1 看 Workflow / Pre-Market

关注：

- 今日是否已加载 market context。
- 是否已有 decision packet。
- 是否有 opening next action。
- 是否有未处理 review queue。

如果 workflow 显示 attention needed，先完成它提示的上下文检查。

### 6.2 看 External Context

重点看：

- 宏观新闻窗口。
- 交易所状态。
- external chart reference。
- provider health。
- capture / screenshot readiness。

如果出现高波动事件窗口或交易所异常，盘中所有候选都要降权处理。

### 6.3 看 Digest / Reminders

Digest 用来提醒历史上容易忽略的问题，例如：

- 高频失败模式。
- stale evidence。
- 需要复核的历史 proof。
- setup-family 风险。
- 模板或偏好相关的注意事项。

这些提醒不是交易信号，而是当天分析时要主动排除的认知盲点。

## 7. 盘中分析流程

盘中不要先问“买还是卖”。正确流程是先判断当前系统是否只是在观察，还是有值得人工复核的结构。

### 7.1 先看 Decision Assistant Summary

重点字段：

- `headline`
- `market posture`
- `risk posture`
- `attention reason`
- `launch mode`
- `live analysis assistant ready`
- `must_not_trade`
- `no-trade reasons`
- `next actions`

如果 `risk posture` 或 `no-trade reasons` 给出高优先级 blocker，默认动作是继续观察或暂停，不进入执行讨论。

### 7.2 看 Watchlist / Candidate Tiers

候选通常分层展示：

- `review_now`
- `strong_watch`
- `soft_watch`
- `archive_only`

使用方式：

- `review_now`：值得人工复核，但不等于下单。
- `strong_watch`：持续观察，等待确认补齐。
- `soft_watch`：低优先级关注。
- `archive_only`：主要用于复盘，不作为盘中重点。

候选卡片里常见字段：

| 字段 | 怎么读 |
| --- | --- |
| `status` / `candidate_state` | 候选状态，可能是 blocked、monitoring、executable 等。 |
| `side` | 结构方向，只是模型侧上下文，不是买卖指令。 |
| `quality_score` | 质量评分，用于排序，不是胜率保证。 |
| `present_conditions` | 已满足的结构条件。 |
| `missing_confirmations` | 还缺什么确认。 |
| `rejected_conditions` | 为什么被拒绝。 |
| `reason_codes` | 机器可追溯原因。 |
| `entry_zone` / `stop_loss` / `targets` | 仅用于结构分析和纸面复盘，不是下单参数。 |

### 7.3 看 No-Trade Reasons

No-Trade Reasons 是当前阶段最重要的输出之一。

常见原因包括：

- market stale。
- runtime blocker。
- news/event window。
- confirmation missing。
- direction mismatch。
- trust gate 未过。
- risk / framework evidence 不足。
- visual review missing。

如果 no-trade reason 明确，operator 应优先记录“为什么不做”，而不是寻找反例强行交易。

### 7.4 看 Evidence Chain

Evidence Chain 用来回答：

```text
系统为什么这样判断？
```

通常包含：

- Decision Gate。
- Launch Mode。
- Session Context。
- Focus Candidate。
- Operator Queue。
- Weekly Review。
- External Context。

使用要求：

- 至少能追溯到 market freshness、candidate confirmation、trust boundary。
- 如果证据链缺关键环节，只能做观察，不进入人工交易计划。
- 如果 evidence 与真实图表观察冲突，以人工复核和外部图表为准，并记录 disagreement。

### 7.5 看 Explain / Reason Citations

Explain 用来拆解系统判断逻辑。Reason Citations 用来定位原因来源。

正确用法：

- 找出当前结论依赖哪些条件。
- 找出条件是 present、missing、rejected 还是 stale。
- 找出当前最短补齐路径。

错误用法：

- 只看 narrative 里方向词。
- 只看 entry/target 数字。
- 跳过 missing/rejected reason。

## 8. 人工复核标准

系统输出只能触发人工复核，不触发真实执行。

当候选看起来“不错”时，operator 至少要完成以下独立检查：

1. 当前 `Read-only Live Analysis` 仍为 ready。
2. 行情 freshness 仍为 fresh。
3. `must_not_trade=true` 仍可见，确认自己不是让系统下单。
4. 候选的 missing confirmations 已理解。
5. no-trade reasons 已逐条排除或记录。
6. external context 没有高风险窗口。
7. 人工图表复核与系统结构一致。
8. 风险上限、账户状态、交易规则由 operator 独立判断。

如果任何一项不清楚，操作结论应是：

```text
继续观察，记录原因。
```

## 9. 如何记录盘中证据

### 9.1 Record Shadow Observation

用于记录当天系统观察样本。

适用场景：

- 系统有候选，但仍未 executable。
- 系统给出 no-trade reason。
- operator 观察到系统判断与盘面一致或冲突。
- 需要为 R2 shadow/paper evidence 增加真实样本。

操作入口：

- Decision Assistant 面板中的 `Record Shadow Observation`
- Launch Readiness / Shadow Paper 区域中的同名按钮
- API：`POST /trading/shadow-paper/observe`

### 9.2 Agree / Disagree Shadow Observation

用于记录 operator 对系统判断的反馈。

使用方式：

- `Agree Shadow Observation`：人工复核认为系统判断合理。
- `Disagree Shadow Observation`：人工复核认为系统判断有问题。

记录 disagreement 时，必须在 note 中说明：

- 系统哪里错了。
- 人工图表看到什么。
- 是数据问题、结构识别问题、风险问题，还是外部 context 问题。

### 9.3 Review Entry / Note

Review Entry 用于沉淀复盘材料。

建议记录：

- 当天最关键的 no-trade reason。
- 最有价值的候选。
- 最明显的误判。
- 是否有 missed opportunity。
- 下次需要改进的确认条件。

## 10. 收盘后复盘流程

收盘后按照以下顺序复盘。

### 10.1 看 Timeline

确认当天关键变化：

- 当前 packet。
- previous packet。
- candidate 状态变化。
- alert / note / execution 相关时间线。

### 10.2 看 Workflow / Archive

用 archive 查询和对比：

- 同类 setup 最近是否表现一致。
- 今天的候选与历史基线相比是否异常。
- workflow digest 是否完整。
- 是否需要保存 baseline 或对比快照。

### 10.3 看 Learning / Replay

关注：

- setup-family trend。
- replay percentile。
- peer baseline。
- risk discipline verdict。
- missed opportunity attribution。

这些用于改进模型和流程，不用于追单。

### 10.4 Weekly Review

Weekly Review 当前是只读上线的运营入口之一。

重点看：

- `entry_count`
- `framework_execution_rate`
- `risk_violation_count`
- `next_week_actions`

即便 `paper_ticket_count=0`，也可以先记录 review 草稿，因为当前阶段不要求 paper ticket 样本满。

## 11. 常见状态解释

### 11.1 `restricted_decision_support`

含义：

```text
可以用 cockpit 做受限人工复核、证据整理和 no-trade 解释，但不代表完整决策支持，更不代表可以执行。
```

正确动作：

- 看盘。
- 复核。
- 记录。
- 进入 shadow/paper 证据采样。

禁止动作：

- 把系统方向当交易建议。
- 用系统 entry/target 直接下单。
- 要求系统生成真实订单。

### 11.2 `collecting_paper_samples`

含义：

```text
R2 shadow/paper 证据还在采集中。
```

这不是只读上线 blocker，但说明系统还不能晋级为更高可信度的辅助决策系统。

### 11.3 `paper_ticket_sample_gate`

含义：

```text
需要未来出现真实 executable candidate 后，才能继续补 paper ticket / paper execution 证据。
```

不要为了补样本而伪造 executable candidate。

### 11.4 `account_context_unavailable`

含义：

```text
账户上下文不可用，但如果 market/runtime/review packet 正常，仍可进行纯行情只读分析。
```

限制：

- 不得使用账户余额、持仓、订单信息做结论。
- 页面必须把 account context unavailable 显示出来。

## 12. 故障处理

### 12.1 行情 stale

表现：

- `market_freshness` 不是 `market_data_fresh`
- `market_stream` 不是 `market_stream_connected`
- `market_data_gap` 不是 `market_data_gap_clear`

处理：

1. 停止使用实盘分析结论。
2. 运行 read-only smoke。
3. 检查 runtime status。
4. 等待 market truth 恢复。
5. 恢复后重新记录 observation。

### 12.2 runtime blocker

表现：

- `runtime_health=blocked`
- `current_blocker` 有值。

处理：

1. 不使用候选结论。
2. 查看 `/trading/runtime-status`。
3. 修复 blocker。
4. 重新运行 smoke。

### 12.3 review packet 不可用

表现：

- smoke `review_packet` blocked。
- Decision Assistant summary unavailable。

处理：

1. 不使用 cockpit 总结。
2. 查看 API 错误。
3. 修复后重新 smoke。

### 12.4 UI 边界文案缺失

表现：

- smoke `static_app` blocked。
- 页面没有显示 `Read-only Live Analysis` 或 `must_not_trade`。

处理：

1. 不给 operator 使用 UI。
2. 重新部署正确版本。
3. 静态检查和 smoke 通过后再开放。

## 13. 推荐日常 SOP

### 盘前 5 分钟

1. 运行 `run_readonly_live_analysis_smoke.py`。
2. 打开 Trader Mode `/trader-mode`。
3. 先看状态是否 `Review Now` / `Observe Only` / `Do Not Use`。
4. 只有需要解释原因时，再打开 Read-only Live Analysis / External Context / Workflow。
5. 用 Review Entry 记录当天关注点。

### 盘中

1. 只先看 Trader Mode 一张卡。
2. `Review Now`：人工复核唯一 focus，并记录 Agree / Disagree / No Trade / Need More Evidence。
3. `Observe Only`：继续观察，记录 no-trade / waiting reason。
4. `Do Not Use`：暂停使用 cockpit 结论，先修 blocker。
5. drill-down 只在需要核对证据或写记录时打开。
6. 不做任何系统驱动的真实下单。

### 收盘后

1. 看 Timeline。
2. 看 Archive / Workflow 对比。
3. 写 Review Entry。
4. 更新 Weekly Review 草稿。
5. 总结当天系统有用与无用之处。

## 14. 上线后仍需采集的证据

只读上线已经闭环，但以下证据仍需要持续积累：

- paper ticket 样本。
- paper execution 样本。
- operator feedback 样本。
- weekly review entries。
- executable candidate 后的人工复核记录。
- disagreement 的原因分类。

这些证据用于未来判断是否可以进入更高层级：

- `decision_support_ready=true`
- 更完整的 R2 shadow/paper 窗口。
- R3 交易 adapter 沙盒验证。
- R4/R5 真实试点和稳定化制度。

在当前阶段，这些都不是只读上线 blocker。

## 15. 一句话使用原则

```text
盘中先看 Trader Mode：Review Now 才人工复核唯一候选，Observe Only 只观察记录，Do Not Use 立即暂停；复杂证据只做 drill-down，任何时候都不要把系统输出当作实盘买卖指令。
```