dsh-longbridge
Author / Maintainer: @Zacklinkk
DSH 长桥（Longbridge）港美股数据接入插件：券商级行情、账户与交易工具 + 设置页凭据管理。
定位
- 港美股（
700.HK/AAPL.US格式）+ 券商级能力（持仓/下单/账户），数据源为
Longbridge OpenAPI（longbridge npm SDK，App Key/Secret 认证）。
- 与
dsh-stock-market差异化：它覆盖沪深 A 股免费公开源；本插件覆盖港美股与券商级数据。 - 交易工具强制确认：
longbridge_place_order/longbridge_cancel_order每次调用都过
DSH 审批通道（tools/pre-execute → approval），非 allowed-once 一律拒绝。
硬前置：凭据门槛
1. 在长桥 App 完成开户； 2. 登录 open.longbridge.com 开发者平台完成开发者认证 / OpenAPI 权限申请； 3. 行情权限与交易权限分别开通（免费；港股实时订阅级别、美股期权数据有单独条件）； 4. 在用户中心取得 App Key / App Secret / Access Token 三件套，填入 设置 → 长桥。
凭据只写入 DSH 凭据保险箱（ctx.credentials，本地 $DSH_HOME/.credentials.yaml）， 不进入 settings 文档、日志或会话内容；环境变量 LONGBRIDGE_APP_KEY / LONGBRIDGE_APP_SECRET / LONGBRIDGE_ACCESS_TOKEN 提供时优先（只读遮蔽）。
工具清单（9 个，按开关分组）
| 分组 | 工具 | 说明 |
|---|---|---|
| 行情（默认开） | longbridge_quote | 实时快照（≤20 代码） |
longbridge_kline | K线（1m…year，≤500 根，前/不复权） | |
longbridge_indices | 港美主要指数（HSI/HSTECH/DJI/SPX/NDX…） | |
longbridge_watchlist | 券商自选分组 list/add/remove | |
longbridge_market_status | 当日交易时段 | |
| 账户（默认关） | longbridge_account | 资金总览（现金/净资产/保证金） |
longbridge_positions | 持仓列表 | |
| 交易（默认关，强制确认） | longbridge_place_order | 下单（LO/ELO/MO，限价校验） |
longbridge_cancel_order | 撤单 |
开关在 设置 → 长桥 即时生效（动态注册/注销工具组）。账户/交易组默认关闭； 交易组开启后每次下单仍会弹确认。
UI
- 设置页（
settings.section「长桥」）：凭据三件套 + 状态徽章 + 测试连接（700.HK 探活）、
环境（live/paper）、三组工具开关、实验面板开关。
- 右侧行情面板（实验，默认关）：自挂固定列 +
--dsh-longbridge-panel-width挤压布局，
每 5s 轮询指数快照。开启方式：设置 → 长桥 → 实验：右侧行情面板。
开发与构建
npm ci --include=dev # 公开依赖（含 longbridge SDK）
DSH_WORKSPACE_ROOT=/path/to/dsh-checkout npm run setup:dsh-workspace # 链接 DSH 私有 peer
npm run typecheck && npm test && npm run build # 门禁：tsc + vitest + tsdown(client bundle)lib/ 为构建产物（host 半区 tsc 输出 + client 半区 tsdown bundle，含 CSS 内联）。
安装
dsh plugin --profile web add link:/absolute/path/to/dsh-longbridge
# 或从 git/npm 源安装发布包；hub catalog 每 2h 自动收录本仓库安装后刷新 Web GUI（http://127.0.0.1:3080）：设置页出现「长桥」；模型工具目录出现 longbridge_*（按开关）。
限流与配额（实现内已处理/需知）
- Quote：10 req/s、并发 5（SDK 自动限流）；Trade：**30 req/30s、间隔 ≥20ms（本插件
TradeThrottle 强制）**；
- 历史 K 线按月配额（unique symbols，按资产分级 100–3000），实时 K 线（
candlesticks）
与行情快照不受此配额限制。
路线备注（第一轮调研结论，存档）
- dsh-mcp-client（streamable-http）不支持 OAuth 2.1，无法直挂
https://mcp.longbridge.com
（实测 401 + RFC 9728 挑战）；自托管 longbridge-mcp 仍走同一 OAuth。原生插件（本仓库） 使用 legacy App Key/Secret 三元组，无浏览器交互。详见 docs/（若随仓发布）与工作目录调研文档。