dsh-whale-live2d 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-whale-live2d 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-whale-live2d 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-whale-live2d 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/9/21。

鲸鱼娘动态挂件 harmless0819-dev/dsh-whale-live2d

DeepSeek Harness

harmless0819-dev40 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

把余额挂件的静态图换成可互动的 Live2D 模型

29.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/26 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add harmless0819-dev/dsh-whale-live2d

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · vision

装得上吗

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 40 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令发起外部网络请求

查看扫描证据（共 14 处，展示前 14 条）

发起网络请求
lib/client.js:124
fetch(HEALTH_URL, { cache: 'no-store' })
发起网络请求
lib/client.js:563
fetch(EMOTE_STATE_URL, { cache: 'no-store' })
发起网络请求
lib/client.js:608
fetch(EMOTE_STATE_URL, { cache: 'no-store' })
发起网络请求
lib/client.js:693
fetch(HEALTH_URL, { cache: 'no-store' })
发起网络请求
lib/live2d-vendor.js:17
`,e.accessibleText&&(t.innerText=e.accessibleText)),t.style.width=`${Or}px`,t.style.height=`${Or}px`,t.style.backgroundColor=this.debug?`rgba(255,255,
发起网络请求
lib/live2d-vendor.js:924
`)_();else if(!l&&d){let e=d.xAdvance+(d.kerning?.[o]||0)+u;a.width+=e,a.spaceWidth=e,a.spacesIndex.push(a.charPositions.length),a.chars.push(i)}}else
发起网络请求
lib/live2d-vendor.js:925
${n}`);throw n instanceof Error&&n.stack&&(u.stack=n.stack),u}}};IC.defaultOptions={onProgress:void 0,onError:void 0,strategy:`throw`,retryCount:3,ret
发起网络请求
lib/live2d-vendor.js:974
`],{type:`application/javascript`})),this.worker=new Worker(rw)}};iw.revokeObjectURL=function(){rw&&=(URL.revokeObjectURL(rw),null)};let aw=0,ow,sw=ne
执行外部命令来自配置/变量
test-e2e.mjs:273
const child = spawn(CHROME, args, { stdio: ['ignore', outFd, errFd] })
执行外部命令固定命令
test-e2e.mjs:281
try { spawnSync('taskkill', ['/PID', String(child.pid), '/T', '/F'], { stdio: 'ignore' }) } catch (err) {}
执行外部命令固定命令
test-e2e.mjs:288
try { spawnSync('taskkill', ['/PID', String(child.pid), '/T', '/F'], { stdio: 'ignore' }) } catch (err) {}
执行外部命令来自配置/变量
test-gl-texture.mjs:101
const child = spawn(CHROME, args, { stdio: ['ignore', outFd, errFd] })
执行外部命令固定命令
test-gl-texture.mjs:107
try { spawnSync('taskkill', ['/PID', String(child.pid), '/T', '/F'], { stdio: 'ignore' }) } catch (e) {}
执行外部命令固定命令
test-gl-texture.mjs:111
try { spawnSync('taskkill', ['/PID', String(child.pid), '/T', '/F'], { stdio: 'ignore' }) } catch (e) {}

扫描于 2026/11/1（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

按相同几何位置叠放
无核心时降级静态

把鲸鱼小组件的静态图换成 Live2D 模型，按相同几何位置叠放。没有 Cubism Core 时降级回静态小组件。

README

由 DeepSeek 最新模型翻译生成

dsh-whale-live2d 把 DSH Web 右下角的余额挂件（dsh-whale-widget）从一张静态 PNG 换成 Live2D 动态模型（默认：DS 鲸鱼娘，44 表情 / 8 动作）。为什么是「叠加式插件」 dsh-whale-widget 装在 %DSH_HOME%\profiles\web\node_modules\ 里，有两个硬约束： 1. 它由 dsh plugin add github:MeteorNOX/DeepSeek-Balance-Whale-Widget 安装，升级时会覆盖该目录 —— 任何直接改它的改动都会丢； 2. 它只认一张静态 PNG（/dsh-whale/image.png），内部没有任何 Live2D 支持。所以本插件不改挂件一个字节，而是照 dsh-whale-emote 已验证的模式： - 自己注册路由（/dsh-live2d/）； - 用挂件自己也在用的 tapIndex 机制注入一段客户端脚本； - 客户端脚本把挂件那张透明化（但保留元素本身），在完全相同的几何位置叠一块 Live2D canvas。

展开完整文档（README 剩余 1 节）

dsh-whale-live2d

把 DSH Web 右下角的余额挂件（dsh-whale-widget）从一张静态 PNG 换成 Live2D 动态模型（默认：DS 鲸鱼娘，44 表情 / 8 动作）。

为什么是「叠加式插件」

dsh-whale-widget 装在 %DSH_HOME%\profiles\web\node_modules\ 里，有两个硬约束：

1. 它由 dsh plugin add github:MeteorNOX/DeepSeek-Balance-Whale-Widget 安装，升级时会覆盖该目录 —— 任何直接改它的改动都会丢；
2. 它只认一张静态 PNG（/dsh-whale/image.png），内部没有任何 Live2D 支持。

所以本插件不改挂件一个字节，而是照 dsh-whale-emote 已验证的模式：

- 自己注册路由（/dsh-live2d/）；
- 用挂件自己也在用的 tapIndex 机制注入一段客户端脚本；
- 客户端脚本把挂件那张 透明化（但保留元素本身），在完全相同的几何位置叠一块 Live2D canvas。

保留 元素这一点很关键：挂件的命中测试是
img.getBoundingClientRect() + PNG alpha 取样（isWhaleHit），
元素一旦删除，rect 全为 0，挂件会整个点不动、拖不动。
保留它，则拖拽 / 吸附 / 气泡 / 音效 / 每轮消耗统计全部照旧。

依赖：Cubism Core 必须由你自己提供

Live2D 的专有许可不允许再分发 live2dcubismcore.min.js，所以本插件不内置、不代下。请从 Live2D 官方渠道获取（Cubism SDK for Web），放到：

%DSH_HOME%\pets\.runtime\live2dcubismcore.min.js

没有它也不会坏：挂件会优雅降级成原本的静态鲸鱼娘，页面上弹出一张写明落点路径的安装指引卡。（渲染栈 pixi.js + Live2D 引擎是 MIT 许可，已作为 lib/live2d-vendor.js 随本插件发布，无需另装。）

安装

从 GitHub（推荐）
dsh plugin --profile web add github:harmless0819-dev/dsh-whale-live2d

或从本地克隆
dsh plugin --profile web add link:

装完重启 dsh web（Settings → 重启 DSH，或 dsh-whale-emote\restart-web.ps1 在你自己的终端里跑），然后浏览器 F5。

重启是必须的：插件的挂载声明（cordis.patch.yml）只在启动时读取。
装好之后，改 lib/client.js 只要 F5，不用再重启 —— 宿主路由每次请求都从磁盘读。

卸载

dsh plugin --profile web remove dsh-whale-live2d

挂件会立刻回到原来的静态 PNG（本插件从未改动它）。

怎么确认装好了

三个层次，从粗到细：

1. 宿主侧就绪状态（core 是否为 true 是决定性的一条）
curl http://127.0.0.1:3080/dsh-live2d/health.json

2. 模型本体可服务
curl -o NUL -w "%{http_code}" http://127.0.0.1:3080/dsh-live2d/asset/c_0120.moc3

3. 浏览器侧实况（F12 控制台） window.__dshLive2d → { state: 'ready' | 'core-missing' | 'error' | 'no-widget', ... }

state 的含义：

| state | 含义 |
| ready | 模型已上屏，PNG 已透明化 |
| core-missing | 缺 Cubism Core；静态挂件保持可见 + 指引卡 |
| error | 加载失败（.detail 有原因）；已退回静态挂件 |
| no-widget | 没找到 .dshwv-body（挂件被禁用或未加载） |

换成别的 Live2D 模型

模型目录是 assets/whale-girl/，由 package-model.mjs 生成。换模型时：

1. 把新模型的原文件放进 _incoming//；
2. 改 package-model.mjs 顶部的 SRC / EXPR / MOTION 映射；
3. node package-model.mjs。

脚本会断言：源文件缺失、引用闭包不完整、或目录里残留非 ASCII 文件名（宿主路由与 Live2D 清单只接受 /^[A-Za-z0-9._-]+$/ 的路径段）都会硬失败，不会静默产出一个加载不了的模型。

文件结构

dsh-whale-live2d/
├── package.json # DSH bundle 插件元数据 ├── cordis.patch.yml # 插件挂载声明 ├── README.md # 本文件 ├── package-model.mjs # 模型打包：ASCII 重命名 + 生成 model3.json 清单 ├── test-harness.mjs # 宿主侧离线自测（路由 / 穿越防护 / 模型完整性） ├── test-client.mjs # 客户端离线自测（缺 Core 时优雅降级） ├── lib/ │ ├── index.js # 宿主侧：路由 + 模型服务 + 注入 │ ├── client.js # 客户端：把静态 img 换成 Live2D canvas │ └── live2d-vendor.js # pixi.js + Live2D 引擎（MIT，随包发布） └── assets/ └── whale-girl/ # 打包好的 Live2D 模型（3.95 MB，纯 ASCII 路径） ├── c_0120.model3.json ├── c_0120.moc3 ├── c_0120.physics3.json ├── c_0120.cdi3.json ├── c_0120.2048/ # 贴图 ├── motions/ # 8 个动作 └── .exp3.json # 44 个表情

自测 powershell
node D:\deepseek\dsh-whale-live2d\test-harness.mjs # 27 项
node D:\deepseek\dsh-whale-live2d\test-client.mjs # 11 项

两个都是离线跑（mock ctx / 最小 DOM 桩），不碰 profile、不启服务。必须保持全绿。

模型授权

DS 鲸鱼娘模型由 B站 @氵六青（11272072）无偿分享，作者声明：商用直播 √、自印物料 √，禁止盗用与出售。

⚠️ 本仓库确实包含了模型文件（assets/whale-girl/），以便插件开箱即用。
我们没有出售它，也不主张对它的任何权利；若作者反对这一再分发， assets/whale-girl/ 会被移除 —— 缺模型时插件会优雅降级成静态挂件。

完整的第三方声明见 THIRD-PARTY-NOTICES.md。
换用其他模型时请自行确认授权。