前言¶
DeepSeek Harness (DSH) 的核心在於插件化，但原生界面在成本控制和狀態反饋上相對精簡。dsh-sym（symbiote，共生體）是一個旨在直接疊加在 DSH 原生界面上的讀數層插件。它不新增面板，不打斷工作流，主要解決開發者對實時會話花費、賬戶餘額、峯谷計費以及上下文引用的即時可見性問題。
功能概覽¶
以下是 dsh-sym 在界面上的主要表現形式：
| 圖標 | 功能 | 出現位置 |
|---|---|---|
| 💵 | 會話花費 | 輸入框狀態欄末尾 |
| 👛 | 賬戶餘額 | 輸入框下方工具行，模型名左側 |
| 🕐 | 峯谷時段 | 品牌行 deepseek HARNESS 後面 |
@ |
引用回覆 | 每條已完成回覆的動作行 |
| ▮ | 快捷按鈕條 | 側欄與對話區之間的豎條 |
| ⚙ | 共生體設置 | 設置 → 插件 → 共生體設置 |
| ⑂ | Git 狀態 | 會話頭部標題行最前 |
這些組件互不干擾：某一處讀不到數據時它會自動隱藏，不影響其他功能。
核心功能詳解¶
1. 實時會話花費¶
在輸入框下方狀態欄末尾，會顯示兩個人民幣金額。
- 💵 本會話總計：從第一條消息到現在，所有輪次累計的花費。
- 💬 本次任務：在右側的輪次導航刻度上選中某一格，對應的這一輪花費。
- 查看詳情：鼠標懸停在金額上，會展開完整的賬單，包括廠商、模型、峯時/谷時單價以及 cache hit/miss/output 的 token 數量。
- 上下文壓縮：顯示本會話已壓縮的次數，懸停時顯示丟失的 token 量。
計價覆蓋 1046 個模型和 42 家廠商。
2. 賬戶餘額¶
位於輸入框下方工具行、模型選擇器左側。
- 數據來源：使用官方的
ctx.remote.account接口，與「設置 → 賬戶」共用同一份憑據。 - 刷新機制：掛載時讀一次，之後每 60 秒刷新；讀不到時降爲每 5 分鐘重試。
- 顯示：優先顯示 CNY 錢包，只有美元錢包時顯示
$。懸停可查看贈送餘額和更新時間。
3. 峯谷時段¶
在品牌行後面跟隨一個狀態標記，直觀顯示當前計費時段。
- 峯時：琥珀色描邊，按標準價計費。
- 谷時：灰色，按半價計費。
- 刷新：每天在固定時刻觸發 5 次（北京時間 09:00、12:00、14:00、18:00、00:00），邊界後約半秒翻轉。窗口重新獲得焦點時會立即重新對時。
4. 引用回覆¶
每條已完成的回覆動作行裏多一個 @ 按鈕。點擊後，輸入框內會出現一個短標記（如 @引用#9806056fac67）。
- 模型讀取：模型讀到的是那條回覆的完整原文，不是這個標記。
- 實現方式：宿主側監聽
session/event，維護最近 400 條消息的索引。發送前，宿主的agent/pre-step鉤子會掃描並展開標記爲 Markdown 引用塊。 - 限制：只對之後的發送生效，不改變會話結構；索引在內存中，App 重啓後需重新填充。
5. 快捷按鈕條¶
位於側欄與對話區之間的豎條。點擊按鈕內容會直接填入輸入框，光標留在框內。
- 分組：分爲三組「官方命令 → 技能 → 預設提示詞」。
- 實現：調用官方的
commandUi.dispatch將決策交回官方，因此外觀和交互與官方菜單完全一致。 - 自定義：可在「共生體設置」中修改按鈕內容和圖標（內置 105 個圖標）。
6. 共生體設置¶
在「設置 → 插件 → 共生體設置」中管理。
- 顯示項開關：控制餘額、計費、內存佔用、壓縮信息的可見性。
- 快捷按鈕管理：支持增刪、改名、改圖標、改類型、排序（組內排序）。
- 導入導出：配置存儲在瀏覽器本地存儲中，支持 JSON 文件導入導出。
7. Git 狀態膠囊¶
顯示在會話頭部標題行最前。
- 內容：分支名、工作區改動（
+N −M）、未跟蹤文件數（?N）。 - 交互：點分支名可切換分支（僅在分支數 > 1 時可用）。切換時會使用
git switch，拒絕強制丟棄改動的操作。 - 數據源：每 2 秒輪詢一次宿主的認證路由。
8. 會話菜單增強¶
在側欄會話行的懸停菜單中，官方四項下方新增一組。
- 複製會話 ID：複製 UUID，失敗時菜單不關閉。
- 導出會話日誌：複用官方的
dsh-session-log-export功能，與頭部「下載 Session 日誌」一致。
安裝¶
本包爲 DSH 組合包（bundle），安裝後會自動合併 cordis.patch.yml，無需手動修改配置。
# 推薦方式：通過 GitHub 安裝
dsh plugin --profile desktop add github:seeseeczl/dsh-sym
注意：本插件未發佈到 npm。npm 上存在一個同名或相似的項目
dsh-hud，與本插件無關。
典型用法¶
- 查看花費：在聊天右側的輪次刻度上滾動或點選，觀察輸入框末尾的「本次任務」金額變化。
- 刷新余額：點擊輸入框下方工具行中的錢包圖標。
- 引用回覆：在對話歷史中，點擊某條回覆右側的
@按鈕，直接在當前輸入框中引用該條消息。 - 使用快捷命令：點擊側欄右縫的快捷按鈕，內容會自動填入輸入框並準備發送。
注意事項¶
- 零依賴：這是一個純 JavaScript 項目，無構建步驟。
- 本地存儲：配置文件存儲在瀏覽器本地存儲中，不寫入 DSH 的配置文件。
- 權限：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
總結¶
dsh-sym 通過「共生」的方式，將成本、餘額、計費時段等關鍵信息直接疊加在 DSH 原生界面之上，無需切換面板。它提供了從會話花費細粒度控制到 Git 狀態同步、上下文引用等實用功能，適合需要精細化管理 DeepSeek 調用成本與工作流的開發者。
