前言¶

在用 DeepSeek Harness（DSH）寫代碼或查資料時，如果想順便看一眼行情，通常要麼打開另一個網頁，要麼在對話裏粘貼數據。這會打斷思路，也分散注意力。DSH 生態採用「一切皆插件」的設計，插件可以掛載在官方槽位上，既不侵入本體，又能按需加載。

dsh-market-dock 就是一個掛載在 DSH 官方槽位上的行情面板插件。它把 A股、港股、美股的實時行情、K線、熱榜、快訊嵌入到對話框上方和輸入框旁，並自帶本地持倉與盈虧現算、價格提醒，以及一個「行情隱身」開關。這個插件由 xxxSnack 維護，分類爲聯網工具，非雪球官方產品，數據來自雪球公開 Web 接口。

核心功能¶

行情面板¶

面板掛載在 conversation.input.dock，按 Esc 可收起。面板包含 6 個 tab：

• 行情：頂部是四大指數（上證、深證、創業板、滬深300），下方是自選股。點擊任意一行可打開詳情頁。
• 熱榜：實時熱榜列表。
• 搜索：支持中文名、拼音、ticker 與純代碼（如「茅臺」/「maotai」/「600519」/「00700」）。
• 快訊：7×24 快訊。
• 盈虧：當日盈虧 chip，以及盈虧與持倉的統計。
• 持倉：本地持倉列表，可增刪改。

詳情頁展示大號現價、漲跌額/漲跌幅、16 格指標卡、K線（蠟燭 + 成交量 + MA）、分時圖，以及 7 個時間週期（5/15/30/60 分、日/周/月）。

迷你行情徽標¶

徽標掛載在 shell.overlay，是一個獨立懸浮組件。它可拖拽，可摺疊成一行，位置與尺寸會落盤。徽標會輪播自選股與指數漲跌。右上角的 ⊘ 按鈕是「行情隱身」開關，− 按鈕用於摺疊。

指數條¶

在輸入框上方常駐一行四大指數，單獨佔行，不擠佔輸入區。

本地持倉與盈虧¶

「持倉」tab 裏維護持倉數據：代碼、股數、成本價，可隨時增刪改。當日盈虧、持倉盈虧、市值按實時行情現算，不依賴任何賬本接口。

今日盈虧¶

面板頭部常駐一枚盈虧 chip。可選接同花順投資賬本做一次性導入/校對：在「持倉」tab 裏點擊「從賬本同步」，粘貼 Cookie 即可。賬本只在你點擊時請求，不點就一個請求都不發。賬本失效不影響實時盈虧計算。

價格提醒¶

給任意標的設上限/下限，到價會彈系統通知。提醒判定跑在宿主側 watcher 裏，所以面板關着、頁面刷新、徽標摺疊都不影響提醒。瀏覽器未給通知權限時，第一次觸發會提示授權。

行情隱身¶

「行情隱身」一鍵讓面板、徽標、指數條一起卸載（不是 CSS 隱藏），行情輪詢隨之停止——真的一個行情請求都不發；價格提醒仍然生效。恢復有三條路徑：

• 左下角恢復膠囊：屏幕左下角一枚 ● 行情 小膠囊，單擊即可恢復。
• 快捷鍵：Ctrl + Alt + Shift + X（macOS 爲 ⌘ + Alt + Shift + X），可在「設置 → 通用 → 快捷鍵」裏修改。
• Agent 工具：讓 AI 調 xueqiu_display（hidden: false），或直接說「把行情打開」。

隱身狀態是宿主級的：存儲在 $DSH_HOME/dsh-xueqiu/.xueqiu-ui-state.json，刷新、重啓、換工作區、換瀏覽器都保持一致。

Agent 工具¶

插件提供 7 個工具，並在對話裏渲染成 4 張工具卡片：

• xueqiu_quote：實時行情快照（A股/港股/美股/指數/ETF）。
• xueqiu_kline：歷史 K 線（OHLCV + 漲跌幅）。
• xueqiu_search：按名稱/拼音/代碼搜標的。
• xueqiu_hot：熱榜。
• xueqiu_news：7×24 快訊。
• xueqiu_kol：某隻股票的熱議大V。
• xueqiu_display：讀/寫「行情隱身」狀態（{hidden: true｜false}；不傳參即只讀）。

安裝與啓用¶

環境要求¶

面向 DSH 0.2+（宿主 shell 服務改名後的版本），已在該版本驗證；更早版本未做兼容。

安裝命令¶

方式一：作爲 bundle 插件（推薦）

# GitHub 源
dsh plugin --profile web add github:xxxSnack/dsh-market-dock

# 或本地目錄（開發 / 自用最省事）
dsh plugin --profile web add /abs/path/to/dsh-market-dock

裝完後重啓一次 dsh web（插件行發現按啓動緩存），再刷新頁面即可看到面板。

手動接入等價於在 profile 的 package.json 裏寫兩處（~/.dsh/profiles/web/package.json）：

{
  "dependencies": { "dsh-market-dock": "link:/abs/path/to/dsh-market-dock" },
  "dsh": { "profile": { "bundles": ["…", "dsh-market-dock"] } }
}

並讓 node_modules/dsh-market-dock 指向插件目錄（link: 依賴或 symlink，二選一即可）。

方式二：動態插件

倉庫裏的 dynamic/host.js 與 dynamic/client.js 是同一份源碼構建出的動態形態，可在任意 DSH 會話裏用 cordis_define（kind: new）+ cordis_run 加載，不必進 profile。兩個形態能力一致，區別只在安裝方式。

典型用法¶

行情與自選¶

在面板「行情」tab 裏添加自選股，支持搜索。點擊任意一行可查看詳情。右上「刷新」按鈕可手動觸發一次刷新；其餘時候按交易時段自適應刷新，並帶 TTL 緩存與請求節流。

本地持倉與盈虧¶

在「持倉」tab 裏手工添加持倉（代碼 + 股數 + 成本價）。當日盈虧與持倉盈虧會根據實時行情自動計算。如需校對，點擊「從賬本同步」，粘貼同花順投資賬本的 Cookie，完成一次性導入/校對。

價格提醒¶

在詳情頁或列表裏爲某個標的設置上限/下限，到價會彈系統通知。提醒在宿主側 watcher 裏運行，面板關閉或刷新不影響。

行情隱身與恢復¶

• 隱身：面板頭部「隱身」按鈕、徽標上的 ⊘ 按鈕，或對 AI 說「把行情隱身」。
• 恢復：左下角恢復膠囊、快捷鍵 Ctrl + Alt + Shift + X，或讓 AI 調 xueqiu_display（hidden: false）。

適用場景與注意¶

適合在 DSH 中一邊對話一邊查看行情、分析 K線、管理自選與本地持倉，或用 Agent 工具讓模型自己查行情與快訊。插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證（MIT + Apache-2.0 嵌入組件）。

短結尾¶

dsh-market-dock 在官方槽位上提供了完整的行情查看、自選管理、本地持倉與盈虧現算、價格提醒與「行情隱身」功能，與上游 dsh-xueqiu 是替代關係，裝之前建議先卸掉上游同名插件。更多細節見目錄頁與 GitHub 倉庫。

目錄頁¶

https://www.skillhub.cn/plugins/xxxSnack/dsh-market-dock

GitHub¶

https://github.com/xxxSnack/dsh-market-dock