前言¶

給智能體接行情，常見的做法是註冊一家行情數據服務商、申請 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 / 幻方無官方從屬關係）