前言¶
DeepSeek Harness (DSH) 採用了插件化架構，允許開發者根據需求擴展功能。在本地運行和調試時，開發者需要直觀地瞭解當前系統的運行狀態（如模型是否在工作、是否正在進行上下文壓縮）以及資源消耗情況（Token 使用量、成本）。日誌文件雖然詳盡，但在調試過程中不夠直觀。dsh-token-pet 旨在通過一個常駐桌面的 Q 版角色，將 DSH 的後臺事件（請求、工具調用、壓縮、歸檔等）轉化爲可視化的動畫與數據面板，讓狀態反饋即時可見，同時提供 Token 統計與成本估算能力。
插件簡介¶
dsh-token-pet 是一個爲 DeepSeek Harness Desktop 提供懸浮桌面寵物、運行狀態反饋與 Token / 上下文可視化能力的插件。
- 作者：Jimmy0123-ux
- 類別：趣味換裝
- 許可證：MIT
- 核心價值：將後臺事件狀態化、可視化；提供跨會話的 Token 賬本與成本估算；集成本地提示詞增強工作流。
核心功能¶
該插件主要包含以下功能模塊：
運行狀態可視化¶
系統會將當前請求、工具調用、上下文壓縮、會話歸檔和提示詞增強等真實 DSH 事件轉化爲 12 個正式逐幀動作。用戶無需打開日誌，就能通過寵物右上角的狀態牌看到系統此刻處於空閒、工作中、壓縮中、工具完成/失敗或提示詞生成等狀態。
實時上下文展示¶
寵物下方會實時顯示上下文佔用率。配合獨立的可拖動浮窗，用戶可以查看當前會話的詳細數據，包括輪次、步數、模型耗時以及 Token 分類。
跨會話 Lifetime Ledger¶
插件維護一個跨會話的終身用量賬本。即使源會話被歸檔或刪除，該賬本仍會保留累計值，方便長期追蹤使用情況。
成本估算與預算¶
默認情況下不顯示成本信息。用戶可在設置中開啓“顯示成本估算”。開啓後，插件會在本地根據價格表估算本月與各模型的成本，並支持設置月預算。當成本超限時，寵物會播放預警動作。
數據分析與管理¶
- 模型與趨勢分析：支持按服務商、模型和日期統計，提供近 7 日或 30 日聚合趨勢（按本地時區）。
- 會話成本排行：展示最耗 Token 的會話列表。
- 數據導出：支持導出 JSON 或 CSV 格式的用量統計（僅包含數字，不含對話內容）。
提示詞增強工作流¶
集成本地 MIT Prompt Optimizer 規則。用戶可以在獨立抽屜中對提示詞進行預覽、編輯、覆蓋、追加或撤回，並直接發送到 DSH Composer。
界面與交互¶
- 主題切換：支持深色（默認）/淺色主題，一鍵切換生效。
- 皮膚系統：內置 4 套配色皮膚，並支持導入本地皮膚 ZIP 文件。
- 低打擾設計：採用純快照面板讀取與後臺增量索引，避免打開界面時掃描全部會話，確保性能流暢。
安裝與啓用¶
注意：這是一個 Web 界面插件，必須在 DSH 的 Web 界面中才能顯示寵物。宿主環境必須包含 Web UI 組件（@deepseek-ai/dsh-web-app）。
命令行安裝¶
如果使用命令行啓動 DSH，可以使用以下命令安裝：
# 網頁版
dsh plugin --profile web add dsh-token-pet
# 桌面版
dsh plugin --profile desktop add dsh-token-pet
安裝完成後，需重啓 DSH（或刷新 Web 頁面）以使插件生效。
典型用法¶
- 主題切換：在設置 → 外觀中選擇“淺色”或“深色”，界面主題即時切換。
- 查看成本：在設置 → 成本與預算中勾選“顯示成本估算”，浮窗“總覽”中會出現成本卡片與月預算進度條。
- 導出數據：在設置頁選擇導出 JSON 或 CSV 格式的用量統計。
- 設置提示音：在浮窗設置 → 語言與通知中開啓“完成提示音”，在會話成功完成後會聽到提示音。
- 提示詞增強：在提示詞增強抽屜中編輯提示詞後，點擊“直接發送”即可提交到 DSH。
注意事項¶
- 環境依賴：插件依賴宿主包含 Web UI 組件。如果提示“缺 WebUI 組件”，請確認目標 profile（web 或 desktop）包含
@deepseek-ai/dsh-web-app。 - 版本要求：依賴 Node.js 版本 >= 22.19。
- 本地處理：成本估算僅爲本地參考，不請求任何外部價格接口，也不上傳用量數據。
- 隱私保護：僅統計數字，不含對話內容。
- 皮膚導入：導入本地皮膚 ZIP 時，客戶端會進行路徑與大小校驗（上限 24MiB / 64MiB）。
總結¶
dsh-token-pet 通過視覺化的方式解決了 DSH 開發者對運行狀態和資源消耗的監控需求，同時提供了實用的成本追蹤與提示詞增強工具。其輕量級的設計和低打擾的性能優化，使其能夠無縫集成到日常開發流程中。
