wloops/dsh-git-worktree

Name: wloops/dsh-git-worktree
Author: wloops

Plugin插件 Native原生 ⭐ 17 MIT Subagents & Orchestration子代理与编排 Dev Workflow开发与代码工作流 Productivity & Tasks效率与任务

用于DeepSeek Harness的Git worktree会话目标，具备隔离任务会话、可逆本地预览、人工确认交付、恢复及同会话迭代功能。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-git-worktree is a native plugin built exclusively for DeepSeek Harness that enables isolated task execution using Git worktrees. It creates a separate work directory for every coding task assigned to the agent, so the agent never modifies your active working project directly. This worktree approach was originally developed for the Domi open source desktop coding workbench, and this repository is a dedicated adaptation for DeepSeek Harness that can be installed and used independently. Once installed, the plugin aggregates all worktrees for a single project in the DSH sidebar, making it easy to view and manage all current and past tasks.

The typical workflow starts after you create a new isolated task, the agent makes all edits and runs tests in the dedicated worktree. When the agent finishes, you can preview the changes directly in your current working project before you decide to merge them, or you can reject the changes and ask the agent to revise without impacting any of your existing uncommitted work. You can save progress in stages for long-running tasks, run multiple tasks in parallel with no interference, and start your next task directly in the same conversation after delivery. This workflow is designed for developers who run multiple agent tasks and want to maintain full control over all changes made to their codebase.

To install the plugin, you need Node.js version ^22.19.0 or higher than 24.0.0, a compatible version of DeepSeek Harness, the Harness Web Client, and an existing Git workspace. After installation, you can enable the Worktree option when creating a new DSH session. The standard installation command is dsh plugin --profile web add dsh-git-worktree, which can be run directly from your terminal. It is released under the permissive MIT open source license. Currently, it does not support cross-project global management, task forking, or editing saved stages, and first-time users are recommended to complete a full end-to-end workflow to get familiar with the tool.

dsh-git-worktree 是专门为 DeepSeek Harness 开发的原生 Git Worktree 插件，核心能力是为每个编码任务创建独立的 Git 工作目录，避免 Agent 直接修改开发者当前正在使用的项目。它的工作流设计源自 Domi 开源桌面编码工作台的 Git Worktree 方案，针对 DeepSeek Harness 做了独立适配，可以单独安装使用。安装后，插件会在 DSH 侧边栏聚合同一项目的所有任务 Worktree，方便开发者集中查看管理所有当前和历史任务。

开发者发起任务后，插件会创建隔离的 Worktree，Agent 在独立目录中完成修改和测试，之后开发者可以先在当前项目预览修改效果，确认无误后再保存合并，不满意可以直接撤回修改，完全不会影响本地已有的未提交改动。它支持长任务分阶段保存进度，多个任务并行处理也不会互相干扰，还能在任务交付后直接在原对话继续下一轮开发。这套流程适合需要让 Agent 处理多任务、同时希望保留对代码修改完全控制的开发者。

本插件依赖 Node.js 版本 ^22.19.0 或 >=24.0.0，以及对应基线版本的 DeepSeek Harness、Harness Web Client 和 Git Workspace，可通过 DSH 的 CLI 命令一键安装。它遵循 DSH 的界面语言设置，不提供独立语言开关，采用 MIT 许可证完全开源，目前暂不支持跨项目全局管理、任务分叉、已保存阶段编辑删除等功能，第一次使用建议走一遍完整的创建、预览、保存、清理流程来熟悉操作。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-git-worktree（wloops/dsh-git-worktree）
仓库：https://github.com/wloops/dsh-git-worktree
本站详情页：https://www.yhbd.top/plugins/wloops-dsh-git-worktree/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 17 · 最近提交 2026-09-30 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示

17 stars - an early-stage project星标 17，属于早期项目

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add dsh-git-worktree

把 wloops/dsh-git-worktree 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

8.7 KB · 缓存于 2026-09-30 22:10:06 · 8.7 KB

dsh-git-worktree

让 Agent 在独立 Git Worktree 中完成任务，你看过修改后再决定是否保存。

dsh-git-worktree 是 DeepSeek Harness 的 Git Worktree 插件。它会为每个编码任务创建独立的 Worktree（工作目录），Agent 不会直接改动你正在使用的项目。任务完成后，你可以先预览结果，再选择保存、退回修改或放弃。

这套 Git Worktree 工作方式最初来自基于 Pi Agent Runtime 的开源桌面 coding 工作台 Domi，本插件是针对 DeepSeek Harness 独立适配的版本，可以单独安装和使用。

English · 完整使用指南 · 架构说明

为什么使用它？

让 Agent 直接修改当前项目时，它的改动可能与你尚未提交的内容混在一起；同时运行多个任务时，也更容易互相影响。使用本插件后：

每个任务都在自己的 Git Worktree（独立工作目录）中修改和测试；
多个任务可以同时进行，不会共用同一个工作目录；
Agent 完成后，你可以先把修改临时显示在当前项目中查看；
只有确认后才会保存本轮修改，遇到冲突时不会自动覆盖你的内容。

核心能力

Git Worktree 隔离：每个任务都有独立的工作目录和 Agent 对话。
多个 Worktree 并行：可以同时开发多个任务；为了避免混入修改，同一项目每次只验收一个任务。
提交前预览：先在当前项目中查看真实效果，不会立即创建 Git 提交。
不满意可以退回：撤回本次预览，继续让 Agent 修改，不影响其他本地改动。
只保存本轮任务：确认后只提交这个任务的修改，不把无关内容一起带入。
长任务可分阶段：先保存当前阶段的进度，再继续开发；最终仍合并为一次交付。
出错时保护现场：检测到分支变化、内容冲突或中断时停止操作，保留现场供你处理。
集中查看任务：同一项目的当前及历史 Worktree 会按 Host 导航归属聚合到侧边栏，归属不明确时保守保留原位置。
验收详情集中查看：从验收条打开只读详情，查看文件列表、验证记录与版本信息，不必翻找聊天工具记录。
空仓库安全起步：无提交仓库可在明确确认后创建不包含用户文件的空首次提交，再建立隔离 Worktree。
携带项目 Skills：首次及下一轮 Worktree 创建时一次性携带 .dsh/skills、.agents/skills 和 .claude/skills，辅助文件与 Git 交付隔离。
原对话继续下一轮：任务交付后，无需新开对话即可继续下一项修改。

当前版本管理单个项目中的 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 改代码	继续修改或撤回本次预览
不需要先查看效果	跳过预览并保存

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 wloops/dsh-git-worktree 的 README.md。在 GitHub 查看原文 →