前言¶

在 DSH 裏做智能體或日常開發時，常會需要快速掃一眼持倉或指數，又不想切到券商客戶端或單獨開行情站。專業看盤與交易仍應交給券商與專業軟件；若在 Harness 同一套 Web 界面裏掛一塊延遲公開行情、只讀、不接交易的股票看板，摸魚盯盤會省不少上下文切換。下面介紹社區插件 寰鏡股票看板 MarketLens（@suifei/dsh-market-lens），由維護者 suifei 發佈，分類爲聯網工具，源碼與包見 GitHub 與 SkillHub 目錄頁。

這是什麼¶

一句話定位：給散戶在 DSH Web 面板裏看自己股票情況的只讀看盤·盯盤看板——極致簡單，行情分析與交易請用專業軟件。

• 覆蓋 A 股（滬/深/北）、港股、美股 的指數與個股；板塊視圖在後續版本。
• 數據來自公開免費接口的延遲行情（非 Level-2），UI 會常駐標註；不做下單、撤單、持倉盈虧、量化執行或任何寫操作（連配置寫回都沒有）。
• 當前包版本以 npm 爲準（資料中 package.json 爲 0.34.8）；README 寫明 0.27.1 起依賴 schemastery/dsh-tools 可正常解析，0.29.0 起證券大廳爲 WebGL2 燈牆管線。

架構與數據流¶

行情抓取只發生在 DSH 宿主側；瀏覽器裏的 React 面板通過同源 HTTP 訪問 /market-lens/*，不直連外部行情源。

瀏覽器（DSH Web GUI）                      Node（DSH Host）
┌─────────────────────────┐   同源 HTTP   ┌──────────────────────────┐
│ client.js  React 面板     │ ───────────→ │ index.js                  │
│ · 側欄入口與主面板         │  /market-lens│  · 只讀路由與工具          │
│ · Canvas 自繪 K 線        │   /*        │  lib/service.js 緩存/降級  │
│ · localStorage 自選/偏好  │             │  sources: 東方財富/騰訊/Yahoo │
└─────────────────────────┘             └──────────────────────────┘

智能體側還提供三個只讀模型工具：market_search、market_quotes、market_kline，與面板共用同一套 createMarketService；描述中寫明只讀、不涉及交易，且沒有下單類寫工具。

多源按市場降級（單源失敗自動切換；全鏈失敗時 quotes 返回 failed[]，有緩存時可能帶 stale: true）：

核心功能¶

三列看盤首頁¶

指數條、自選列表（代碼主視覺 + 微型趨勢線 + 漲跌膠囊 + 市場狀態條）、K 線（MA、量副圖、框選放大），以及詳情卡、提醒、財報（A 股）、資訊等右欄能力。輪詢在上一請求完成後再排下一次；標籤頁隱藏時暫停，回前臺立即刷新。

證券大廳¶

頂部工具欄可進入 800×450 燈牆大屏（桌面版安裝後左側欄有「寰鏡股票看板」，點「證券大廳」進入）。大廳爲固定燈格矩陣，離屏原生渲染後等比縮放居中顯示，與窗口分辨率解耦。

符號與搜索¶

內部符號與騰訊公開接口詞表一致（如 sh600519、hk00700、usAAPL）；輸入支持多種常見寫法，裸 6 位 A 股代碼可按規則推斷市場。搜索支持代碼、中文名、拼音全拼與拼音首字母（如 gzmt → 貴州茅臺）。

宿主 HTTP 接口（摘錄）¶

同源護欄下提供只讀路由，例如：

• GET /market-lens/quotes?symbols=...（≤200 個符號）
• GET /market-lens/kline?symbol=...&period=day|week|month&count=20-320
• GET /market-lens/search?q=...
• GET /market-lens/meta（輪詢間隔、默認自選、免責聲明等）

QuoteRow 中缺失字段爲 null，UI 顯示 —，不補零。K 線前復權在宿主側固定，UI 與工具不暴露復權參數。

安裝與啓用¶

安裝走 DSH 自帶的 dsh plugin：會加依賴並把 bundle 寫入 dsh.profile.bundles，一般無需手改 patch。

桌面版（DSH Desktop）¶

dsh plugin --profile desktop add @suifei/dsh-market-lens

裝完後重啓 DSH Desktop；左側欄出現「寰鏡股票看板」，可從頂部進入證券大廳。

Web 版（dsh web）¶

dsh plugin --profile web add @suifei/dsh-market-lens
dsh web

換端口可用 dsh web --port 8080。瀏覽器從左側欄進入；升級或改配置後刷新頁面即可。

釘版本、快照與卸載¶

dsh plugin --profile desktop add @suifei/dsh-market-lens@0.34.3
dsh plugin --profile desktop add github:suifei/dsh-market-lens#<40 位 commit>
dsh plugin --profile desktop remove @suifei/dsh-market-lens

也可在 DSH「插件管理」界面按包名安裝，效果等價。

不使用 dsh plugin 時，可在 profile 的 cordis.patch.yml 中手動 insert 掛載（id: market-lens，name: '@suifei/dsh-market-lens'）；可選 config 含 diagLevel、pollIntervalMs、scrollVpx 等，詳見 README 配置節。

典型用法¶

1. 日常盯盤：安裝並啓動對應 profile 後，在側欄打開寰鏡股票看板，維護自選列表（存於瀏覽器 localStorage），觀察延遲報價與 K 線；需要總覽時進入證券大廳。
2. 智能體問價：在對話中讓模型調用 market_quotes / market_kline / market_search，參數上限與路由一致（例如 symbols ≤200，kline count 20–320）。
3. 調參與排障：在 cordis.patch.yml 行內 config 可改 pollIntervalMs（默認 5000）、scrollVpx（大廳滾動速度，0 爲凍結）等；diagLevel 爲日誌總開關（發佈默認 errors），診斷日誌默認落在 ~/.dsh/market-lens/marketlens-diag-<日期>.jsonl，可通過 GET /market-lens/diag?tail=50 回讀。

適用場景與注意¶

適合：已在用 DSH Desktop 或 dsh web 的開發者，希望同源面板裏輕量看延遲行情、搜代碼、拉 K 線或讓模型只讀查價，且明確不需要交易能力。

不適合：需要 Level-2、極低延遲、實盤下單或持倉同步的場景——插件 deliberately 不接任何交易端。

安全與權限：插件以當前 dsh 進程權限運行，會向東方財富、騰訊、Yahoo 等公網源發起只讀 GET；安裝前請查看 源碼倉庫 與 MIT 許可證，自行評估網絡與合規要求。SkillHub 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係；Harness 生態理念是「一切皆插件」，本包是社區維護的聯網工具之一（目錄頁標註星標等信息以站點爲準）。

結尾¶

寰鏡 MarketLens 把 A 股、港股、美股的延遲公開行情收進 DSH Web 面板與只讀模型工具，強調簡單與不交易。若要在本機試用，從目錄頁或 README 覈對最新版本後，用上面的 dsh plugin 命令裝入對應 profile 即可。

• 目錄頁：https://www.skillhub.cn/plugins/suifei/dsh-market-lens
• GitHub：https://github.com/suifei/dsh-market-lens