前言¶
DeepSeek Harness (DSH) 采用了插件化架构，允许开发者根据需求扩展功能。在本地运行和调试时，开发者需要直观地了解当前系统的运行状态（如模型是否在工作、是否正在进行上下文压缩）以及资源消耗情况（Token 使用量、成本）。日志文件虽然详尽，但在调试过程中不够直观。dsh-token-pet 旨在通过一个常驻桌面的 Q 版角色，将 DSH 的后台事件（请求、工具调用、压缩、归档等）转化为可视化的动画与数据面板，让状态反馈即时可见，同时提供 Token 统计与成本估算能力。
插件简介¶
dsh-token-pet 是一个为 DeepSeek Harness Desktop 提供悬浮桌面宠物、运行状态反馈与 Token / 上下文可视化能力的插件。
- 作者：Jimmy0123-ux
- 类别：趣味换装
- 许可证：MIT
- 核心价值：将后台事件状态化、可视化；提供跨会话的 Token 账本与成本估算；集成本地提示词增强工作流。
核心功能¶
该插件主要包含以下功能模块：
运行状态可视化¶
系统会将当前请求、工具调用、上下文压缩、会话归档和提示词增强等真实 DSH 事件转化为 12 个正式逐帧动作。用户无需打开日志，就能通过宠物右上角的状态牌看到系统此刻处于空闲、工作中、压缩中、工具完成/失败或提示词生成等状态。
实时上下文展示¶
宠物下方会实时显示上下文占用率。配合独立的可拖动浮窗，用户可以查看当前会话的详细数据，包括轮次、步数、模型耗时以及 Token 分类。
跨会话 Lifetime Ledger¶
插件维护一个跨会话的终身用量账本。即使源会话被归档或删除，该账本仍会保留累计值，方便长期追踪使用情况。
成本估算与预算¶
默认情况下不显示成本信息。用户可在设置中开启“显示成本估算”。开启后，插件会在本地根据价格表估算本月与各模型的成本，并支持设置月预算。当成本超限时，宠物会播放预警动作。
数据分析与管理¶
- 模型与趋势分析：支持按服务商、模型和日期统计，提供近 7 日或 30 日聚合趋势（按本地时区）。
- 会话成本排行：展示最耗 Token 的会话列表。
- 数据导出：支持导出 JSON 或 CSV 格式的用量统计（仅包含数字，不含对话内容）。
提示词增强工作流¶
集成本地 MIT Prompt Optimizer 规则。用户可以在独立抽屉中对提示词进行预览、编辑、覆盖、追加或撤回，并直接发送到 DSH Composer。
界面与交互¶
- 主题切换：支持深色（默认）/浅色主题，一键切换生效。
- 皮肤系统：内置 4 套配色皮肤，并支持导入本地皮肤 ZIP 文件。
- 低打扰设计：采用纯快照面板读取与后台增量索引，避免打开界面时扫描全部会话，确保性能流畅。
安装与启用¶
注意：这是一个 Web 界面插件，必须在 DSH 的 Web 界面中才能显示宠物。宿主环境必须包含 Web UI 组件（@deepseek-ai/dsh-web-app）。
命令行安装¶
如果使用命令行启动 DSH，可以使用以下命令安装：
# 网页版
dsh plugin --profile web add dsh-token-pet
# 桌面版
dsh plugin --profile desktop add dsh-token-pet
安装完成后，需重启 DSH（或刷新 Web 页面）以使插件生效。
典型用法¶
- 主题切换：在设置 → 外观中选择“浅色”或“深色”，界面主题即时切换。
- 查看成本：在设置 → 成本与预算中勾选“显示成本估算”，浮窗“总览”中会出现成本卡片与月预算进度条。
- 导出数据：在设置页选择导出 JSON 或 CSV 格式的用量统计。
- 设置提示音：在浮窗设置 → 语言与通知中开启“完成提示音”，在会话成功完成后会听到提示音。
- 提示词增强：在提示词增强抽屉中编辑提示词后，点击“直接发送”即可提交到 DSH。
注意事项¶
- 环境依赖：插件依赖宿主包含 Web UI 组件。如果提示“缺 WebUI 组件”，请确认目标 profile（web 或 desktop）包含
@deepseek-ai/dsh-web-app。 - 版本要求：依赖 Node.js 版本 >= 22.19。
- 本地处理：成本估算仅为本地参考，不请求任何外部价格接口，也不上传用量数据。
- 隐私保护：仅统计数字，不含对话内容。
- 皮肤导入：导入本地皮肤 ZIP 时，客户端会进行路径与大小校验（上限 24MiB / 64MiB）。
总结¶
dsh-token-pet 通过视觉化的方式解决了 DSH 开发者对运行状态和资源消耗的监控需求，同时提供了实用的成本追踪与提示词增强工具。其轻量级的设计和低打扰的性能优化，使其能够无缝集成到日常开发流程中。
