From c2734d11dd86652aae162fecce7f429aeed6a9f3 Mon Sep 17 00:00:00 2001
From: claude_dev <claude-dev@sanguo.local>
Date: Tue, 8 Sep 2026 18:22:01 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=BF=81=E7=A7=BB=E8=AF=84=E4=BC=B0?=
 =?UTF-8?q?=C2=A76.3=E5=9D=917=E2=80=94=E2=80=94pip=E8=A3=85=E6=A1=A5clien?=
 =?UTF-8?q?t=E6=B1=A1=E6=9F=93=E5=AE=98=E6=96=B9xtquant=E4=BA=8B=E6=95=85?=
 =?UTF-8?q?=E4=B8=8E=E4=BF=AE=E5=A4=8D=E9=93=81=E5=BE=8B=20[nas]?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/design/2026-09-07-miniqmt-shutdown-migration-assessment.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/design/2026-09-07-miniqmt-shutdown-migration-assessment.md b/docs/design/2026-09-07-miniqmt-shutdown-migration-assessment.md
index 95c7c31..d8daeb5 100644
--- a/docs/design/2026-09-07-miniqmt-shutdown-migration-assessment.md
+++ b/docs/design/2026-09-07-miniqmt-shutdown-migration-assessment.md
@@ -120,6 +120,7 @@
 4. **「编辑策略交易」弹窗无运行模式控件**（国金定制）：模拟/实盘切换按钮在主界面；模拟账号下单天然走模拟柜台
 5. **qmt_launcher restart 会连杀 miniQMT**：mini/完整版/miniquote 同属一个 bin.x64，按目录隔离也躲不开——**只在维护窗用**（16 引擎全停时）
 6. get_full_tick 实时性判据：`timetag` 字段盘中应实时跳动，隔夜值停在 00:00
+7. **🔴 pip 装桥客户端会污染官方 xtquant（09-08 事故）**：wheel 内 `src/xtquant/*.py` 会覆盖 site-packages 官方 xtquant（250516.1.1）同名 py（xtdata.py 变 9 行桥化委托；pyd/dll 幸存）→ 当晚 21:00 xt_eod 炸（compat 层 `get_stock_list_in_sector` NotImplementedError，ETF/基金/北交 09-07 EOD 缺失）。修复=`pip install --force-reinstall --no-deps xtquant==250516.1.1`（18:1x 完成，xtdata 连回 miniQMT 验证绿）。**铁律：在有官方 xtquant 的机器上装桥 client，必须先从 zip 剔除 xtquant 目录再装；或装完立刻 force-reinstall xtquant 恢复**。桥 client/策略 glue 目录均不受重装影响（独立路径）
 
 ### 6.4 自愈链（09-08 用户拍板：挂了再说）