DeepSeek Harness Plugin

Oliver-314/dsh-meow-notifier

Stars ★ 0 Downloads (30d) 353 Category Notifications & Integrations Added 2026-11-16 npm dsh-meow-notifier

Sends DeepSeek Harness turn-completion, pending-approval and pending-question alerts to a phone through the MeoW push service, with per-event toggles and three message formats.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-meow-notifier

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:Oliver-314/dsh-meow-notifier

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

This plugin publishes its README in Chinese only.

test

把 DeepSeek Harness 的关键状态通过 MeoW 推送到手机,离开电脑时也能收到项目的最新消息。

  • 任务完成 / 出错 / 中止:一轮工作结束、Agent 回到空闲时发送。
  • 等待你确认:工具调用需要批准且等待超过 2 秒时发送(自动批准或秒答不会打扰)。
  • AI 向你提问:ask_user_question 等待回答时发送。
  • 插件挂在 profile 层,所有工作区、所有会话(含新开会话)都生效。

安装

要求:DeepSeek Harness 0.2.x,Node 22+。

从 npm 安装:

dsh plugin add dsh-meow-notifier

从源码安装(本地目录会被链接,修改后需重启 Harness 加载 Host 代码):

git clone https://github.com/Oliver-314/dsh-MeoW-notifier.git
dsh plugin add ./dsh-MeoW-notifier

也可以在 Web 界面的 插件(Plugins) → Add plugin 里填包名或本地目录,安装后启用 MeoW Notifications。

配置

  1. 打开侧边栏 插件(Plugins) → Installed plugins → MeoW Notifications。
  2. 填写 MeoW App 里注册的昵称,按需修改分类(最多 10 个字)、三类通知开关和消息格式。
  3. 点 保存,再点 发送测试通知 确认手机能收到。
  4. 页面底部会显示“最近一次通知”的结果,便于排查。

消息格式

手机通知大约能显示 180 个字符,页面提供三档:

格式 内容 长度
完整版 会话、项目 + 完整回复摘要 最长 260 字,可能被客户端截断
精简版(默认) 已完成 · 会话 + 项目 + 一句话摘要 正文 ≤ 160 字
仅状态 已完成 · 会话 约 10–20 字

状态词包括:已完成 / 出错 / 已中止 / 超出长度上限 / 被阻断 / 等待确认 / 需要回答。精简版的摘要是本地取回复的第一句话,不调用模型,不产生额外费用。

设置保存在 $DSH_HOME/meow-notify/state.json(默认 ~/.dsh/meow-notify/state.json),不会上传除昵称外的任何内容。

工作原理

插件是一个 DSH bundle,包含两部分:

部分 文件 职责
Host 半 host.js 监听 agent/status、approval/request、user-questions/request,组装消息并调用 MeoW API;在 /meow-notify/api/ 下提供设置读写和测试发送的路由
浏览器半 client.js 在插件页注册 plugins.bundle.config,渲染设置表单(React 来自浏览器模块表,样式使用 --dsw-alias-* 主题变量)

Host 半是纯 ESM,浏览器半是 window.__ModuleLoader__ 工厂格式,没有构建步骤,也没有运行时依赖。

发送队列串行执行:最小间隔 4.5 秒、每小时最多 60 条、每天最多 1000 条;只在 JSON 业务状态 status=200 且 data=true 时判定成功,超时、断连或 500 不做自动重试(推送不是幂等操作)。仅当 Harness 对外公布的地址不是 127.0.0.1 / localhost 时,通知才附带打开链接。

已知限制

  • MeoW 每天允许输错昵称 3 次,超过会封禁 IP 一天;昵称务必与 App 中完全一致。
  • 尽量避免通过多人共享的公共出口 IP 发送:同一 IP 向多个昵称推送可能被判定为攻击流量。
  • 当前会话审批策略为 never 时工具调用会被自动拒绝,不会产生“等待确认”提醒;需要把权限策略调到会询问的模式。
  • MeoW 只支持纯文本和 HTML,不支持 Markdown;本插件只发送纯文本。

开发

没有依赖需要安装。克隆后直接跑测试:

npm test

或者分别运行:

node test/host.test.mjs     # 事件、消息组装、限流、发送队列
node test/style.test.mjs    # 三种消息格式的长度与内容
node test/client.test.mjs   # 设置页渲染冒烟

修改 Host 代码后需要重启 Harness 才会加载新模块(Node ESM 缓存);浏览器半由客户端按文件变更刷新。

发布说明见 RELEASING.md,贡献指南见 CONTRIBUTING.md,安全问题见 SECURITY.md。

English

Push DeepSeek Harness task completion, approval, and question alerts to your phone through MeoW.

dsh plugin add dsh-meow-notifier

Open Plugins → MeoW Notifications, enter the nickname registered in the MeoW app, save, and send a test notification. Completion messages carry the session title, project folder, and the last reply; approvals and questions wait 2 and 1.5 seconds so instant answers stay quiet.

Phone clients show roughly 180 characters, so the page offers three formats: Full, Compact (default, one sentence, ≤ 160 characters), and Status only (for example 已完成 · 重构登录页). The summary is local text processing and never calls a model. Notifications are queued at 4.5-second intervals and capped at 60 per hour.

License

MIT

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.