dsh-git-worktree

面向 DeepSeek Harness 的 对话 ↔ 工作树绑定 插件：让多个会话在同一项目上并行工作，每个会话绑定一个独立 git 工作树 + 分支，一键创建、互不干扰。

Conversation↔worktree binding for DeepSeek Harness: run multiple conversations on one project in parallel, each bound to its own isolated git worktree + branch, created in one click.

绑定 / Binding — 会话在创建时即绑定到专属工作树：工作树 + 工作区 + 会话一次成型（绑定关系可推导、可展示、可清理）。
Agent 工具 / Agent tools — 9 个工具（git_session_binding、git_repo_status、git_worktree_*、git_branch_*），每个会话都可以调用。 9 tools (git_session_binding, git_repo_status, git_worktree_*, git_branch_*) every conversation can call.
浏览器面板 / Browser panel — 侧边栏的 Bindings 入口：绑定管理器，列出工作树及其绑定的会话，一键创建绑定会话，删除时警告并可选归档绑定会话。 A sidebar Bindings entry: the binding manager — lists worktrees with their bound conversations, creates a bound conversation in one click, and warns about (optionally archiving) bound conversations on removal.

绑定是什么 / What a binding is

DSH 中，会话的工作目录（cwd）在创建时冻结，工作区归属要求"会话 cwd == 工作区路径"。因此绑定只能在创建会话的那一刻发生——把会话建在专属工作树里，绑定关系即成立：

A DSH session's cwd is frozen at creation and workspace membership requires the session's canonical cwd to equal the workspace path. So a binding happens at creation time: the conversation is born inside its own worktree:

~/projects/foo/                  ← 主工作树 / primary worktree (main)
├── .dsh-wt/
│   ├── feature-a/               ← 会话 A 绑定 / conversation A is bound here (branch feature-a)
│   └── bugfix-b/                ← 会话 B 绑定 / conversation B is bound here (branch bugfix-b)
└── (共享同一个 .git / one shared .git)

绑定关系无需额外存储，由 sessions.list（cwd）× git worktree list（路径→分支）× workspaces.list 推导而来——面板和 agent 工具看到的都是实时事实。

Bindings are derived, not stored: sessions.list (cwd) × git worktree list (path→branch) × workspaces.list — what the panel and the agent tools show is live fact.

一键创建绑定会话 / One-click bound conversation

在面板输入 repo 路径（默认取当前会话工作区）和功能名，点 创建绑定会话：

git worktree add -b /.dsh-wt/（重名自动加后缀 -2、-3…）
（幂等注册工作区）

工具	用途
`git_session_binding`	开场必查：本会话的绑定——仓库、所在工作树、检出分支、peer 工作树。`bound` 仅在拥有专属（非主）工作树时为 true。
`git_repo_status`	分支、领先/落后、脏文件；查询本会话所在仓库时附带 `binding` 块。
`git_worktree_list`	列出所有工作树（含分支/HEAD），标记 `主工作树` 与 `当前会话`。
`git_worktree_add`	创建工作树。`name` → `/.dsh-wt/`（锚定主仓库根，从工作树内创建也不会嵌套）；或显式 `path`。`unique` 自动去重（`-2`、`-3`…）；显式 `newBranch` 冲突则报 git 原错。
`git_worktree_remove`	删除工作树（分支保留）。只接受已注册的工作树；主工作树会被拒绝；`force` 可删除含未提交改动的工作树。
`git_branch_list`	列出分支：短 sha、检出标记（调用者所在工作树的 HEAD）、上游；`all` 包含远程分支。
`git_branch_create`	创建分支；`switch` 立即检出；`from` 指定基于哪个提交/分支。
`git_branch_switch`	切换当前工作树的分支；`create` 表示不存在时先创建。
`git_branch_delete`	删除分支；`force` = `-D`。git 会拒绝删除在任何工作树中已检出的分支——这是保护机制，直接呈现而非绕过。

Tool	Purpose
`git_session_binding`	Call first: this conversation's binding — repo, the worktree its workspace lives in, the checked-out branch, peer worktrees. `bound` is true only with a dedicated (non-primary) worktree.
`git_repo_status`	Branch, ahead/behind, dirty entries; attaches the session's `binding` when querying its own repo.
`git_worktree_list`	Every worktree with branch/HEAD, marked `primary` and `this session`.
`git_worktree_add`	Create a worktree. `name` → `/.dsh-wt/` (anchored to the main repo root, never nested inside the caller's worktree); or explicit `path`. `unique` auto-dedupes (`-2`, `-3`, …); explicit `newBranch` collisions surface git's error.
`git_worktree_remove`	Remove a worktree (branch kept). Only registered worktrees accepted; the primary worktree is refused; `force` removes uncommitted changes.
`git_branch_list`	Branches with short sha, checked-out marker (the caller worktree's HEAD), upstream; `all` includes remotes.
`git_branch_create`	Create a branch; `switch` checks it out; `from` picks the base.
`git_branch_switch`	Switch the current worktree's branch; `create` creates it first.
`git_branch_delete`	Delete a branch; `force` = `-D`. Git refuses branches checked out anywhere — that protection is surfaced, not bypassed.

dsh-git-worktree

安装

说明文档

dsh-git-worktree

绑定是什么 / What a binding is

一键创建绑定会话 / One-click bound conversation

安装 / Installation

工具 / Tools

面板 / Panel

配置 / Configuration

架构 / Architecture

测试 / Tests