Community plugins for DeepSeek Harness (DSH) Web GUI: system notifier. Plain JavaScript, no build required.
Pending human review — the facts below come from the source repository.
Community plugins for DeepSeek Harness (DSH) Web GUI: system notifier. Plain JavaScript, no build required.
Users who want this capability in DSH; check the source and docs before installing.
dsh plugin --profile web add github:YZz-S/dsh-notifier No supported platforms were declared.
running back to idle (a turn ends), sends "Task completed" - Confirmation / input notification: when an approval is triggered (approval/request, e.g. a tool needs your confirmation), sends "Action required" with the tool name and reason - Does not interfere with the approval flow: approval notifications pass through the waterfall's next() transparently — never answers on your behalf or changes the approval result - Cross-platform: Windows (Toast + fallback balloon) / macOS (osascript) / Linux (notify-send) - Session title shown: the title is always "DeepSeek Harness"; the body shows "session title" + status (Task completed / Action required) - DeepSeek Harness branding: registers a custom AppUserModelID on Windows so the source app name and icon show as DeepSeek Harness ### Triggered Events | Event | Mode | Notification content | | --- | --- | --- | | agent/status → idle (top-level session, previously running) | emit | Task completed | | approval/request | waterfall | Tool X needs your confirmation in the page (+ reason) | ### Files | File | Description | | --- | --- | | index.js | Installable Host half (dsh.bundle entry, ES module) | | cordis.patch.yml | Bundle patch: inserts the notifier plugin row | | host.js | Dynamic usage (cordis_define code.host) | | package.json | Installable package metadata declaring dsh.bundle | | README.md | This document | | LICENSE | MIT license | ### Installation (dsh.bundle) This repo is also an installable dsh plugin package (package.json declares dsh.bundle): sh dsh plugin --profile web add github:YZz-S/dsh-notifier After installation, system notifications are sent automatically when a task finishes or manual confirmation/input is needed (pure Host plugin — no page refresh required). The dynamic usage (cordis_define loading host.js) is kept; pick either one. ### Usage #### Method 1: dynamic Cordis plugin (temporary) Define and run in a dsh Web GUI session with the Cordis tools: 1. Call cordis_define: paste the content of host.js as code.host (plugin.kind: 'new', idPrefix of 3–6 lowercase letters) 2. Call cordis_run to activate (pure Host plugin — no page refresh required) 3. The next time a task finishes or confirmation is needed, a system notification pops up > Note: a dynamic plugin lives as long as the current dsh process. After restarting dsh you must define and run it again. #### Method 2: install as a regular plugin (recommended) See "Installation (dsh.bundle)" above: dsh plugin --profile web add github:YZz-S/dsh-notifier. ### How It Works Notification command (probe-degraded in order, first available wins): 1. powershell (Windows) → WinRT Toast with a custom AppUserModelID (DeepSeekHarness.Notify, source name + avatars.githubusercontent.com/u/148330874?v=4&s=200 icon); if Toast throws, it degrades to a balloon notification 2. osascript (macOS) → display notification … with title … 3. notify-send (Linux) Title / body are embedded into the -Command script after PowerShell single-quote escaping; the process is spawned by subprocess.spawn with an argv array, and Node handles the correct command-line quoting. Top-level session filtering: agent/status covers all agents (including subagents). The plugin uses agents.roots() to detect top-level sessions and only sends "Task completed" for them, avoiding notification spam from subagent finishes; if the agents service is unavailable it degrades to no filtering. ### Privacy - Only registers an AppUserModelID in HKCU (source name + icon); no file writes, no telemetry, no persistent storage - The icon is fetched from a public CDN (avatars.githubusercontent.com/u/148330874?v=4&s=200) by Windows only when a notification is displayed - No local data is collected or uploaded - All side effects hang on the plugin Fiber and are cleaned up on stop ### Known Limitations - The plugin silently disables itself when the subprocess service is unavailable - The Windows notification icon comes from a CDN; offline, the icon is not shown (the notification itself still pops up) - agent/status → idle fires at the end of every top-level turn — that is the "turn/task completed" semantic - A dynamic plugin is process-level: after a restart you must run it again ### Pre-Release Checklist - [x] No hard-coded keys / tokens / passwords (patterns like api[_-]?key, secret, token, password, private-key headers scanned) - [x] No personal information (usernames, machine paths, internal IPs, emails) - [x] The only network endpoint is the public CDN (avatars.githubusercontent.com/u/148330874?v=4&s=200, fetched by Windows solely for the notification icon), disclosed in this README - [x] MIT license in place, README complete - [x] No telemetry / no third-party data collection - [x] Code uses only dsh dynamic plugin public interfaces (Services / ctx.on / subprocess); all side effects hang on the plugin Fiber and are cleaned up on stop ### License MIT --- ## 中文 English · ← 返回 DeepSeekHarnessPlugins DeepSeek Harness（dsh）系统通知插件：当任务完成，或需要你在页面中手动输入 / 确认信息时，发送一条操作系统原生通知，让你切到别的窗口时也不会错过关键节点。 ### 功能 - 任务完成通知：顶层会话从 running 回到 idle（一个回合结束）时，发送「任务已完成」 - 需要确认 / 输入通知：触发审批（approval/request，例如需要你确认执行某个工具）时，发送「需要确认」，并带上工具名与原因 - 不干预审批流程：审批通知走 waterfall 的 next() 透传，绝不抢答、不改变审批结果 - 跨平台：Windows（Toast + 气泡兜底）/ macOS（osascript）/ Linux（notify-send） - 会话标题显示：标题固定「DeepSeek Harness」，正文显示「会话标题」+ 状态（任务已完成 / 需要确认） - DeepSeek Harness 品牌：Windows 通知注册自定义 AppUserModelID，来源应用名与图标显示为 DeepSeek Harness ### 触发的事件 | 事件 | 模式 | 通知内容 | | --- | --- | --- | | agent/status → idle（顶层会话，且此前为 running） | emit | 任务已完成 | | approval/request | waterfall | 工具 X 需要你在页面中确认（+ 原因） | ### 文件说明 | 文件 | 说明 | | --- | --- | | index.js | 可安装的 Host 半边（dsh.bundle 入口，ES module） | | cordis.patch.yml | bundle 补丁：插入 notifier 插件行 | | host.js | 动态用法（cordis_define 的 code.host） | | package.json | 声明 dsh.bundle 的可安装包元信息 | | README.md | 本说明 | | LICENSE | MIT 许可证 | ### 安装（dsh.bundle） 本仓库同时是可安装的 dsh 插件包（package.json 声明 dsh.bundle）： sh dsh plugin --profile web add github:YZz-S/dsh-notifier 安装后任务完成或需要人工确认/输入时自动发送系统通知（纯 Host 插件，无需刷新页面）。 动态用法（cordis_define 加载 host.js）仍保留，两种方式二选一。 ### 使用方法 #### 方式一：动态 Cordis 插件（临时运行） 在 dsh Web GUI 的会话中，用 Cordis 工具定义并运行： 1. 调用 cordis_define：code.host 粘贴 host.js 的内容（plugin.kind: 'new'，idPrefix 取 3–6 个小写字母） 2. 调用 cordis_run 激活（纯 Host 插件，无需刷新页面） 3. 下一次任务完成或需要确认时即会弹出系统通知 > 注意：动态插件的生命周期与当前 dsh 进程相同。重启 dsh 后需重新定义运行。 #### 方式二：安装为正式插件（推荐） 见上文「安装（dsh.bundle）」：dsh plugin --profile web add github:YZz-S/dsh-notifier。 ### 工作原理 通知命令（按顺序降级探测，取第一个可用）： 1. powershell（Windows）→ WinRT Toast，注册自定义 AppUserModelID（DeepSeekHarness.Notify，来源名 + avatars.githubusercontent.com/u/148330874?v=4&s=200 图标）；Toast 抛出异常时自动降级为气泡通知 2. osascript（macOS）→ display notification … with title … 3. notify-send（Linux） 标题 / 正文通过 PowerShell 单引号转义后内嵌进 -Command 脚本；由 subprocess.spawn 以 argv 数组派生，Node 侧负责正确的命令行引号处理。 顶层会话过滤：agent/status 会覆盖所有 agent（含子代理）。插件用 agents.roots() 判断是否为顶层会话，只对顶层会话发「任务已完成」通知，避免子代理结束刷屏；agents 服务不可用时降级为不过滤。 ### 隐私说明 - 仅在 HKCU 注册 AppUserModelID（来源名 + 图标），无文件写入、无遥测、无持久化存储 - 图标取自公开 CDN（avatars.githubusercontent.com/u/148330874?v=4&s=200），仅在显示通知时由 Windows 拉取 - 不采集、不上传任何本地数据 - 副作用全部挂在插件 Fiber 上，停止即清理 ### 已知限制 - subprocess 服务不可用时插件静默停用 - Windows 通知图标取自 CDN，离线时图标不显示（通知本身仍会弹出） - agent/status → idle 在每次顶层回合结束时触发，属于「回合/任务完成」语义 - 动态插件为进程级生命周期，重启后需重新运行 ### 开源前检查 - [x] 无硬编码密钥 / Token / 密码（已扫描 api[_-]?key、secret、token、password、私钥头等模式） - [x] 无个人信息（用户名、机器路径、内部 IP、邮箱） - [x] 网络端点仅公开 CDN（avatars.githubusercontent.com/u/148330874?v=4&s=200，仅供 Windows 拉取通知图标），已在 README 披露 - [x] MIT 许可证齐全，README 完整 - [x] 无遥测 / 无第三方数据收集 - [x] 代码仅使用 dsh 动态插件公开接口（Services / ctx.on / subprocess），副作用全部挂在插件 Fiber 上，停止即清理 ### License MIT --- English · 中文Not by stars — picked by hand, one at a time.
A visual settings dashboard for DeepSeek Harness: every registered settings namespace — including third-party plugin ones the official UI never covers — rendered as editable, schema-driven forms. Early, but the right direction: stop hand-editing YAML.
A DIY trajectory visualizer for DeepSeek Harness: watch the agent’s plan and execution unfold as a graph instead of scrolling raw logs. Early, but it fills a real gap — understanding at a glance what the agent is doing.
Dispatch DSH work from Claude Code / Codex: spin up in-host DSH agent sessions with per-tier presets, watch native subagent progress, and borrow a multimodal bridge that lends the text-only harness vision and image generation. An orchestration plugin that turns DSH into a backend for other coding agents.