社区插件合集 bertholomus/dsh-public-plugins

dsh-public-plugins

DeepSeek Harness（DSH）Desktop 的社区插件。

每个插件都是普通的 DSH 插件包。把它加进 DSH 配置档的 bundles，再在配置档的 cordis.patch.yml 里设置好。配置档使用 patchReload: live 时，改完设置不用重启就生效。

| 插件 | 作用 |
| dsh-site | 把运行中的 DSH Desktop GUI 提供给私有网络里的其他设备（比如 Tailscale tailnet）。会话、工作区、工具都和本机一致。 |
| discord | 把 Discord 机器人接到 DSH 会话上。每个 Discord 线程就是一个常驻智能体会话，智能体通过 Discord 工具作答。完整的机器人设置步骤见它的 README。 |
| categories | 给 DSH 会话列表里的工作区分组：每个分类一个标题，下面放它的工作区，其余归入 Other workspaces，在列表或 Categories 页面里创建和整理。 |
| coordinator | 任何聊天都能把活儿放到线程里跑。聊天为专注的工作启动线程会话，每个线程向它汇报，线程各自保留自己的模型、effort 和权限。 |
| calendar | 你的日历，给你和你的智能体用：iCloud、Google、Microsoft 365 和 Exchange Online、Fastmail、Nextcloud 及其他 CalDAV 服务器、订阅的 .ics 源，还有这台电脑上的日历。智能体读取它们，并在权限允许时修改。 |
| session-bridge | 跑在 Unix socket 上的本地 JSON API，驱动 Host 自己的会话控制器。脚本和其他智能体可以创建、提示、引导、取消、读取 DSH 会话，你在 DSH 窗口里实时看着它们。 |
| session-watch | Autopilot、Decisions 和 Agent Terminals 共用的监视器：从 DSH 自己的事件里拿到每个会话的状态，并用会话自己的日志证明消息已送达。没有自己的页面。 |
| autopilot | 没人看着时也让会话继续跑：重启后告诉被中断的会话接着干，对还有未完成待办的安静会话提醒一次然后退避，把因错误停下的目标重新启动。每个动作都有 Why 行和总开关。 |
| decisions | 一个收件箱，装下所有等你处理的事：决策行、等待批准的工具、问题框里的问题、需要做决定的线程。每张卡片显示问题、建议、会话和等待时长；答案写回会话，由它的日志证明。可选把备注发到 webhook 或命令。 |
| agent-terminals | 把命令行编码智能体接入 DSH：每个智能体占一个终端标签页，与自己的会话并排；重启后重新拉起并续上原来的对话；你的消息逐条输入，并从它的对话记录中确认已被读取；它当前在做什么（工作中、空闲、等你回复）显示在会话列表对应行和 Decisions 里。 |
| proof | 对「已完成」「已通过」「已修复」「已部署」这类说法逐条核对它那一轮实际跑了什么，把没有任何证据支撑的标出来，并维护一份可导出的台账。需要时，还能在本地模型上做一次独立的只读核查。 |
| canon | 共享长期记忆：每轮开始前，从你的 canon vault（一个 Obsidian 文件夹）里挑出几条生效中的笔记，要求与当前会话的文件夹和提示词匹配，拼成一小段文本，并标出每条笔记的路径。默认只读 vault；允许草稿笔记后才会写入，且只有你能把草稿转正。 |
| recall | 搜索所有已完成的内容：为 DSH 会话、对话记录文件夹和交接笔记建本地全文索引，支持按文件夹、模型、日期和类型筛选。点开结果会直接跳到该会话的那一轮，智能体也能用 recall_search 工具查同一个索引。 |
| wallpaper | 给 DSH Desktop 换壁纸和毛玻璃：壁纸库支持轮换和配色，侧边栏、对话区、输入区和右侧面板可开毛玻璃，还有动效和可编辑的标题。纯视觉功能。 |
| reasoning-pill | 一个推理控制项：在输入区的模型名旁边放一颗 Reasoning 药丸，取代 DSH 模型菜单里的 Effort 行。 |
| notifications | 你没在用 DSH 时发系统通知。Coordinator、Decisions、Agent Terminals 和 Autopilot 都通过它推送消息，点一下就把 DSH 窗口切到消息对应的聊天，它的页面会列出每条通知的后续结果。 |

Session Watch、Autopilot、Decisions、Agent Terminals、Proof、Canon 和 Recall 共同组成 DSH Plugin Suite：它们如何配合、如何一次性全部安装、每个插件如何测试和评判，见 SUITE.md。

这些插件是独立作品，并非 DeepSeek 制作或背书。

Gallery

每个插件一张图，取自一个演示用的 home。各插件 README 里有更多。

Coordinator 0.1.0: Any chat can run its work in threads that report back to it.
Decisions 1.0.1：一个收件箱，装下所有等你处理的事。就地答复。

Recall 1.0.0：搜索你做过的一切，每条结果都能打开到它所在的那一轮。
Proof 1.0.0：把「已完成」「已通过」「已修复」「已部署」这类说法，逐条对照这一轮实际跑过的东西。

Autopilot 1.1.0：没人盯着的时候，也让会话继续跑下去。
Agent Terminals 1.0.0：在 DSH 里跑命令行编码智能体，每个都在自己的会话旁边的终端标签页里。

Canon 1.0.0：从 Obsidian vault 来的共享长期记忆，每轮以一小段带引用的内容加进去。
Calendar 0.1.0：你的日历放进 DSH，给你和你的智能体用。

Discord 0.2.0：为你自己的频道准备的 Discord 机器人：每段对话各有一个话题，各有一个独立的 DSH 会话。
Session Watch 1.1.0：Autopilot、Decisions 和 Agent Terminals 共用的监视器。

Categories 0.1.0：在 DSH 的会话列表里把工作区分组到分类中。
Reasoning pill 0.1.0：设置推理只需一处：模型名旁的 Reasoning 控件。

Notifications 0.1.0：你没在用 DSH 窗口时发系统通知。
Wallpaper 0.1.0：把你的壁纸放到 DSH 背后，支持毛玻璃、色彩模式和动效。

DSH Site 0.2.0：把这台 Mac 上的 DSH 窗口开放给你私有网络里的设备。
Session Bridge 0.4.0：让这台 Mac 上的脚本和定时任务能够启动、提示、引导并读取 DSH 会话。

安装插件

只有当配置档在 dsh.profile.bundles 中列出某个插件的包时，DSH 才会加载它。随后插件的 bundle 会添加该插件的配置行，你在配置档的 cordis.patch.yml 中配置这一行。示例使用默认桌面配置档 ~/.dsh/profiles/desktop 和 coordinator 插件。

| 插件 | 包 | 行 id |
| dsh-site | dsh-plugin-dsh-site | dsh-site |
| discord | dsh-plugin-discord | discord |
| categories | dsh-plugin-categories | categories |
| coordinator | dsh-plugin-coordinator | coordinator |
| calendar | dsh-plugin-calendar | calendar |
| session-bridge | dsh-plugin-session-bridge | session-bridge |
| session-watch | dsh-plugin-session-watch | session-watch |
| autopilot | dsh-plugin-autopilot | autopilot |
| decisions | dsh-plugin-decisions | decisions |
| agent-terminals | dsh-plugin-agent-terminals | agent-terminals |
| proof | dsh-plugin-proof | proof |
| canon | dsh-plugin-canon | canon |
| recall | dsh-plugin-recall | recall |
| wallpaper | dsh-plugin-wallpaper | wallpaper |
| reasoning-pill | dsh-plugin-reasoning-pill | reasoning-pill |
| notifications | dsh-plugin-notifications | notifications |

1. 克隆本仓库：

git clone https://github.com/bertholomus/dsh-public-plugins ~/.dsh-plugins/dsh-public-plugins

2. 备份两个配置档文件：

cd ~/.dsh/profiles/desktop
ts=$(date -u +%Y%m%dT%H%M%SZ)
cp cordis.patch.yml cordis.patch.yml.bak-$ts
cp package.json package.json.bak-$ts

3. 用 DSH Desktop 安装的 dsh 命令把插件加入配置档。npm 上的 dsh 会拒绝修改桌面配置档。

dsh plugin --profile desktop add ~/.dsh-plugins/dsh-public-plugins/plugins/coordinator

这条命令把包链接进配置档，并加入 dsh.profile.bundles。想手动完成同样的操作，在 ~/.dsh/profiles/desktop 中：

- 在 package.json 的 dependencies 中加入 "dsh-plugin-coordinator": "link:/Users/<you>/.dsh-plugins/dsh-public-plugins/plugins/coordinator"。
- 在同一文件中，把 "dsh-plugin-coordinator" 加到 dsh.profile.bundles 末尾。
- 链接进 node_modules：ln -s ~/.dsh-plugins/dsh-public-plugins/plugins/coordinator node_modules/dsh-plugin-coordinator 除此之外不需要安装别的。插件把 @deepseek-ai/schemastery 和它们用到的 DSH 包列为 peerDependencies，DSH 会给它们各自的副本。在你自己的插件副本里，把这些包保留为 peer。DSH 不会去配置档的 node_modules 里找链接插件的 dependencies，所以插件如果把它们列在那里，导入就会失败，除非插件自己的文件夹里装了这些包。

4. 在 cordis.patch.yml 里配置插件。插件的 bundle 已经加好了这一行，所以按 id 定位这一行，给它一个 config。每个插件的 README 都写了自己的配置。

- id: coordinator
config:
the plugin's settings

5. 重启 DSH Desktop。运行中的 DSH 不会加载新的 bundle。之后，当配置档使用 patchReload: live 时，对这一行的修改会实时生效。

用 insert 加的行，即使 bundle 也列着，仍然能用，因为实际运行的是配置过的那一行。上面的定位写法可以避免出现重复行。

移除插件

1. 从 cordis.patch.yml 里删掉它的行。
2. 在 package.json 里，从 dsh.profile.bundles 删掉这个包，并删掉它的依赖。
3. 删掉 node_modules/dsh-plugin-* 符号链接。
4. 重启 DSH Desktop。

或者恢复安装第 2 步的备份。

测试

npm test # dsh-site, session-bridge, coordinator (pure logic), the categories window, calendar, session-watch, autopilot, decisions
npm run showcase # the pictures in docs/screenshots/, made in a demo home; npm test checks docs/site.json against them
npm install --no-save @deepseek-ai/schemastery @deepseek-ai/dsh-llm@next @deepseek-ai/dsh-brand@next @deepseek-ai/dsh-tools@next
node plugins/discord/test/smoke.mjs # discord (no token needed)
node plugins/coordinator/test/smoke.mjs # coordinator (fake DSH host)
node plugins/coordinator/test/client.mjs # coordinator's window half
node plugins/categories/test/smoke.mjs # categories (fake DSH host)

coordinator + session-bridge on a real DSH, with a scripted model server
npm install --prefix /tmp/dsh @deepseek-ai/dsh
DSH_BIN=/tmp/dsh/node_modules/@deepseek-ai/dsh/lib/bin.js npm run test:e2e

categories + session-bridge on a real DSH
DSH_BIN=/tmp/dsh/node_modules/@deepseek-ai/dsh/lib/bin.js npm run test:e2e:categories

calendar + session-bridge on a real DSH (RADICALE_VENV, a virtualenv with radicale, adds a CalDAV account)
DSH_BIN=/tmp/dsh/node_modules/@deepseek-ai/dsh/lib/bin.js npm run test:e2e:calendar

autopilot + session-watch on a real DSH in a throwaway home: every DSH under .e2e/ and the installed app's (see plugins/autopilot/README.md)
npm run test:e2e:autopilot

decisions + session-watch + autopilot on a real DSH in a throwaway home, with a stand-in webhook on this machine (see plugins/decisions/README.md)
npm run test:e2e:decisions

any suite plugin (autopilot, decisions, agent-terminals, proof, canon, recall) on every DSH under .e2e/ and the installed app's
node scripts/e2e.mjs proof

npm run showcase 需要 ImageMagick 7（magick）、git、script、curl 和 jq，还需要 Playwright 及其 Chromium（优先用 PLAYWRIGHT_MODULE，否则用 .e2e/tools，再否则用已安装的 playwright 或 playwright-core；详见 test/e2e/harness.mjs），以及一个可运行的 DSH：优先用已安装应用的，否则用 .e2e/ 下最新的，或者用 --dsh <version> 指定的那个。npm run showcase -- recall decisions 只截取这些插件的图片。

License

MIT