前言¶
在構建 DeepSeek Harness 代理時，讓它們具備訪問實時金融數據的能力是一項常見需求。通常這需要開發者手動接入第三方 API。dsh-stock-lookup 插件通過封裝兩個工具，直接解決了“從公司名稱/代碼到實時行情”這一鏈路的問題。
是什麼¶
這是一個由 minyang-chen 維護的 DeepSeek Harness 插件。它爲代理提供兩個核心工具：stock_resolve 和 stock_profile。前者用於解析公司名稱或部分代碼爲股票符號，後者用於獲取實時報價和公司概況。
安裝與啓用¶
安裝插件需要執行以下命令：
dsh plugin --profile web add github:minyang-chen/dsh-stock-lookup
安裝或更新後，必須重啓 DSH 才能生效：
dsh web
核心功能¶
stock_resolve¶
該工具用於將公司名稱、部分名稱或代碼解析爲標準股票符號。
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
query |
string | 是 | 公司名稱、部分名稱或代碼，例如 "Apple"、"nvidia"、"TSLA" |
limit |
number | 否 | 最大返回結果數（1-10），默認爲 5 |
返回信息：股票代碼（ticker）、CIK、官方公司名稱、以及直接指向 SEC EDGAR 文件的鏈接。
stock_profile¶
該工具通過 Yahoo Finance 獲取指定股票代碼的實時報價和詳細資料。
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
ticker |
string | 是 | 股票代碼，例如 "AAPL"、"NVDA"、"BRK-B" |
返回信息：包括當前價格、漲跌幅、市盈率（P/E）、市值、板塊、行業、公司描述等。
典型用法¶
代理會自動選擇合適的工具。以下是可以直接使用的示例：
- 直接查詢價格：
What is Apple's current stock price?
代理會直接調用 stock_profile。
- 公司名 -> 代碼 -> 概況：
What sector is Nvidia in?
代理會先調用 stock_resolve 找到 NVDA，再調用 stock_profile 獲取板塊信息。
- 模糊名稱查詢：
Look up Amazon stock
代理會解析出 AMZN 並提供後續操作。
- 獲取 SEC 文件鏈接：
Give me the SEC EDGAR filing link for Microsoft
代理會調用 stock_resolve 並返回 SEC EDGAR 的直接鏈接。
- 批量查找：
Find all companies with "apple" in the name
返回最多 10 個匹配結果，包含代碼、CIK 和 EDGAR 鏈接。
配置與注意事項¶
配置項¶
插件提供以下配置：
| 配置項 | 默認值 | 說明 |
|---|---|---|
enabled |
true |
是否註冊工具 |
quoteTtlMs |
15000 |
行情緩存有效期（毫秒） |
數據源與依賴¶
- 無 API 密鑰：使用該插件不需要申請任何 API 密鑰。
- 外部服務：僅依賴 Yahoo Finance 獲取實時數據。
- SEC 數據：解析功能使用捆綁的 SEC EDGAR 公司索引（約 10,000 家美國上市公司）。數據會在 DSH 啓動時檢查，如果超過 7 天會自動從 SEC 官網刷新；若刷新失敗，則使用本地緩存。
總結¶
dsh-stock-lookup 通過封裝 stock_resolve 和 stock_profile，讓代理能夠直接執行股票研究任務。它無需額外配置，依賴開源數據源，適合需要在對話中集成金融數據的 DeepSeek Harness 代理開發場景。
