deepseekplugins

DeepSeek Harness plugin

dsh-workmate

Task-completion toasts and webhooks plus a private local knowledge base with kb_search.

Docs & Rendering
Jump to install

Source facts

Repository
halosb/dsh-workmate
Latest update
Aug 14, 2026
Category
Docs & Rendering
GitHub stars
6
Format
bundle
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/halosb/dsh-workmate
Plugin: dsh-workmate
Author: halosb

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-workmate（工作搭档）

> 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）。

环境要求

  • DeepSeek Harness（源码运行 Node ≥ 22 + pnpm，或已安装的 dsh CLI）
  • Windows 系统通知需要允许 PowerShell/应用通知权限

安装

# 从 GitHub 安装（已安装 CLI）
dsh plugin --profile web add github:halosb/dsh-workmate

# 从 GitHub 安装（源码运行环境）
pnpm dsh plugin --profile web add github:halosb/dsh-workmate

# 或本地目录
dsh plugin --profile web add ./dsh-workmate
pnpm dsh plugin --profile web add ./dsh-workmate

# 装完必须重启
dsh web          # 默认端口 3080
pnpm dsh web     # 源码运行环境

卸载：

dsh plugin --profile web remove dsh-workmate
pnpm dsh plugin --profile web remove dsh-workmate

> 纯 JS、无构建步骤，git 安装不需要 pnpm 的 prepare/allowBuilds 授权。

使用与配置

打开 Web UI → 设置 → 工作搭档，全部可视化配置（详细说明见 [使用与配置文档.md](./使用与配置文档.md)）：

任务通知：启用开关 / 时长阈值（默认 60 秒）/ 系统通知 / Webhook URL / 失败通知 / 仅后台通知 / 音效反馈。

私有知识库：索引目录 / 支持格式 / 分块大小与重叠 / 重新索引按钮 / 索引统计；模型可用 kb_search 检索、web_capture 抓网页入库、kb_recent 直接列出已存网页。

出厂默认：通知开、阈值 60s、Toast 开、仅后台开、音效开；知识库未配置（填目录并点"重新索引"即启用）。

模型工具一览

工具用途
kb_search(query)检索知识库，返回匹配块（文件/片段/分数）
web_capture(url)抓取网页正文入库，返回索引文件位置与取回方式
kb_recent(limit?)直接列出最近捕获的网页（标题/URL/块数/时间），最新在前

Webhook 请求体

任务结束时 POST 到配置的 URL（Content-Type: application/json）：

{
  "sessionId": "…",
  "title": "会话标题或工作区名",
  "status": "done" | "error",
  "durationMs": 132000,
  "message": "任务完成，用时 2 分 12 秒"
}

仓库结构

dsh-workmate/
├── package.json          # dsh.bundle + dsh.client 声明
├── cordis.patch.yml      # 组合层：插入 workmate 行
├── index.js              # host 半边：通知监听 + 知识库索引/检索 + kb_search/web_capture/kb_recent 工具 + /wf/* 路由
├── client.js             # 浏览器半边：设置页 UI
├── docs/
│   └── screenshots/      # 设置页效果预览截图
├── README.md
├── 使用与配置文档.md      # 完整使用与配置说明
├── config.json           # 运行时生成：用户配置（已 gitignore）
├── kb-index.json         # 运行时生成：知识库索引（已 gitignore）
└── LICENSE

反馈

有问题或建议，欢迎通过邮箱联系作者：

  • 📮 反馈邮箱：i@halosb.com
  • 作者：芝麻 (halosb)

许可证

[MIT](./LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category