omdsh-dev/dsh-longbridge

Name: omdsh-dev/dsh-longbridge
Author: omdsh-dev

插件Plugin 原生Native ⭐ 5 BSD-3-Clause 安全Security Web 界面Web UI

DSH plugin for Longbridge HK/US market data, accounts, positions, and approval-gated order placement, with a built-in settings panel.

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

DSH 长桥插件通过 Longbridge OpenAPI 接入港美股行情、账户与下单能力，区别于 dsh-stock-market 聚焦免费 A 股源。它提供 9 个工具：行情组默认开启，支持实时快照、K 线、指数、自选与交易时段；账户与交易组默认关闭，开启后下单撤单每次仍走 DSH 审批通道强制确认。注意：使用前需先在长桥 App 完成开户、申请 OpenAPI 权限并取得 App Key/Secret/Access Token，凭据存储于 DSH 凭据保险箱。

The dsh-longbridge plugin connects to Longbridge OpenAPI to provide Hong Kong and US stock quotes, account data, and order execution. Unlike dsh-stock-market which covers free A-share sources, it focuses on broker-level capabilities. It exposes nine tools grouped by switch: quotes (snapshots, K-lines, indices, watchlist, market status) are on by default, while account and trade tools are off by default and require explicit enabling. Order placement and cancellation always route through the DSH approval channel for confirmation. Caveat: users must open a Longbridge account, apply for OpenAPI permissions, and configure App Key/Secret/Access Token via the settings page; credentials are stored only in the DSH vault.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-longbridge】【https://github.com/omdsh-dev/dsh-longbridge】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:omdsh-dev/dsh-longbridge

把 omdsh-dev/dsh-longbridge 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.1 KB · 缓存于 2026-08-23 03:41:49 · 4.1 KB

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 一律拒绝。

硬前置：凭据门槛

在长桥 App 完成开户；
登录 open.longbridge.com 开发者平台完成开发者认证 / OpenAPI 权限申请；
行情权限与交易权限分别开通（免费；港股实时订阅级别、美股期权数据有单独条件）；
在用户中心取得 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/（若随仓发布）与工作目录调研文档。

渲染基于仓库 omdsh-dev/dsh-longbridge 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install