← 返回列表
需源码安装
DSH 桌面宠物 · Live2D 桌宠
暂不能直接安装（需源码编译或环境不满足）：仓库缺少 package.json，无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/9/21 · 已提供中文文档
综合分
30.7
GitHub 分
30.7
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add deanzhang2026-max/dsh-lived-pet仓库缺少 package.json，无法用 dsh 插件安装命令安装，改用 GitHub 源安装
信任档位：已验证本站已于 2 天前真实安装成功
- 是什么
- dsh 原生插件 · desktop
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 4 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/22（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-lived-pet（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
仓库缺少 package.json，无法用 dsh 插件安装命令安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 00:10:03
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成DSH 桌面宠物 · Live2D 桌宠
一只住在桌面上的透明、置顶、无边框 Live2D 桌宠，用来实时显示
DeepSeek Harness agent
正在做什么 —— 全屏干活时也能看到它是在思考、在忙、还是卡住了。
16 态总览
它能做什么
| 能力 | 说明 |
|---|---|
| 透明置顶 | Electron 原生窗口，transparent + frame:false + alwaysOnTop，切换全屏应用也看得见 |
| 状态实时联动 | 插件监听 harness 的 session/event，气泡显示「正在执行 pwsh …」，Live2D 表情同步切换 |
| 16 种状态 | 不只"在忙"：读文件 / 写代码 / 跑命令 / 联网搜索 / 派子代理 / 列计划 / 连续顺利 / 反复失败 / 被打断 / 长任务，各有自己的表情与动作 |
| 动作有节奏 | 每个长状态配一组语义相容的动作池并轮换（±15% 抖动），不会一直吹泡泡；出错/被打断这类瞬间只演一次 |
| 表情不被动作带跑 | 表情与动作独立选择，表情永远不从动作推导 —— 身体在动，脸是稳的 |
| 不会混搭素材 | 模型有两套名字很像的泡泡系统（chuipaopao 泡泡糖 / paopao 泡泡，而 paopao4/5 其实是蝴蝶结），状态切换时会一起释放，不会出现「晕晕 + 嘴含泡泡」的怪画面 |
| 小鲸鱼陪伴 | 头顶那条小鲸鱼默认常驻，16 个状态全程陪着（模型自带的 jingyu） |
| 参数不靠猜 | 模型自带 cdi3.json，用中文写明了全部 247 个参数的名字（chuipaopao3=泡泡出现、jingyu=鲸鱼、maoshou2-7=猫手…），改参数前先查它 |
| 换装系统 | 悬停气泡浮出四个槽位：头饰 · 眼镜 · 贴纸 · 桌面，共 20 个素材可叠加 |
| 装扮自动穿脱 | 「读文件」自动戴眼镜、「写代码」自动贴贴纸；手动选过的槽位不再被状态抢占 |
| 44 个表情 + 7 个动作 全部接入 | 18 个表情用作情绪、20 个用作装扮，7 个动作全用上（不切分） |
| 自带验证器 | electron\electron.exe verify 跑完 16 态、截图、逐参数核对，当前 16/16 通过 |
实时联动
v1.1 的几个状态
| 干活中（会吹泡泡糖 + 转动作） | 读文件（自动戴眼镜） |
|---|---|
| 干活态 | 搜索态 |
| 晕晕（圈圈眼，嘴里没有泡泡） | 反复失败（脸红 + 挤番茄酱） |
|---|---|
| 晕晕态 | 反复失败态 |
头顶那条小鲸鱼是模型自带的 jingyu 参数，默认常驻，16 个状态全程陪着。
组成
dsh-pet-bridge/ DSH 插件：把 agent 状态写进 pet_state.json
docs/ 截图
桌宠本体（Electron + Live2D 模型）在 Releases 里下载。
安装
1. 桌宠本体
下载 Releases 中的 DSH桌宠_Live2D版.zip（约 150 MB，Electron 运行时已内置）：
1. 解压到任意目录
2. 双击 创建桌面快捷方式.bat（只需一次）
3. 以后双击桌面的「DSH桌宠」即可
不需要装 Node.js、不需要装浏览器、不需要联网。
2. DSH 插件（状态联动）
dsh plugin --profile web add "file:"
然后重启 dsh web。
⚠️ file: 安装是复制而非符号链接 —— 改了插件源码后必须重新 add 一次
（或改 package.json 的 version 触发 pnpm 更新），否则改动不生效。
工作原理
agent 思考 / 调工具 / 完成 / 出错
↓
[dsh-pet-bridge] 监听 session/event，按工具名细分状态，node:fs 直写
↓
pet_state.json {"bubble":"正在执行 read …","status":"reading"}
↓
[Electron 主进程] 读文件 → IPC 推给页面
↓
[pet.html] 文字 + 配色 + 进度条 + 换装槽位
↓
[Live2D] 呆呆眼+眼镜 / 调皮+贴纸 / 星星眼 / 爱心眼 …
表情为什么不会"串味"
动作曲线和表情写的是不同的参数，但并不完全不相交 —— 比如「番茄酱」
动作会写 ParamCheek21。如果表情在动作之前写，就会被动作覆盖，表现为
上一个状态的表情残留到下一个状态（v1.0 就有的隐藏 bug）。
所以 pet.html 每帧都在 internalModel.update() 返回之后重写一次
表情与装扮参数；切状态时则强制抹掉全部表情参数（而不是只抹上一个表情
用到的那些 —— 各表情的参数列表并不相同）。
这类问题肉眼几乎看不出来，所以仓库里带了一个验证器：
electron\electron.exe verify
它把桌宠跑起来、切到 16 个状态、逐个截图，再直接读模型参数核对
"这个状态是不是只开了它该开的参数"；另外还会停在几个长状态上守十几秒，
确认动作真的在轮换而不是重播同一段 —— 当前结果：
STRICT CHECK (face + auto-outfit params only; motion-driven params ignored)
passed = 16 failed = 0
motion scheduler: 5/5 states behave
hard errors = 0
动作调度的一句实测输出：
working pool=[0,0,2] fired 5x seq=[吹泡泡 > 吹泡泡 > 开盖 > 吹泡泡 > 吹泡泡]
表情参数在同一段时间里零漂移 —— 证明“身体在动、脸不动”这条成立。
为什么不用 WPF + WebView2：WPF 的 AllowsTransparency=True 是 layered window，
承载不了 WebView2 的子 HWND —— 结果是 WPF 自绘的阴影正常显示、WebView2 内容永远空白。
Electron 把这三件事一次性解决了。
版权
程序代码 MIT，见 LICENSE。
Live2D 模型「DS鲸鱼娘」版权不属于本项目：
- 作者：B站 @氵六青 (uid 11272072)
- 授权：无偿分享；可商用直播、可自印物料
- 禁止：任何形式的盗用与出售
转发时请保留此声明，也不要把模型单独提取出来另行分发或售卖。
Live2D Cubism Core 版权归 Live2D Inc. 所有。