前言¶
在 DSH 裏問股票相關問題，模型若只靠訓練數據回答，價格、漲跌、財務口徑很容易過時或失真。常見做法是自己在對話外查行情站、寫腳本調 API，再把結果貼回對話；或者單獨配 MCP 服務器、維護 JSON 配置。ashareapi 官方提供的 ashareapi-dsh-plugin 走另一條路：把 ashareapi.com 的 MCP 服務掛進 DSH，Agent 在對話中通過工具拉取實時或結構化 A 股數據。下面介紹它是什麼、能做什麼，以及桌面端、Web UI 和命令行怎麼裝、怎麼用。
這是什麼¶
ashareapi-dsh-plugin 是 A 股數據 API 的 DeepSeek Harness 插件，維護者爲 ashareapi。插件本身不含行情計算或多源邏輯，只負責把遠端 MCP 端點註冊到 DSH；傳輸、工具註冊、斷線重連由 DSH 自帶的 MCP 客戶端處理。底層默認連接 https://api.ashareapi.com/mcp。
裝上之後，例如在 DSH 裏問「600667 現在多少錢」，Agent 會調用對應工具返回真實數據，而不是編造數字。npm 包版本爲 0.1.3，許可證 MIT，運行要求 Node.js ≥ 20、dsh ≥ 0.2.0-rc.2。
核心功能¶
插件共暴露 31 個 A 股相關工具（在 DSH 中名稱形如 mcp__ashareapi__ashare_quote）。能力覆蓋行情、K 線、分時、五檔盤口、財務、資金流、龍虎榜、板塊、因子選股、宏觀、可轉債、量化回測等，與 README 中的工具列表一致。
無需 API Key 即可使用的 5 個工具：
ashare_quote：實時快照ashare_kline：K 線（固定前復權，無adjust參數）ashare_hot：熱搜榜ashare_changedist：漲跌分佈ashare_market_overview：市場總覽
其餘 26 個工具（如 ashare_orderbook、ashare_finance、ashare_backtest 等）需要在 ashareapi 定價頁 獲取 Key 後配置。
README 還說明了若干服務端行爲（由 ashareapi 後端承擔，非插件本地實現）：多數據源互爲備份、K 線口徑固定、停牌等「市場無數據」與取數失敗區分返回、工具描述面向 Agent 編寫。插件倉庫僅含 index.js 與配置，零運行時依賴。
安裝與啓用¶
桌面端 / Web UI（推薦）¶
- 從 DeepSeek Harness 桌面端下載頁 安裝客戶端（macOS / Windows）。
- 打開左側「插件」頁面，輸入包名並安裝：
ashareapi-dsh-plugin
Web UI（dsh web）使用同一「插件」頁面，操作相同。README 註明：桌面端 profile 由桌面應用管理，不能用下面命令行的 plugin add 裝桌面端；桌面端請只用插件頁面。
裝完後重啓或重新打開 DSH，即可在對話中使用。命令行與 Web UI 安裝會調用本機 pnpm（DSH 不自帶；桌面端自帶一份）；未安裝時可先執行 npm i -g pnpm。
命令行（Web profile）¶
啓動 Web UI：
npx @deepseek-ai/dsh web
添加插件：
npx @deepseek-ai/dsh plugin --profile web add ashareapi-dsh-plugin
若已全局安裝 dsh，可將 npx @deepseek-ai/dsh 替換爲 dsh。裝完後重啓 dsh web 生效。啓動前可檢查配置是否掛上：
npx @deepseek-ai/dsh --profile web --dump-config
輸出中應出現 # == ashareapi-dsh-plugin。
其他安裝方式（命令行）：
# 從 GitHub
npx @deepseek-ai/dsh plugin --profile web add github:ashareapi/ashareapi-dsh-plugin
# 從本地目錄（開發調試）
npx @deepseek-ai/dsh plugin --profile web add file:/絕對路徑/ashareapi-dsh-plugin
卸載：
npx @deepseek-ai/dsh plugin --profile web remove ashareapi-dsh-plugin
配置 API Key（可選）¶
5 個免費工具不用配置即可調用。要用其餘工具，在 ~/.dsh/.env（或 $DSH_HOME 對應目錄）增加：
ASHAREAPI_KEY=ct-你的KEY
或在 profile 的 cordis.patch.yml 中按 id 覆蓋（Web / 命令行爲 ~/.dsh/profiles/web/cordis.patch.yml）：
- id: mcp-ashareapi
name: ashareapi-dsh-plugin
config:
apiKey: ct-你的KEY
可配置項還包括 url（默認 https://api.ashareapi.com/mcp）、serverName（默認 ashareapi）、headers 等；字段說明見倉庫 README。
典型用法¶
裝好後在對話裏直接用自然語言提問，Agent 會選用對應工具。README 給出的對應關係示例：
| 你可以這樣問 | 會用到的工具 |
|---|---|
| 600667 現在多少錢？ | ashare_quote |
| 幫我拉一下 600667 最近 60 天的日 K | ashare_kline |
| 今天市場什麼情況？ | ashare_market_overview |
| 現在大家都在看什麼股票？ | ashare_hot |
| 今天漲跌家數怎麼分佈？ | ashare_changedist |
參數、返回字段與樣例見 ashareapi 文檔 與 端點清單。
適用場景與注意¶
適合誰： 已在用 DeepSeek Harness（桌面端、Web UI 或 CLI）做研究、問答或自動化流程，希望在同一對話裏查 A 股行情、K 線、市場概覽或（配 Key 後）財務、板塊、回測等數據的開發者與量化/投研使用者。
分類： 社區目錄將其歸爲「聯網工具」；目錄站點 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係，DSH 生態本身是「一切皆插件」的擴展方式。
安全與權限： 插件以當前 dsh 進程權限 運行，會向配置的 MCP URL 發起網絡請求；安裝前建議查看 GitHub 源碼 與 MIT 許可證，並妥善保管 ASHAREAPI_KEY，勿提交到公開倉庫。
不用 DSH 時： 同一 MCP 服務也可在其他支持 MCP 的客戶端中通過 URL 接入，說明見 ashareapi MCP 頁。
結尾¶
ashareapi-dsh-plugin 把官方 A 股 MCP 以最小配置接入 DSH：包名安裝、5 個免費工具免 Key、31 個工具覆蓋從快照到量化回測的常見需求。需要進一步瞭解可訪問插件目錄頁 skillhub.cn/plugins/ashareapi/ashareapi-dsh-plugin 與倉庫 github.com/ashareapi/ashareapi-dsh-plugin。
