前言¶
在 DeepSeek Harness（DSH）裏掛着 A 股持倉時，常見的浮層能回答「今天一共賺了多少」：組合盈虧、上證指數、分時圖。彙報或發羣時，下一個問題往往是「這些錢是哪幾只票貢獻的、誰跑贏指數、有沒有一張可以直接轉發的圖」。同生態裏已有依賴同花順投資賬本 Cookie 的懸浮盈虧卡，強在自動同步真實持倉，但需要保存登錄態。
dsh-pnl-attribution 走另一條路：持倉來自本地 CSV/JSON，不讀 Cookie；在同一張浮層裏做逐只貢獻歸因，並在收盤後一鍵導出可分享的 PNG 小結。下面按定位、功能、安裝、配置與邊界說明用法。
這是什麼¶
dsh-pnl-attribution 是 DSH 的客戶端插件，維護者爲 dingchenhui0618-arch。它在 Web 界面右下角提供「持倉貢獻榜」浮卡，用公開行情接口拉取現價與上證分時，按持倉計算今日盈虧貢獻前五、相對上證強弱，並在上海時區 15:00 後允許導出 1080×1680 的收盤小結 PNG。
靈感來自 pm25000/dsh-ths-holdings，本倉庫爲獨立實現（MIT），未 fork、未複製其代碼。當前版本在 package.json 中爲 0.1.0，許可證 MIT。
核心功能¶
浮卡把三件事放在同一層：
- 今日盈虧：組合金額與漲跌幅，與上證指數並排。
- 貢獻前五：每隻持倉的今日盈虧貢獻金額，按金額降序取前五；同時標出相對上證強弱（個股漲跌幅減上證漲跌幅，單位 pp）。
- 收盤小結 PNG：含貢獻榜、上證分時、只陳述數字的自動摘要；導出在瀏覽器本地完成，不產生第二次行情請求。
持倉只讀你指定的本地文件；不接券商、不保存 Cookie、不下單。行情來自騰訊公開接口（qt.gtimg.cn 快照與 web.ifzq.gtimg.cn 分時），默認約每 20 秒輪詢；失敗時保留上一次成功快照並標記「緩存」，卡片會顯示數據時間。
安裝與啓用¶
尚未發佈 npm 包，從 GitHub 安裝（需 DSH 0.2.x，engines.dsh 爲 >=0.2.1-rc.2 <0.3.0）：
dsh plugin --profile <你的 profile> add github:dingchenhui0618-arch/dsh-pnl-attribution
本地開發目錄也可直接指定路徑安裝。裝好後重啓 DSH 或刷新 Web 頁面；桌面端在插件頁安裝時 profile 由應用管理。
插件以當前 DSH 進程權限運行；安裝前可在 GitHub 查看源碼與 MIT 許可證。
配置持倉¶
默認讀取：
~/.dsh/pnl-attribution/holdings.csv
CSV 示例（cost 可省略；交易所前綴可省略，六位代碼按規則推斷）：
code,name,shares,cost
600519,貴州茅臺,100,1320.00
300750,寧德時代,400,245.00
601318,中國平安,1200,48.20
也支持 JSON 數組或 { "holdings": [...] }，字段爲 code|symbol、name、shares、cost。倉庫內 examples/holdings.demo.csv 爲演示持倉，複製到上述路徑可先看到效果。
要自定義路徑或刷新間隔，在 profile 的 cordis.patch.yml 中爲插件項增加 config：
- insert:
- id: dsh-pnl-attribution
name: dsh-pnl-attribution
config:
holdingsPath: D:\money\holdings.csv
refreshMs: 20000
refreshMs 限制在 5 秒到 10 分鐘；修改持倉文件後憑 mtime 自動失效緩存，也可點卡片上的「刷新」。
貢獻與小結規則¶
單隻今日盈虧 = 股數 × (現價 − 昨收)；相對上證強弱 = 單隻漲跌幅 − 上證漲跌幅。組合今日盈虧爲有行情的持倉之和；cost 僅作記錄，不參與今日盈虧。無行情的持倉會標記缺失並排除。
收盤小結：Asia/Shanghai 15:00 前導出按鈕禁用；摘要僅含組合合計、漲跌家數、前五合計、最大正/負貢獻等數字，不含買賣建議。非交易日顯示上一交易日收盤數據。
適用場景與注意¶
適合：已在 DSH 裏工作、願意自行維護本地持倉表、需要「誰貢獻了今日盈虧」和可發羣的收盤圖，且不希望插件接觸券商憑據的 A 股（滬深北六位代碼）投資者。
不適用：需要自動從同花順同步持倉、港股美股、兩融期權等；本插件刻意不做券商會話。
隱私與邊界：狀態由本機 DSH Web 在 /dsh-pnl-attribution/state 提供；能訪問你 DSH Web 的人能看到這張卡。不要把 Web 端口暴露到不可信網絡。不是交易系統，不構成投資建議。
結尾¶
dsh-pnl-attribution 用本地持倉 + 公開行情，在 DSH 浮層裏補齊「逐只貢獻」與「收盤 PNG」，與同花順 Cookie 路線互補而非替代。目錄頁：https://www.skillhub.cn/plugins/dingchenhui0618-arch/dsh-pnl-attribution；源碼與說明：https://github.com/dingchenhui0618-arch/dsh-pnl-attribution。
