dsh-whale-girl-live2d

🚀 网页版一键部署（不用懂命令行）

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.

点一下就能跟 agent 说话 · 右键就是钱包 · 表情 / 装饰 / 场景 / 动作 四页菜单 · 拖动换位置

🐋 先读这三行：只有一套插件，两种用法

1. 插件只有一个：dsh-whale-girl-live2d。装一次，网页版和桌面版共用同一份 ——

模型、动作、表情、跟 agent 的联动、菜单、钱包、设置，全部在插件里。

1. 网页版 = 插件自带的用法，装完就有（Windows / macOS / Linux 都能用）。
2. 桌面版 = 额外下载一个 1.4 MB 的 macOS 外壳 App，把同一个页面放进桌面上的独立窗口。

它不是第二个插件，也不用再装任何东西。

「网页版和桌面版是两套不同的插件吗？」→ 不是。

是一套插件 + 一个可选的 Mac 外壳。所以你不需要"两边都装插件"，

也不存在"装了桌面版会不会跟网页版冲突"。

两种用法对照

· 🖥 网页版 · 🐋 桌面版（macOS 外壳） 是什么 · 插件本体（必装） · 一个 1.4 MB 的 App，加载插件提供的那一页 她住在哪 · DSH Web 界面右下角（浏览器标签页里） · 你的桌面上：透明、无边框、永远置顶 支持平台 · Windows / macOS / Linux · 只有 macOS 13+（跨平台外壳在计划中） 需要装什么 · 插件 · 插件 ＋ 这个 App 浏览器要开着吗 · 要（她在那张标签页里） · 不用，DSH 在跑就行 额外能力 · — · 点击穿透（不挡干活）· 拖她=拖窗口 · 贴边悬浮球 · 菜单栏 🐋 · 低性能模式 · 设置里「彻底关闭 App」

安装：两条路都行，按你现在的状态选

🅰 先装网页版，再装桌面版（推荐）

# ① 装插件
dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d

# ② 重启 DSH（宿主插件只在启动时加载），然后刷新页面
#    右下角出现她 = 网页版成功

# ③ 自检（返回 401 = 已挂载，被信任栅栏挡着，正常；404 = 没加载）
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3080/dsh-pet/pet.js

然后装桌面版：去 Releases 下载 **DS-WhaleGirl-Pet-macOS-*.zip → 解压 → 把 DS 鲸鱼娘桌宠.app** 拖进「应用程序」→ 双击。

🅱 先装桌面版，再装网页版（也可以）

1. 直接下载上面那个 zip，解压、拖进「应用程序」、双击。

→ 这时窗口里会显示一张提示卡「🐋 正在找 DSH…」——这是正常的，因为插件还没装。

1. 再按 🅰 的 ①②③ 装插件并重启 DSH。
2. 她会出现，不用重启 App —— App 每 5 秒自动重试一次，插件一就位她就自己出来了。

⚠️ 顺序无所谓，但少了插件一定不行：桌面 App 本身不带模型、不带联动

（所以它只有 1.4 MB）。它只是一个窗口，内容全在插件里。

Windows / Linux 用户看这里

• 桌面外壳目前只有 macOS 版（Swift 编译出来的 .app），Release 里只有 Mac 附件。
• Windows / Linux 用网页版就行，功能完全一样（联动、菜单、钱包一个不少），只是她住在浏览器标签页里。
• 跨平台外壳（Electron）在计划中；在那之前，Windows 用户可以用

http://127.0.0.1:3080/dsh-pet/standalone 配 Chrome 的「创建快捷方式 → 在窗口中打开」， 得到一个小窗效果（但不透明、不置顶、不能点击穿透，不是真桌宠）。

装完不出现 / 连不上？按顺序查这五条

现象 · 原因 · 怎么办 桌面 App 里显示「正在找 DSH…」 · 插件没装 / DSH 没跑 / 插件被停用了 · 先确认 curl …/dsh-pet/pet.js 是 401；是 404 就往下看 /dsh-pet/pet.js 返回 404 · 插件没被注册，或在插件设置里被停用 · ① 看 ~/.dsh/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles 里有没有 dsh-whale-girl-live2d；② 看 ~/.dsh/profiles/web/cordis.patch.yml 里有没有 `- id: dsh-live2d-pet` + `disabled: true`（有就删掉这两行）——踩过一次：插件被误停用，表现为「App 突然连不上、她也消失」 网页版刷新后什么都没有 · 宿主插件要重启 DSH 才加载 · 重启 DSH，再强刷页面（Cmd+Shift+R / Ctrl+F5） 双击 App 好像没反应 · 它是无 Dock 图标的后台型 App，可能已经在跑了 · 看菜单栏右上角的 🐋；再双击一次会把窗口叫到最前面；~/Applications/ 里只该有一份 App 更新了但没变化 · pnpm 按 lockfile 记住了旧 commit · dsh plugin --profile web update dsh-whale-girl-live2d；不行就 remove 再 add

桌面版的技术说明（想知道细节再看）

见 desktop/README.md：本机通行证（为什么壳子能过信任栅栏）、 透明窗口的私有键、点击穿透怎么判定、怎么自己编译。

🚀 安装（网页版）/ Install the web version

先确认一件事：你机器上已经装好 DSH（DeepSeek Harness）。终端里敲 dsh --version 有输出就说明没问题；

没装的话先装 DSH，再回来装这个桌宠。

方式 A：命令行装（推荐，一条命令）

dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d

• --profile web 是 DSH Web 界面的 profile 名。如果你用的是别的 profile 名，把 web 换成你自己的。
• 这条命令会从 GitHub 拉取插件并注册进 profile（需要能访问 GitHub）。

方式 B：手动下载 ZIP（不想用命令行 / 公司网络限制 git）

1. 打开仓库页面 → 绿色 Code 按钮 → Download ZIP
2. 解压到一个你能记住的目录，例如：

• macOS / Linux：~/Documents/dsh-whale-girl-live2d-main
• Windows：C:\Users\你的用户名\Documents\dsh-whale-girl-live2d-main

1. 用 绝对路径装（link: 后面必须是绝对路径；有空格一定要加引号）：

# macOS / Linux
dsh plugin --profile web add "link:/Users/你的用户名/Documents/dsh-whale-girl-live2d-main"

# Windows（PowerShell / CMD 都可以）
dsh plugin --profile web add "link:C:\Users\你的用户名\Documents\dsh-whale-girl-live2d-main"

方式 C：从 DSH 插件市场装

等本插件被 DSH 插件市场 收录后， 在界面的插件中心搜 `鲸鱼娘`、`whale-girl` 或 `live2d` 就能一键安装（收录进度见下方「相关链接」）。 现在还没收录，先走方式 A 或 B。

装完必须做两步（少一步都不会出现）

1. 重启 DSH（宿主插件只在启动时加载）：把正在跑的 dsh web 停掉，重新起一次
2. 刷新页面（强刷 Cmd+Shift+R / Ctrl+F5）

装成功后，界面右下角会出现鲸鱼娘。

一行自检

浏览器打开：`http://127.0.0.1:3080/dsh-pet/pet.js`

看到 · 意思 401 · ✅ 插件已挂载（被 DSH 的信任栅栏挡着，这是正常的） 404 · ❌ 插件没被加载 —— 看下面的「排错」 满屏 JS 代码 · ✅ 也已经挂载了（你的 DSH 没开信任栅栏）

更新 / 卸载

# 更新到最新版（更新完同样要重启 DSH + 刷新页面）
dsh plugin --profile web update dsh-whale-girl-live2d

# 卸载
dsh plugin --profile web remove dsh-whale-girl-live2d

🇬🇧 English — Install（点开）

Requirements: DSH (DeepSeek Harness) already installed — dsh --version should print something.

Option A — one command (recommended)

dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d

web is the profile name used by the DSH Web UI; replace it if your profile is named differently. This pulls the plugin from GitHub and registers it in that profile (needs GitHub access).

Option B — download the ZIP (no command line / git blocked): click Code → Download ZIP, unzip it anywhere, then install it by absolute path (quote it — especially on Windows or with spaces):

dsh plugin --profile web add "link:/absolute/path/to/dsh-whale-girl-live2d-main"

Option C — from the DSH plugin market: once the plugin is listed, search for whale-girl or live2d in the plugin center and install with one click. *It is not listed yet* — use A or B for now.

After installing, two steps are mandatory: ① restart DSH (host plugins load at startup), ② reload the page (hard reload: Cmd+Shift+R / Ctrl+F5). She appears in the bottom-right corner.

One-line check: open http://127.0.0.1:3080/dsh-pet/pet.js — 401 means loaded (the trust gate is doing its job), 404 means not loaded (see Troubleshooting).

Update / remove

dsh plugin --profile web update dsh-whale-girl-live2d   # then restart DSH + reload
dsh plugin --profile web remove dsh-whale-girl-live2d

🎮 一分钟上手 / Quick start

你想干嘛 · 怎么做 跟她说话 / 给 agent 发消息 · 点工具栏的 「说话」 打开输入框（再点一次就关），Enter 发送、Shift+Enter 换行；回复会逐字冒进气泡里。旁边「打断」可以中止当前这一轮 摸摸她 · 直接点她（上半身和下半身反应不一样；连着猛点会炸毛，这是设计） 换表情 / 换装 / 摆场景 / 演小动作 · 点工具栏的 `⋯`，菜单分四页（见下方「菜单」） 看余额 / 本轮花了多少 · 右键点她，弹出钱包（再按一次右键、点 ×、点别处或按 Esc 都能收） 挪位置 · 直接拖。松手时：靠左/右墙就吸过去，竖直位置保持你放的高度；离两侧都远就停在原地 藏起来 · 点工具栏的 `–`，右下角留个小把手，点一下就叫回来 一键重置 · 菜单 →「设置」→「一键重置所有状态」：表情、道具、场景、动作全部回到最初的「本子 + 笔 + 平常脸」

🇬🇧 English — Quick start