前言¶

给智能体接行情，常见的做法是注册一家行情数据服务商、申请 API Key、把 Key 挂进环境，再自己写一层 A股/美股代码识别逻辑。每做一个新 agent，这套流程都要重来一遍；如果还想让 agent 参与交易决策，就得额外操心凭据安全和误下单的问题。

dsh-trading-toolkit 把这件事收敛成一个 DSH 插件：行情查询、ADX 状态信号、简易回测预览，全部只读。下面介绍它的功能、安装方式和典型用法。

这是什么¶

dsh-trading-toolkit 是 kentleenot 维护的 DeepSeek Harness（DSH）插件，MIT 许可证，当前版本 0.1.0。一句话定位：面向 DSH 智能体的 A股 + 美股交易工具箱，包含实时行情、历史 K线、ADX 三状态信号和简易回测预览。

它强调只读设计——永不下单、不触碰任何交易凭据。agent 能看数据、算信号，但没有交易通道，这一点在把行情能力接进 agent 时很重要。

DSH 的理念是「一切皆插件」，行情这类外部能力以插件形式接入，装完即可被 agent 调用。

四个工具¶

market_quote¶

股票实时行情。自动识别 A股/美股，6 位代码（600519）、前缀代码（sh600519）、中文名（贵州茅台）、美股 ticker（AAPL/NVDA）、指数（上证指数/深证成指/创业板指/科创50/沪深300）都可以直接传入。数据源是东方财富公开接口，国内直连、无需代理、无需 API 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¶

基于跨状态规则的简易多空回测，输出总收益、最大回撤、胜率、交易次数。注意这是教育用途预览，不是生产级回测。

自动路由规则¶

market_quote 和 kline_history 依据传入的 symbol 自动判断市场：

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。拿不准的时候，可以用 US: / CN: 前缀强制指定市场。

安装与启用¶

先执行下面的命令，在指定 profile 中安装本插件：

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

web 是 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股

历史 K线，period 与 limit 控制周期和数量：

kline_history(symbol: "600519", period: "1d", limit: 120)   # 贵州茅台日K
kline_history(symbol: "AAPL", period: "60m", limit: 48)     # 苹果60分钟K

信号与回测。candles 由 kline_history 的输出直接传入，feePct 是手续费率：

regime_signal(candles: [[high, low, close], ...])
backtest_run(candles: [[high, low, close], ...], feePct: 0.05)

状态分类的阈值¶

regime_signal 的三状态划分沿用固定阈值：

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

这些阈值与作者的生产环境相同：作者把其实盘策略栈 PrinciplesV2（ADX 驱动的三状态自适应策略）以只读、教学形式开放，PrinciplesV2 的实盘复盘与设计笔记见作者博客 libuyan.top。

适用场景与注意¶

适合的场景：

1、在 DSH 里做行情问答、看盘辅助的 agent，直接调用 market_quote 和 kline_history。

2、想把 PrinciplesV2 的三状态分类思路接进自己的 agent 流程，用 regime_signal 拿状态判断。

3、想粗略验证信号思路，用 backtest_run 做预览。

使用前注意：

1、backtest_run 是教育用途预览，不要当生产级回测使用。

2、行情数据来自东方财富公开接口，国内直连免 Key，覆盖沪深与美股。

3、插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证（MIT）。

结尾¶

dsh-trading-toolkit 的价值在于把「接行情」这件重复劳动收敛成一次插件安装，并用只读设计划清了看数据与下单的边界。如果你想给自己的 DSH agent 加上 A股/美股行情能力，可以从下面两个入口开始：

• GitHub：https://github.com/kentleenot/dsh-trading-toolkit
• 社区目录页：https://www.skillhub.cn/plugins/kentleenot/dsh-trading-toolkit （社区维护的插件目录，与 DeepSeek / 幻方无官方从属关系）