dsh-whale-girl-live2d：DeepSeek Harness 里会跟着 agent 干活的 Live2D 桌宠

它是做什么的？

鲸鱼娘桌宠是 DeepSeek Harness（DSH）的 Live2D 桌宠插件，把 DSH Web 界面右下角变成一只会跟着 agent 干活的鲸鱼娘。它解决的是「跑 agent 时看不到状态、想插话还得切窗口」的麻烦，让你在同一个页面里直接看到 agent 的真实状态并跟它对话。插件本体一套，网页版与 macOS 桌面外壳共用同一份模型、动作、表情与联动逻辑，由 Andersen216 维护，采用 MIT 协议。

核心功能

• 状态联动：表情与动作跟着 agent 的真实运行状态变化，不用盯着日志猜进度。
• 点击对话：点一下她就能直接跟 agent 说话，省去切换输入框的步骤。
• 右键钱包：右键唤出钱包面板，把用量与开销放在手边。
• 四页菜单：表情、装饰、场景、动作分四页管理，可拖动换位置。
• 桌面外壳（仅 macOS 13+）：透明无边框、永远置顶，支持点击穿透、拖她即拖窗口、贴边悬浮球与菜单栏图标。
• 跨平台网页版：Windows / macOS / Linux 都能用，功能与桌面版一致，只是她住在浏览器标签页里。

怎么使用这个插件？

在 DSH 的 Web profile 里启用这个 DSH 插件并重启 DSH 后，刷新页面即可在右下角看到她；宿主插件只在启动时加载，所以重启这一步不能省。桌面版是额外下载的 macOS 外壳 App，它本身不含模型与联动，必须配合插件使用，插件就位后 App 每 5 秒自动重试，无需重启 App 她就会自己出现。日常使用中，点她跟 agent 说话、右键打开钱包、拖动换位置，表情与动作会随 agent 状态自动切换；Windows 与 Linux 用户用网页版即可，跨平台外壳仍在计划中。

报错怎么排查？

• 桌面 App 一直显示「正在找 DSH…」：通常是插件没装、DSH 没跑或插件被停用，先确认自检接口返回 401 而不是 404。
• 自检接口返回 404：说明插件没被注册或在插件设置里被停用，按官方说明检查 profile 的依赖与 bundles 配置，并确认补丁文件里没有把该插件标记为 disabled。
• 网页版刷新后什么都没有：宿主插件需要重启 DSH 才会加载，重启后强刷页面即可。
• 双击 App 好像没反应：它是无 Dock 图标的后台型 App，看菜单栏右上角的鲸鱼图标，再双击一次会把窗口叫到最前，且系统里只应保留一份 App。
• 更新后没有变化：包管理器按 lockfile 记住了旧提交，按官方说明重新拉取更新即可。