Skip to content

dsh-task-notifier

Verified

@polunzh/dsh-task-notifier · v1.2.1 · MIT · Web UI

任务通知台:任务完成时响提示音并弹系统/浏览器通知,侧边栏「任务」面板可筛选待回复、进行中与已完成未读的任务。Task-completion chime + system/browser notifications, plus a Tasks sidebar panel that surfaces sessions waiting on your input, running, and unread-completed.

Install

dsh plugin add @polunzh/dsh-task-notifier

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

任务通知台 · Task Notifier

中文 | English

npm 开放插件市场 license dsh

任务面板(浅色)


DeepSeek Harness(DSH)Web 插件:任务完成时提醒你,并提供一屏同时展示「待回复 / 运行中 / 已完成未读」的三列看板任务面板。

它解决什么

DSH 跑长任务时,你切走去干别的,回来才发现早就跑完了。这个插件把「完成」这件事推到你能看到的地方:

  • 提示音:任意会话一轮结束,浏览器合成一段上行 chime(G5→C6),不需要音频素材。
  • 通知双通道:
    • 页面开着且已授权 → 浏览器 Notification,点一下跳回对应会话;
    • 页面关了或未授权 → 宿主在 macOS 上弹系统通知(osascript),不会双弹(心跳判重)。
  • 待回复状态:Agent 向你提问、等你审阅计划或等你审批时,侧栏图标亮起琥珀色脉冲点,面板「待回复」列置顶提示,点开直接回到那个等你决定的会话。
  • 三列看板面板:侧边栏图标(带未读角标)→ 一屏同时看到待回复 / 运行中 / 已完成未读三列,顶部 chip 可单独筛选单列,底部「更早完成」可展开历史;支持按标题搜索、全部标为已读、试听提示音、试发系统通知。
  • 自动同步已读:切换会话时自动标记未读任务为已读。
  • 未读不丢:状态写在 $DSH_HOME/storages/dsh-task-notifier/state.json,重启后还在。
  • 中英双语:界面与系统通知文案跟随宿主语言(zh / en)。

安装

方式一:开放插件市场安装(推荐,可在市场点赞)

已收录进社区市场(分类「工作流与协作」,已通过源码级验证 ✅):在「插件 → 实验性插件」打开「自定义插件市场」→ 发现 → 添加索引源,粘贴:

https://dshopen.org/index.json

之后搜索「任务通知台 / Task Notifier」安装;市场页与点赞见 dshopen 插件页。

方式二:从自建索引安装(可自动检测更新)

同样在「发现 → 添加索引源」粘贴:

https://dsh.127.dev/index.json

之后搜索「任务通知台 / Task Notifier」安装;有新版本时列表会显示可更新,卸载在「已安装」里。 索引每 6 小时随 npm 刷新,源码见 dsh-plugins-index。

方式三:npm 安装

dsh plugin --profile desktop add @polunzh/dsh-task-notifier

配置

全部可省略,写在你的 profile 的 cordis.patch.yml 里:

- insert:
    - id: polunzh-task-notifier
      name: '@polunzh/dsh-task-notifier'
      config:
        osNotify: auto            # auto | always | off
        sound: true               # 浏览器端提示音开关
        osSound: Glass            # macOS 系统提示音名
        osTitle: DeepSeek Harness # 系统通知标题
字段 默认 说明
osNotify auto auto=页面在线交给浏览器通知、离线兜底系统通知;always=恒发系统通知;off=不发
sound true 浏览器合成提示音
osSound Glass macOS 自带提示音名(Glass / Ping / Pop …)
osTitle DeepSeek Harness 系统通知标题

隐私与安全

  • 不联网:没有任何出站请求、遥测或远程资源。
  • 不上传:会话标题只写本机 state.json,目录 0700、文件 0600。
  • 不读凭据:不碰 ~/.dsh/.credentials.yaml、.env、keychain、SSH key。
  • 路由 fail-closed:宿主连接守卫缺失时直接拒绝,不做"没守卫就放行"。
  • 无安装期脚本:package.json 里没有 preinstall/postinstall/prepare。

细节、威胁模型与限流参数见 SECURITY.md。

兼容性

项目 要求
DSH >=0.2.0-rc.2(写在 engines.dsh)
Node >=20
平台 Web UI 全平台;系统通知仅 macOS,其他平台只发浏览器通知
浏览器通知 需要用户点击授权(插件不在后台自动请求)

截图

浅色看板 深色看板
浅色看板 深色看板
已完成未读(单列筛选) 待回复(单列筛选)
已完成未读 待回复
宽屏收敛(1920×1080) 移动端响应式(390×844)
宽屏收敛 移动端响应式

截图为真实界面 + 示例数据,由 npm run screenshot 用 headless Chrome 渲染生成。

开发

npm test              # node:test,60 个用例(含侧边栏已读同步、安全边界与中英字典一致性)
npm run preview       # 本地预览页(真实 client.js + 模拟数据)
npm run screenshot    # 重新生成 preview/screenshots/*.png