dsh-gotify-notify
Verified@wha7ever/dsh-gotify-notify · v0.1.3 · MIT · Web UI
Gotify push alerts for DeepSeek Harness: get pinged when the harness asks you a question, waits for an approval, finishes a turn, or fails
Install
dsh plugin add @wha7ever/dsh-gotify-notify Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Readme
@wha7ever/dsh-gotify-notify
English | 中文
当 DeepSeek Harness 需要你时,通过 Gotify 推送一条通知,这样你可以离开窗口,到真正需要回来的时刻再回来。
会推送什么
| 触发时机 | 推送时点 |
|---|---|
| 提问 | Harness 为你生成问题的瞬间,早于你作答。 |
| 审批 | 有工具调用被阻塞、等待你的决定期间。 |
| 一轮结束 | 这一轮真的停下来之后,包含目标轮次用尽的情况。 |
| 执行出错 | 根会话的一轮报错。默认关闭。 |
会自动继续的会话不会每轮都打扰你:只要会话有一个 active 且 armed 的目标,就跳过结束推送——那一轮由 dsh-goal-round-driver 负责续跑。该驱动所有停止方式都会在目标状态上留下痕迹,因此推送会在目标变为 complete、blocked(轮次上限会写入 round-limit 阻断)、paused,或 resume 后未激活时送达。没有目标的会话则在短暂的稳定窗口后推送,只要 agent 重新开始运行就取消。
安装
dsh plugin --profile web add @wha7ever/[email protected]
本 bundle 自带 gotify-notify 行,无需再往 profile 组合里添加任何东西。
它声明 engines.dsh: ">=0.2.0-rc.1" —— 一个无上界范围:此后每个宿主版本都能直接加载,不需要插件跟着更新,因为本插件只用到 settings 服务与提问 / 批准 / 代理状态 / 代理出错这几个事件。
配置
打开 设置 → Gotify 提醒,依次填写:
- 服务器地址 —— Gotify 实例的基础地址,不要带
/message,例如https://push.example.com;路径前缀会保留,https://example.com/gotify同样可用。 - 应用令牌 —— 在 Gotify 网页版右上角打开 apps 标签,新建应用并复制令牌。Gotify 3 只在创建或轮换时显示一次令牌。
- 优先级 ——
0静默,1-3状态栏图标,4-7加提示音,8-10再加振动。默认8。
然后点 发送测试通知。测试使用的是已保存的配置,所以请先保存再测试。
所有字段都写入当前 profile 的 Cordis patch,与这个 profile 的其他配置放在一起;保存后在下一次通知时立即生效,无需重载。
工作原理
Host 侧声明一个 gotify-notify 行,其 Config 的每个字段都是 .volatile()。@deepseek-ai/dsh-settings 正是把这种字段投影成可编辑、带 revision 校验的表单,而 apply 在推送时通过 .get() 读取它们。
user-questions/request ─┐
approval/request ─┼─▶ 组装简短正文 ─▶ POST <server>/message
agent/status (idle) ─┤ X-Gotify-Key: <app token>
agent/error ─┘
请求体是 JSON,包含 title、message、priority、extras;当启动时记录了 Web UI 地址,extras["client::notification"].click.url 会指回 Harness 界面。
两个 waterfall 事件(user-questions/request、approval/request)只做观察:监听器一律调用 next(),决定权仍在自带的回答者手里。结束推送挂在根 agent 的 running → idle 边沿上,并经过上述稳定窗口。
网络与密钥
- 应用令牌声明为
role('secret')。@deepseek-ai/dsh-settings永远不会把它返回给浏览器:页面只能看到「是否已配置」,且令牌输入框留空表示保持原值,而不是清空。 - 推送使用原生
fetch。Harness 在所有插件加载前就把出网代理策略装到全局 dispatcher 上,所以这次请求和其他所有 Harness 请求走同一套代理规则,回环地址保持直连。 - 唯一的外部目标是你在设置里填的服务器地址,其余数据不出本机。
- 短时间内容完全相同的推送会被丢弃,且同一时刻只允许一条推送在途,避免把你的手机刷屏。
本地验证
bun run test
test/host.test.mjs 直接 import 真实的 lib/index.js,挂到带 volatile 式 Config 字段的假 Cordis 上下文上,拦截 fetch,并驱动该模块订阅的各个事件。它钉住注册顺序(prepend)、每个触发点、真实的 Gotify 请求、目标续跑规则、密钥处理、去重、优先级夹取,以及浏览器 RPC 面。
test/client.test.mjs 用最小 React 运行时 + 假 Cordis 上下文直接跑真实的 lib/client.js,并驱动设置页:断言渲染出的控件与其 label 关联、暂存编辑行为、优先级非法时阻止保存、令牌留空绝不会清掉已存密钥,以及保存时提交的每一条 set/unset 操作。
test/waterfall.test.mjs 钉住这些提醒钩子依赖的 Cordis 顺序规则:位于「抢先作答」的回答者之后的普通监听器永远不会执行,而 { prepend: true } 会让观察者先跑、next() 之后仍由回答者决定。它会从当前 Harness 解析 @deepseek-ai/cordis,解析不到时自动跳过。
卸载
关闭 启用提醒 可以在保留配置的前提下停止推送;或卸载 bundle:
dsh plugin --profile web remove @wha7ever/dsh-gotify-notify
许可
MIT