@weekit/dsh-notify

启用与使用

1. 打开 WebUI 的 设置 > 通知。
2. 开启需要的通知功能。
3. 如需系统通知，点击 请求授权，并在浏览器提示中允许通知。
4. 如需钉钉通知，在钉钉配置组打开官方文档创建自定义机器人，填写 Access Token 与 Signing Secret，选择需要发送的结果类型后保存。
5. 保持默认配置，或分别调整 Tab 提示、运行中 spinner、侧栏状态灯及结果类型。

钉钉的结果筛选独立于浏览器通知开关。关闭系统通知或本地某类结果，不会关闭已启用的钉钉分类。浏览器通知权限被拒后，网页无法再次强制弹出授权框；请从浏览器地址栏的站点权限设置中重新允许通知。

配置

浏览器侧设置保存在当前站点的 localStorage，默认配置如下：

设置	默认
系统通知	开
系统通知正文最大字符数	400（可设置 100–2000）
子代理独立完成通知	关（固定；仅跟随父会话运行计数）
Tab 未读结果汇总	开
Tab 运行中 spinner	开
Tab 空闲标题动效	开
空闲 hidden favicon 提示	关
侧栏绿/红状态灯	开
五类结束结果	全开
未读结果动画	跑马灯
钉钉成功 / 完成消息	开（配置凭据后生效）
钉钉失败 / 中止消息	开（包含错误、阻塞、Token 限制）
钉钉消息免打扰	关（默认时段 23:00-08:00）
免打扰结束后错过消息汇总	关

钉钉凭据与策略保存在 $DSH_HOME/dsh-notify/settings.json，不会写入浏览器 localStorage，API 也不会把凭据回传给页面。凭据管理接口仅接受本机回环地址上的同源 WebUI 请求；通过局域网或公网地址访问 WebUI 时不能修改钉钉配置。免打扰固定按 Asia/Shanghai 判断，支持跨午夜；开启汇总后，期间消息会暂存到同目录的 dingtalk-missed.json，结束时合并为一条通知。普通任务结果也会在发送前短暂写入该持久队列，失败或重启后自动重试；交付采用 at-least-once 语义，极端崩溃窗口可能重复，但不会静默丢失。更换机器人凭据会在保存新凭据前清空旧队列，关闭结果分类也会移除对应待发消息。POSIX 系统使用 0700 目录和 0600 文件权限；Windows 依赖当前用户的文件 ACL，并继续拒绝符号链接和非普通文件。

系统通知正文最大字符数可直接在 dsh-notify 设置页调整，修改后立即生效。