DSH Desktop 的内置通知仅提示“用户回合已完成”,无法判断具体对话或产出内容。dsh-notify-plus 用包含实时会话标题和可操作摘要的原生 Windows Toast 替换了这一功能。
这是什么¶
这是由 hoyin-law 维护的插件,为 DSH Desktop 提供上下文丰富的通知。Toast 标题取自日志回溯的会话标题,正文是对回合产出的确定性 10-20 字提炼。
核心功能¶
-
标题具体化
每个通知标题都使用实时会话标题,而非固定文案。 -
正文精炼
将回合内容提炼为一条可操作的一行字(CJK 为 10-20 字,Latin 遵循 Windows 限制)。 -
保留错误信息
失败时报告实际错误而非通用致歉,上下文耗尽有单独标签。 -
作业标签携带
后台作业通知携带作业标签,便于区分。 -
静默内部扇出
不为内部分发会话触发通知。 -
替换内置行
替换内置通知行并重用设置命名空间。
安装与启用¶
安装命令如下:
dsh plugin --profile <your-profile> add dsh-notify-plus
该插件依赖 @deepseek-ai/schemastery(由 DSH 提供),无需手动安装。
配置说明¶
插件支持通过 Settings 或配置文件控制行为。在配置文件中添加以下内容可自定义设置:
- id: dsh-notify-plus
config:
notifyOnJobCompletion: false
locale: zh
可配置项包括:
* enabled:总开关。
* notifyOnTurnCompletion:对话回合完成时通知。
* notifyOnTurnFailure:对话回合失败或上下文耗尽时通知。
* notifyOnJobCompletion / notifyOnJobFailure:后台作业完成或失败时通知。
* locale:语言设置,auto 为自动,zh 或 en 强制指定。
* suppressWhenFocused:前台静音。
* focusProcess:判定为前台进程的名称。
注意事项¶
- 系统要求:仅支持 Windows 10 或 11。
- 运行环境:使用 Windows PowerShell 5.1。
- DSH 版本:需要 DSH Desktop 2.0.3 或 DeepSeek Harness 0.2.0-rc.2。
- 平台限制:仅支持 win32。
- 前台行为:当 DSH Desktop 拥有前台窗口时,通知保持静默。
- 开发环境:Node.js 版本要求 >= 22.19.0(仅开发与测试需要)。
总结¶
dsh-notify-plus 解决了原生通知信息缺失的问题,通过将标题与正文具体化,让开发者能更清晰地追踪对话状态与作业结果。该插件已兼容 DSH Desktop 2.0.x 与 DeepSeek Harness 0.2.0-rc.x。