前言¶
在 DeepSeek Harness（DSH）裏做與投資相關的能力時，常見做法是散點調用行情 API、另開瀏覽器查術語、再用日曆記財報。數據是非實時的 EOD，規則與縮寫又分散在多處，面板裏很難形成一條可用的工作流。
dsh-us-stocks 由維護者 turboYuu 發佈，歸類爲聯網工具。插件把行情（收盤日線）、內置知識庫、財報日曆、技術指標、提醒、規則引擎問答和組合對比放進 DSH 左側「美股」入口，在單一面板內完成從查詞到盯自選、記提醒的常見步驟。行情明確爲免費日線收盤數據，界面標註「收盤數據 · 非實時」，與盤中實時行情工具的定位不同。
倉庫：https://github.com/turboYuu/dsh-us-stocks；社區目錄頁：https://www.skillhub.cn/plugins/turboYuu/dsh-us-stocks。許可證爲 MIT（見倉庫 README）。
插件定位¶
dsh-us-stocks 是嵌在 DSH 宿主裏的美股助手插件（當前 package 版本 0.6.2）。宿主半 index.js 負責數據代理、緩存、路由與持久化；瀏覽器半 client.js 負責側欄入口與主面板 UI。用戶數據與偏好寫入本地文件：
$DSH_HOME/dsh-us-stocks.json
默認路徑爲 ~/.dsh/dsh-us-stocks.json。
核心功能¶
下面按 README 中的模塊說明已覈實能力；未配置 Finnhub API Key 時，行情、知識庫、提醒及問答中的知識庫部分仍可使用，基本面相關能力需要 Key。
行情（日線 EOD）¶
- 指數概覽：標普 500、道瓊斯、納斯達克 100、納斯達克綜合。
- 自選股：添加或移除代碼，展示收盤價、漲跌額與漲跌幅。
- 日 K 線：近一年日線；優先
lightweight-charts，不可用時降級 SVG 蠟燭圖。 - 基本面：市盈率、市值、股息率、貝塔、每股收益、ROE、52 周高低等（需 Finnhub Key）。
- 搜索：按代碼或名稱（Yahoo 搜索源；國內可能不可用，失敗時靜默降級）。
知識庫¶
內置 60+ 條（M3），分專業術語、縮寫速查、K 線圖解、技術指標、市場規則五類；支持搜索與分類篩選，語言跟隨 DSH 設置。K 線條目帶 OHLC 示意數據，客戶端可渲染小蠟燭圖。
財報日曆、技術指標與提醒¶
- 財報日曆（M2）：自選股未來 7 天財報（Nasdaq 官方日曆，免 Key），可一鍵加財報提醒。
- 技術指標（M2）：主圖 MA(5/20/50)、BOLL(20,2)；副圖 RSI(14)、MACD(12,26,9)。
- 提醒與日程（M5）：美東市場時鐘、開收盤提醒、價格上下穿、財報提前 N 天、免打擾時段；面板提示條與瀏覽器通知（頁腳「開啓通知」）。
智能問答、組合與個性化¶
- 智能問答（M4）：規則引擎路由術語/規則/指標到知識庫，個股行情到 Nasdaq，基本面到 Finnhub，財報日期到 Nasdaq 日曆；回答帶來源、時間戳與免責聲明。
- 組合與對比（M6）：手動錄入持倉跟蹤、多股對比與歸一化走勢、CSV/JSON 導出。
- 個性化：K 線綠漲紅跌或紅漲綠跌、難度等級、主題與語言跟隨 DSH。
數據源與網絡¶
README 說明 Yahoo Finance 在中國大陸不可達後，插件改用下表來源（節選）：
| 數據 | 來源 | 需 Key |
|---|---|---|
| 個股報價 / 日線歷史 | Nasdaq 官方 API（api.nasdaq.com） |
否 |
| 標普 500 / 道瓊斯 | 東方財富（push2.eastmoney.com） |
否 |
| 財報日曆 | Nasdaq 官方財報日曆 | 否 |
| 基本面 / 財報數據 | Finnhub | 是 |
| 財報原文 | SEC EDGAR | 否 |
安裝與使用需能訪問 api.nasdaq.com、push2.eastmoney.com 等端點；插件在 DSH 進程權限下發起聯網請求，安裝前宜自行審閱源碼與許可證。
安裝與啓用¶
環境要求：DSH 桌面端或 Web 端；Node.js ≥ 18（安裝依賴）；可訪問上述行情相關域名。
推薦通過 DSH 插件管理 → 安裝，在輸入框填入 package spec（原文示例）：
github:turboYuu/dsh-us-stocks
也可使用：
git+https://github.com/turboYuu/dsh-us-stocks.git
或倉庫 URL https://github.com/turboYuu/dsh-us-stocks。確認後 DSH 會用 pnpm 拉取代碼並安裝依賴（含 lightweight-charts）。安裝完成後 啓用 插件並刷新頁面。若索引已收錄，可在「插件市場」搜索 dsh-us-stocks。
加載成功後左側欄出現「美股」入口；宿主半 index.js 變更需重載插件（禁用再啓用或重啓 DSH），client.js 變更刷新頁面即可。
配置 Finnhub API Key（可選）¶
- 打開「美股」面板 → 頁腳「設置」。
- 填入 Finnhub API Key → 保存，狀態爲「已配置」即生效。
或通過環境變量：
export FINNHUB_API_KEY=你的_key
優先級：環境變量高於界面設置。免費 Key 可在 https://finnhub.io 申請；Key 以明文保存在本機 dsh-us-stocks.json。
典型用法¶
面板入口¶
主面板頂部六個標籤：行情 / 問答 / 日曆 / 提醒 / 組合 / 知識庫；頁腳爲 設置 與 開啓通知。
問答快捷句¶
README 給出的示例提問包括：什麼是 ETF、PE 是什麼、AAPL 行情、美股交易時間。
調試與健康檢查¶
開發時可請求宿主路由，例如：
curl http://127.0.0.1:<端口>/api/us-stocks/health
主要 REST 前綴爲 /api/us-stocks/*（如 quote、candles、knowledge、ask、watchlist 等，詳見 README 接口表）。
適用場景與注意¶
適合在 DSH 工作流內做美股收盤日線查閱、術語學習、財報日前提醒與自選股對比的用戶；不適合需要盤中實時報價的場景。搜索與部分數據源在國內網絡下可能失敗或降級，應以界面實際結果爲準。
插件屬於 DSH 社區生態中的第三方聯網工具，與 DeepSeek / 幻方無官方從屬關係；社區目錄 skillhub.cn 爲獨立站點。使用前請確認本機 DSH 版本、Node 版本與網絡策略滿足 README 要求。
結尾¶
dsh-us-stocks 把日線行情、知識庫、日曆、指標、提醒和問答收斂到 DSH 單一入口，減少在多個站點之間切換。進一步說明與版本歷史見 GitHub README：https://github.com/turboYuu/dsh-us-stocks；目錄頁：https://www.skillhub.cn/plugins/turboYuu/dsh-us-stocks。
