DeepSeek Harness 常驻插件：魔兽世界风格的物品栏与费用记账

前言¶

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 的工作流，通过魔兽世界风格的交互提供了直观的物品栏体验，并解决了长期会话费用统计的痛点。开发者可据此构建更结构化的本地知识库和成本控制体系。

插件目录 | GitHub 仓库