Andersen216/dsh-whale-girl-live2d
🐋 鲸鱼娘桌宠 · Whale Girl Live2D —— DSH(DeepSeek Harness)Web 界面里的 Live2D 桌宠:跟着 agent 的真实状态换表情与动作,点一下就能直接跟 agent 说话,右键是钱包。A Live2D desktop pet for the DSH Web UI. 安装 Install: dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d
Project Overview项目介绍
dsh-whale-girl-live2d is a Live2D desktop-pet bundle plugin explicitly built for DSH (DeepSeek Harness), maintained by Andersen216 under a dh-prefixed repo name and packaged with a real DSH manifest (package.json dsh.bundle.patch plus cordis.patch.yml) so the host loads it on startup. The single plugin delivers the entire experience — the Cubism model, motion and expression rigs, the SSE event bridge from the agent, a reverse prompt channel, click-through chat bubble, and a four-page menu for expressions, decorations, scenes, and actions. It ships a web variant usable on Windows, macOS, and Linux inside the DSH web UI's lower-right corner, and an optional 1.4 MB Swift shell App for macOS 13+ that hosts the same plugin page as a transparent, always-on-top, dock-less desktop pet.
Install it with one command — dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d — or use dsh plugin --profile web add "link:/abs/path/to/unzipped" after downloading the ZIP; a future marketplace listing under "鲸鱼娘 / whale-girl / live2d" will offer a one-click path. The target audience is DSH users who want a Live2D character that mirrors the agent's working state and reacts via right-click wallet menus, draggable positioning, and per-platform companion modes without depending on any non-DSH service.
The code is MIT (© 2026 Andersen216), while the bundled artwork under assets/model/** is CC BY-NC-SA 4.0 credited to 上善无形, ZipZipPipe, and 氵六青; the project is explicitly non-commercial. Runtime dependencies are Live2D Cubism Core, PIXI.js 6.5.10, and pixi-live2d-display 0.4.0. First-run caveats: restart DSH so the host plugin loads, self-check with curl http://127.0.0.1:3080/dsh-pet/pet.js (401 means mounted behind the trust fence, 404 means not registered), and confirm cordis.patch.yml has not disabled dsh-live2d-pet; the macOS shell carries no model, so without the plugin it only shows "🐋 正在找 DSH…", and audio is currently a placeholder.
dsh-whale-girl-live2d 是一款面向 DSH(DeepSeek Harness)的 Live2D 桌宠插件,由 Andersen216 维护,仓库命名为 dsh-*,使用 dsh.bundle.patch 与 cordis.patch.yml 作为 DSH 宿主挂载点。它提供完整的 Web 版功能,跨 Windows、macOS、Linux 三大平台通用:DSH Web 界面右下角会出现一只跟着 agent 状态切换动作与表情的鲸鱼娘;macOS 用户可额外下载 1.4 MB 的 Swift 外壳 App,把它当成无边框、透明、置顶的桌面常驻宠物使用。
安装方式有三种:命令行 dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d、手动下载 ZIP 用 link: 绝对路径安装、等待 DSH 插件市场收录后一键安装。桌宠内含四页菜单(表情 / 装饰 / 场景 / 动作)、点击跟 agent 对话、反向 prompt 通道、SSE 事件桥、点穿透明、菜单栏图标与钱包按钮等。它面向喜欢 Live2D 角色陪伴、希望桌宠跟 agent 工作状态联动的 DSH 用户,无需 DSH 之外的其他服务。
代码以 MIT 发布(Copyright © 2026 Andersen216),美术素材走 CC BY-NC-SA 4.0,归上善无形、ZipZipPipe、氵六青三位作者共有,项目整体标榜非商业。运行时依赖 Live2D Cubism Core、PIXI.js 6.5.10 与 pixi-live2d-display 0.4.0,首次安装后必须重启 DSH 宿主;macOS 外壳 App 本身不带模型,缺少插件会停在提示卡;模型暂未携带音频资源。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-whale-girl-live2d(Andersen216/dsh-whale-girl-live2d)
仓库:https://github.com/Andersen216/dsh-whale-girl-live2d
本站详情页:https://www.yhbd.top/plugins/andersen216-dsh-whale-girl-live2d/
本站登记:类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 23 · 最近提交 2026-10-03 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 23 stars - an early-stage project星标 23,属于早期项目
- 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:Andersen216/dsh-whale-girl-live2d
把 Andersen216/dsh-whale-girl-live2d 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
🚀 网页版一键部署(不用懂命令行)
DSH 网页版原来要自己装 Node、装 CLI、起服务、再装插件 —— 现在一条命令搞定:
# macOS / Linux / WSL:起网页版(自动挑空闲端口、自动打开浏览器)
curl -fsSL https://raw.githubusercontent.com/Andersen216/dsh-whale-girl-live2d/main/tools/dsh-web-deploy.sh | bash
# 想连桌宠插件一起装好
curl -fsSL https://raw.githubusercontent.com/Andersen216/dsh-whale-girl-live2d/main/tools/dsh-web-deploy.sh | bash -s -- --with-pet
Windows:下载仓库里的 tools/dsh-web-deploy.cmd 双击运行(内部走 PowerShell,
已绕开执行策略;⚠️ 作者没有 Windows 机器,这版尚未真机验证)。
它做了什么:检查 Node(≥20)→ 复用已装的 dsh(没有就用 npm exec 免安装跑)→
用官方支持的 --port 0 让系统挑空闲端口 → 抓出带登录 token 的地址 → 自动开浏览器 →
(可选)装桌宠插件。
子命令:--doctor 只体检不起服务 · stop 停止 · status 看状态。
状态记在 ~/.dsh/.web-deploy.json(只存 pid/端口/时间,不存 token)。
为什么不用现成的?调研了一圈(2026-10-03),社区 6 个「一键部署」项目全是 Windows 专用 (.cmd / PowerShell / WinForms),macOS/Linux 的
curl | bash是空白;而且多数选择 「下便携 Node + 拉源码 + 完整构建」这条 2–4GB 的重路径 —— 其实npm exec直接跑官方包即可。
兼容性(重要)
| 宿主 | 状态 |
|---|---|
| DSH 0.2.0-rc.1 / 0.2.0-rc.2(官方桌面版当前版本) | ✅ 对齐的目标版本,开发与验证都在这个版本上 |
| DSH 0.2.x(后续版本) | 🔄 会持续跟进 |
| DSH 0.1.x(例如桌面版 0.1.7-rc.2) | ❌ 不支持 —— 会报 failed to import / did not activate |
为什么老版本不行:宿主插件 API 在 0.1.x → 0.2.x 之间有过变动
(举例:connection.requestRejection 在 0.1.0-rc.3 上不存在、0.1.5-rc.2 上才有)。
本插件本身只依赖 Node 内置模块、没有任何第三方依赖,所以加载失败不是缺依赖,
而是与老宿主的 API 不匹配。
遇到 failed to import 怎么办:把官方桌面版 / DSH 升级到 0.2.0-rc.x 或更新,重装插件即可。
🐋 鲸鱼娘桌宠 · Whale Girl Live2D
DSH(DeepSeek Harness)Web 界面里的 Live2D 桌宠 —— 她真的在跟着 agent 干活。 A Live2D desktop pet for the DeepSeek Harness Web UI — she really does follow what the agent is doing.
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
jiuge2467/DSH-Desktop
MemTensor/memmy-agent
OpenPetsHQ/openpets
QCYTSN/dsh-dafeiyu
vlln/whale-girl
ChisaAlter/WhaleIsle
Sutera-Diffusus/dsh-whale-musume