前言¶
在 DeepSeek Harness（DSH）里跑智能体任务时，宿主侧往往更关注会话与工具链本身：Token 花了多少、按官方价大概多少钱、有没有顶到自设预算，通常要另找统计或记账方式。归档会话也不能等同于从本地彻底清掉记录。若你还希望长时间开发时有个不挡操作的状态提示，纯 Web 界面又缺少这类「贴桌面的」反馈。
下面介绍社区插件 DSH 伴侣（@qiuzhiyei/dsh-companion）：面向 DSH 的客户端类伴飞插件，把桌宠、用量与费用统计、预算告警、历史导出和会话管理放在同一套本地能力里。维护者为 qiuzhiyei（QiuWenXiong），源码与说明见 GitHub，也可在 SkillHub 插件目录 查看条目。DSH 生态强调「一切皆插件」；SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
DSH 伴侣 是给 DeepSeek Harness 使用的 npm 插件包，当前 README 与 package.json 中的版本为 1.0.4，许可证 MIT。简介概括为：桌宠陪伴、Token/费用相关统计与估算、预算告警，以及对宿主界面的增强；分类上属于 客户端 插件（dsh.client 注入宿主 UI 工作区）。插件说明强调数据在本地处理，不依赖本文未列出的外部上报流程。
核心功能¶
以下能力均来自项目 README 的功能列表，按使用面归纳。
桌宠与界面¶
- 桌宠：随任务状态切换表情，支持拖动与交互，空闲时会自行「散步」。
- 5 套皮肤：JK、秘书、女警、中华娘、旗袍；皮肤会连带表情与台词口吻变化。
- 桌面悬浮窗：透明置顶、点击穿透，并提供系统托盘能力（README 表述为「真托盘」）。
用量、费用与告警¶
- 统计面板：展示 Token、任务数、成功率、时长、费用、缓存命中等，并带环比。
- 费用估算：按 DeepSeek 官方计价，区分高峰/闲时分档，缓存命中单独计价。
- 预算告警：支持单任务或每日上限，可按 Token 或费用设限；触顶时通过气泡与系统通知提醒。
数据与会话¶
- 历史与导出：可按模型、状态、日期、关键词筛选，导出 CSV 或 JSON。
- 会话管理：支持彻底删除会话（README 说明宿主侧仅提供归档，本插件补足「删干净」的需求）。
- 久坐提醒：坐满指定分钟数后提醒起身活动（具体分钟数以插件内配置为准，README 仅描述为「坐够 N 分钟」）。
安装与启用¶
安装方式以 README 为准，分桌面与命令行两种。
桌面版（DSH 插件管理器）
- 打开插件管理器 → 安装插件。
- 输入包名
@qiuzhiyei/dsh-companion。 - 安装后在管理器中 启用 该插件。
- 完全退出 DSH 后重新打开，使客户端注入生效。
命令行
将 <你的 profile> 换成你实际使用的 DSH profile 名称：
dsh plugin --profile <你的 profile> add @qiuzhiyei/dsh-companion
装完后同样需要在插件管理器里 启用，并 完全退出重开 DSH。README 注明：桌宠首次启动会自动下载运行时（约 150 MB，国内镜像），无需手动安装 Electron。
典型用法¶
README 未给出单独的「配置 YAML 片段」或逐步截图教程；实际使用路径可以概括为：
- 按上一节完成安装、启用与重启 DSH。
- 在客户端界面中使用统计面板查看 Token、任务与费用等指标，并留意环比变化。
- 在插件提供的预算相关设置里配置单任务或每日上限（Token 或费用），触顶时关注气泡与系统通知。
- 需要留档时用历史筛选导出 CSV/JSON；需要清理本地会话记录时使用会话彻底删除，而非仅依赖宿主归档。
- 若启用桌宠，首次启动等待运行时下载完成；之后可通过皮肤切换改变形象与台词风格，桌宠会随任务状态更新表情。
开发侧若需自研或排错，仓库 README 给出构建与测试命令：
pnpm install && pnpm run build
pnpm test
架构说明见仓库内 AGENTS.md，发版流程见 npm发布.md。
适用场景与注意¶
适合谁
- 长期在 DSH 桌面客户端里跑任务，希望 用量、费用、缓存命中 一眼可见，并要做 预算封顶提醒 的开发者。
- 需要 本地导出 历史、或要把会话从本地 彻底删除 的用户。
- 接受在桌面增加 桌宠 / 悬浮窗 作为状态陪伴，并需要久坐提醒的场景。
使用前请注意
- 插件随当前 DSH 进程权限 运行，安装前请自行阅读 源码仓库 与 MIT 许可证，确认符合你的安全与合规要求。
- 费用为 按官方规则的估算，实际账单以 DeepSeek 侧为准；高峰/闲时与缓存计价规则以插件实现与当时官方文档为准。
- 桌宠首次运行有 约 150 MB 运行时下载，网络环境差时需预留时间；启用与重启步骤不可省略，否则客户端注入可能未加载。
结尾¶
DSH 伴侣 把桌宠、本地化的 Token/费用统计、预算告警、历史导出和会话彻底删除收进一个客户端插件，适合在 Harness 里长期跑任务、又希望数据和提醒留在本机的用户。条目与分类见 SkillHub：qiuzhiyei/dsh-companion；安装包与完整功能列表见 GitHub：qiuzhiyei/dsh-companion。
