dsh-workmate DSH plugin

This plugin adds two major features to DSH: task-completion notifications and a private knowledge base. It monitors agent status to notify you when long-running tasks finish or fail, via Windows Toast or webhook. It also indexes local documents and provides model tools (kb_search, web_capture, kb_recent) for offline retrieval entirely on your machine.

skills-workflows developer-tools

How to install the dsh-workmate DSH plugin

dsh plugin --profile web add github:halosb/dsh-workmate

Copying does not run this command. Review the repository and version before installing the dsh-workmate DSH plugin.

dsh-workmate DSH plugin data source

dsh-workmate DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-workmate DSH plugin can do

Monitors agent idle/running status and notifies on task completion or failure after a configurable threshold (default 60s).
Supports two notification channels: Windows native Toast and webhook POST (JSON payload).
Provides a private knowledge base that indexes local text files (txt, md, json, yaml, js, ts, etc.) fully offline using BM25 scoring.
Includes model tools: kb_search (retrieve matching chunks), web_capture (capture web page content into the index), and kb_recent (list recently captured web pages).
Offers sound feedback via PowerShell Beep (zero dependency) for task completion, failure, approval, and question form events.
Only notifies when the browser tab is in the background (configurable).

Where the dsh-workmate DSH plugin fits

Get notified when a long-running agent task completes or fails without needing to watch the UI.
Build a private, offline knowledge base from local documents and let the model search it automatically.
Capture web pages into the knowledge base by simply providing a URL, then retrieve them later via the model.
Use webhook notifications to integrate with external services like WeChat Work, Telegram, or custom endpoints.
Keep sensitive documents on your machine without sending them to any external embedding service.

Who the dsh-workmate DSH plugin is for

DSH users who run long agent tasks and want desktop or webhook notifications.
Developers and researchers who need a private, offline knowledge base integrated with their DSH agent.

dsh-workmate DSH plugin limitations

Windows native Toast notifications require Windows system and permission for PowerShell/application notifications.
Sound feedback uses PowerShell Beep, which may not work on non-Windows platforms.
Knowledge base only indexes text-based formats (txt, md, json, yaml, js, ts, etc.); binary files like PDF or images are not supported.
Web capture tool relies on fetching the page content; dynamic site content may not be fully captured.
The plugin is in early stage; configuration is only available via the Web UI settings page.

dsh-workmate DSH plugin: from the repository README

Quoted from the halosb/dsh-workmate README, the upstream source of the dsh-workmate DSH plugin. Copyright remains with the original authors.

> DeepSeek Harness 工作搭档插件：**任务完成通知** + **私有知识库**。 > A workmate for DeepSeek Harness: task-completion notifications and a private knowledge base. 以官方插件机制安装，**不修改任何 DSH 源码**，不需要重新构建前端。 ## 特性 ### 🔔 任务完成通知 - 监听 Agent 状态（`agent/status` idle ⇄ running）计时，**长任务**（超过阈值）结束/失败时提醒 - 通道一：**Windows 原生 Toast**（标题=会话标题/工作区名，正文=耗时与状态） - 通道二：**Webhook 推送**（POST JSON，可接企业微信/Telegram/自建服务/邮箱网关） - **音效反馈**：任务完成"叮"、失败低音、审批出现提醒音、**提问表单出现提示音**（PowerShell Beep，零依赖） - 「仅后台通知」：浏览器标签页在前台时不打扰 ### 📚 私有知识库 - 索引本地文档目录（txt/md/json/yaml/js/ts 等文本格式），**完全离线** - 提问时模型自动调用 **`kb_search` 工具**检索（BM25 词频打分），返回文件+片段+分数 - **`web_capture` 工具**：给个 URL → 抓取正文 → 直接入库；返回**索引文件位置**与取回方式 - **`kb_recent` 工具**：**直接列出**最近捕获的网页（标题/URL/块数/时间/索引路径），无需盲搜 - **重建不丢网页库**：本地目录"重新索引"时自动合并保留所有网页捕获，互不覆盖 - 文档不离开本机，不依赖 embedding 模型 ## 效果预览 ![设置页 - 任务通知](docs/screenshots/settings-1.png) ![设置页 - 私有知识库](docs/screenshots/settings-2.png) ## 工作原理（30 秒） 1. 本插件是 DSH **组合包（bundle）**：`package.json` 声明 `dsh.bundle` + `dsh.client`。 2. host 半边监听 `agent/status`（计时通知）+ 索引知识库 + 注册 `kb_search`/`web_capture`/`kb_recent` 模型工具 + 提供 `/wf/*` 路由；浏览器半边是设置页。 3. 配置持久化在插件自己的 `config.json`（`GET/POST /wf/settings`），索引数据在 `kb-index.json`（均已 gitignore）。 ## 环境要求

Read the full READMERepository license: MIT

dsh-workmate DSH plugin questions

How do I install dsh-workmate?

You can install it via the DSH CLI: `dsh plugin --profile web add github:halosb/dsh-workmate`. If you are running DSH from source, use `pnpm dsh plugin --profile web add github:halosb/dsh-workmate`. After installation, you must restart the DSH web server (`dsh web` or `pnpm dsh web`).

Why are notifications not working?

First, make sure you have enabled notifications in the plugin settings page (Settings → Workmate). Check that the notification threshold (default 60 seconds) is appropriate for your tasks. For Windows Toast, you need to allow PowerShell notifications in Windows settings. If you are using webhook, verify the URL is correct and reachable. Also, the 'Only background notification' option may suppress notifications when the browser tab is active.

What file formats does the knowledge base support?

The knowledge base indexes text-based files: .txt, .md, .json, .yaml, .yml, .js, .ts, and other plain text formats. Binary files like PDF, Word, images, or executables are not supported. You can only index local directories; remote files are not supported natively.

Can I use the knowledge base with external large language models?

The plugin registers model tools (kb_search, web_capture, kb_recent) that are available to any model running in DSH. The model can call these tools to search or capture content. The knowledge base is fully offline and does not depend on any external embedding service. It works with any model that supports tool calling in DSH.

How do I uninstall dsh-workmate?

Run the command: `dsh plugin --profile web remove dsh-workmate`. If you are running from source, use `pnpm dsh plugin --profile web remove dsh-workmate`. The plugin's configuration and index files (config.json, kb-index.json) are stored in the plugin directory and will be removed along with the plugin.