naiwa-laugh

让 奶蛙桌宠 在 DeepSeek Harness (DSH) 每轮回答结束时捧腹大笑一次的插件。

本项目不包含奶蛙桌宠的 exe、素材.nwp、音频或任何形象素材——那些版权归原作者所有，请自行获取。本插件只负责「在正确的时机给桌宠发个消息」。

效果

DSH 里每轮 agent 回答结束 → 奶蛙播放约 14 秒的捧腹大笑。

• 桌宠没在运行时，插件会尝试自动把它拉起来
• 3 秒防抖，连续触发不会叠加
• 任何失败都只写日志，不会影响回答本身

已知限制

• 子 agent（subagent）结束时也会触发一次，因为 harness 的 agent/turn-stopping 不带 agent 信息。3 秒防抖会压掉紧挨着的重复触发。
• 只支持 Windows：靠窗口消息和 PowerShell 触发。

环境要求

• Windows 10 / 11
• DSH Desktop（dsh 内核 0.2.x）
• 奶蛙桌宠（原作者 yugh6，抖音：握石竹）

安装

从 GitHub 安装

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

从本地目录安装（开发/自用）

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

装完重启 DSH（完全退出再打开）。

配置（多数情况不用管）

插件会自动寻找奶蛙桌宠，搜索范围：下载 / 桌面 / 文档 / 用户目录 以及 D: E: F: 盘，最多 3 层、最多 4 秒。找到后会把路径记进配置，下次直接用。

如果你自己改了路径，或者桌宠放在别处，可以手动指定。创建 %USERPROFILE%\.dsh\naiwa-laugh.json：

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

路径要写到 exe 本身，不是文件夹。也可以用正斜杠："C:/Users/.../奶蛙桌宠.exe"。

也可以在 profile 的 cordis.patch.yml 里用 config.exePath 覆盖（优先级更高）。

兼容性

插件对两种桌宠都能用：

桌宠版本	触发方式
官方原版	模拟两次快速点击（原版靠这个判定双击）；笑完 15 秒再补一次点击让它站起来
打过 --laugh 补丁的版本	直接发 WM_APP+3，响应更快，桌宠自己会在笑完 3 秒后站起

判断方式是自动的：先发消息，700ms 后查状态，没在笑就回落到模拟点击。

补丁版的原版源码在 yugh6/Naiwa 的 源码/Naiwa.cs，加约 10 行即可（Main 里加 --laugh 分支 + WndProc 里加一条消息处理）。

排错

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

日志停在	含义
没有 plugin loaded	插件没挂载，检查 dsh plugin list 和 bundles 列表
没有 trigger via	事件没到，确认 DSH 版本有 agent/turn-stopping 接缝
exePath not configured	按上面「配置」写 json
pet window did not appear	exe 路径错，或桌宠启动失败
trigger sent but state=	桌宠收到了但没进入大笑，可能窗口标题变了

卸载

dsh plugin --profile desktop remove naiwa-laugh

然后重启 DSH。

许可

插件代码 MIT。奶蛙桌宠及其素材的版权归原作者 yugh6，本项目不声称任何权利，也不分发其任何文件。

---

English

A DSH plugin that makes the Naiwa desktop pet laugh once whenever an agent turn ends.

It ships no pet binary or artwork — you install the pet yourself from its original author. The plugin only sends window messages to it.

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

Configure %USERPROFILE%\.dsh\naiwa-laugh.json with {"exePath":"C:\\...\\奶蛙桌宠.exe"}, then restart DSH.

Works with both the stock pet (synthetic double-click) and a patched build that understands WM_APP+3 (detected automatically). Logs to %USERPROFILE%\.dsh\naiwa-laugh.log.