快速开始¶

本仓库是 Agent Skills 层：在 Cursor / Claude Code / 豆包工作 / WorkBuddy 里用自然语言驱动脚本，通过 HTTP 调用 QMT Bridge。

架构¶

Mac / Linux / Windows（主力机 · 本仓库）     Windows（中转站）
┌──────────────────────┐                ┌─────────────────────────┐
│ Cursor / 豆包 / WorkBuddy │ HTTP/WS  │  QMT 客户端（登录中）      │
│ @skills/.../SKILL.md │ ◄───────────► │  qmt-server (qmt-bridge) │
│ 分析 / 本地报告       │   局域网       │  xtquant                 │
└──────────────────────┘                └─────────────────────────┘

1. 安装本仓库全部 Skills¶

把本仓 skills/ 装进当前 Agent。布局要求：各 qmt-bridge-* 为 Skill；_shared 与它们同级复制（共享库，不注册为 Skill，但必须有）。

对话安装（豆包工作 / WorkBuddy / Cursor 等）¶

帮我安装这个 skill：https://github.com/atorber/qmt-trading-skill

安装布局（必须遵守）：
1. 把 skills/ 下每个 qmt-bridge-* 目录安装为独立 Skill。
2. 同时把 skills/_shared 复制到与上述 Skill 同一父目录（并列）。_shared 是共享库，不要注册成 Skill，但必须复制。
3. 一并复制 skills/VERSION。
安装完成后读取 VERSION，并确认 _shared 与各 Skill 同级。

也可界面上传：最终须为 <skills-root>/_shared/ 与 <skills-root>/qmt-bridge-*/ 并列。

通用 CLI¶

npx skills add atorber/qmt-trading-skill -g -y

更新已安装的 Skills¶

帮我把 qmt-trading-skill 更新到最新版：https://github.com/atorber/qmt-trading-skill
覆盖全部 qmt-bridge-*，并同步同级 _shared 与 VERSION；读出 VERSION 确认。

npx skills check
npx skills update -g -y
# 或
npx skills add atorber/qmt-trading-skill -g -y

git 克隆：git pull --recurse-submodules 后查看 skills/VERSION。更新后建议新开对话。详见仓库 README。

开发克隆（需跑脚本时）¶

git clone --recurse-submodules https://github.com/atorber/qmt-trading-skill.git
cd qmt-trading-skill
pip install qmt-bridge-pro
pip install -e ".[dev]"
cp .env.example .env

开发对照 Bridge 源码：pip install -e "./vendor/qmt-bridge"。

编辑 .env：QMT_BRIDGE_HOST / QMT_BRIDGE_PORT / QMT_BRIDGE_API_KEY 须与 Bridge 一致。

开发克隆：仓库根 .env
社区 / Agent 安装：<skills-root>/.env（与 _shared 同级；可复制 skills/.env.example）

手动改文件或让 setup Skill 写入：见仓库 README「配置客户端连接」。变量表见配置参考。

客户端地址

服务端可监听 0.0.0.0；Skill 脚本请连接 127.0.0.1 或 Windows 局域网 IP，不要把 0.0.0.0 当作 HTTP 目标。

2. 检测并（按需）安装 / 启动 QMT Bridge¶

Skills 装好后，在对话中说：

检查 QMT Bridge 是否已启动；若未启动再帮我安装并启动。已在跑则不要重复安装或重启。

或 @skills/qmt-bridge-setup/SKILL.md（见 qmt-bridge-setup）。Agent 规程：

先健康检查（bridge_health.py / GET /api/meta/health）
已可达 → 直接报告状态，不重复安装、不重启
不可达 → 再安装 / 配置 / 启动（Windows 与 QMT 同机；QMT 需「独立交易」登录）

手动启动示例：

# 在 qmt-bridge 仓库
pip install -e ".[full]"
qmt-server --port 8080 --trading --api-key your-secret-key \
  --mini-qmt-path "C:\你的QMT路径\userdata_mini" \
  --stock-account-id 普通账户ID --credit-account-id 信用账户ID

验证：http://127.0.0.1:8080/docs、GET /api/meta/health，或：

python skills/qmt-bridge-setup/scripts/bridge_health.py

3. 开始使用¶

对话中直接说自然语言即可。每个 Skill 一条典型提示词（共 23 条）：

Skill	提示词
setup	`检查 QMT Bridge 是否已启动；若未启动再帮我安装并启动`
trading	`帮我查持仓和可用资金`
execution-review	`用投顾/基金经理/交易员三角色做今日复盘并综合裁决`
feishu-doc	`把今日复盘同步到飞书`
portfolio-risk	`组合风险快照，看下持仓集中度`
daily-pnl	`今天账户盈亏多少`
order-ops	`查今日委托和可撤单`
kline-backfill	`复盘前检查近3日两市成交额`
return-analysis	`评估持仓涨幅概率并总结明日策略`
market-watch	`自选行情快照`
sector-theme	`今天行业强弱怎么排`
financial-download	`下载财报到 Bridge 缓存`
fundamental-screen	`按 ROE、EPS 做基本面筛选`
technical-signal	`用 QMT 公式检查是否金叉`
smart-execution	`预览这笔买单会不会涨跌停`
rebalance	`按目标权重生成调仓计划`
credit-margin	`查两融保证金和担保品`
realtime-monitor	`WebSocket 订阅实时行情`
event-calendar	`今天是不是交易日`
etf	`查 ETF 列表和申赎清单`
convertible	`可转债列表和条款快照`
option	`查 510050 期权链`
hk-connect	`港股通标的有哪些`

更多变体见 Agent Skills 与 skills/README.md。写操作须确认后脚本才加 --execute --confirm。

4. 本机手动跑脚本（调试）¶

python skills/qmt-bridge-daily-pnl/scripts/daily_pnl_snapshot.py \
  --host 127.0.0.1 --port 8080 --api-key YOUR_KEY

python skills/qmt-bridge-execution-review/scripts/daily_trade_report.py \
  --host 127.0.0.1 --port 8080 --api-key YOUR_KEY --feishu-md

Windows 中文乱码：chcp 65001 或 $env:PYTHONIOENCODING='utf-8'。

每日复盘定时调度¶

前台常驻，到点生成复盘并同步飞书（需 Bridge、QMT、lark-cli auth）：

scripts\daily_eval_scheduler.bat
scripts\daily_eval_scheduler.bat --run-now
scripts\daily_eval_scheduler.bat --run-now --skip-feishu

时间见 .env 中 DAILY_EVAL_SCHEDULE_TIME（默认每交易日 15:10）。日志：logs/daily_eval_scheduler.log。

复盘报告长什么样：每日复盘报告示例。