dsh-trading-toolkit

项目介绍

中文

DSH agent 的 A股/美股交易工具箱：实时行情、OHLCV K线、ADX 三状态市场分类信号与简易回测预览，数据源东方财富。只读设计，永不下单。

English

A-share and US stock trading toolkit for DSH agents: realtime quotes, OHLCV klines, ADX three-state regime signals and simple backtest previews via EastMoney. Read-only, never places orders.

A-share + US stock trading toolkit for DeepSeek Harness agents: 行情查询（A股+美股）、ADX 三状态信号、简易回测预览。只读设计——永不下单、不触碰任何交易凭据。

Tools

工具	说明
`market_quote`	股票实时行情，自动识别 A股/美股：6位代码（600519）、前缀代码（sh600519）、中文名（贵州茅台）、美股 ticker（AAPL/NVDA）、指数（上证指数/深证成指/创业板指/科创50/沪深300）。数据源：东方财富，国内直连免 Key
`kline_history`	历史 OHLCV K线：A股/美股，周期 1m/5m/15m/30m/60m/1d/1w/1M，复权 0/1/2，最多 1000 根，输出可直接喂给 regime_signal
`regime_signal`	ADX 三状态市场分类：`trend`（趋势）/ `oscillating`（震荡）/ `noise`（噪声），含多空方向与 200-EMA 偏向。纯计算
`backtest_run`	基于跨状态规则的简易多空回测（总收益/最大回撤/胜率/交易次数）。教育用途预览，非生产级回测

安装

dsh plugin --profile web add github:kentleenot/dsh-trading-toolkit

（web 是 profile 名，可替换为你自己的 profile；该命令会在指定 profile 中安装本插件。）

然后将插件加入你的 DeepSeek Harness 组合配置（参见 harness 第三方插件文档）。

用法示例（agent 可调用）

market_quote(symbol: "600519")        # A股：贵州茅台
market_quote(symbol: "贵州茅台")       # A股：中文名搜索
market_quote(symbol: "000001")        # A股：上证指数
market_quote(symbol: "AAPL")          # 美股：苹果
market_quote(symbol: "NVDA")          # 美股：英伟达（未知 ticker 自动探测市场）
market_quote(symbol: "US:AAPL")       # 强制美股
market_quote(symbol: "CN:600519")     # 强制 A股
kline_history(symbol: "600519", period: "1d", limit: 120)   # 贵州茅台日K
kline_history(symbol: "AAPL", period: "60m", limit: 48)     # 苹果60分钟K
kline_history(symbol: "贵州茅台", period: "1w", limit: 30)  # 中文名周K
regime_signal(candles: [[high, low, close], ...])
backtest_run(candles: [[high, low, close], ...], feePct: 0.05)

自动路由规则

6 位数字 / sh|sz|bj 前缀 / 中文名 → A股
纯字母 ticker（AAPL、NVDA、PLTR）→ 美股
US: / CN: 前缀 → 强制指定市场
常见美股 ticker（AAPL/MSFT/NVDA/TSLA/META/AMZN/GOOGL/HOOD/AMD/NFLX/BRK/JPM/KO/DIS/BA）走内置映射；未知 ticker 自动探测 NASDAQ/NYSE/AMEX

为什么做这个

本插件把作者实盘策略栈（PrinciplesV2 —— ADX 驱动的三状态自适应策略）以只读、教学形式开放。状态分类沿用生产环境相同的阈值：

trend：ADX >= 25，方向由 +DI/-DI 交叉决定，200-EMA 偏向覆盖
oscillating：15 <= ADX < 25
noise：ADX < 15

行情数据源用东方财富公开接口：国内直连、无需代理、无需 API Key、免费，同时覆盖沪深与美股。

开发

npm test          # node --test test/
node test/smoke-market.mjs   # 行情网络冒烟测试（A股+美股）

License

MIT

dsh-trading-toolkit

项目介绍

项目信息与收录信号

数据评分

安装与使用

项目截图

仓库 README