前言¶
DeepSeek Harness 的 agent 在處理個股行情、財報、分析師觀點和新聞等問題時，如果沒有結構化的市場數據工具，通常會退回到網頁搜索和 shell 命令，再逐頁抓取、解析 HTML。dsh-us-stocks 是一個面向 DeepSeek Harness 的插件，由 Realyujie 維護，基於 yahoo-finance2 提供一組服務器端 agent 工具，用於查詢美股行情、價格歷史、財務報表、分析師共識、新聞和持倉信息。
這是什麼¶
- 包名：
dsh-us-stocks - 倉庫路徑：
Realyujie/dsh-us-stocks - 許可證：MIT
package.json聲明版本：0.3.0- 依賴：
yahoo-finance2 ^4.0.2
它註冊的是服務器端 agent 工具。在 web profile 中，它還會附帶一個瀏覽器側組件，用於繪製 get_history 對應的 K 線圖；在 TUI 或 headless profile 中，瀏覽器側組件不存在，但所有工具仍然可用。
核心工具¶
| 工具 | 返回內容 |
|---|---|
get_quote |
最新價、漲跌、日內區間、成交量、市值、P/E、EPS、賬面價值、股息率、52 周區間、移動平均線、最近和下一次財報日期 |
get_history |
日線、周線、月線的 OHLCV 數據，包含調整後的收盤價，以及窗口內的分紅和拆股信息 |
get_financials |
利潤表、資產負債表和現金流量表科目，可按季度或年度查詢 |
get_analyst_view |
共識評級、按月的買入/持有/賣出數量、目標價、前瞻 EPS 和營收預測、近期券商上調和下調、EPS beat/miss 歷史 |
get_news |
近期新聞標題，包含發佈方、時間戳和鏈接 |
get_ownership |
內部人與機構持股比例、最大機構和基金持有人、內部人近六個月買入和賣出情況 |
基金報價字段會附帶 caveats，涉及費用率準確性、滾動收益口徑和重倉持倉覆蓋範圍。這些說明會隨響應字段一起出現，避免把基金層面的彙總指標誤解爲單一公司的估值數據。
安裝與啓用¶
下面介紹幾種安裝方式。安裝完成後，需要重啓 profile，因爲插件在啓動樹構造成型時纔會被解析。
通過 Harness 安裝¶
如果當前環境已經可以訪問倉庫，可以直接對 DeepSeek Harness 說：
Install this plugin: https://github.com/Realyujie/dsh-us-stocks
安裝過程中可能會請求文件系統權限，因爲 profile 目錄位於 session workspace 之外。
手動安裝¶
如果 dsh 已在 PATH 中，可以執行：
dsh plugin --profile web add dsh-us-stocks
如果 dsh 不在 PATH 中，可以通過 npx 調用：
npx @deepseek-ai/dsh plugin --profile web add dsh-us-stocks
這裏的 dsh plugin 會在 profile 目錄內轉發到 pnpm，並保持 profile 的 dsh.profile.bundles 列表同步，因此不需要手動註冊插件。
更新插件¶
之後更新時，可以執行：
dsh plugin --profile web update dsh-us-stocks
本地開發¶
如果要指向本地 checkout，可以使用 link: 路徑：
dsh plugin --profile web add link:/absolute/path/to/dsh-us-stocks
本地開發時，代碼改動通常需要執行構建流程並重啓 profile 後生效。
典型用法¶
安裝完成後，可以要求 Harness 使用這些工具查詢指定 ticker。例如，圍繞一個 ticker，可以分別請求：
get_quote：獲取當前報價和基礎估值字段get_history：獲取日線、周線或月線 OHLCV 數據get_financials：獲取季度或年度財務報表科目get_analyst_view：獲取共識評級、目標價和近期調整記錄get_news：獲取近期新聞標題get_ownership：獲取內部人和機構持倉情況
倉庫還提供了基準腳本。可以執行：
npm run benchmark
也可以指定另一個 ticker：
npm run benchmark -- TTMI
適用場景與注意¶
這個插件適合需要在 DeepSeek Harness 中查詢結構化美股數據的場景，尤其是希望減少網頁抓取、HTML 解析和多次 shell 調用的任務。
使用前後需要注意：
- 插件會在當前 DSH 的權限上下文中運行，安裝前應檢查源碼、依賴和許可證。
- 安裝可能請求 profile 目錄的文件系統權限，因爲該目錄位於 session workspace 之外。
- 插件按 MIT 許可證發佈，
package.json中聲明版本爲0.3.0。 - 在 TUI 或 headless profile 中，瀏覽器側組件不存在，但工具調用仍然可用。
- 基金報價字段存在口徑和覆蓋範圍限制，應結合響應中的 caveats 使用。
結尾¶
dsh-us-stocks 的價值在於把美股行情、財報、分析師觀點、新聞和持倉查詢收斂爲一組明確的 agent 工具，而不是讓 agent 在網頁和 shell 中反覆摸索。
- GitHub：https://github.com/Realyujie/dsh-us-stocks
- 目錄頁線索（未獨立覈實）：https://www.skillhub.cn/plugins/Realyujie/dsh-us-stocks
