clutch-dsh
Coding ToolsCerbur/clutch-dsh
Open-source DSH plugins for DeepSeek Harness, including a worktree view for organizing sessions by Git worktree.
- dsh-plugin
Verification and compatibility
This section shows evidence collected by the catalog. Undeclared information is labeled as unknown.
- Current-version compatibility
- Verified on the catalog Harness version
- Declared Harness range
- Not declared
- Declared platforms
- Not declared
- Profiles
- web
- Build approval
- No requirement detected
- Permissions
- Not declared
- External services
- Not declared
- Telemetry
- Unknown
This is not a security endorsement. Review source, permissions, and configuration before installing.
View evidence and scope
Verification covers only the named source, version, and Harness environment. It does not guarantee future compatibility.
@cerbur/clutch-dsh-worktree@0.1.8- The plugin completed a load check in an isolated environment.
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。
