DeepSeek Harness 金融市場監控插件：dsh-market-watch

在 DeepSeek Harness (DSH) 的插件生態中，獲取實時數據是擴展智能體能力的關鍵一環。對於需要處理金融場景的開發者或用戶，dsh-market-watch 提供了首個專門針對金融市場數據的功能集。它不依賴昂貴的私有接口，而是利用免費公共數據源（如騰訊財經、CoinGecko）來提供行情、自選股管理和圖表展示。

插件概覽¶

dsh-market-watch 是一個金融監控工具包，主要解決在本地或 DSH 環境下實時追蹤股票、指數和加密貨幣的需求。

核心價值：基於免費數據源提供實時報價、本地持久化自選股、閾值警報、定期輪詢以及 ASCII/mermaid 圖表。
維護者：JohnXu22786
開源協議：MIT

核心功能¶

插件通過 DSH 的工具系統和獨立的命令行接口（CLI）提供以下能力：

實時報價：支持 A 股（上交所/深交所/北交所）、指數及加密貨幣。數據主要來自騰訊財經的免費接口和 CoinGecko 公共 API。
本地自選股：在本地持久化存儲關注列表（代碼/名稱/市場/類型），插件與 CLI 共享同一數據源，無需重啓即可生效。
閾值警報：支持設置價格或漲跌幅度的觸發條件（gt/gte/lt/lte）。警報在每次輪詢時觸發，並支持冷卻時間（cooldown）以防止頻繁打擾。
定期輪詢：內置定時器，自動刷新自選列表。輪詢邏輯會丟棄重疊的請求，且對免費數據源友好。
圖表渲染：支持在聊天中渲染 ASCII 柱狀圖、折線圖以及 Mermaid xychart-beta 流程圖。

安裝與啓用¶

在安裝前，請確保環境滿足以下依賴要求：

Node.js：版本需爲 ^22.19 || >=24
DeepSeek Harness (dsh)：版本需爲 >=0.1.0-rc.6
Profile：需使用 web 或 headless profile

安裝過程如下：

確保已安裝 Node.js 和 dsh。
將插件代碼克隆或放置到本地目錄。
在該目錄下執行安裝命令：

dsh plugin --profile web add .

安裝成功後，插件會自動註冊到 DSH 的配置中，並在重啓後生效。可以通過 dsh config dump | grep market-watch 檢查插件是否正確加載。

典型用法¶

插件提供了 6 個 DSH 工具和一套獨立的 CLI 工具，它們操作相同的數據目錄。

命令行工具 (CLI)¶

dsh-market-watch 是獨立的命令行程序，適合在終端中手動執行：

查詢行情：

    dsh-market-watch quote sh600000 bitcoin --days 5

這將輸出浦發銀行（600000）和比特幣的最新報價，並附帶最近 5 天的迷你走勢圖。

管理自選股：

    dsh-market-watch watch sh600000 bitcoin --name "BTC"

添加股票代碼和幣種到本地自選列表。

查看列表：

    dsh-market-watch list

管理警報：

    dsh-market-watch alert add bitcoin --field price --op gte --value 70000 --cooldown 600

設置比特幣價格達到 70000 時觸發警報，冷卻時間爲 600 秒。

繪製圖表：

    dsh-market-watch chart sh600000 --days 30 --format mermaid

生成 30 天的 Mermaid 格式圖表。

執行單次輪詢：

    dsh-market-watch poll --once

DSH 工具¶

插件註冊了以下工具，智能體在對話中可直接調用：

quote：查詢最新報價。
list：列出當前自選股。
watch：添加關注對象。
unwatch：移除關注對象。
alert：管理警報規則。
chart：生成圖表。

適用場景與注意事項¶

適用場景：
* 需要在 DSH 環境中實時追蹤 A 股或加密貨幣的用戶。
* 需要構建具備金融監控能力的智能體。
* 需要在本地持久化存儲交易計劃或關注列表的開發者。

重要注意事項：

數據延遲：由於使用免費公共數據源，行情數據可能存在幾秒到幾分鐘的延遲，並不等同於交易所的實時撮合價格。
數據來源：
- A 股/指數：騰訊財經接口。
- 加密貨幣：CoinGecko 公共 API（注意免費 Tier 的速率限制）。
投資建議：本插件提供的所有數據均爲免費公共數據，不構成任何投資建議。請勿僅基於延遲數據做出交易決策。

結語¶

dsh-market-watch 爲 DSH 生態引入了金融數據能力，通過 CLI 和工具系統的雙重入口，實現了從查詢到可視化的完整閉環。對於需要處理金融場景的開發者，這是一個可以直接落地的工具。更多細節及源碼，請參考插件目錄或 GitHub 倉庫。