前言¶

在 DeepSeek Harness（DSH）里跑 agent，一轮回答结束往往只有日志或界面上的静默切换。若你已经在 Windows 上使用 奶蛙桌宠，可以把「回合结束」和桌宠动作绑在一起：回答完，桌宠大笑十几秒再站起来，而不必自己切窗口去点。

下面介绍社区插件 bbtnoctrl/dsh-naiwa（包名 naiwa-laugh）。它不负责分发桌宠本体，只在正确时机向已安装的奶蛙进程发窗口消息；失败只写日志，不影响 DSH 的回答流程。

这是什么¶

dsh-naiwa 由维护者 bbtnoctrl 发布，是一个仅面向 Windows 的 DSH Desktop 插件。定位一句话：DSH 启动时尽量把奶蛙拉到桌面上；每次 agent 回合结束（harness 的 agent/turn-stopping）时触发一次约 14 秒的捧腹大笑。

插件仓库：https://github.com/bbtnoctrl/dsh-naiwa
社区目录页：https://www.skillhub.cn/plugins/bbtnoctrl/dsh-naiwa

奶蛙的 exe、素材.nwp、音频等版权归原作者 yugh6，需自行获取；本插件 MIT 许可，仅包含触发逻辑。

核心功能¶

启动与回合结束¶

1. 打开 DSH 后，若桌宠未在运行，插件会尝试自动启动；已在运行则不动。
2. 每轮 agent 回答结束，触发大笑；约 14 秒后桌宠自行站起（具体行为随官方版或补丁版略有差异，见下文兼容性）。
3. 3 秒防抖：连续触发不会叠加大笑。
4. 任意步骤失败只记录到日志，不阻塞、不改写 DSH 的回答。

若不希望 DSH 一启动就拉起桌宠，在配置里设置 "startOnLoad": false。

自动寻找桌宠¶

插件通过目录中是否存在 素材.nwp 判定奶蛙安装位置（exe 改名仍可识别）。扫描在后台异步执行，上限约 3000 个目录、8 秒，不阻塞 DSH 启动；找到后把路径写入配置，后续直接读取。

多个候选时，优先选路径或名称里带「奶蛙」的。扫不到时常见原因包括：装在 C:\Program Files\、未列出的盘符、OneDrive 同步目录内、素材.nwp 被删或改名等，需手动指定 exePath。

与两种桌宠版本的兼容¶

插件先发消息，700ms 后查状态；若未进入大笑则回退为模拟点击。

已知限制¶

• 子 agent（subagent）结束时也会触发一次，因 agent/turn-stopping 当前不带 agent 维度信息；紧挨着的重复由 3 秒防抖压制。
• 仅 Windows：依赖窗口消息与 PowerShell。
• 窗口标题需为奶蛙原版 NaiwaDesktop.Source.v1；其它变体桌宠可能无法驱动。

环境要求¶

• Windows 10 / 11
• DSH Desktop（dsh 内核 0.2.x）
• 已安装的奶蛙桌宠（原作者 yugh6）
• 插件 package.json 标明 Node >= 18，且 os 为 win32

安装与启用¶

DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前建议浏览仓库源码与 MIT 许可证；插件以 当前 DSH 进程权限 运行，会启动本机 exe 并向其窗口发消息。

从插件市场安装（推荐）¶

在 DSH 插件市场搜索 naiwa 或 奶蛙（分类：娱乐 / fun），点击安装。无需再执行命令行。

命令行从 GitHub 安装¶

市场不可用或搜不到时，在 PowerShell 中执行：

dsh plugin --profile desktop add github:bbtnoctrl/dsh-naiwa

本地目录安装（开发或自用）¶

dsh plugin --profile desktop add C:\path\to\naiwa-laugh

装完后 完全退出并重新打开 DSH。

配置¶

多数情况依赖自动探测即可。手动指定时，创建 %USERPROFILE%\.dsh\naiwa-laugh.json：

{
  "exePath": "C:\\Users\\你的用户名\\Downloads\\Naiwa-main\\Naiwa-main\\奶蛙桌宠.exe"
}

exePath 必须指向 exe 文件，也可用正斜杠路径。

在 profile 的 cordis.patch.yml 里用 config.exePath 可覆盖上述文件（优先级更高）。

典型用法与排错¶

正常使用流程：安装插件并自备奶蛙 → 重启 DSH → 开始对话；每轮 agent 结束应看到桌宠大笑。不需要大笑开机自启时，在 JSON 中加 "startOnLoad": false 后重启 DSH。

日志路径：%USERPROFILE%\.dsh\naiwa-laugh.log

卸载：

dsh plugin --profile desktop remove naiwa-laugh

然后重启 DSH。

结尾¶

dsh-naiwa 把 DSH 的回合结束事件接到奶蛙桌宠的捧腹大笑上，适合已在 Windows 上使用奶蛙、希望在本地 agent 工作流里加一点可见反馈的开发者。它不替代桌宠安装与素材获取，也不影响回答本身的可靠性。

• 目录页：https://www.skillhub.cn/plugins/bbtnoctrl/dsh-naiwa
• 源码与说明：https://github.com/bbtnoctrl/dsh-naiwa