Files

T

claude_dev 4ebbd434a6 docs(archive): 过期文档归档波——14 件墓碑+台账补全+两轮审计报告入库 [nas]

- 归档 12 件(git mv 保历史,audit/20261001_docs_audit/ §2.1 判定):
  deployment/{vps-native-brain,windows-bridge-setup,d-phase-windows-deploy,README}
  (miniQMT/FastAPI-bridge 退役架构,09-08)+vps-deploy-pending(一次性任务使命
  终结)+specs/phase3b-vue(里程碑已兑现)+plans/{phase3c-paper-trading,
  backtest-result-page,strategy-management-backend,factor-batch1}(已完成/被
  实态推翻)+design/provider-mcp-expose(未实施行号全失效)+research/README
  (死模板)
- 原位墓碑 2 件: sanguo_qmt_bridge/README(包内保留,运维语义退役)+
  CHANGELOG(冻结,变更历史以 git log 为准)
- 台账: audit/README 补 5 波次表+状态列+固定安全清单约定(每波必查凭据/
  鉴权面/CI 门禁 diff——历轮审计系统性盲区,docs_audit §5.2);docs/README
  索引对齐归档后实态(+design/audit 行)
- 审计报告入库: 20260927_commit_docs_consistency+20261001_architecture_
  code_audit+20261001_docs_audit 三目录

Co-Authored-By: Claude Code <notify@anthropic.com>

2026-10-01 09:08:29 +08:00

3.6 KiB

Raw Blame History

⚠️ 已归档（2026-10-01，audit/20261001_docs_audit/ §2.1 归档波）

归档原因：运维语义已退役：本文描述的 FastAPI bridge(:8765) 通道 09-08 随 miniQMT 整体退役；生产栈=大QMT 桥栈（XtItClient+redis RPC，runbook §1/§3）。代码保留（默认值与代码自洽），本文仅作包内历史说明。

现行权威：docs/deployment/vps-production-runbook.md（§1/§3 桥栈）。

处置：保留原地（包内 README 不移动）；原文全文见 git 历史（归档 commit 前一版）。

sanguo QMT bridge (D-1 MVP)

Windows 端 FastAPI 服务，封装 xtquant，供 sanguo(NAS) 跨网调 miniQMT 下单/查询。

前提

miniQMT 客户端已登录并保持运行（极简模式即可）
xtquant 可 import（miniQMT 安装目录自带，或 pip install xtquant）
Python 3.10+

安装

cd C:\sanguo_qmt_bridge   # bridge 代码所在目录
pip install -r requirements.txt

xtquant 来自 miniQMT 安装目录（bin.x64\Lib\site-packages），无需 pip install。若 import 失败，确认 miniQMT 的 site-packages 在 PYTHONPATH，或 pip install xtquant。

配置（环境变量）

变量	说明	默认值
`BRIDGE_TOKEN`	必填。共享密钥，sanguo 端同值。不设则受保护接口返回 503	—
`MINIQMT_USERDATA`	miniQMT userdata_mini 路径	`D:\国金QMT交易端模拟\userdata_mini`
`ACCOUNT_ID`	miniQMT 账户 ID	`66639661`
`BRIDGE_SESSION_ID`	xtquant session ID（int）	`20260710`

设置 BRIDGE_TOKEN（PowerShell）：

# 临时（当前终端）
$env:BRIDGE_TOKEN = "你的随机密钥"

# 永久（系统环境变量）
[Environment]::SetEnvironmentVariable("BRIDGE_TOKEN", "你的随机密钥", "User")

生成密钥：python -c "import secrets; print(secrets.token_urlsafe(32))"

启动

cd C:\sanguo_qmt_bridge
uvicorn bridge:app --host 127.0.0.1 --port 8765

启动日志看到 xtquant 连接成功 即就绪。若 miniQMT 未连上，服务仍运行（/health 报 disconnected）。

接口

所有受保护接口需 header X-Bridge-Token: <BRIDGE_TOKEN>，/health 豁免。

GET /health（无需鉴权）

{"status": "ok", "miniqmt_connected": true}

POST /order

请求：

{
  "code": "sh600000",
  "action": "buy",
  "price": 10.50,
  "volume": 100,
  "price_type": "limit",
  "reason": "策略信号"
}

成功：

{"ok": true, "order_id": 12345}

失败：

{"ok": false, "error": "报单失败 order_id=-1"}

GET /account

{"ok": true, "cash": 100000.0, "frozen": 0.0, "market_value": 50000.0, "total": 150000.0}

GET /positions

{
  "ok": true,
  "positions": [
    {"code": "sh600000", "volume": 200, "can_use": 200, "avg_price": 10.30}
  ]
}

代码格式

入参（/order）：sanguo 格式 sh600000 / sz000001
返回（/positions）：sanguo 格式 sh600000 / sz000001
bridge 内部自动转 xtquant 格式 600000.SH / 000001.SZ

验证

跑过 check_xtquant.py 确认 xtquant 可用后，启动 bridge 再验证：

# 健康检查（无需 token）
curl http://127.0.0.1:8765/health

# 查资金（需 token）
curl -H "X-Bridge-Token: 你的密钥" http://127.0.0.1:8765/account

自启（可选，D-2）

任务计划程序创建 sanguo-bridge，onstart，命令：

uvicorn bridge:app --host 127.0.0.1 --port 8765

工作目录设为 bridge 代码目录。依赖 miniQMT 客户端已先启动。

3.6 KiB Raw Blame History Unescape Escape