clutch-dsh
编程与工具Cerbur/clutch-dsh
DeepSeek Harness 的开源 DSH 插件，包括按 Git worktree 组织会话的视图。
- dsh-plugin
验证与兼容性
这里展示目录实际采集到的证据；未声明的信息会明确标为未知。
- 当前版本兼容性
- 已在当前目录版本验证
- 声明的 Harness 范围
- 未声明
- 声明的平台
- 未声明
- 适用 Profile
- web
- 构建授权
- 未检测到需要
- 权限声明
- 未声明
- 外部服务
- 未声明
- 遥测声明
- 未知
这不是安全背书；安装前仍应查看源码、权限和配置。
查看证据与判定范围
验证仅覆盖标出的来源、版本和 Harness 环境，不代表未来版本仍然兼容。
@cerbur/clutch-dsh-worktree@0.1.8- 插件已在隔离环境完成加载检查。
README
@cerbur/clutch-dsh
@cerbur/clutch-dsh 是一个用于开发 DSH（DeepSeek Harness）plugin 的 pnpm workspace。根项目只负责 workspace 发现、共享工具链、package 规则和 Cordis patch 校验；根 package 保持 private，不作为可发布 plugin。
Workspace layout
每个直接位于 packages/* 下的目录可以是一个完整 plugin package，也可以
是包含若干独立 module package 的 plugin 根目录。Service Definition、Provider
和 Consumer 是能力角色，不是必须拆开的 package；只有角色需要独立替换、
独立发布或独立安装时才拆分。
没有 package.json 的目录可以作为规划入口存在，不会被 workspace guard
当作可运行 package。当前 packages/clutch-dsh-worktree/ 直接就是完整的
@cerbur/clutch-dsh-worktree package，其内部通过 src/contract/、src/provider/、
src/manage/、src/host/ 和 src/client/ 保留角色 seam，并包含已接入 DSH Web UI
的 Host 与 Client entry。该 package 的具体架构和权责见
packages/clutch-dsh-worktree/AGENTS.md。
若确实需要独立 module package，仍可使用
packages/<plugin>/<package-name>/；目录名必须与 package.json.name 完全
一致，并以所属 plugin 名称加 - 为前缀。模块数量、模块名和角色组合由
plugin 功能决定，workspace 不强制固定后缀。workspace 同时兼容直接位于
packages/* 下的 package 和一层 nested package。
可安装 DSH bundle 使用真实 DSH manifest：package.json 的
dsh.bundle.patch 指向同 package 内的 cordis.patch.yml。clutch-dsh
额外的 clutchDsh metadata 只用于 workspace 结构校验和记录角色。
Commands
pnpm install
pnpm run check
pnpm run build
pnpm run test
新增或修改 package 后，也可以分别运行：
pnpm run check:workspace
pnpm run check:patches
pnpm run format:check
pnpm run lint
pnpm run typecheck
具体命名、依赖和 patch 规则见 plugin authoring guide。
已发布 plugin
当前可安装的 plugin packages 包括：
| Plugin name | Screenshot | 功能描述 |
|---|---|---|
@cerbur/clutch-dsh-worktree | 为 DSH Web UI 增加按 Git Worktree 组织 Session 的视角，同时继续由 DSH 管理原始 Project 和 Session 数据。 | |
@cerbur/clutch-dsh-fireworks | 通过 happy_fireworks Agent 工具为 DSH Web UI 增加庆祝礼花覆盖层。 |
在已安装 DSH CLI 的环境中，可以安装需要的 plugin：
dsh plugin --profile web add @cerbur/clutch-dsh-worktree
dsh plugin --profile web add @cerbur/clutch-dsh-fireworks
dsh web
本地 checkout 安装、版本同步见
packages/clutch-dsh-worktree/README.md 和
packages/clutch-dsh-fireworks/README.md；plugin
发布的通用流程见根目录 docs/RELEASING.md，各包参数与安装来源见各包
自己的 docs/RELEASING.md。
