dsh-git-worktree
Experimental Git worktree Session Targets for DeepSeek Harness with real isolated sessions, review ToolViews, human-confirmed delivery, and safe cleanup.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add dsh-git-worktree@0.9.0
Git Worktree is published as dsh-git-worktree and currently resolves to version 0.9.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
让 Agent 在独立 Git Worktree 中完成任务，你看过修改后再决定是否保存。
dsh-git-worktree 是 DeepSeek Harness 的 Git Worktree 插件。它会为每个编码任务创建独立的 Worktree（工作目录），Agent 不会直接改动你正在使用的项目。任务完成后，你可以先预览结果，再选择保存、退回修改或放弃。
这套 Git Worktree 工作方式最初来自基于 Pi Agent Runtime 的开源桌面 coding 工作台 Domi，本插件是针对 DeepSeek Harness 独立适配的版本，可以单独安装和使用。
让 Agent 直接修改当前项目时，它的改动可能与你尚未提交的内容混在一起；同时运行多个任务时，也更容易互相影响。使用本插件后：
当前版本管理单个项目中的 Git Worktree，暂不提供跨项目的全局管理界面。
flowchart LR
A[当前项目] -->|创建隔离任务| B[独立 Git Worktree]
B --> C[Agent 修改并测试]
C --> D[查看验收结果]
D -->|预览修改| E[在当前项目中查看效果]
E -->|确认并保存| F[创建本轮提交]
F --> G[在原对话继续下一轮]
D -.->|保存阶段进度| H[继续开发]
E -.->|撤回本次预览| I[返回修改]
D -.->|跳过预览| F
| 目标 | 操作 |
|---|---|
| 先在当前项目中查看效果 | 预览修改 |
| 预览结果没有问题 | 确认并保存 |
| 任务很长，先固定当前进度 | 保存阶段并继续 |
| 还要让 Agent 改代码 | 继续修改或撤回本次预览 |
| 不需要先查看效果 | 跳过预览并保存 |
详细的操作、恢复场景和命令见完整使用指南。
^22.19.0 || >=24.0.00.1.2-rc.1 为开发验证基线；0.1.5-rc.1 已有用户可用反馈并通过部分隔离验证，详见兼容矩阵与限制。并非只能使用最新版。从旧 Harness 升级时请先处理 Host 数据迁移：0.1.2-rc.1 已移除可选 SQLite Session 后端，旧数据需使用旧版 Harness 导出；Code Mode 已更名为 PTC mode，但现有会话记录仍可读取。应用和本插件统一通过 dsh Profile 启动与安装。
从旧版 Harness 升级后，如果 Web 界面提示 Failed to load plugins，请按兼容矩阵选择修复版本并重启 Harness；下方以当前 0.9.0 为例。0.7.2 及更早版本依赖已停止发布的 dsh-client-runtime；0.7.3 在 rc.1 Web Client 中还可能形成 conversation / uiWorkspace 循环等待。
dsh plugin --profile web add dsh-git-worktree@0.9.0
dsh plugin --profile web add dsh-git-worktree
也可以安装指定版本：
dsh plugin --profile web add github:wloops/dsh-git-worktree#v0.9.0
安装后打开 Git Workspace，在新建 Session 时启用 Worktree；已有 Local Session 也可以让模型调用 worktree_create 创建隔离 Session。
第一次使用建议先完成一次“创建 → 预览修改 → 确认并保存 → cleanup”的完整流程。
如果 Git 源安装被 pnpm build approval 阻止，或需要查看完整命令和排错步骤，请阅读安装与使用指南。
Managed Worktree 聚合到原 Local 项目
完整操作步骤见完整使用指南。
每次把任务修改写回当前项目之前，插件都会重新确认任务版本、项目位置和文件状态仍与验收时一致。如果你切换了分支、修改发生冲突，或上一次操作意外中断，插件会停止写入并保留现场，而不是猜测后继续覆盖。
Worktree 隔离主要用于避免任务之间误改文件，不是用来运行不受信任代码的系统沙箱。
更详细的状态检查与恢复规则见：
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run check:publish
端到端启动：
pnpm run dev:dsh
插件跟随 DSH 的中英文选择，不提供独立语言开关。请在 DSH 中明确选择 English，以便界面、工具和 /worktree 消息都使用英文；自动浏览器语言尚未写入 DSH 偏好时，工具和命令会回退中文。详见 语言传递与文案贡献说明。