DSH 背包（Backpack）

DeepSeek Harness 常驻插件：魔兽世界风格的物品栏 / 背包系统。右下角背包按钮展开物品栏，支持粘贴内容自动识别类型入库、选择本地文件、拖入文件等方式添加物品；同时自动统计所有会话（含已归档）的 token 费用，按 DeepSeek 官方动态定价换算成金币/银币/铜币。

适用于 DSH Web profile（dsh web）。本插件以常驻 bundle 形式安装，重启 DSH 后依然生效（区别于会话级动态插件）。

特性

• 🎒 物品栏：右下角 FAB 展开/收起（快捷键 B），无限袋子、分页管理（每页 6×4），虚空仓库（超容自动收纳、不可删除）
• 🏷️ 物品类型：链接 / 提示词 / 笔记 / 技能 / 文件 / 图片 / 插件 / 命令 / 其他，支持自定义类别（侧栏「＋添加类别」）
• ⭐ WoW 质感：品质颜色（粗糙→传说）、黄字风味文字、悬浮信息卡、右键菜单（查看/发送/复制/固定/编辑/移动/摧毁）
• 🖱️ 交互：拖拽移动物品、拖入文件生成物品、粘贴内容自动识别类型、图标库挑选
• 🔎 查看详情：右键「查看」按内容自动渲染——链接卡片（可点击）、Markdown 富文本、HTML 沙箱页面（iframe，脚本不执行）、图片/纯文本
• 💰 费用记账：扫描全部会话日志（sessionQuery，旋转批次增量），按模型 + 请求时段套用 DeepSeek 官方定价；悬浮金额弹出卡片查看近 7 天每日总花费与每个模型花费（移开自动关闭）
• 🤖 Agent 工具：backpack_add / backpack_money / backpack_search（Agent 检索背包作长期记忆库）
• 🔍 检索：搜索（/ 快捷键聚焦）、品质过滤、排序、一键整理、Shift+点击批量多选、拖拽放置预览
• 🖱️ 交互：面板可拖拽并记住位置、Esc 关闭、toast 分色、保存状态指示、选中描边

环境要求

• DeepSeek Harness（dsh），Web profile
• 依赖的 peer 包（DSH 自带）：@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-settings、@deepseek-ai/schemastery、react

安装

以本地 workspace 包方式装入你的 web profile：

1. 放入源码：把本仓库放到 profile 的 packages 目录，例如 ~/.dsh/profiles/web/packages/backpack。

2. 注册 workspace：编辑 ~/.dsh/profiles/web/pnpm-workspace.yaml：

   packages:
     - .
     - packages/*

3. 声明依赖与 bundle：编辑 ~/.dsh/profiles/web/package.json：

   {
     "dependencies": { "@ggame/backpack": "workspace:*" },
     "dsh": {
       "profile": {
         "bundles": [
           "@deepseek-ai/dsh-base",
           "@deepseek-ai/dsh-web-app",
           "@ggame/backpack"
         ]
       }
     }
   }

4. 安装：在 profile 目录执行 pnpm install。

5. 配置行：在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

   - id: backpack
     config:
       autoScan: true
       scanIntervalSec: 60

6. 重启 DSH：dsh web。之后浏览器右下角会出现背包按钮。

若你的 profile 已启用其他 bundle（如 vision-toolkit），把 @ggame/backpack 追加进 bundles 列表即可，互不影响。

🤖 AI 一键安装提示词（复制发给 DSH Agent）

请帮我在 DSH 中安装 @ggame/backpack 背包插件。请执行：
1. cd ~/.dsh/profiles/web
2. pnpm add @ggame/backpack
3. 编辑 package.json，在 dsh.profile.bundles 数组里追加 "@ggame/backpack"（保留原有项）
4. 编辑 cordis.patch.yml，在末尾追加：
   - id: backpack
     config:
       autoScan: true
       scanIntervalSec: 60
5. 执行 pnpm install
6. 重启 dsh web

截图

背包面板	物品查看（Markdown 详情）

费用明细（悬浮金额卡片）	添加物品

使用

物品类型自动识别规则：https://…→链接；@插件id→插件；本地路径→图片/文件；命令特征→命令；长文本→提示词。

配置（设置 → 插件 → 插件配置 → 背包）

货币与费用记账

• 约定：金币=元，银币=角，铜币=分（1 金 = 100 银 = 10000 铜）。

• 数据来源：sessionQuery 读取全部会话日志（live + 已归档），从 assistant/message 事件提取真实 TokenUsage（inputTokens + cacheWriteTokens 按未命中输入计，cacheReadTokens 按命中输入计，outputTokens + reasoningTokens 按输出计），从 request/header 事件取模型名。

• 官方定价（元/百万 tokens，DeepSeek 定价文档）：

  模型	缓存命中输入	未命中输入	输出
  deepseek-v4-flash	0.02	1	2
  deepseek-v4-pro	0.025	3	6

• 峰谷计价：2026-08-17 00:00（北京时间）起，高峰时段（9:00–12:00、14:00–18:00）按高峰价（flash 0.10/3.0/9.0，pro 0.30/9.0/27.0），闲时为高峰价一半。peakPricing: false 可关闭。

• 修订机制：定价规则变更（PRICE_REV 变化）会自动清零旧账、按日志全量重建，避免残留错误计价。

• 说明：token 数来自日志真实上报；金额换算依赖上方价格表（估算值），GLM 等非 dsh-llm 通道与无 usage 上报的调用不计入。

数据文件

~/.dsh/backpack-state.json（可在设置中改路径），结构：

{
  "version": 1,
  "tags": ["自定义类别"],
  "money": { "gold": 22, "silver": 15, "copper": 74 },
  "usageLog": [{ "ts": 1786723329685, "model": "deepseek-v4-flash", "input": 74, "hit": 5760, "output": 2348, "costCu": 49 }],
  "totalUsage": { "input": 0, "output": 0, "hit": 0 },
  "modelUsage": { "deepseek-v4-flash": { "input": 0, "output": 0, "hit": 0 } },
  "modelCostCu": { "deepseek-v4-flash": 232236 },
  "dayCostCu": { "2026-08-15": 331862 },
  "scanState": { "__init": 1, "__priceRev": "v5-dayledger-20260815", "<sessionId>": 1272847 },
  "bags": [{ "id": "bag-main", "name": "主背包", "cols": 6, "rows": 4, "order": 0, "fixed": true }],
  "items": [{ "id": "it-…", "bagId": "bag-main", "slot": 0, "type": "note", "name": "…", "rarity": 2, "payload": "…", "flavor": "…", "count": 1, "createdAt": 0, "lastUsed": 0, "useCount": 0, "extra": {}, "icon": "" }]
}

slot = -1 且 bagId = 'bag-vault' 表示物品在虚空仓库。

开发

• src/client.js 是浏览器端可读源码（__ModuleLoader__ 工厂体），lib/client.js 是其包装产物。
• 修改客户端后重新打包：pnpm build（node scripts/build-client.mjs），输出 lib/client.js。
• lib/pricing.js 是定价与货币核心（零依赖），单元测试：pnpm test（node tests/pricing.test.mjs）。
• 检查：pnpm check。
• Host 逻辑在 lib/index.js：设置注册、会话扫描记账、持久化、Web API（/_dsh/backpack/api、/_dsh/backpack/media）、Agent 工具（backpack_add / backpack_money）。

仓库结构

lib/index.js        宿主逻辑（设置 / 扫描记账 / 持久化 / Web API / 工具）
lib/pricing.js      定价与货币核心（官方价目、峰谷计价、金额归一化）
lib/client.js       浏览器 bundle（生成物，已随仓库提交）
src/client.js       浏览器端可读源码（构建输入）
scripts/build-client.mjs    src → lib 打包脚本
icons/               类型图标（28 个 PNG）
tests/pricing.test.mjs      定价/货币单元测试
cordis.patch.yml    DSH bundle 挂载声明

许可与致谢

• 代码：MIT。
• 图标：魔兽风格示例图标（来自 AI 生成素材，icons/ 目录），仅供个人使用与演示；发布/商用前请替换为自有素材或确认素材许可。