dsh-trading-toolkit

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

Tools

安装

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