前言¶

在 DSH 里跑智能体、调工具、盯会话时，界面多半是 Web 或桌面客户端里的文本与进度条。若希望在本地有一个始终可见、能跟会话状态同步的「在场感」，常见做法是另开聊天窗口或通知，但很难和 DSH 的主会话、工具调用、回复内容绑在同一条事件链上。dsh-dstuber 是社区插件，在 Windows 上提供透明置顶的 Live2D 桌宠窗口，并通过 DSH 插件机制接收主会话消息、工作进度与回答，配合表情、口型与可选 TTS，把联动做在桌面上。

这是什么¶

dsh-dstuber（npm 包名 dsh-dstuber，仓库 T-MS-Reyes/dsh-DSTuber）由维护者 T-MS-Reyes 发布，在 SkillHub 社区目录中归类为「趣味换装」。定位是：运行在 Windows 桌面的 Live2D 桌宠插件，与 DeepSeek Harness 深度联动——桌宠会跟随 DSH 干活状态碎碎念、在会话里接话，并可将回答用本地语音读出。插件代码采用 MIT 许可证；内置 Live2D 角色资产版权归各原作者，使用前需遵守各来源页面的授权条款。

核心功能¶

下面按 README 已说明的能力归纳，不超出资料范围。

桌面呈现¶

• 透明置顶、无边框 Live2D 窗口，可拖动；右键打开设置；双击可随机切换模型自带表情（可在设置中关闭）。
• 显示范围可选半身或全身；缩放约 60%～140%；可关闭眨眼、呼吸等空闲动作以减少动态。

表情与口型¶

• 16 种基础情绪，以及模型自带表情；可在「表情映射」中指定含义，并支持自定义标签（保存后由默认模型分析成情绪配方）。
• 对话逐句带 [happy] 等标签时，表情随句切换，整句结束后约 1.7 秒淡出。
• 语音播放时口型按音节级包络驱动（10ms 采样）；无语音时嘴保持闭合。

语音¶

• Edge TTS：默认引擎，默认音色 zh-CN-XiaoyiNeural，可调语速与音调；需联网。
• GPT-SoVITS：在设置中填写本地安装路径后，可一键启停服务；插件不打包 GSV 模型，需自行安装。

碎碎念与主对话均可走语音；设置里可控制碎碎念的朗读范围（不读 / 只读重要 / 全部）。

与 DSH 的联动¶

• 主会话闲聊桌宠可接话；工具调用、报错、完成时更新状态与表情。
• 可选字幕窗显示 DSH 回复；桌宠旁对话输入条可直接对 DSH 说话；可选在 DSH 网页右下角显示浮层（默认关闭）。

模型¶

内置「DS鲸鱼娘（全身）」与「DS鲸鱼娘（桌面 Q 版）」；支持上传标准 Cubism 4 模型目录（.model3.json）并自动适配。配置与模型数据位于插件目录 .webview2/ 下。

安装与启用¶

环境要求¶

推荐安装（npm）¶

Web profile 下在 PowerShell 执行：

dsh plugin --profile web add dsh-dstuber

桌面端可在「插件管理」搜索 dsh-dstuber 安装，或执行：

dsh plugin --profile desktop add dsh-dstuber

安装完成后重启 DSH 生效。离线包可从 Releases 下载 dsh-dstuber-v0.1.0.zip 解压后放进 DSH 插件目录；桌面端用户安装到 ~/.dsh/profiles/desktop 对应 profile 后需重启桌面端。

启用与首次启动¶

1. 打开 DSH → 设置 → 内置插件 → 桌宠，确认已启用。
2. DSH 启动时会自动拉起桌面壳，桌宠默认出现在屏幕右下角；若未出现，在插件卡片点「启动桌宠」，或在设置 → 常规勾选「DSH 启动时自动启动桌宠」。
3. 桌面端若提示外部访问被拒绝，需在桌面端设置中开启「浏览器访问」。

可选：设置 → 语音选择 Edge TTS 或 GPT-SoVITS；设置 → 模型管理内置模型或上传自有 Live2D 模型。

典型用法¶

经过上面的安装与启用，日常可以按下面方式使用（均来自官方 README 描述的可复现行为）。

1. 只看状态：保持桌宠置顶，DSH 执行工具或报错时观察表情与碎碎念，无需额外配置 Edge TTS 即可看到口型与表情（无语音时嘴闭合）。
2. 听回复：在设置 → 语音保持 Edge TTS 默认，或配置 GPT-SoVITS 路径后点「启动服务」，等状态为「运行中」后再让 DSH 产出较长回答，核对音节级口型与逐句表情。
3. 从桌宠发话：使用桌宠旁对话输入条向 DSH 发送内容；主会话里的闲聊桌宠也会接话，工作指令仍由 DSH 处理。
4. 换模型或映射：设置 → 模型切换 Q 版/全身或上传 .model3.json；在表情映射里为模型自带表情指定情绪或自定义标签，保存后对话内容会按标签驱动表情。

设置可通过桌宠右键/托盘独立窗口修改，与 DSH 设置页共用同一份配置。

适用场景与注意¶

适合谁：在 Windows 上长期使用 DSH Web 或 DSH NEXT、希望桌面有 Live2D 陪伴且要与会话/进度联动的开发者或用户。

权限与安全：插件以当前 DSH 进程权限运行；安装前应阅读仓库源码与 MIT 许可证，并单独确认 Live2D 与人设资产的授权（README 鸣谢表中列出了 B 站模型与人设仓库链接）。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。

已知限制：Edge TTS 需联网；离线请用 GPT-SoVITS。卸载插件不会自动删除 .webview2/ 数据，彻底清理需删除整个插件目录。当前版本为 0.1.x（package.json 为 0.1.0），升级前建议备份 .webview2/。

结尾¶

dsh-dstuber 把 Live2D 桌宠、DSH 事件桥与可选 TTS 收进一个 Windows 插件包，适合在写 Harness、盯智能体会话时保留桌面侧的反馈通道。更多细节与离线/源码安装方式见 GitHub README：

• 社区目录：https://www.skillhub.cn/plugins/T-MS-Reyes/dsh-DSTuber
• 仓库：https://github.com/T-MS-Reyes/dsh-DSTuber