dsh-pet-remielle · 蕾米埃尔桌宠

由 DSH 真实会话事件驱动的多宠物网页桌宠：桌宠实时跟随 DeepSeek Harness 的任务进展，以贴纸动画 + 状态气泡呈现。

• 多宠物注册表 + 状态气泡（项目 / 阶段 / 待办 / 进度实时汇报）
• SSE 实时推送 + 可选的桌面悬浮窗（随包 Electron，透明置顶）
• 双击画画联动：粗笔刷揭示作品图（绘制中 → 得意中 → 淡出）
• 一键版本检查 + 增量更新
• 设置页与插件详情页共用设置（外观 / 宠物 / 行为 / 桌面悬浮 / 关于）

兼容 DeepSeek Harness（含其分支）的 web profile；桌面悬浮模式默认关闭，可按需开启。桌面模式要求 DSH >= 0.1.2-alpha.1，以提供带 token 的认证根 URL。

---

特性一览

能力	说明
状态来源	DSH session/event 真实事件，非 DOM 抓取
状态机	PetReducer 纯函数（含 mood 映射，可单测）
消息协议	类型化协议（protocol.js）
配置	schemastery 持久化 + DSH 设置页 / 插件详情页
多 Session 优先级	审批 > 计划审核 > 等待回答 > 完成提醒 > 等待/错误 > 当前会话 > 状态优先级 > 更新时间。同级仅稳定前两名，第三名及以后仍随更新时间轮转
实时推送	SSE 流（断线自动重连 + 轮询兜底）
状态气泡	页面内与桌面悬浮均使用自适应两层牌叠：顶层状态卡 + 带 +N 的汇总背板；message + detail（项目 · 已完成 x/y · 阶段）
会话操作	网页与桌面一致：点卡片 / ? / ! 打开对应会话，✓ 允许一次；无网页客户端在线时点卡片/图标用系统浏览器打开 DSH 页面
完成提醒	后台完成后保留绿点直至处理；仅前台可见的标签页中的当前会话会自动消除（即便此刻正开着桌面悬浮窗），后台标签页不抢清除；桌面悬浮窗只展示提醒，点开该会话（网页内跳转、浏览器打开，或点击桌面完成卡）同样消除。当前已打开会话不显示未读绿点（仅当前 Host 生命周期）
出错提醒	后台回合失败（模型调用失败等）保留粉圈直至打开该对话；当前会话失败不进提醒。点气泡跳转或侧边栏点进该对话后提醒消失。审批/提问不受影响
余额	状态与用量都开启时，点气泡左侧圆点或在气泡上滚轮切换余额页（60s 自动刷新、数字滚动动画、网络抖动沿用最近余额）；停在当前页，不自动回落
今日已用	双模式任选：小鲸鱼记账（免令牌，余额差值累计）/ 实时·令牌（平台费用接口直接返回真实金额，精确）
桌面悬浮	随包 Electron 透明置顶窗口（可选，默认关）
多宠物	插件 → 蕾米埃尔桌宠 → 宠物（注册表 + 切换当前宠物）
版本更新	内置检查 + 一键增量更新

---

贴纸（mood）→ 状态映射

贴纸	展示	触发场景
01 绘制中	<img src="assets/pets/remielle/01.gif" width="56" alt="01 绘制中"/>	THINKING + streaming：流式输出（正在写回复）、双击画画
02 摸鱼中	<img src="assets/pets/remielle/02.gif" width="56" alt="02 摸鱼中"/>	WORKING / ERROR：调用工具（查找/编辑/测试/命令）
03 得意中	<img src="assets/pets/remielle/03.gif" width="56" alt="03 得意中"/>	PULSE SUCCESS：回合完成、绘制完成、点击互动
04 思考中	<img src="assets/pets/remielle/04.gif" width="56" alt="04 思考中"/>	THINKING：回合/步骤开始、推理、结果整理
05 等待中	<img src="assets/pets/remielle/05.gif" width="56" alt="05 等待中"/>	WAITING：提问回答、审批等待、计划待审、回合挂起（blocked）
06 待机中	<img src="assets/pets/remielle/06.gif" width="56" alt="06 待机中"/>	IDLE / DISCONNECTED：空闲、回合结束之后

多 Session 同时运行时按 审批 > 计划审核 > 等待回答 > 完成提醒 > 等待/错误 > 当前会话 > 状态优先级 > 更新时间 选择顶层任务；其余会话由可点击的 +N 汇总背板表示。子 Agent 默认忽略（可在设置开启）。

宠物定义约定

assets/pets/<id>/01.gif  绘制中（输出/画画）
assets/pets/<id>/02.gif  摸鱼中（工具/错误）
assets/pets/<id>/03.gif  得意中（完成/互动）
assets/pets/<id>/04.gif  思考中
assets/pets/<id>/05.gif  等待中
assets/pets/<id>/06.gif  待机中

可选扩展（不影响完整性校验）：

assets/pets/<id>/07.gif           额外贴纸槽位
assets/pets/<id>/pet-manifest.json  每贴纸对齐偏移 + 作品图数量
assets/pets/<id>/pics/<n>.png      作品图（双击宠物随机弹出，n 从 1 起）

id 只能含字母、数字、下划线、连字符。内置宠物：蕾米埃尔（remielle，素材版权见 NOTICE）。

---

安装

适用于 DSH / DeepSeek Harness（含 Fairy 等基于 DSH 的分支）的 web profile。

# 方式一：npm 注册表（推荐，可一键增量更新）
dsh plugin --profile web add dsh-pet-remielle

# 方式二：GitHub 仓库（构建安装，无版本校验）
dsh plugin --profile web add github:Gin-7/dsh-pet-remielle

# 方式三：本地目录（开发调试，link 安装）
dsh plugin --profile web add D:\path\to\dsh-pet-remielle

# 方式四：GitHub Release tgz
dsh plugin --profile web add "C:\Users\you\Downloads\dsh-pet-remielle-<version>.tgz"

插件行 id：dsh-pet-remielle。卸载即复原，无残留。

---

更新

插件内置「宠物管理 → 更新」页 + 右下角更新气泡：检查 GitHub 最新版本，发现新版可一键更新。

安装形态	版本	更新方式
本地链接（link）	≥ 0.3.0	一键 git pull（增量）
npm 注册表（registry）	≥ 0.3.0	一键 pnpm update dsh-pet-remielle（增量）
任意形态	< 0.3.0	不支持自动更新：0.3.0 起包名已变更，需彻底卸载旧版本后重新安装

…