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交易全书》主线的只读辅助工具：

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 进行只读实盘辅助分析决策。

当前系统的上线定位是：

只读实盘辅助分析工作台，默认入口是 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. 访问入口

当前内部部署入口：

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 执行：

$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

通过时应看到类似结论：

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

如果使用 JSON 输出：

$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，正确动作是：

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

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

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

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

暂停使用 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 用来回答：

系统为什么这样判断？

通常包含：

• 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 独立判断。

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

继续观察，记录原因。

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

含义：

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

正确动作：

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

禁止动作：

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

11.2 collecting_paper_samples

含义：

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

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

11.3 paper_ticket_sample_gate

含义：

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

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

11.4 account_context_unavailable

含义：

账户上下文不可用，但如果 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. 一句话使用原则

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