前言¶

使用 DeepSeek Harness（DSH）做本地 Web 面板時，有些用戶會希望在一個側邊入口裏順手查看 A 股持倉和自選行情，而不是另外打開瀏覽器標籤頁。

Bob-Bo1/dsh-stock-watch 是一個 DSH 客戶端插件。它在 DSH 左側邊欄底部提供股票入口，用來查看 A 股持倉和自選股的即時行情；持倉頁顯示盈虧，自選頁只顯示行情，並支持在網頁中添加數據、保存到本機 holdings.json。

插件定位¶

Bob-Bo1/dsh-stock-watch 由 Bob-Bo1 維護，許可證爲 MIT。

它解決的是本機 A 股觀察場景：把持倉和自選數據放在你自己的電腦上，通過 DSH Web 頁面查看行情和盈虧。行情來自騰訊公開行情接口；持倉數據只從本機 JSON 文件讀取，插件不會把持倉內容上傳到項目作者服務器。

這是一個觀察工具，不構成投資建議，也不會執行買賣操作。

核心功能¶

• 在 DSH 左側邊欄底部提供股票入口。
• 查看 A 股持倉和自選股的即時行情。
• 持倉頁顯示盈虧，自選頁只顯示行情。
• 支持在網頁中查找、添加、修改和刪除持倉與自選股票。
• 支持把股票數據寫入本機 holdings.json。
• 支持環境變量 DSH_STOCK_HOLDINGS 指定持倉文件。
• 行情來自騰訊公開行情接口。
• 頁面可見時按設置間隔刷新，頁面不可見時暫停請求。
• 按 A 股習慣紅漲綠跌顯示。
• 網絡異常時會保留上一組成功數據。

安裝與啓用¶

先從 GitHub 安裝插件：

dsh plugin --profile web add github:Bob-Bo1/dsh-stock-watch

安裝後，需要在 DSH Web profile 的 cordis.patch.yml 中確認存在插件註冊項：

- insert:
  - id: stock-watch
    name: stock-watch

這裏的重點是確認 id: stock-watch 和 name: stock-watch 已存在。

確認註冊後，重啓 DSH Web：

dsh web

如果要在本地做開發安裝，可以先克隆倉庫：

git clone https://github.com/Bob-Bo1/dsh-stock-watch.git D:\Tools\stock-watch
dsh plugin --profile web add link:D:\Tools\stock-watch

本地路徑可以替換成你實際保存插件的目錄。本地安裝後，同樣需要確認 cordis.patch.yml 已註冊插件，再重啓 DSH Web。

關聯本機股票數據¶

推薦把持倉文件放在 DSH workspace 根目錄：

你的 DSH workspace\holdings.json

最簡單的做法是：

1. 複製倉庫裏的 holdings.example.json。
2. 將副本改名爲 holdings.json。
3. 替換成自己的數據。
4. 放到 DSH workspace 根目錄。
5. 打開 DSH 左側邊欄底部的股票入口查看結果。

也可以用環境變量指定一個本機文件：

$env:DSH_STOCK_HOLDINGS = 'D:\Private\stocks\holdings.json'; dsh web

這個環境變量只保存文件路徑，優先級高於默認 workspace\holdings.json。

網頁添加與字段要求¶

插件支持在網頁中查找、添加、修改和刪除持倉與自選股票。添加後的股票數據會寫入本機 holdings.json。

持倉和自選使用不同字段：

• 持倉允許字段：code、name、quantity、costPrice。
• 自選允許字段：code、name。
• 其他字段會被丟棄。

持倉字段要求：

• code 必填，格式爲 sh、sz 或 bj 加 5～6 位數字。
• quantity 必填，且必須大於 0。
• costPrice 必填，且必須大於 0。

自選字段要求：

• 每項只需要 code 和可選 name。

數據與計算範圍¶

• 持倉頁顯示盈虧。
• 自選頁只顯示行情。
• 行情來自騰訊公開行情接口。
• 網絡異常時會保留上一組成功數據。
• 按 A 股習慣紅漲綠跌顯示。
• 當前版本沒有計入手續費、印花稅、分紅和融資成本。

適用場景與注意¶

適合需要在本機 DSH Web 面板中查看 A 股持倉、自選行情和本機盈虧的用戶。使用前建議先檢查源碼、許可證和本機文件權限。

需要注意：

• 持倉數據只從你自己電腦上的一個 JSON 文件讀取。
• 插件只把本機配置中的股票信息傳給當前 DSH 頁面，不會上傳到本項目作者的服務器。
• 行情請求發送到騰訊行情接口時只包含股票代碼，不包含你的數量、成本價或 API Key。
• 默認情況下，DSH Web 服務只監聽本機地址。
• 如果暴露到局域網或公網，能訪問 DSH 的人也可能讀取本地插件路由返回的持倉摘要。
• 不要把真實 holdings.json、截圖、賬號信息或 API Key 提交到 GitHub。
• DSH 插件會以當前 DSH 進程權限運行；安裝前建議檢查源碼和權限影響。
• 許可證爲 MIT。

結尾¶

Bob-Bo1/dsh-stock-watch 適合放在本機 DSH Web 環境裏，作爲一個輕量的 A 股持倉和自選觀察入口。它讀取本機 holdings.json，調用騰訊公開行情接口刷新行情，並在持倉頁顯示盈虧。

• GitHub 倉庫：https://github.com/Bob-Bo1/dsh-stock-watch
• 插件目錄線索（來自插件線索，未包含在已抓取資料中）：https://www.skillhub.cn/plugins/Bob-Bo1/dsh-stock-watch