工作区待办 ACCSCI/dsh-plugins

DSH 插件

为 DeepSeek Harness（dsh）准备的插件集合——本仓库的插件就是针对这个桌面端 / Web 端 harness 编写的。每个插件都是独立包：一个 Node 宿主半边（路由、服务、持久化），以及在有需要时提供的浏览器半边（通过 shell 启动图加载的 Web GUI 贡献）。

除非插件自己声明，否则这里的东西都不面向模型：插件就是安装进配置档的普通 DSH 包，本仓库里的这些插件添加的是面向用户的界面，而不是智能体工具。

插件

| 插件 | 作用 | 半边 |
| workspace-todo | 待办列表，绑定到会话的工作目录，从会话标题栏的按钮打开。数据存放在 <working directory>/.dsh/todos.json，因此同一目录上的每个会话共享同一份列表。 | 宿主 + Web 客户端 |

安装

git clone https://github.com/ACCSCI/dsh-plugins

然后把某个插件安装进 DSH 配置档。两种方式都行：

- 插件管理器（作用于运行中的配置档）。 在 Plugins 页面操作，或通过管理工具：install_bundle <absolute path to the plugin directory>。刷新 GUI 页面后，新的浏览器半边就会出现。
- 官方装配（重启后生效）。 dsh plugin --profile <profile> add <absolute path to the plugin directory>。

插件目录就是声明了 dsh.bundle.patch 的包（它的 cordis.patch.yml 插入加载器行），对于带浏览器半边的插件，还要声明 dsh.client 以及 ./client 导出。

修改插件

- 浏览器半边（lib/client.js）：刷新 GUI 页面。shell 会从磁盘上的文件重新构建模块图。
- 宿主半边（lib/index.js）：重启 DSH。加载器用普通的 import() 导入插件模块，所以运行中的进程会保留它已经加载的模块——禁用 / 启用该条目或重装 bundle 都不会重新导入它。

仓库结构

plugins/<name>/
package.json # name, exports, dsh.bundle.patch, dsh.client
cordis.patch.yml # the loader row this bundle inserts
lib/index.js # host half
lib/client.js # browser half (when the plugin has one)
test/.mjs # dependency-free test scripts
README.md # what it does, how it is installed, what was verified

测试

每个测试脚本都跑在纯 Node 上，没有依赖，也不需要安装 DSH：

node plugins/workspace-todo/test/host-routes.mjs # drives the real route handlers over a shimmed ctx.fs contract
node plugins/workspace-todo/test/client-smoke.mjs # renders the real component tree with a minimal React substitute
node plugins/workspace-todo/test/live-check.mjs <project dir> # against a running GUI (needs the profile's local credential)

CI 在每次 push 时运行离线测试套件。

许可证

MIT——见 LICENSE。

中文说明

这是一个面向 DeepSeek Harness（dsh） 的插件集合。每个插件都是一个独立包：Node 侧 host 半（路由、服务、持久化）+ 可选的浏览器侧 client 半（通过启动图注入 Web GUI 的界面贡献）。
这里的插件默认都不注册模型工具——它们是给用户用的界面能力，不是给智能体用的工具。

| 插件 | 作用 |
| workspace-todo | 绑定到「当前会话工作目录」的待办清单：会话顶栏一个按钮打开浮层面板；数据存在 <工作目录>/.dsh/todos.json，同一目录下的所有会话共享一份清单 |

安装：git clone 本仓库后，把某个插件目录装进 DSH 配置档 —— 插件管理端 install_bundle <插件目录绝对路径>（活配置立即生效，新客户端入口刷新页面）或 dsh plugin --profile <profile> add <插件目录绝对路径>（重启后生效）。

改动生效规则：改 lib/client.js 刷新页面即可；改 lib/index.js 必须重启 DSH（加载器用普通
import() 取模块，进程内的 ESM 缓存不会因为停用/启用 entry 或重装 bundle 而失效）。

自测：每个插件的 test/.mjs 都是零依赖的普通 Node 脚本，可直接运行；CI 会在每次 push 时跑离线用例。