DSH Token Pet · 用量小宠物

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

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

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

当前版本：0.1.0 · Node.js >=22.19

核心能力一览

• 运行状态可视化：12 个正式动作反馈请求、工具、压缩、归档、点击和提示词增强；
• 实时上下文：常驻显示上下文占用率，并在浮窗展示轮次、步数、模型耗时和 Token 构成；
• 终身用量账本：跨会话保存单调累计，源会话归档或删除后仍保留历史值；
• 模型与趋势分析：按服务商、模型和日期统计，并以用户本地时区展示小时趋势与请求次数；
• 提示词增强工作流：跟随当前会话模型路由，结果可预览、编辑、覆盖、追加、撤回或直接发送；
• 低打扰性能设计：纯快照面板读取、10 秒请求deadline、后台增量索引、旧数据保留和有限重试；
• 桌面化交互：宠物与浮窗独立拖动、尺寸持久化、视口恢复、reduced-motion和低性能模式。

功能与界面

功能	界面位置 / 效果
当前运行状态	宠物右上角状态牌：空闲、工作中、工具完成、提示生成中等
上下文占用	宠物下方显示 上下文 xx%
当前会话数据	浮窗“总览”中的当前上下文、轮次、步数与模型耗时
Lifetime Ledger	浮窗“总览”中的终身用量账本与模型排行
本日趋势	按本地时区聚合的小时趋势折线图
模型明细	浮窗“模型”页，按服务商与模型展示累计用量
设置与维护	浮窗“设置”页，包含尺寸、动画速度、低性能模式、索引维护和动作预览
提示词增强	独立抽屉：预览、编辑、覆盖、追加、复制、撤回和直接发送

主要功能

宠物与状态反馈

• 单一固定角色身份，不随上下文档位更换角色或服装；
• 12 个正式逐帧动作，每个动作 32 帧、100ms / 帧；
• 固定脚底锚点与动作级水平锚点，避免跨动作漂移；
• multi-row 宽条带、ping-pong 循环和 one-shot 完整播放；
• 双图片缓冲：旧动作持续播放，新动作解码完成后原子接管；
• 用户预览与点击动作可立即抢占，后台事件在 40ms 窗口内合并；
• reduced-motion 与低性能模式下保留真实状态文案，可停用视觉运动。

上下文与用量

• 当前上下文占用率；
• 当前模型、轮次、步数和 Token 分类；
• 独立 Lifetime Ledger：归档或删除源对话后仍保留累计值；
• 每模型、每日期累计；
• 本日小时趋势与请求次数；
• 清空历史使用明确二次确认，并通过水位机制防止旧日志回灌。

性能浮窗

• 宠物与面板可独立拖动；
• 面板支持等比例缩放，按住 Shift 可自由缩放；
• 打开面板只读取持久化快照，不自动扫描历史或启动索引同步；
• 所有面板请求有 10 秒 deadline，失败后保留旧快照；
• 趋势后台刷新时仍展示已有数据；
• 索引增量维护由宿主后台协调器执行，用户也可显式“立即同步”。

提示词增强

• 仅在用户点击后执行，不自动增强；
• 未指定模型时跟随当前 DSH 会话路由，并回退到 agentDefaultModel；
• 支持自定义模板与 {{prompt}} 占位符；
• 结果进入独立编辑区，不会自动发送；
• 直接发送通过 DSH 官方 inputActions 写入并提交，不伪造 HTTP 请求；
• 插件日志不保存完整提示词。

宠物动作展示

动作循环演示

动作说明

动作	中文状态	触发场景	预览
idle	空闲	无任务时持续播放
working	工作中	请求运行、会话执行
eating	压缩中	上下文压缩开始
digesting	整理中	上下文压缩完成后的整理阶段
warning	上下文预警	上下文接近阈值或提示异常
evolve	状态更新	压力档位发生变化时的庆祝动作
click	打招呼	用户点击宠物
archive	已归档	会话归档或移除
tool-success	工具完成	工具调用成功
tool-failure	工具失败	工具调用失败
prompt-enhancing	提示生成中	提示词增强请求执行中
prompt-ready	提示已就绪	增强结果返回

安装与分享

本机源码 link 安装

git clone https://github.com/Jimmy0123-ux/dsh-token-pet.git
Set-Location dsh-token-pet
npm install
npm run build

dsh plugin --profile desktop add link:<本项目绝对路径>

从 npm 安装

dsh plugin --profile desktop add dsh-token-pet

GitHub Release / tgz 安装

# 直接安装公开Release
dsh plugin --profile desktop add https://github.com/Jimmy0123-ux/dsh-token-pet/releases/download/v0.1.0/dsh-token-pet-0.1.0.tgz

# 或安装已下载的本地文件
dsh plugin --profile desktop add C:\path\to\dsh-token-pet-0.1.0.tgz

宿主代码或客户端代码更新后建议完整重启 DSH Desktop。推荐使用 npm；开发调试使用源码 link。

开发与验证

npm install
npm run typecheck
npm test
node scripts/qpet-asset-audit.mjs
# 可选：仅在本地保留 Review/h3-actions 生产源时运行
python scripts/check-strip-stability.py
npm run build
npm pack --dry-run --json

当前主要门禁：

• TypeScript host / client 双工程检查；
• 126+ 项 Node 测试；
• QPet 资源、固定身份、帧数、脚底锚点和播放器结构审计；
• click / prompt-enhancing 水平稳定性检查；
• 发布包去重检查（无 sourcemap、无重复独立条带）；
• 面板纯快照读取、后台同步、deadline 与双缓冲回归。

构建产物

lib/index.js       # DSH 宿主插件
client/client.js   # 自包含 Web 客户端 bundle

发布包只包含 lib、client/client.js、文档和配置；生成源、Review 视频、ZIP、逐帧素材与 node_modules 不进入 npm 发布包。

项目结构

src/index.ts                         宿主路由、索引与后台协调器
src/client/index.ts                  浮窗挂载、状态桥接和客户端请求
src/client/pet.tsx                   宠物 HUD 与状态展示
src/client/pet-action-player.tsx     双缓冲逐帧播放器
src/client/pet-action-sheets.generated.ts  内嵌 WebP 条带注册表
assets/pet/action-sheets/            可选宿主条带文件
docs/                                产品、制作与开发文档
scripts/                             生成、审计和稳定性脚本
tests/                               host / client / persistence 回归测试

数据、隐私与安全

• 统计数据来自本地 DSH 会话持久化层；
• 面板打开只读取持久化快照，不扫描历史；
• 后台索引采用单飞、分片和低频兜底；
• 提示词增强只在用户明确点击后执行；
• 不在插件日志中保存完整提示词；
• 皮肤与资源路径经过校验，不允许路径穿越、脚本或可执行内容；
• Review 目录中的生成源、视频、ZIP和个人审核素材不提交到仓库。

清晰度与性能边界

• 默认 size=120、DPR≤2 时使用 540px 源 cell 降采样显示；
• DPR=1 下 size≤320 不超过源分辨率；
• DPR=2 且大尺寸时会触及源图上采样上限；
• 播放器固定最多两个图片缓冲，并在交换后释放旧 src；
• 当前客户端内嵌条带以避免 host/client 更新时序不一致；发布包已移除 sourcemap和重复条带文件。

文档

• 产品与技术设计
• 开发清单
• 动作资源与运行时规范

README媒体可通过以下命令重新生成：

python scripts/build-readme-media.py

许可证

项目代码以 MIT License 发布。仓库内宠物运行时素材随本插件公开分发；若要在其他项目中单独复用美术素材，请先联系项目作者确认授权。