前言¶
在 DeepSeek Harness(DSH)里跑 agent,回合往往要等模型和工具链跑完才知道结果;agent 通过提问工具向你索要输入时,若一直盯着界面,既费神也容易错过时机。常见做法是偶尔切回标签页看状态,或依赖终端里的日志——对 Web 端长时间任务来说并不顺手。
下面介绍社区插件 dsh-genshin-lisa-notice(维护者 EagleClark):在浏览器侧对「回合结束」和「agent 提问等待输入」两类事件做声音提醒、系统通知,并可选用飞书 webhook 推送;内置多款原神角色语音,也可上传自定义 mp3。插件面向 dsh web profile,音频素材随包分发,无需自行挂外部路径。
这是什么¶
dsh-genshin-lisa-notice 是 DSH 的 Web 客户端插件。名字里的 lisa 来自早期只用丽莎语音做「执行完成提醒」的命名,后续已扩展交互提醒、配置页、内置语音库与自定义上传,名称仍沿用。
一句话定位:任意会话在执行完成、或 agent 调用 ask_user_question 向你请求输入时,播放可配置的提醒音,并可选浏览器系统通知与飞书推送;模型请求失败导致回合报错时,也会走声音、系统通知与红色飞书卡片,并带上 HTTP 状态码、错误码与原始信息。
- 目录页:https://www.skillhub.cn/plugins/EagleClark/dsh-genshin-lisa-notice
- 源码与说明:https://github.com/EagleClark/dsh-genshin-lisa-notice
- 当前包版本(package.json):0.15.2,许可证 MIT
- 运行环境:dsh ≥ 0.1.7-rc.2(插件使用 Config +
configForms,旧版依赖settingsScope时无法激活)
核心功能¶
两类自动提醒¶
装好后无需额外操作,下列时刻会自动触发(声音 / 系统通知默认开启,飞书默认关闭):
- 执行完成:任意会话回合即将结束(
agent/turn-stopping),播放「完成提醒语音」,发送带任务完成摘要的系统通知;若开启飞书,则推送到配置的 webhook。 - 等待输入:agent 在
tools/pre-execute阶段分发ask_user_question时(早于提问 UI 出现),播放「交互提醒语音」,并同样可走系统通知与飞书。
多次完成会在客户端合并为一次播放,避免连续刷屏。
通知与语音配置¶
在侧边栏 插件 → 已安装 → dsh-genshin-lisa-notice 中,Genshin通知提醒 配置卡片提供:
- 声音提醒、系统通知(默认开)、飞书通知(默认关),各有一个开关。
- 完成提醒语音、交互提醒语音 各一个下拉框;默认分别为「丽莎姐姐聊聊天」「罗莎莉亚不加班」。内置选项还包括:兹白·无须言语、罗莎莉亚·还不走吗、胡桃·晒太阳月亮歌、系统音效 1–3;旁有 试听(未保存也可试听内置语音)。
- 下拉选「自定义音频…」可上传 mp3(界面显示原文件名);自定义文件保存在
$DSH_HOME/data/dsh-genshin-lisa-notice/。 - 飞书 Webhook 地址:填入群自定义机器人 webhook 并开启飞书后,完成或需要输入时会推送交互卡片(完成绿色标题条、提问橙色;任务与结果或问题分区;Card JSON 2.0,正文 markdown 表格可转为飞书原生 table 等)。卡片体积过大或被拒时会降级或退回纯文本。
- 确认 保存并立即生效;取消 丢弃未确认项;恢复默认 回到包内默认。配置写入当前 profile 的
cordis.patch.yml($DSH_HOME/profiles/<profile>/cordis.patch.yml下dsh-genshin-lisa-notice的config:),无需重启 dsh。
模型故障提醒¶
请求失败导致回合报错(如欠费、鉴权失败、限流 429、服务端 5xx、网络异常、超时)时,除声音与系统通知外,飞书侧使用红色卡片,并附带具体状态码与错误信息(在开启飞书的前提下)。
工作原理(简述)¶
| 端 | 职责 |
|---|---|
Host(lib/index.js) |
监听回合结束与 ask_user_question 分发;通过 webServer 提供语音试听、按配置输出的提醒音、上传与 /poll(计数与完成摘要);在 agent/status 为 idle 时组摘要并发送飞书卡片。 |
Client(client/client.js) |
约每 700ms 轮询 /poll,按开关播放音频并发起浏览器系统通知;处理自动播放策略与用户手势解锁。 |
安装与启用¶
官方建议 优先从 npm 安装(预构建包,升级更简单):
dsh plugin --profile web add dsh-genshin-lisa-notice
也可从 GitHub 源码安装:
dsh plugin --profile web add github:EagleClark/dsh-genshin-lisa-notice
安装完成后 重启 dsh web,并刷新页面(客户端 bundle 随启动注入)。
若已升级到插件 0.10.0 及以上(配置模型迁移到 dsh ≥ 0.1.7-rc.2 的 Config / configForms),需要 再执行一次上述安装命令 后重启——profile 里保留的是安装时的快照。
典型用法¶
1. 零配置监听
完成上述安装并重启 web 后,正常在 DSH Web 里对话即可;回合结束或 agent 提问时会按默认语音与通知策略提醒。
2. 改语音与飞书
打开 插件 → dsh-genshin-lisa-notice → Genshin通知提醒,在下拉框中切换完成/交互语音,或上传自定义 mp3;需要群提醒时填写飞书 webhook 并打开「飞书通知」,点 确认。
3. 听不到声音时
浏览器自动播放策略要求页面至少有一次用户交互(点击或按键)。重启后若首次提醒被拦截,在页面任意处点一下,后续提醒即可正常出声。系统通知需在浏览器首次询问时 允许 通知权限。
适用场景与注意¶
适合谁:主要在 DSH Web 端跑 agent、希望「离开页面也能被叫回来」的开发者;需要把完成摘要或提问推到飞书群时,可开 webhook。
权限与信任:插件随当前 dsh 进程 运行,会读写 profile 配置、在 $DSH_HOME/data/dsh-genshin-lisa-notice/ 存上传文件,并向配置的飞书地址发 HTTP 请求。安装前建议在 GitHub 查看源码与 MIT 许可证,自行判断是否纳入环境。
素材与合规:README 注明内置语音版权归原版权方,仅供个人使用;公开分发或商用前请自行确认素材许可。
DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-genshin-lisa-notice 把「回合结束」和「等待你输入」两类高频节点做成可配置的语音与通知(含可选飞书),减少盯着 Web 界面的时间。安装命令以 README 为准,装完重启 dsh web 即可使用。