dsh-token-pet

DSH Token Pet · 用量小宠物

English guide · 简体中文 DeepSeek Harness Desktop 的悬浮桌面宠物、运行状态反馈与 Token / 上下文可视化插件。

DSH Token Pet 将当前请求、工具调用、上下文压缩、会话归档和提示词增强等真实 DSH 事件转化为一个常驻桌面的 Q 版角色。12 个正式逐帧动作让用户无需打开日志，就能看到系统此刻处于空闲、工作、压缩、工具完成/失败或提示词生成等状态。

它不只是动画挂件：可拖动、可缩放的三标签浮窗会展示实时上下文占用、当前模型与 Token 分类、跨会话 Lifetime Ledger、服务商/模型累计、本地时区小时趋势和索引维护状态；提示词增强抽屉支持用户主动触发、预览编辑、覆盖/追加、复制、撤回和直接提交到 DSH composer。面板只读取持久化快照，历史同步由后台增量索引维护，避免打开界面时扫描全部会话。

当前发布版本：0.4.2 · Node.js >=22.19 本版修复了浮窗长期显示"本次有 N 个会话读取失败"的问题：已删除/归档会话的日志不存在时不再被当作读取失败（保留账本既有值、不再提示），并清理了会反复重试的"僵尸 live 标记"；真正的读取异常仍会提示。0.4.1 修复了局部设置事件会重置其他偏好（主题 / 成本开关 / 提示音），并新增界面截图与英文文档同步。0.4.0 新增深色 / 浅色主题切换、可视化价格编辑器、成本估算改为默认关闭（可主动开启），并修复了客户端按钮文字被宿主深色样式覆盖看不清、以及皮肤 ZIP 导入导致的客户端加载失败。 界面截图 截图由插件真实组件在 Chrome 中渲染生成（示例数据，不含任何真实会话内容）。 深色主题（默认） 提示词增强抽屉：

浅色主题 切换主题（深色 / 浅色）

在浮窗 设置 → 外观 → 界面主题，或 DSH 设置 → 用量小宠物 中： 深色（默认）/ 浅色：切换立即生效，覆盖统计浮窗、设置面板、提示词抽屉、皮肤面板、趋势维护与浮窗标题栏。 成本估算（默认关闭，可主动开启） 默认不显示任何成本信息；需要时到 设置 → 成本与预算 勾选"显示成本估算"。 开启后可在同一卡片中用表格逐行编辑价格表（模型名 / 输入 / 输出 / 缓存读 / 缓存写），支持添加、删除、保存、恢复默认，无需手写 JSON。 可选月预算告警：超预算时宠物播预警动作（开启完成提示音时同时发声）。 切换英文与完成提示音

在浮窗 设置 → 语言与通知，或 DSH 设置 → 用量小宠物 中： 语言 → English：立即切换宠物状态、浮窗、增强抽屉、设置及维护反馈；两处设置同步。自定义模板、草稿、预览内容和模型名称保持原文。 完成提示音：默认关闭。开启后，当前会话每次成功完成回复响一次；工具结束、取消、错误、切换会话和载入旧记录不响。 试听：手动检查浏览器是否允许播放，不会打开自动提示音。开启开关只解锁音频，不自动响；重载后可能需要点击或按键重新解锁。被浏览器阻止的通知会丢弃，不会随后补响。 声音在本地合成，无音频下载、外部通知服务或系统通知权限请求；关闭开关、离开会话或断开实时视图会停止旧声音。

新版浮窗将当前上下文/会话与终身账本明确分区；模型排行和趋势使用自适应卡片，长模型名可换行，窄宽度下标题栏使用带提示的图标按钮，正文统一滚动。 核心能力一览 运行状态可视化：12 个正式动作反馈请求、工具、压缩、归档、点击和提示词增强； 实时上下文：常驻显示上下文占用率，并在浮窗展示轮次、步数、模型耗时和 Token 构成； 终身用量账本：跨会话保存单调累计，源会话归档或删除后仍保留历史值； 深色 / 浅色主题：一键切换，全部面板同步换肤； 成本估算与月预算（默认关闭）：按本地价格表估算本月与各模型成本，价格表可视化编辑，可选月预算超限预警； 模型与趋势分析：按服务商、模型和日期统计，以本地时区展示小时趋势；支持近 7 日 / 近 30 日按日聚合； 会话成本排行：展示最耗 Token 的会话，数据来自持久化用量索引的纯快照读取； 导出用量数据：JSON / CSV 导出账本、趋势与会话统计，仅统计数字不含对话内容； 提示词增强工作流：跟随当前会话模型路由，结果可预览、编辑、覆盖、追加、撤回或直接发送； 可换肤：内置 4 套配色皮肤，并支持导入本地皮肤 ZIP（客户端 fflate 解包，含路径与大小校验）； 低打扰性能设计：纯快照面板读取、10 秒请求deadline、后台增量索引、旧数据保留和有限重试； 桌面化交互：宠物与浮窗独立拖动、尺寸持久化、视口恢复、reduced-motion和低性能模式； 完成提示音：默认关闭，支持叮咚 / 气泡 / 轻柔主题与音量调节。 功能与界面 主要功能 宠物与状态反馈 单一固定角色身份，不随上下文档位更换角色或服装； 12 个正式逐帧动作，每个动作 32 帧、100ms / 帧； 固定脚底锚点与动作级水平锚点，避免跨动作漂移； multi-row 宽条带、ping-pong 循环和 one-shot 完整播放； 双图片缓冲：旧动作持续播放，新动作解码完成后原子接管； 用户预览与点击动作可立即抢占，后台事件在 40ms 窗口内合并； reduced-motion 与低性能模式下保留真实状态文案，可停用视觉运动。 上下文与用量 当前上下文占用率； 当前模型、轮次、步数和 Token 分类； 独立 Lifetime Ledger：归档或删除源对话后仍保留累计值； 每模型、每日期累计； 本日小时趋势与请求次数； 清空历史使用明确二次确认，并通过水位机制防止旧日志回灌。 成本估算与月预算（默认关闭） 默认不显示任何成本信息；到 设置 → 成本与预算 勾选"显示成本估算"后才启用； 纯本地价格表（USD / 1M token），键支持模型名、claude-* 前缀与 * 兜底； 可视化编辑：表格逐行填写"模型名 / 输入 / 输出 / 缓

动作循环演示

动作说明 安装 重要：这是一个 Web 界面插件，必须在 DSH 的 Web 界面里才能显示宠物。你只需要把它装到正在运行的 DSH 网页版/桌面版即可，不需要额外执行 dsh web。 方式一：在 DSH Web 界面内直接安装（推荐给普通用户）

如果你已经打开 DSH 的网页版或桌面版：

1. 打开 设置 → 插件市场 / 插件管理； 2. 搜索 dsh-token-pet； 3. 点击安装； 4. 重启 DSH（或刷新 Web 页面）。

不需要执行任何命令行，也不需要 dsh web。 方式二：命令行安装（开发者 / 命令行用户）