前言¶
DeepSeek Harness（DSH）採用插件化架構。在使用過程中，管理提示詞、鏈接、筆記等碎片化資源通常需要手動整理；同時，統計所有會話（含已歸檔）的 Token 費用往往需要依賴外部腳本或手動計算。gxx950224/backpack 插件爲 DSH 提供了一套常駐的物品欄與費用記賬系統，採用魔獸世界（WoW）風格的 UI，支持對各類資源進行分類存儲，並能基於 DeepSeek 官方動態定價自動覈算成本。
核心功能¶
該插件主要解決資源管理和成本追蹤兩個問題。
物品欄與分類管理
* 背包系統：右下角懸浮按鈕（FAB）或按 B 鍵展開物品欄，支持無限袋子、分頁管理（6×4 格子）。
* 物品類型：自動識別並分類鏈接、提示詞、筆記、技能、文件、圖片、插件、命令及其他內容。
* 虛空倉庫：提供超容收納空間，不可刪除，用於存放自動歸類的雜物。
* 交互與視覺：支持拖拽移動物品、拖入文件生成物品、鼠標懸浮查看詳情。界面呈現 WoW 質感，包含品質顏色、風味文字及信息卡片。
費用記賬
* 自動統計：掃描全部會話日誌（含已歸檔），提取真實 Token 使用量（inputTokens、cacheReadTokens、outputTokens 等）。
* 貨幣換算：將成本換算爲金幣（元）、銀幣（角）、銅幣（分）。
* 動態定價：按 DeepSeek 官方定價規則計費，支持峯谷計價（默認開啓）。
* Agent 工具：提供 backpack_add、backpack_money、backpack_search 等工具，供 Agent 調用。
安裝與啓用¶
本插件以常駐 bundle 形式安裝，需配合 DSH Web profile 使用。安裝前請確保已安裝必要的依賴。
- 安裝依賴：
在 DSH Web profile 目錄下執行：
pnpm add @ggame/backpack
- 註冊工作區：
編輯~/.dsh/profiles/web/pnpm-workspace.yaml，確保包含packages/*：
packages:
- .
- packages/*
- 配置 Bundle：
編輯~/.dsh/profiles/web/package.json，在dsh.profile.bundles數組中追加@ggame/backpack：
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@ggame/backpack"
]
}
}
}
- 配置插件參數：
在~/.dsh/profiles/web/cordis.patch.yml末尾追加：
- id: backpack
config:
autoScan: true
scanIntervalSec: 60
- 執行安裝並重啓：
在 profile 目錄執行pnpm install，然後重啓 DSH Web (dsh web)。
基本操作¶
安裝完成後，瀏覽器右下角會出現背包按鈕。
- 開合背包：點擊右下角按鈕或按
B鍵。 - 添加物品：在面板點擊「＋物品」，粘貼內容自動識別類型；或直接將本地文件拖入面板。
- 使用物品：雙擊物品。鏈接類可直接打開；提示詞/命令類會發送到輸入框；技能/插件類會生成調用文本。
- 查看詳情：右鍵物品選擇「查看」，可預覽鏈接卡片、Markdown 富文本、HTML 沙箱頁面、圖片或純文本。
- 批量操作：按住
Shift點擊可多選物品，支持拖拽整理。
費用與計價規則¶
費用統計基於 DSH 日誌中的 sessionQuery 事件和 assistant/message 事件中的 TokenUsage 數據。
- 貨幣單位：約定 1 金幣 = 1 元，1 銀幣 = 0.1 元，1 銅幣 = 0.01 元。
- 計價模型：支持按模型覆蓋單價，或使用默認定價。插件內置 DeepSeek 官方定價文檔（
deepseek-v4-flash、deepseek-v4-pro）。 - 峯谷計價：默認開啓。高峯時段（如 9:00–12:00、14:00–18:00）按高峯價計費，閒時爲高峯價的一半。可在配置中關閉。
- 數據維護：當定價規則變更（
PRICE_REV變化）時，舊賬會自動清零並重建，以避免計價錯誤。
注意事項¶
- 環境要求：僅適用於 DSH Web profile (
dsh web)。 - 安裝形式：以常駐 bundle 形式安裝，重啓 DSH 後依然生效。
- 依賴關係：依賴 DSH 自帶的 peer 包（
@deepseek-ai/cordis等）。 - 數據來源：Token 數量直接來源於日誌真實上報，非估算值。
- 許可與圖標：代碼採用 MIT 許可證；圖標僅供個人使用，商用前需替換。
總結
backpack 插件將資源管理與成本控制融入 DSH 的工作流，通過魔獸世界風格的交互提供了直觀的物品欄體驗，並解決了長期會話費用統計的痛點。開發者可據此構建更結構化的本地知識庫和成本控制體系。
