前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構。對於需要長時間在桌面端工作的開發者而言，界面的個性化與資源消耗的可視化是提升效率的關鍵。針對這一需求，下面介紹由 Smith-yue 維護的 TypeScript 插件 dsh-skin-token-dashboard。該插件不依賴外部網絡，專注於提供本地化的桌面皮膚切換與基於官方會話投影的 Token 用量統計。
插件概覽¶
這是一個面向 DeepSeek Harness Desktop/Web 的 TypeScript 插件工程。它主要解決兩個問題：
1. 桌面外觀定製：提供兩套可切換的桌面皮膚（深海夜航與暖紙日光），並支持本地圖片輪播。
2. Token 追蹤：通過官方 tokenUsage 會話投影讀取數據，提供詳細的 Token 統計面板。
項目信息：
* 所有者：Smith-yue
* 許可證：MIT
安裝與啓用¶
安裝前需確保環境滿足以下條件：
* Node.js 版本爲 ^22.19.0 || >=24.0.0
使用官方 CLI 將插件安裝到 Web profile：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-skin-token-dashboard
安裝完成後，必須完全退出並重新打開 DSH Desktop，才能在界面中看到新功能。在 DSH Desktop 插件市場中搜索 dsh-skin-token-dashboard 也可以完成相同操作。啓用後，進入“設置 → 通用 → 桌面皮膚”即可切換主題。
核心功能¶
桌面皮膚與背景¶
插件內置兩套完整皮膚（深海夜航暗色、暖紙日光亮色），並保留 Harness 原生聊天統計條。背景支持以下配置：
* 內置背景：隨包發佈五套攝影背景。
* 本地輪播：支持遞歸掃描本地子文件夾中的圖片（支持 AVIF、BMP、GIF、JPEG、PNG、WebP，最多 2000 張）。
* 控制選項：可設置 1-1440 分鐘的輪播間隔，支持暫停、繼續或立即切換下一張。
* 自定義覆蓋：支持自定義 CSS 背景色、圖片透明度，以及背景色/漸變覆蓋透明度。所有設置（皮膚、顏色、文件夾路徑、輪播參數）重啓後自動恢復。
Token 用量統計¶
插件在“設置 → Token 用量”中提供了一個詳細麪板，實時展示當前會話的彙總數據：
* 會話總量
* 計費輸入
* 輸出
* 緩存命中率
* 四類 Token 構成（未緩存輸入、緩存讀取、緩存寫入、輸出）
這些數據基於官方 tokenUsage 會話投影讀取，不依賴額外的統計數據庫，也不會複製消息內容。
API 使用¶
插件在 Host 端註冊了 ctx.skinTokenUsage 服務。開發者可以通過以下 TypeScript 代碼讀取並打印 Token 統計：
const usage = ctx.skinTokenUsage.read(session)
if (usage) {
console.log(usage.billedInputTokens)
console.log(usage.outputTokens)
console.log(usage.totalTokens)
console.log(usage.cacheHitRate)
}
read() 方法爲同步一致性讀取，僅返回彙總計數，不返回原始 prompt、response 或工具內容。
隱私與安全¶
插件在隱私設計上較爲剋制：
* 不發起網絡請求：所有數據讀取均在本地完成。
* 不保存會話內容：插件不復制消息內容，Token 數據僅從 Harness 已有的持久會話投影中讀取。
* 文件訪問限制：Host 文件讀取 RPC 僅接受本機迴環連接，只讀取已由原生選擇器授權並保存的目錄，拒絕路徑越界和符號鏈接穿透。
* 數據持久化：皮膚偏好與用戶選擇的本地背景文件夾路徑寫入 $DSH_HOME/settings.yaml，圖片內容本身不會複製到設置或數據庫中。
適用場景¶
該插件適合需要精細化管理 DeepSeek Harness 桌面體驗的開發者或用戶。如果你希望自定義工作臺背景，同時需要清晰掌握上下文壓縮、緩存命中等 Token 細分數據，該插件提供了無需額外數據採集的輕量級解決方案。
相關鏈接¶
- GitHub 倉庫：https://github.com/Smith-yue/harness-plugin
- 插件目錄：https://www.skillhub.cn/plugins/Smith-yue/harness-plugin
