Andersen216/dsh-whale-girl-live2d 预览 preview

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 本身不带模型,缺少插件会停在提示卡;模型暂未携带音频资源。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 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.

Release Code: MIT Artwork: CC BY-NC-SA 4.0 Non-commercial Platform

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-custom-tool 下一个 Next deepseek-plugin-store →