前言¶
在 DeepSeek Harness (DSH) 的插件化生態中，可視化監控 Agent 的行爲與項目狀態是提升開發效率的關鍵。現有的方案往往缺乏直觀的行情展示，難以快速捕捉代碼量的變化趨勢與 Token 消耗情況。dsh-tonghuashun 插件旨在解決這一問題，它提供了同花順行情終端風格的界面皮膚，並集成了代碼量 K 線行情面板，幫助開發者以更直觀的方式審視 Agent 的“運行軌跡”。
是什麼¶
dsh-tonghuashun 是一個 DSH harness 客戶端插件。它包含兩個核心部分：
1. 同花順行情終端風格皮膚：基於 ui-skin-ths 和 ui-market 模塊構建。
2. 代碼量 K 線行情面板：位於宿主詳情欄右側，用於展示代碼行數與 Token 使用情況。
該插件由 AdamPlatin123 維護，遵循 MIT 協議。
核心功能¶
K 線行情面板¶
K 線面板位於右側，默認寬度 360px、高度 260px。它支持以下模式：
* 連續柱流：逐筆記錄，首尾相接，用於查看完整的代碼變更流。
* 逐步：每一筆變化佔一根，等距排列，方便逐筆覈對。
* 分時：基於真實時間，橫軸爲時間刻度，自動處理空槽。
* 日 / 周 / 月：按 UTC 日曆聚合，周從週一開始。
縱軸口徑¶
面板底部縱軸支持三檔口徑：
1. 絕對行數：項目真實總量。
2. 相對基線：總量減去固定錨點。
3. 每筆變化：單根柱的淨變化（0 居中）。當總量漂移較大時，此口徑能避免小改動被壓扁。
視覺與篩選¶
- 空/滿表示：實心表示 Agent 歸屬的改動（紅漲綠跌），空心表示未歸屬的改動（如外部校準、補齊漂移）。
- 僅 Agent 篩選：勾選後僅繪製 Agent 歸屬柱，縱軸按 Agent 柱計算，避免大額漂移干擾視線。
Git 統計規則¶
統計以 git ls-files --cached --others --exclude-standard 爲準：
* 已跟蹤文件：永遠計入。
* 未跟蹤文件：若被 .gitignore 忽略，視爲“外部校準”，產生灰色未歸屬柱。
* 修改忽略文件：不產生 K 線，狀態中標記 git-ignored-source-excluded。
Token 口徑¶
按宿主提供者記錄保存：未緩存輸入、緩存讀取、緩存寫入、輸出及推理。推理不重複計入總量。
安裝與啓用¶
本插件兼容 DSH Desktop 2.0.5 內置的 Harness 0.1.2-rc.1 及同版網頁客戶端。
構建後，通過 DSH 官方命令加入目標 Profile：
dsh plugin --profile desktop add -w "./dsh-tonghuashun-0.3.4.tgz"
應用重新加載後，在常規設置中切換“同花順風格皮膚”。默認啓用，關閉或卸載會還原主題覆蓋。
典型用法¶
- 構建插件：在插件目錄下執行
npm pack，生成dsh-tonghuashun-0.3.4.tgz。 - 安裝：執行上述安裝命令。
- 預覽調試：本地開發時可運行
npm run dev，默認地址http://127.0.0.1:4317。預覽操作僅修改output/acceptance-project/src/ledger.js。 - 導出數據：點擊導出按鈕可獲取當前項目的 JSON 數據。
適用場景與注意¶
- 適用場景：需要長時間觀察 Agent 編程過程、監控代碼行數變化趨勢、統計 Token 消耗的開發者。
- 頭部壓縮：宿主頭部行情條按可用寬度分級收縮，始終保留代碼總量與狀態點。插件自身內容上限爲 42vw。宿主的
headerUtilities爲flex:none，插件只能壓縮自身內容，不會擠壓宿主標題。 - 數據共享：網頁和桌面連接同一個本機 Host 時共用數據。一個賬本由一個 Host 進程寫入，獨佔鎖阻止第二個 Host 靜默覆蓋。
- Shell 命令限制：Shell 命令沒有宿主級文件歸屬證據，不會僅憑命令成功就生成 Agent K 線，實際總量會重掃校準。
結尾¶
dsh-tonghuashun 通過輕量級圖表與同花順風格的結合，爲 DSH 用戶提供了可視化的項目監控手段。其 MIT 許可證允許自由使用與修改，早期實現仍可在倉庫歷史中取回。倉庫地址：https://github.com/AdamPlatin123/dsh-tonghuashun。
