前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常開發時，經常需要掃一眼 A 股、港股、美股或外匯、期貨的現價，又不想單獨開交易軟件或網頁圖表。常見做法是瀏覽器書籤或第三方 App，和 Harness 窗口是割裂的。dsh-marketboard 是 stitchmaps 維護的 DSH Client 原生插件：把多市場標的收進一塊自選看板，只展示列表與實時價，不帶 K 線圖表，並跟隨 DSH 明暗主題與語言設置。
這是什麼¶
dsh-marketboard（DeepSeek Harness 行情看板）面向 DSH Web GUI 桌面端，分類屬於聯網工具。Host 側拉取公開行情接口，Browser 側通過本地 API 渲染 React 界面；自選、設置與自定義分組寫在宿主機 <DSH_HOME>/dsh-marketboard/data.json，不使用 localStorage。插件只讀行情，不提供下單能力。
維護者與倉庫：GitHub stitchmaps/dsh-marketboard，當前 package 版本爲 0.2.1，許可證 MIT。
核心功能¶
七類市場，一塊看板¶
默認分組覆蓋 A 股（cn）、港股（hk）、美股（us）、外匯（fx）、國內商品期貨（futcn）、國際商品期貨（futgl）與全球指數（index）。首次運行內置 49 個 curated 標的示例；可按分組篩選、在自選內搜索、按漲跌幅排序。
自動刷新與 stale 標記¶
默認支持 3 / 5 / 10 / 30 / 60 秒自動刷新，可暫停/恢復、手動刷新。上游異常時會對陳舊報價做標記；成功拉到的報價緩存 15 分鐘，缺數據時再走備用源。
自選與自定義分組¶
星標置頂，一鍵移除；通過搜索或手動代碼表單添加。除不可刪的默認市場分組外，可新建、重命名、刪除自定義分組，並勾選成員；不同市場的標的可以放進同一個命名集合。
看板信息密度¶
除現價外，界面提供漲跌家數、平均漲跌、領漲/領跌、最後更新時間、日內區間位置、開盤價與昨收等彙總信息，而不是簡單表格堆疊。
數據來源（無需 API Key）¶
Host 使用公開接口批量拉價，每輪刷新主源最多兩次批量請求，仍缺失的標的再 fallback：
| 資產 | 主源 | 備用 |
|---|---|---|
| A 股 / 港股 / 美股 / A 股指數 | 騰訊 qt.gtimg.cn |
新浪 hq.sinajs.cn |
| 外匯 | 新浪 fx_s* |
Yahoo Finance chart |
| 國內商品期貨 | 新浪 nf_* |
— |
| 國際商品期貨 | 新浪 hf_* |
Yahoo Finance chart |
| 全球指數 | 新浪 int_* |
Yahoo Finance chart |
行情可能延遲、不完整或暫時不可用；僅供個人參考，不構成投資建議。
與 Harness 的集成方式¶
UI 僅使用主題 token 配色，支持 zh/en 本地化，響應式佈局；Client 用本地 React 控件實現，不依賴 Harness Client 包 import。Browser 通過相對路徑訪問 api/dsh-marketboard/...，適配 DSH 桌面 Web GUI 的 IPC fetch。
安裝與啓用¶
倉庫是 DSH bundle（dsh.bundle.patch + dsh.client）。官方 README 給出兩種方式，不要憑插件名拼接 dsh plugin add github:...。
方式 A — DSH CLI（將路徑換成本機 clone 或解壓後的絕對路徑）：
dsh plugin --profile desktop add file:/absolute/path/to/dsh-marketboard
方式 B — Plugin Manager
在 DSH Plugin Manager 中將倉庫目錄添加爲本地 bundle，再啓用。
安裝後刷新 DSH Web GUI（Ctrl+R）。若 Host 半部已在運行，需重新加載 profile patch（移除並重新添加 dsh-marketboard 的 insert 行），或重啓桌面應用一次。
環境要求（README 已驗證項）：
- DSH：
>= 0.2.0-rc.2 || >= 0.2.1-rc.2 - Node：
^22.19.0 || >= 24.0.0 - 平臺：Web GUI
典型用法¶
經過上面的安裝步驟後，可按 README 順序操作：
- 在左側導航打開 Marketboard。
- 用分組 chip 切換市場或自定義分組；默認市場分組自動生成且不可刪除。
- 點 New group 創建自定義集合並勾選成員；用 Manage 重命名或刪除自定義分組。
- 點 Add symbol 按名稱/代碼搜索，或手動輸入代碼。當前若選中自定義分組，新標的也會加入該組。
- 懸停行：星標置頂，
×移除。 - 工具欄可暫停自動刷新，也可隨時手動刷新。
- 打開 Settings 調整刷新間隔、漲跌配色（紅漲綠跌或相反）與界面密度。
手動添加代碼時，README 給出的格式示例包括：A 股 600519 或 sh600519；港股 00700；美股 AAPL、BRK.B；外匯 EURUSD、EUR/USD；國內期貨 RB0 / RB；國際期貨 CL、CL=F；指數 sh000001、^GSPC 等。
Host 側主要 API 均爲 POST JSON，例如 /api/dsh-marketboard/state（讀寫自選與設置）、/api/dsh-marketboard/quotes（拉當前報價）、/api/dsh-marketboard/search（內置目錄與騰訊股票搜索）。寫入由 Host 校驗與規範化 ID，瀏覽器不自行生成標識。
適用場景與注意¶
適合誰：在 DSH 桌面環境裏工作、需要同時盯多市場列表價、又不需要圖表的交易員式參考或開發者。
隱私：無賬號、Cookie、API Key，無遙測；Browser 只訪問本地 DSH API，Host 才訪問公開行情/搜索端點；自選與設置不離開本機。
安全與合規：插件以當前 DSH 進程權限運行，安裝前應閱讀源碼與 MIT 許可證，並自行遵守上游數據提供方條款。社區目錄頁 skillhub.cn 插件條目 與 DeepSeek / 幻方無官方從屬關係，DSH 生態理念是「一切皆插件」，本文介紹的是社區維護的聯網工具，而非官方應用商店內置應用。
結尾¶
dsh-marketboard 把 A 股、港股、美股、外匯、國內外期貨與指數收進一塊 Harness 原生看板：自選持久化、自定義分組、可配置刷新，Host 批量拉價且無需 API Key。需要詳情、Issue 或本地 bundle 結構時，見目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/stitchmaps/dsh-marketboard
- GitHub：https://github.com/stitchmaps/dsh-marketboard
