前言¶

在 DSH web GUI 裏，如果只把股票作爲查詢對象或自選股，看到的通常是自己手動維護的列表。對已經在同花順投資賬本里記錄真實持倉的人，更直接的需求是把真實持倉盈虧放到當前工作界面裏，減少來回切換頁面。

下面介紹 DSH 插件 dsh-ths-holdings。它讀取同花順投資賬本的真實持倉數據，在 DSH web GUI 右下角展示今日盈虧、上證指數和當日走勢圖，不需要手動添加股票。

這是什麼¶

dsh-ths-holdings 是一個 DSH 插件，定位爲“持倉盈虧懸浮卡片”。

• 插件名：dsh-ths-holdings
• 維護者：PM25000
• 許可證：MIT
• 解決的問題：自動同步同花順投資賬本中的真實持倉數據，在 DSH web GUI 中顯示今日盈虧、上證指數和當日走勢圖。

這個插件不是簡單的自選股工具，它讀取的是真實持倉和盈虧數據。

核心功能¶

已覈實的功能包括：

• 即時持倉盈虧：默認每 20 秒輪詢一次，可從真實投資組合獲取數據。
• 今日盈虧顯示：可顯示元金額、百分比或兩者。
• 當日走勢圖：帶零軸的迷你折線，遵循紅漲綠跌。
• 上證指數：與盈虧一起展示。
• 多賬戶支持：自動發現 fund_key，支持從投資組合列表下拉選擇。
• 自動獲取 Cookie：一鍵彈出系統瀏覽器登錄窗口，並自動保存 Cookie。
• 保存時校驗：粘貼或自動獲取後立即校驗 Cookie 是否有效。
• 可拖動：沿右側邊緣垂直拖動標題欄，位置保存在 localStorage。
• 卡片內設置：可在卡片中粘貼 Cookie 並選擇投資組合。
• 憑證安全：Cookie 不離開宿主進程。

另外，插件僅保留 10jqka 域名的 Cookie，且不以明文存儲。

安裝與啓用¶

先確認運行環境。資料顯示 Node 要求爲：

^22.19.0 || >=24.0.0

安裝到 DSH web profile：

dsh plugin --profile web add dsh-ths-holdings

安裝完成後重啓 web 服務：

dsh web

啓動後，DSH web GUI 右下角會出現懸浮卡片。

典型用法¶

自動獲取 Cookie¶

推薦先使用自動獲取流程：

1、打開 DSH web GUI。

2、打開卡片設置，選擇「自動獲取 Cookie（推薦）」。

3、在彈出的系統瀏覽器窗口登錄同花順投資賬本。

4、登錄成功後，窗口自動關閉，Cookie 自動保存，卡片刷新持倉。

5、如果存在多個投資組合，從下拉框中選擇目標投資組合。

自動獲取窗口包含反自動化僞裝，用於通過同花順 WAF。如果頁面遇到 WAF 或 Nginx forbidden，可以在窗口按 F5，或手動打開：

https://tzzb.10jqka.com.cn

登錄後點擊「我已登錄，繼續 →」。

手動粘貼 Cookie¶

如果自動獲取失敗，可以手動粘貼：

1、打開同花順投資賬本網頁並登錄：

https://tzzb.10jqka.com.cn

2、打開瀏覽器開發者工具，在 F12 Console 中執行：

copy(document.cookie)

3、回到 DSH 卡片設置，將 Cookie 粘貼到配置項：

STOCK_PNL_COOKIE

4、保存。

插件保存後會立即校驗 Cookie，顯示有效或無效狀態。

Cookie 過期處理¶

會話 Cookie 會過期。過期後卡片會顯示 Token 已過期，需要重新自動獲取，或手動粘貼新的 Cookie。

持倉數據更新¶

完成新交易後，從投資賬本 app 重新上傳數據到網頁版，以保持持倉一致。

適用場景與注意¶

適合已經使用同花順投資賬本，並且希望在 DSH web GUI 中查看真實持倉盈虧的 DSH 用戶。

使用前注意：

• 該插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• Cookie 是會話憑證，會過期，過期後需要重新獲取或手動粘貼。
• 本文功能描述基於已覈實資料；資料末尾存在截斷，可能還有未列出的能力、依賴或限制。

鏈接¶

GitHub：

https://github.com/PM25000/dsh-ths-holdings