
halosb/dsh-workmate
30最近提交 2026年8月14日
dsh-workmate DSH 插件
本插件为 DSH 增加两大功能:任务完成通知和私有知识库。它监听 agent 状态,在长时间任务结束或失败时通过 Windows 原生 Toast 或 Webhook 通知你。同时,它能索引本地文档并提供完全离线的模型工具(kb_search、web_capture、kb_recent),让你拥有私有知识库。
如何安装 dsh-workmate DSH 插件
dsh plugin --profile web add github:halosb/dsh-workmate复制不会执行命令。安装 dsh-workmate DSH 插件前请核对仓库和版本。
dsh-workmate DSH 插件数据来源
dsh-workmate DSH 插件快照日期:2026年8月16日
discovered
dsh-workmate DSH 插件能做什么
- 监听 agent 空闲/运行状态,在任务超过阈值(默认60秒)完成或失败时发送通知。
- 支持两种通知通道:Windows 原生 Toast 和 Webhook POST(JSON 格式)。
- 提供私有知识库,索引本地文本文件(txt、md、json、yaml、js、ts 等),完全离线,使用 BM25 打分检索。
- 包含模型工具:kb_search(检索匹配片段)、web_capture(抓取网页内容入库)、kb_recent(列出最近捕获的网页)。
- 通过 PowerShell Beep 提供音效反馈(零依赖),支持任务完成、失败、审批、提问表单提示音。
- 可配置仅在浏览器标签页后台时通知,避免前台打扰。
dsh-workmate DSH 插件适合哪些场景
- 长时间 agent 任务完成后无需盯着界面,自动弹出通知或推送 Webhook。
- 将本地文档构建为私有知识库,模型自动检索相关信息。
- 通过 URL 抓取网页内容入库,后续可让模型直接查询。
- 利用 Webhook 对接企业微信、Telegram 或自建服务,实现任务完成通知。
- 敏感文档完全留在本地,不需要上传到外部 embedding 服务。
dsh-workmate DSH 插件适合谁
- 运行长时间 agent 任务并希望获得桌面或 Webhook 通知的 DSH 用户。
- 需要私有离线知识库并希望与 DSH 智能体集成的开发者或研究人员。
dsh-workmate DSH 插件的限制
- Windows 原生 Toast 通知需要 Windows 系统并允许 PowerShell/应用通知权限。
- 音效反馈使用 PowerShell Beep,在非 Windows 平台可能无法工作。
- 知识库仅索引文本格式(txt、md、json、yaml、js、ts 等),不支持 PDF 或图片等二进制文件。
- 网页抓取工具依赖页面内容获取,动态网站内容可能无法完整捕获。
- 插件目前处于早期阶段,配置仅通过 Web UI 设置页进行。
dsh-workmate DSH 插件的仓库 README 摘录
以下文字摘自 dsh-workmate DSH 插件的上游仓库 halosb/dsh-workmate 的 README,版权归原作者,仅作引用。
> 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 模型 ## 效果预览   ## 工作原理(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)。 ## 环境要求
阅读完整 README仓库许可: MIT
dsh-workmate DSH 插件常见问题
如何安装 dsh-workmate 插件?
通过 DSH CLI 安装:`dsh plugin --profile web add github:halosb/dsh-workmate`。如果从源码运行 DSH,使用 `pnpm dsh plugin --profile web add github:halosb/dsh-workmate`。安装后必须重启 DSH web 服务器(`dsh web` 或 `pnpm dsh web`)。
通知为什么不工作?
首先请确保已在插件设置页(设置 → 工作搭档)中启用通知。检查任务时长阈值(默认60秒)是否合适。对于 Windows Toast,需要在 Windows 设置中允许 PowerShell 通知。如果使用 Webhook,请确认 URL 正确且可达。另外,“仅后台通知”选项会在浏览器标签页活跃时屏蔽通知。
知识库支持哪些文件格式?
知识库索引基于文本的文件:.txt、.md、.json、.yaml、.yml、.js、.ts 等纯文本格式。不支持 PDF、Word、图片或可执行文件等二进制文件。只能索引本地目录,不支持远程文件。
知识库可以配合外部大语言模型使用吗?
插件注册的模型工具(kb_search、web_capture、kb_recent)可供 DSH 中运行的任何模型调用。模型可以调用这些工具搜索或抓取内容。知识库完全离线,不依赖任何外部 embedding 服务,支持任何在 DSH 中支持工具调用的模型。
如何卸载 dsh-workmate?
运行命令:`dsh plugin --profile web remove dsh-workmate`。如果从源码运行,使用 `pnpm dsh plugin --profile web remove dsh-workmate`。插件的配置文件和索引文件(config.json、kb-index.json)存储在插件目录中,会随插件一起删除。