dsh-pet-remielle

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

由 DSH 真实会话事件驱动的多宠物网页桌宠：桌宠实时跟随 DeepSeek Harness 的任务进展，以贴纸动画 + 状态气泡呈现。 多宠物注册表 + 状态气泡（项目 / 阶段 / 待办 / 进度实时汇报） SSE 实时推送 + 可选的桌面悬浮窗（随包 Electron，透明置顶） 双击画画联动：粗笔刷揭示作品图（绘制中 → 得意中 → 淡出） 一键版本检查 + 增量更新 设置页与插件详情页共用设置（外观 / 宠物 / 行为 / 桌面悬浮 / 关于） 兼容 DeepSeek Harness（含其分支）的 web profile；桌面悬浮模式默认关闭，可按需开启。桌面模式要求 DSH >= 0.1.2-alpha.1，以提供带 token 的认证根 URL。 特性一览 贴纸（mood）→ 状态映射 多 Session 同时运行时按 审批 > 计划审核 > 等待回答 > 完成提醒 > 等待/错误 > 当前会话 > 状态优先级 > 更新时间 选择顶层任务；其余会话由可点击的 +N 汇总背板表示。子 Agent 默认忽略（可在设置开启）。 宠物定义约定

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

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

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

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

插件内置「宠物管理 → 更新」页 + 右下角更新气泡：检查 GitHub 最新版本，发现新版可一键更新。 | 任意形态 | 说明：0.3.0 之前存在包名/行 id 变更（0.2.0 之前为 @dsh-external/dsh-client-ui-pet-remielle，0.2.0–0.3.0 为 dsh-pet-remielle）。直接 git pull/pnpm update 无法跨过该变更，所以低于 0.3.0 必须先卸载旧版再重装新版（否则会出现 loaded without registering … via ModuleLoader.load 之类的加载报错）。命令如下： 在「插件 → 蕾米埃尔桌宠 → 关于」中，低于 0.3.0 的版本点击「一键更新」也会给出同样的卸载/重装指引，不会直接覆盖升级。 桌面悬浮模式（可选）

desktopMode 默认关闭。开启后使用 Electron 运行时拉起透明、置顶、无边框的独立窗口显示宠物。 窗口支持拖动（位置自动记忆）、滚轮缩放、双击画画、右键菜单。 状态/余额气泡与网页一致：堆叠会话卡、单圆点切换、提示文字与点击行为同网页；✓ 仍执行「允许一次」。 已知限制：「有待处理内容」的绿点信息来自网页侧边栏，仅在网页端在线时同步给桌面窗。网页关闭期间出现的新提醒可能不出现在桌面气泡里，下次打开网页即可看到；日常保持网页开启则不受影响。 桌面窗按系统缩放自动补偿 UI 尺寸，与网页端视觉大小一致。 双击画画：作品显示在桌面右上角的独立小窗，粗笔刷沿对角来回揭示，完成后「得意中→淡出」。 右键菜单与网页端完全一致（见下方「使用」）。 关闭/切换后自动回到页面内；随 DSH host 退出自动关闭（宿主退出后最多 1 秒内消失）。 桌面窗的 Electron 数据目录固定在系统应用数据目录（Windows %APPDATA%\dsh-pet-remielle，macOS / Linux 落在各自的应用数据目录），不放临时目录——%TEMP% 会被系统磁盘清理连缓存一起删掉。同一时刻只允许一个桌面窗持有它：检测到另一个存活实例（宿主刚重启、旧窗口还没退完）时自动退避到带 pid 的兄弟目录，两者不共用同一份 Chromium 缓存。

Electron 运行时来源（按顺序探测）：DSH_PET_ELECTRON 环境变量 → vendor/electron- - /（本目录不进 Git，按当前系统自动下载对应平台包）→ 系统已安装的 Electron → 均无则仅页面内展示。 首次运行：若开启桌面悬浮模式但本机找不到 Electron 运行时，会提示下载并安装（需你确认，因 Electron 运行时约 100–220MB，Windows 最大）；下载失败则自动回落页面内展示，不会影响其他功能。也可手动把任一对应平台的 Electron 发行包解压到 vendor/electron- - /，或设置 DSH_PET_ELECTRON 指向现有 electron 可执行文件（Windows：electron.exe；macOS：Electron.app/Contents/MacOS/Electron；Linux：electron）。 平台能力 使用 单击桌宠：切换随机贴纸心情。 双击桌宠：进入画画动画，绘制完成后在屏幕（右上角）弹出作品图，随后淡出。 右键桌宠：页面内与桌面窗同一套菜单（同宽同序，滑块左右对齐）—— 角色大小 / 透明度 / 左右镜像 / 锁定位置 / 暂停动画 / 显示气泡 / 画画 / 重置位置 / 桌面悬浮模式。「重置位置」一次清掉页面内与桌面窗两个位置；「暂停动画」冻在当前这一帧（不是起始帧），需要安全上下文（127.0.0.1 / localhost / https）才精确，纯 http 局域网地址退回首帧；取消暂停会让 GIF 从第 0 帧重播（浏览器重设 src 的固有行为， 无法定位到指定帧）。 换屏幕/改窗口大小保持同一位置：记住的是宠物贴着的那条边与边距（例如「离左 118px、离下 33px」），换屏后边距不变——宽屏上贴左下角，竖屏上还是同样留 118/33；放不下时以「能放下」为界钳住。旧版存的绝对像素或相对比例会在首次加载时自动折算成锚点，无需重拖。 完整设置页（设置 → 宠物管理 / 插件详情页）：启用 / 隐藏桌宠、宠物管理、响应子 Agent、用量模式与平台令牌、气泡子项与气泡缩放细项——低频，或者关掉之后连入口一起消失（所以不进右键）。 两端主题同源：菜单与气泡在页面内和桌面窗用同一套色值，也跟随同一个主题来源——网页端把宿主主题（body[data-ds-dark-theme]）上报给宿主，桌面窗据此着色；没有网页在线（或上报过期）时桌面窗回落系统深浅色，独立窗口跟系统仍是合理默认。条目、顺序、几何参数同样逐项一致（开关行的勾选符不改变行高），两端色值另有跨文件断言钉住。 气泡翻页：状态与用量都开启时，点左侧圆点或在气泡上滚轮，在状态卡与余额页之间切换；停在当前页，不会自动回落。 滚轮（桌宠）：调整角色大小。 页面内宠物菜单也可反向拉

状态与用量都开启时，点气泡左侧圆点或在气泡上滚轮即可查看 DeepSeek 账户余额与今日消耗（气泡显示「DeepSeek 余额 ¥X」+「今日已用 ¥X · 空闲/高峰时段」，时段用颜色标识：空闲绿、高峰红）。只开用量时气泡直接显示余额页。停在当前页，不会自动回到状态。 余额：来自官方接口 api.deepseek.com/user/balance（凭据 DEEPSEEK_API_KEY）。60 秒自动刷新；切到余额页时会拉一次；余额变化时有数字滚动动画；网络瞬时抖动自动沿用最近余额不报错。 今日已用 · 小鲸鱼记账（默认，免令牌）：每次观测余额后用余额差值自动累计，持久化到 $DSH_HOME/.dshp-usage.json，跨天自动归零归档。无需额外令牌，但属于估算——DSH 关闭期间的消耗会漏记。 今日已用 · 实时·令牌（精确）：配置平台会话令牌 DEEPSEEK_PLATFORM_TOKEN 后，直连平台费用接口（platform.deepseek.com/api/v0/usage/by_api_key/cost），直接取平台按小时统计的真实金额——无需本地定价表，DeepSeek 调价自动跟随： 气泡里同时显示当前所处时段（空闲 / 高峰）：工作日高峰为 9:00–12:00 与 14:00–18:00（北京时间），周六周日与中国法定节假日全天空闲（调休上班的周末同样按空闲计费，与官方口径一致）。节假日日历以内置表兜底、后台静默刷新公共日历数据（缓存到 $DSH_HOME/.dshp-holidays- .json），仅在首次/过期时发一次只含年份的请求 令牌缺失或失效时自动回落记账模式

切换用量模式：插件 → 蕾米埃尔桌宠 → 行为 →「用量模式」（小鲸鱼记账 / 实时·令牌）。也可从「设置 → 宠物管理 → 行为」修改同一配置。 DEEPSEEK_PLATFORM_TOKEN 获取方式：登录 platform.deepseek.com → F12 开发者工具 → Network → 打开「用量」页面 → 复制 api/v0/usage/... 请求的 Authorization 请求头值 → 配置到 DSH 凭据服务。 配置（插件 → 蕾米埃尔桌宠） 其余外观/行为项（角色大小、透明度、镜像、锁定、气泡、用量模式、桌面悬浮、暂停、隐藏……）通过「设置 → 宠物管理」和插件详情页共同提供，不再重复展示在「内置插件」清单里；其中即时可见且高频的那几项同时出现在右键菜单（清单见「使用」一节）——两端菜单同