前言¶

在 DSH（DeepSeek Harness）里跑长对话、多工具调用时，token 往往分散在会话统计、上下文条和模型响应里，要判断「这一步吃了多少」「今天一共烧了多少」得来回点界面。官方投影里还包含缓存读/写，数字口径和直觉上的「新输入」也不完全一致。下面介绍社区插件 dsh-token-mascot（界面里叫「小汪」）：在客户端右下角常驻一个 Q 版角色，把本会话累计、速率、上下文占用、当前任务和「今日 · 全部会话」收在同一张可展开卡片里，数据来自宿主内存，不额外联网。

这是什么¶

dsh-token-mascot 由维护者 zouyuhang233 发布，分类为 客户端（dsh.client.platform = "web"），当前版本 1.4.2，许可证 MIT。仓库：https://github.com/zouyuhang233/dsh-token-mascot；社区目录页：https://www.skillhub.cn/plugins/zouyuhang233/dsh-token-mascot。

插件在 DSH 窗口右下角显示角色「小汪」。点击展开/收起面板，拖拽可改位置（会记住）。适合需要在写代码、调 Agent 时一眼看到 token 与任务状态、又不想离开当前页面的开发者。

核心功能¶

面板各区域与 README 中的说明一致：

角色默认尺寸 112px，可在配置里改为 64–220px。

环境要求：面向 DSH Desktop ≥ 0.2.1-rc.3 开发。旧版仍可用大部分功能，但「今日 · 全部会话」会自动隐藏。插件尚未发布到 npm；安装产物已构建好，不需要本机安装 Node 或自行编译。

安装与启用¶

安装前建议浏览仓库源码与 LICENSE，确认你愿意以当前 DSH 进程的权限加载该客户端插件（插件不发起网络请求，数字均来自宿主投影与事件）。

方式一：Git 地址（推荐）¶

1. 打开 DSH：设置 → 插件 → 添加插件
2. 在输入框粘贴仓库地址：

https://github.com/zouyuhang233/dsh-token-mascot

3. 点 安装，等待完成
4. 完全退出并重开 DSH（或刷新窗口）
5. 右下角出现小汪即表示安装成功

若无法访问 GitHub，可到 Releases 下载 dsh-token-mascot-1.4.2-plugin.zip，解压后用含 package.json 的目录本地绝对路径安装（不要选到 lib 子目录）。DSH 若出现「安装源 / registry」相关选项，Git 来源保持默认即可。

配置（可选）¶

在 DSH profile 补丁层覆盖，默认文件路径示例：

C:\Users\<你的用户名>\.dsh\profiles\desktop\cordis.patch.yml

在数组中增加与已有 - id: 同级的一项：

- id: dsh-token-mascot
  config:
    mascot:
      collapsed: false        # 打开客户端时卡片是否默认展开
      showLiveEstimate: true  # 是否显示「本步实时估算」
      showContext: true       # 是否显示上下文占用条
      showTask: true          # 是否显示当前任务
      showToday: true         # 是否显示「今日 · 全部会话」
      size: 112               # 角色尺寸 px（64–220）
      offsetX: 18             # 默认位置：右边距
      offsetY: 104            # 默认位置：底边距
      accent: '#4d93f8'       # 强调色

保存后重开 DSH 生效。拖拽后的位置与展开状态存在浏览器 localStorage，不受上述项影响。

典型用法¶

经过上面的安装步骤并重开客户端后，可以按下面顺序熟悉交互：

1. 点小汪展开或收起 token 卡片。
2. 拖拽小汪调整在窗口中的位置。
3. 点卡片里的 「今日 · 全部会话」，展开各会话消耗明细，再点收起。
4. 若看不到「今日」一行，检查 DSH 是否 ≥ 0.2.1-rc.3。
5. 首次打开时各会话投影按需加载，「今日」可能先显示 … / M+，随后变为准确值。

理解数字时留意 README 中的口径：卡片顶部是本会话累计（不按天重置）；「今日」是当天新增。累计含缓存读，往往远大于单纯新输入；≥ 1 亿显示「亿」（两位小数），否则显示「万」。模型响应结束才结算，生成中的 ≈N 为流式估算，结算后被精确值覆盖。

若插件页显示「运行中」但右下角无角色：完全退出并重开或 Ctrl+R；确认版本；插件页若有「页面同步失败」则点重试。

适用场景与注意¶

适合：长期在 DSH Desktop 里对话、需要实时看 token 速率与上下文占用、并希望汇总「今天所有会话新增」的开发者。

注意：

• 插件以 DSH 客户端 Web 层运行，权限与当前 DSH 进程一致；安装前请自行审阅 仓库源码。
• 不发起任何网络请求；角色图内嵌，不上传会话内容到外部服务。
• SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件为社区贡献，非官方内置组件。
• 更新：在插件页卸载后按安装步骤重新添加，并重开 DSH。变更见仓库 CHANGELOG.md。

结尾¶

dsh-token-mascot 把 DSH 里分散的 token 投影和任务状态收到右下角一张卡里，用角色状态辅助判断当前是在思考、调工具还是出错，适合作为日常开发的轻量看板。进一步了解功能与 FAQ 见 GitHub README；从目录页进入亦可：SkillHub 插件页 · GitHub 仓库。