DeepSeek Harness（DSH）采用插件化架构，旨在通过模块化扩展能力。在开发与多会话管理场景中，用户往往需要直观的状态反馈和任务进度追踪。dsh-foxbell-pet 插件通过在 DSH Web 或桌面端右下角提供可拖拽的桌宠系统，将多项目状态监控、效率用量看板与语音交互集成在一个可视化的界面中。
该插件由 jarvislee90s-dot 维护，默认内置小狐狸 Foxbell，支持通过外部宠物体系进行热切换。
核心功能¶
多项目状态监控
桌宠头顶会根据 MAM（多 Agent 管理）色彩口径显示状态卡片：
* 红：待审批
* 黄：运行中
* 绿：完成未读（点击可确认消失）
* 深红 + ⚠：错误断联（与待审批红区分）
点击状态卡片可直接切换到该项目会话并标记已读。
外部宠物体系
插件提供完整的宠物管理功能：
* 热切换：内置宠物与导入宠物同场管理，点击即可切换，无需刷新页面。
* 多来源导入：支持本地文件夹、Zip 包、Codex 宠物目录以及 Petdex 在线仓库导入。
* 完整性守卫：切换时校验图集、语音与清单的完整性，确保运行稳定。
* 磁商店管理：宠物数据存储在 ~/.dsh/foxbell-pet/pets/<id>/，支持安全删除（移入回收站）。
效率与用量看板
* 效率看板：基于事件时间轴展示“节奏姿态”，包括高强度、活跃、长任务、空闲及摸鱼状态。悬停宠物可查看五口径 Token 用量（请求输入、缓存命中、命中率、产出、你的输入）。
* 用量看板：提供三级披露（L1 迷你条、L2 小黑板、L3 主列大看板），支持按日/小时/路由/工具折叠数据，并提供导出图片功能。
交互与物理手感
* 拖拽物理：支持水平抛掷惯性、重力坠落以及落地压扁回弹，位置记忆与边界钳制。
* 语音交互：完成播 done 组、待审批播 approval 组（10s 限流）、报错播 error 组。
* 右键菜单：提供显隐开关、大小调节（0.75/1/1.25）、五场景动作绑定、宠物切换及关于信息。
安装与启用¶
使用官方安装命令即可完成安装，插件构建产物随仓库提交，无需本地构建。
dsh plugin --profile web add github:jarvislee90s-dot/dsh-foxbell-pet#release
安装完成后，重启 dsh web 并硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到桌宠。设置页面会出现 foxbell-pet 配置卡，侧栏底部有显隐开关。
使用说明¶
- 切换宠物：在右键菜单或设置卡的“宠物管理”区点击切换，即时生效。
- 查看用量：鼠标悬停在桌宠上约 0.5 秒可查看迷你条，点击右键选择“📊 查看最近总结”或“📈 用量看板”可展开详细数据。
- 动作绑定：在右键菜单的“五场景动作绑定”中可配置双击、红灯、黄灯、深红灯、绿灯对应的动作，并支持实时预览。
环境要求与注意事项¶
- 宿主版本：需安装 DeepSeek Harness (DSH) ≥ 0.1.2-rc.1。v2.3.0 版本已适配 DSH 0.2.0-rc.2 桌面端运行时。
- 版本兼容：v1.x 版本不支持，请确保使用 v2.x 系列。
- 依赖说明：插件不直接依赖
@deepseek-ai/dsh-settings，该服务由宿主运行时提供。 - 本地开发：若需从源码安装，需 Node ≥ 20 与 pnpm，使用
dsh plugin --profile web add .以 link 方式安装。
总结¶
dsh-foxbell-pet 是一款将实用监控工具与桌面宠物结合的 DSH 插件。它通过可视化的方式解决了多项目状态追踪与 Token 用量统计的需求，同时提供了丰富的交互与自定义空间。
