deanzhang2026-max/dsh-lived-pet 预览 preview

deanzhang2026-max/dsh-lived-pet

Desktop桌面端 ⭐ 2 NOASSERTION Pets & Fun桌宠与娱乐

Project Overview项目介绍

DSH Desktop Pet is an Electron-based, topmost, frameless, transparent Live2D desktop companion that stays visible above full-screen windows, designed specifically to visualize what a DeepSeek Harness agent is doing in real time. The repository ships only the dsh-pet-bridge DSH plugin that subscribes to harness session/event streams and writes per-state JSON, while the pet binary itself is distributed as a roughly 150 MB zip in Releases containing an embedded Electron runtime. The bridge installs via dsh plugin --profile web add "file:<absolute path>" followed by a restart of dsh web, after which the desktop binary reads pet_state.json, pushes updates over IPC, and swaps bubble text, color, progress bar, and the 44 facial expressions plus 7 motions accordingly.

The companion distinguishes 16 granular states — reading files, writing code, running commands, web search, spawning sub-agents, listing plans, smooth streaks, repeated failures, interruptions, long-running tasks — each backed by semantically compatible motion pools that rotate with roughly 15% jitter, while instantaneous states like errors or interrupts fire their motion only once. Expressions and motions write to separate model parameters and the renderer re-asserts expression values every frame after internalModel.update() returns, wiping the full expression set on state transitions to prevent bleed-through such as "dizzy face while blowing a bubble". Auto-outfit slots — headwear, glasses, stickers, desk props, 20 assets total — are applied for matching states, yet any slot the user has manually chosen is reserved and never overridden.

No Node.js, browser, or network is required because the Electron runtime is bundled, and the Live2D model "DS鲸鱼娘" is provided by Bilibili creator @氵六青 under a royalty-free license permitting commercial livestream and self-printed merchandise but prohibiting resale or extraction; the program code itself is MIT, while Cubism Core remains Live2D Inc. property. Because file: installation copies rather than symlinks, any source edit requires re-running the add command or bumping package.json#version so pnpm refreshes the plugin. A first-run sanity check is available through electron\electron.exe verify, which cycles the 16 states, captures screenshots, audits model parameters against expectations, and parks on long states to confirm motion rotation rather than replay.

DSH Desktop Pet 是一款基于 Electron + Live2D 的桌宠应用,主窗口为 transparent、frame:false、alwaysOnTop 的无边框置顶窗体,在全屏应用之上仍可见。它通过自带的 dsh-pet-bridge 插件监听 DeepSeek Harness 的 session/event,把 agent 实时状态写入 pet_state.json,Electron 主进程读取后通过 IPC 推送到 pet.html,气泡文字、配色、进度条和 44 个表情、7 个动作随之切换;该项目仓库仅包含 DSH 桥接插件,桌宠本体需从 Releases 下载约 150 MB 的 zip 包,解压后双击创建桌面快捷方式即可运行。

该桌宠内置 16 种细分状态,涵盖读文件、写代码、跑命令、联网搜索、派子代理、列计划、连续顺利、反复失败、被打断、长任务等场景,每个长状态配有语义相容的动作池并以 ±15% 抖动轮换,出错或被打断类瞬间动作仅触发一次。表情与动作使用不同的模型参数且独立调度,每帧在 internalModel.update() 返回后强制重写,切状态时清空全部表情参数,从而避免"晕晕+嘴含泡泡"等串味;头顶的 jingyu 小鲸鱼默认常驻。手动选过的换装槽位(头饰、眼镜、贴纸、桌面,共 20 个素材)不会被自动装扮状态抢占,适合需要长时间观察 agent 进度的开发者使用。

依赖方面无需 Node.js、浏览器或联网,Electron 运行时已内置,Live2D 模型来自 B 站 @氵六青,可商用直播与自印但禁止单独提取分发或售卖,程序代码采用 MIT 许可,Live2D Cubism Core 版权归 Live2D Inc.;安装桥接插件需执行 dsh plugin --profile web add "file:<绝对路径>" 后重启 dsh web,注意 file: 安装是复制而非符号链接,修改源码后必须重新 add 或升级 version 才生效;首次运行可执行 electron\electron.exe verify 完成 16 状态截图与参数核对。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:deanzhang2026-max/dsh-lived-pet

把 deanzhang2026-max/dsh-lived-pet 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Desktop Pet · 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-pet-bridge 绝对路径>"

然后重启 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]          呆呆眼+眼镜 / 调皮+贴纸 / 星星眼 / 爱心眼 …

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-skill 下一个 Next dsh-skin-studio →