paradoxSCH
dsh-worktree
Durable Git worktree isolation and delivery plugin for DeepSeek Harness
- Stars
- 1
- Language
- TypeScript
- Created
- Aug 14, 2026
- Updated
- Aug 14, 2026
Introduction
dsh-worktree
面向 DeepSeek Harness 的独立 Git worktree 插件。每个子代理在受管理的 checkout 中工作，主工作区不会被并发任务直接修改；任务结束后，插件根据精确状态指纹安全清理或保留结果。
这是独立发布仓库，不属于 Harness monorepo。DSH 上游只提供通用的 child cwd 扩展接口，Git 快照、worktree、恢复、交付和产品界面均由本仓库维护。
当前状态
仓库正在按完整产品范围开发，尚未发布稳定版。当前已实现：
fresh、head、working-state三种工作基线；- staged、unstaged、untracked 状态的无损复制，ignored 文件默认不带入；
- one-shot 与 continuable DSH 子代理 provider；
- durable journal、状态指纹、安全清理、显式 discard token；
- 可注入崩溃边界与启动恢复；
- Windows 上的真实 Git、Cordis 和 provider 测试。
交付动作、管理 CLI、DSH tools、审批边界和 Web UI 仍在实现，因此当前版本标记为 alpha，而不是缩减范围的 MVP。
DSH 兼容性
插件需要 DSH 的 provider-prepared child cwd 接口。对应上游提交为 0647d61abf，正在等待进入 DeepSeek Harness 的正式发布版本。
已发布的 DSH 0.1.0-rc.6 不包含该接口；本仓库会显式拒绝把它列为受支持运行时，避免出现“插件安装成功但子代理仍写入主 checkout”的静默失效。
从独立仓库安装
在兼容的 DSH 版本发布后，可直接把 GitHub 仓库安装到任意全局 DSH profile：
dsh plugin --profile web add github:paradoxSCH/dsh-worktree
dsh plugin --profile headless add github:paradoxSCH/dsh-worktree
建议生产环境固定 release tag 或 commit：
dsh plugin --profile web add github:paradoxSCH/dsh-worktree#<tag-or-commit>
验证 Bundle 已加入全局 profile，而不是当前项目：
dsh --profile web --dump-config
dsh plugin --profile web why dsh-worktree
卸载：
dsh plugin --profile web remove dsh-worktree
发布到 npm 后，安装入口将简化为：
dsh plugin --profile web add dsh-worktree
仓库提交预构建的 lib/，GitHub 安装不需要执行不受信任的 prepare 构建脚本。
默认行为
- 默认 source：
working-state； - 默认 lifetime：
managed； - 默认 provider 名称：
worktree； - 状态目录：
$DSH_HOME/plugins/dsh-worktree； - ignored 文件不自动复制；
- 子代理有新增变化时自动保留 worktree；
- destructive discard 必须携带最新检查 token 和显式确认。
开发
pnpm install
pnpm run check
pnpm run pack:check
主要文档：
License
MIT