前言¶
用 DeepSeek Harness（dsh）跑长任务时，Mac 常会按系统策略息屏或进入休眠，对话仍在后台执行，你却不一定盯着窗口。任务结束时如果没有提醒，也容易错过结果或错误状态。系统自带的「勿扰」、第三方计时器与 dsh 的生命周期并不绑定，关掉 dsh 后还要记得手动恢复。
下面介绍社区插件 dsh-small-toolkit（维护者 HanYu-me，GitHub：HanYu-me/dsh-small-toolkit）。它在 dsh 运行期间用 macOS 能力保持亮屏、防休眠，并在主对话一轮任务结束时弹出系统通知；点击通知可把 DeepSeek Harness 切到前台。两项能力都只在 macOS 上生效，属于 DSH 生态里「客户端」类的小工具合集。
这是什么¶
dsh-small-toolkit 是 DeepSeek Harness 的插件：在 lib/features/ 下按文件拆分功能，可分别开关。当前版本 0.3.0，许可证 MIT，要求 Node ^22.19.0 || >=24.0.0，dsh 版本范围为 >=0.1.1-rc.2 <0.3.0（以 package.json 为准）。
它不改动模型或对话逻辑，只在本地 macOS 上补两件实用能力：运行 dsh 时阻止息屏/休眠，以及 主对话任务结束时的系统通知（含标题、结果类型与用时）。
核心功能¶
保持亮屏（keepAwake）¶
配置键 keepAwake。dsh 运行期间调用 caffeinate -di -w <dsh 进程>，阻止 Mac 息屏和休眠；dsh 退出后自动解除。
任务完成提醒（taskNotify）¶
配置键 taskNotify。主对话的一轮任务结束时弹出 macOS 系统通知，内容包含对话标题、结果（完成 / 出错 / 被拦截 / 输出达到上限）和用时。点击通知会切回 DeepSeek Harness 窗口。子智能体、Agent Teams 成员不提醒；手动停止的任务默认不提醒（可在 profile 配置里通过 notifyOn 加入 aborted 以改变行为）。
通知由插件构建的小助手 App「DSH 提醒」发出，图标为 DeepSeek Harness 鲸鱼，安装在 ~/Applications/DSHNotifier.app。首次发通知时 macOS 会请求通知权限；无 Swift 工具链时会退回普通通知，点击可能打开「脚本编辑器」而非 DSH，详见 README「关于通知」一节。
安装与启用¶
Web 版 profile 安装：
dsh plugin --profile web add github:HanYu-me/dsh-small-toolkit
桌面版 profile：
dsh plugin --profile desktop add github:HanYu-me/dsh-small-toolkit
装好后重启 dsh。也可从 Releases 下载预构建的 dsh-small-toolkit.tgz 安装。
卸载：
dsh plugin --profile web remove dsh-small-toolkit
然后重启 dsh（桌面版将 --profile web 换成 desktop）。
典型用法¶
手动开关（无需重启 dsh）¶
编辑首次加载时自动生成的文件：
~/Library/Application Support/dsh-small-toolkit/settings.json
{
"keepAwake": true,
"taskNotify": false
}
taskNotify：每次任务结束时读取；关掉后不再弹通知。keepAwake：约每 3 秒读取一次；关掉会立刻释放防休眠，重新打开则再次接管。- 文件缺失、非法 JSON 或未写某个键时，该功能默认保持开启。
- 若要让某个功能彻底不加载，在 profile 的
cordis.patch.yml里对该功能设enabled: false。
Profile 级配置（改完需重启 dsh）¶
在 profile 的 cordis.patch.yml 里给 small-toolkit 增加 config:：
- id: small-toolkit
config:
keepAwake:
enabled: true
taskNotify:
enabled: true
notifyOn: [completed, error, blocked, max-tokens] # 加上 aborted 则手动停止也提醒
minDurationSec: 0 # 例如 30：只提醒用时 30 秒以上的任务
sound: true # false 为静音
clickOpensApp: true # 关掉后改回普通通知（点击会打开脚本编辑器）
appBundleId: com.deepseek.dsh # 点击通知时切到的应用
通知相关日志：~/Library/Application Support/dsh-small-toolkit/notifier.log。开启 macOS「专注模式」时通知可能被静默。
适用场景与注意¶
适合在 macOS 上长时间用 dsh 做编码、调研或批量任务的用户：需要机器保持唤醒、又希望在主对话结束时有系统级提醒并一键回到 DSH 窗口。
务必注意：
- 插件随当前 dsh 进程运行，安装前建议阅读仓库源码与 MIT 许可证，确认
caffeinate、通知助手等行为符合你的环境策略。 - 非 macOS 系统上这两项功能不生效。
- 社区目录 skillhub.cn 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 理念是「一切皆插件」，安装来源以 README 为准。
结尾¶
dsh-small-toolkit 把「跑 dsh 时不睡屏」和「主对话任务结束提醒并聚焦 DSH」做成可独立开关的两块小功能，配置路径与安装命令在 README 里写全。需要扩展能力时，维护者在 README 中说明了在 lib/features/ 新增文件并注册到 lib/index.js 的方式。
- 目录页：https://www.skillhub.cn/plugins/HanYu-me/dsh-small-toolkit
- 仓库：https://github.com/HanYu-me/dsh-small-toolkit
