前言¶
在 DSH（DeepSeek Harness）里长时间跑会话时，界面往往只有文本流和工具步骤在变化，很难一眼看出「现在在等什么」：是模型在思考、正在写文件，还是卡在工具审批上。自己盯 DOM 或翻日志可以判断，但成本偏高。
下面介绍社区插件 dsh-remielle-pet（蕾米埃尔桌宠）：由维护者 Shinarin 发布，在 DSH 的 Web UI 与桌面版中以浮层形式显示一只桌宠，根据当前会话状态自动切换对应 GIF，并在需要人工介入时做弹跳或提示音提醒。插件遵循 DSH 官方插件生态约定（GitHub 话题 dsh-plugin，包内含 locale/ 与 icon.png），可在 DSH 插件管理页直接识别。分类为趣味换装；仓库当前为 MIT 许可证，版本见发布页（package 元数据中为 1.1.1）。
这是什么¶
dsh-remielle-pet 是 DSH 桌宠插件：不替代会话逻辑，只做「状态可视化 + 轻量互动」。客户端通过读取 DSH 前端 DOM 的稳定契约（data-* 与 aria-label）推断状态；服务端提供内置默认 GIF 的静态路由与配置持久化。GIF 加载失败时会降级为按状态着色的占位动画，避免浮层消失。
核心功能¶
状态跟随¶
实时检测 DSH 会话状态，按优先级切换 GIF（自定义或内置默认）：
| 优先级 | 设置面板标签 | 默认 GIF | 触发场景 |
|---|---|---|---|
| 1（最高） | 待审核 | approval.gif | 工具审批、AI 提问、计划评审 |
| 2 | 编辑中 | answering.gif | 流式文本输出，或工具调用（写文件、编辑、运行命令等） |
| 3 | 思考中 | thinking.gif | 会话运行中但暂无产出：等首 token、reasoning 流式、工具步骤间隙、模型重试 |
| 4 | 空闲中 | idle.gif | 会话未运行或回合已结束 |
典型一轮顺序：发送消息 → 思考中 → 编辑中 →（若出现审批）待审核 → 审批后回到编辑中 → 回合结束 → 空闲中。
说明：切换到 Trajectory 标签页、后台自动压缩（compaction）期间，DSH 前端没有可供检测的运行标记，桌宠会显示为空闲中。
桌宠右上角有状态点：绿（空闲）、橙（思考）、蓝（编辑）、红（待审核）。
互动与位置¶
- 拖动：移动桌宠；位置以距窗口右下角的偏移保存，缩放、最大化与重启后仍锚定右下角。
- 单击：摸头并飘爱心。
- 双击：执行设置里「双击动作」（当前可选：摸头冒爱心）。
- 右键：打开桌宠设置。
首次默认在右下角往左 100px、往上 200px；拖动后记住新位置。
审批提醒与自定义素材¶
出现待审批、待回答提问或计划评审时可弹跳提醒，提示音可选（默认弹跳开、提示音关）。各状态可分别上传自定义 GIF（建议透明底、单张约 1MB 以内）；数据以 base64 存本机 localStorage，不上传服务器。「完成提醒」相关选项当前版本尚未接入触发逻辑，设置项保留。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议浏览 GitHub 仓库 源码与 LICENSE，确认符合你的环境策略。
从 GitHub 安装（推荐）¶
在 DSH 设置 → 插件 → 添加插件中输入：
github:Shinarin/dsh-remielle-pet
或使用命令行（桌面 profile 示例）：
dsh plugin --profile desktop add github:Shinarin/dsh-remielle-pet
包名与仓库名均为 dsh-remielle-pet（用于与 npm 上同名桌宠插件区分）。旧地址 github:Shinarin/dsh-pet 会重定向，仍建议用新地址。
本地路径¶
dsh plugin --profile desktop add <本仓库的绝对路径>
安装或更新后需完全退出并重启 DSH 方可生效。
若本机曾用本地 link: 安装旧版 dsh-pet，切换来源前应先卸载旧版并重启，再装 GitHub 版，避免 Windows 上 junction 相关安装挂起。
卸载：设置 → 插件 → 找到 dsh-remielle-pet → 卸载。
从 dsh-pet 升级¶
1.1.0 起插件标识改为 dsh-remielle-pet。可先备份 ~/.dsh/plugins/dsh-pet/config.json；安装新版并重启后，再在插件页卸载旧 dsh-pet 并重启。新版会尝试从旧 config 迁移到新路径 ~/.dsh/plugins/dsh-remielle-pet/config.json；localStorage 里位置、大小与自定义 GIF（key dsh-pet:*）升级后仍可用。新旧可短暂共存（两只桌宠），迁移完再卸旧版。
典型用法与设置¶
日常无需额外命令：装好并重启后，桌宠随会话自动换图；需要时在右键设置里调大小（50%–250%，默认 100%）、开关显示、审批提醒，或为四种状态上传/清除自定义 GIF。
DSH 设置面板 → 桌宠设置 中主要项：显示、大小、双击动作、审批提醒（弹跳/提示音）、各状态 GIF。服务端路由包括 /plugins/dsh-remielle-pet/default-gif/:state 与 /plugins/dsh-remielle-pet/config（详见仓库 spec/）。
排障时可打开开发者工具，过滤控制台 [DSH-REMIELLE-PET] 日志查看状态判定依据；状态与 DOM 不符时可将日志与场景提交 Issues。深度思考（reasoning）流式归入「思考中」，文本与工具执行归入「编辑中」，这是插件按产品规则的划分。
若与桌面级置顶桌宠（如其它原生置顶窗口插件）同时启用，操作系统窗口层可能遮挡或截走鼠标事件；浮层热区约 220×220（随缩放比例变化）。身份不同的桌宠插件可同时安装，本插件不参与 z-index 争抢。
适用场景与注意¶
适合希望在 DSH 界面里用轻量视觉反馈跟踪会话阶段、并在审批节点获得提醒的开发者。不适合把桌宠当作会话控制或安全边界——它只读前端状态并展示 GIF。
社区目录 SkillHub 插件页 与 GitHub 为独立信息来源，与 DeepSeek / 幻方无官方从属关系；安装与行为以仓库 README 与 spec/ 为准。
结尾¶
dsh-remielle-pet 把 DSH 会话的「待审核 / 编辑 / 思考 / 空闲」映射到一套可自定义的 GIF 与简单互动，Web 与桌面版共用同一套逻辑。需要安装地址与细节时，可查阅 SkillHub 目录 与 GitHub：Shinarin/dsh-remielle-pet。
