@voltage12/dsh-simple-worktree 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiejinyang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# @voltage12/dsh-simple-worktree
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DSH Web 插件（非官方）：在会话输入框工具行一键创建 git worktree，并在会话「…」菜单里把它连同工作区一起收掉。
+
+![创建 worktree](https://cdn.jsdelivr.net/gh/voltage12/dsh-simple-worktree@main/docs/create-dialog.png)
+
+## 功能
+
+### 新建 Worktree
+
+- 入口在 `conversation.input.left`（模型选择、权限预设那一排），是一个无底色、28×28 的分支图标按钮。
+- 按钮始终可点；当前会话目录不是 git 仓库、或系统里找不到 git 命令时，点击只弹出一条提示，不会打开创建窗口。
+- 弹窗两个互斥选项：
+  - **新建分支**（默认）：分支名输入框 + 「基于分支」下拉框（默认当前分支）。
+  - **已有分支**：列出全部本地分支，无默认；已被其他 worktree 检出的分支置灰并标注。
+- 创建位置固定为**主仓库根目录** `<repo>/.agents/worktree/<分支名>`，分支名里的 `/` 拍平成 `-`。
+- 目录重名自动加 `-2`、`-3`… 后缀；分支重名直接报错。
+- 自动创建 `.agents/worktree/` 目录，并确保仓库根 `.gitignore` 含 `.agents/worktree/`。
+- 创建成功后注册为 Workspace，在其中新建 Session 并自动激活。
+- 如果当前会话本身就在 worktree 中（不是主仓库），弹窗底部会多出「删除当前 Worktree」；它与「…」菜单里的「删除 Worktree」走**完全相同**的确认、归档、注销、删除流程。
+- git 失败时弹窗保留、显示原始错误，可改名重试。
+
+![弹窗内删除当前 Worktree](https://cdn.jsdelivr.net/gh/voltage12/dsh-simple-worktree@main/docs/create-dialog-worktree.png)
+
+### 删除 Worktree
+
+- 入口在侧边栏会话行的「…」菜单：`sidebar.workspaces.session.menu.item`。
+- **常驻显示**：主仓库会话也会出现；不在 worktree 中时点击只弹提示，不执行删除。
+- 弹窗会列出：
+  - 该工作区下将被归档的会话数（含当前会话）；
+  - workspace 注册将被移除；
+  - worktree 目录（未提交改动会丢失）；
+  - 未提交改动数、未推送提交数；
+  - 分支会保留。
+- 确认后按顺序执行：归档会话 → 注销 Workspace → `git worktree remove --force` 并清理残留目录。
+- 有会话正在运行时拒绝删除并提示。
+- 分支**不会**被删除。
+
+> DSH 的会话只能归档、不能物理删除；这里的“删除会话”即归档。
+
+![删除确认](https://cdn.jsdelivr.net/gh/voltage12/dsh-simple-worktree@main/docs/delete-dialog.png)
+
+## 安装
+
+```sh
+dsh plugin --profile desktop add @voltage12/dsh-simple-worktree
+```
+
+插件声明了 `dsh.bundle`，`dsh plugin add` 会把它加进 profile 的 bundles 列表。**装完需要重启 DeepSeek Harness**（host 半边在启动时组合）。
+
+如果 npm 镜像尚未同步到新版本，可以临时指定官方源：
+
+```sh
+dsh plugin --profile desktop add @voltage12/dsh-simple-worktree --registry=https://registry.npmjs.org/
+```
+
+卸载：
+
+```sh
+dsh plugin --profile desktop remove @voltage12/dsh-simple-worktree
+```
+
+## 兼容性
+
+- 实测 DSH `0.2.1-rc.2`。
+- 插件通过 `engines.dsh` 声明兼容范围 `>=0.2.1-rc.2 <0.3.0`。DSH 在安装和启动前会做兼容性检查，不匹配时会禁用该插件并提示，而不是直接崩溃。
+- DSH 升级后请重新验证；如需放宽范围，会随插件新版本发布。
+- 界面文案固定中文（中英文字典内容一致），不跟随应用语言切换。
+
+## 安全说明
+
+这是一个**非官方**插件，host 半边会：
+
+- 调用 PATH 中的 `git` 命令；
+- 在仓库根目录创建 `.agents/worktree/` 并修改仓库的 `.gitignore`；
+- 在删除流程中移除 worktree 目录；
+- 注册 `/plugin/simple-worktree/*` 下的本地 HTTP 路由。
+
+只应在你信任的 DSH 安装中启用。不要把 DSH 的 Web 服务直接暴露到不可信网络；如果通过反向代理或隧道对外提供访问，请先确认 DSH 自身的访问控制。
+
+## 开发
+
+```sh
+pnpm install
+pnpm build         # lib/index.js (host) + lib/client.js (web client)
+pnpm typecheck
+pnpm pack          # 发布前构建并检查 tarball
+```
+
+- host 半：`src/host/index.js`，四条 `/plugin/simple-worktree/*` 路由（probe/create/inspect/remove），只依赖 Node 内置模块。
+- client 半：`src/client/index.tsx`，由 esbuild 打成 DSH 的 `window.__ModuleLoader__.load({ id, factory })` 结构；模块 id 直接取 `package.json` 的包名。
+- `lib/` 是构建产物；改 client 后重启进程或刷新页面，改 host 后需要重启宿主。
+
+## 已知边界
+
+- worktree 只包含已提交内容，当前未提交改动不会带过去。
+- workspace/session 注册失败时不回滚已经建好的 worktree，会报错并给出路径。
+- 目录名冲突后缀最多尝试 200 次。
+- **git 以「分支」为单位判断占用，不看 commit**：两个不同分支指向同一个 commit 时，各自都可以有 worktree；只有同一个分支已被某个 worktree 检出时才会被拒绝（git 自身也拒绝）。「新建分支」模式要求分支名尚不存在；如果要为已存在的分支建 worktree，请用「已有分支」模式。
+- 插件依赖 PATH 中的 `git`；找不到 git 时，新建和删除两个入口点击后都会提示「未找到 git 命令」，不会静默失败。
+- DSH 对还没有消息的 blank session 不渲染会话行「…」菜单，所以发第一条消息前看不到菜单里的「删除 Worktree」。但空白会话本身是真实存在的（有 session id、cwd 和持久化日志），可以先在新建弹窗底部用「删除当前 Worktree」删掉它。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# @voltage12/dsh-simple-worktree bundle patch: one insert over the profile root.
+- insert:
+    - id: dsh-simple-worktree
+      name: '@voltage12/dsh-simple-worktree'

package/lib/client.js

@@ -0,0 +1,727 @@
+window.__ModuleLoader__.load({
+	id: "@voltage12/dsh-simple-worktree",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		"use strict";
+		var __defProp = Object.defineProperty;
+		var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+		var __getOwnPropNames = Object.getOwnPropertyNames;
+		var __hasOwnProp = Object.prototype.hasOwnProperty;
+		var __export = (target, all) => {
+		  for (var name2 in all)
+		    __defProp(target, name2, { get: all[name2], enumerable: true });
+		};
+		var __copyProps = (to, from, except, desc) => {
+		  if (from && typeof from === "object" || typeof from === "function") {
+		    for (let key of __getOwnPropNames(from))
+		      if (!__hasOwnProp.call(to, key) && key !== except)
+		        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+		  }
+		  return to;
+		};
+		var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+		// src/client/index.tsx
+		var index_exports = {};
+		__export(index_exports, {
+		  apply: () => apply,
+		  inject: () => inject,
+		  name: () => name
+		});
+		module.exports = __toCommonJS(index_exports);
+		var import_react = require("react");
+		var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		var import_jsx_runtime = require("react/jsx-runtime");
+		var name = "simple-worktree";
+		var inject = ["slots", "sessions", "workspaces", "uiWorkspace", "locale"];
+		var ROUTE_PREFIX = "/plugin/simple-worktree";
+		var NS = "simpleWorktree";
+		var zh = {
+		  button: "Worktree",
+		  buttonTitle: "\u65B0\u5EFA Worktree",
+		  checking: "\u6B63\u5728\u68C0\u67E5 Git \u4ED3\u5E93\u2026",
+		  notRepo: "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93",
+		  gitMissing: "\u672A\u627E\u5230 git \u547D\u4EE4\uFF0C\u8BF7\u5148\u5B89\u88C5 Git \u5E76\u52A0\u5165 PATH",
+		  createTitle: "\u65B0\u5EFA Worktree",
+		  modeNew: "\u65B0\u5EFA\u5206\u652F",
+		  modeExisting: "\u5DF2\u6709\u5206\u652F",
+		  branchName: "\u5206\u652F\u540D",
+		  branchNamePlaceholder: "\u4F8B\u5982 feat/login",
+		  baseBranch: "\u57FA\u4E8E\u5206\u652F",
+		  chooseBranch: "\u8BF7\u9009\u62E9\u5206\u652F",
+		  occupied: "\u5DF2\u88AB worktree \u5360\u7528",
+		  target: "\u5C06\u521B\u5EFA\u5230",
+		  cancel: "\u53D6\u6D88",
+		  create: "\u521B\u5EFA",
+		  creating: "\u521B\u5EFA\u4E2D\u2026",
+		  close: "\u5173\u95ED",
+		  invalidEmpty: "\u8BF7\u8F93\u5165\u5206\u652F\u540D",
+		  invalidName: "\u5206\u652F\u540D\u4E0D\u5408\u6CD5",
+		  invalidExists: "\u672C\u5730\u5DF2\u5B58\u5728\u540C\u540D\u5206\u652F\uFF0C\u5982\u9700\u4E3A\u5B83\u521B\u5EFA worktree \u8BF7\u6539\u7528\u300C\u5DF2\u6709\u5206\u652F\u300D",
+		  invalidSame: "\u8D77\u70B9\u4E0D\u80FD\u4E0E\u5206\u652F\u540D\u76F8\u540C",
+		  loadFailed: "\u8BFB\u53D6\u4ED3\u5E93\u4FE1\u606F\u5931\u8D25",
+		  deleteMenu: "\u5220\u9664 Worktree",
+		  deleteCurrent: "\u5220\u9664\u5F53\u524D Worktree",
+		  deleteTitle: "\u5220\u9664 Worktree",
+		  deleteWarning: "\u6B64\u64CD\u4F5C\u4F1A\u5220\u9664 worktree \u76EE\u5F55\uFF0C\u672A\u63D0\u4EA4\u7684\u6539\u52A8\u5C06\u6C38\u4E45\u4E22\u5931\u3002",
+		  willArchive: "\u8BE5\u5DE5\u4F5C\u533A\u4E0B\u7684 {count} \u4E2A\u4F1A\u8BDD\u5C06\u88AB\u5F52\u6863\uFF08\u542B\u5F53\u524D\u4F1A\u8BDD\uFF09",
+		  willRemoveWorkspace: "\u5DE5\u4F5C\u533A\u6CE8\u518C\u5C06\u88AB\u79FB\u9664",
+		  willRemoveDir: "worktree \u76EE\u5F55\u5C06\u88AB\u5220\u9664\uFF1A",
+		  dirty: "{count} \u4E2A\u672A\u63D0\u4EA4\u6539\u52A8",
+		  ahead: "{count} \u4E2A\u672A\u63A8\u9001\u63D0\u4EA4",
+		  branchKept: "\u5206\u652F {branch} \u4F1A\u4FDD\u7559\uFF0C\u4E0D\u4F1A\u88AB\u5220\u9664",
+		  confirmDelete: "\u786E\u8BA4\u5220\u9664",
+		  deleting: "\u5220\u9664\u4E2D\u2026",
+		  reading: "\u8BFB\u53D6\u4E2D\u2026",
+		  detachedHead: "\u6E38\u79BB HEAD",
+		  notWorktree: "\u5F53\u524D\u4F1A\u8BDD\u4E0D\u5728 worktree \u4E2D",
+		  running: "\u8BE5\u5DE5\u4F5C\u533A\u8FD8\u6709\u4F1A\u8BDD\u6B63\u5728\u8FD0\u884C\uFF0C\u8BF7\u5148\u505C\u6B62\u540E\u518D\u5220\u9664",
+		  workspaceMissing: "\u627E\u4E0D\u5230\u8BE5\u4F1A\u8BDD\u6240\u5C5E\u7684\u5DE5\u4F5C\u533A",
+		  deleted: "\u5DF2\u5220\u9664 Worktree\uFF1A{path}",
+		  workspaceFailed: "worktree \u5DF2\u521B\u5EFA\uFF0C\u4F46\u6CE8\u518C\u5DE5\u4F5C\u533A\u5931\u8D25\uFF1A",
+		  sessionFailed: "\u5DE5\u4F5C\u533A\u5DF2\u6CE8\u518C\uFF0C\u4F46\u65B0\u5EFA\u4F1A\u8BDD\u5931\u8D25\uFF1A"
+		};
+		var en = zh;
+		async function request(method, path, body, query) {
+		  const search = query === void 0 ? "" : `?${new URLSearchParams(query).toString()}`;
+		  const response = await fetch(`${ROUTE_PREFIX}${path}${search}`, {
+		    method,
+		    cache: "no-store",
+		    headers: body === void 0 ? void 0 : { "content-type": "application/json" },
+		    body: body === void 0 ? void 0 : JSON.stringify(body)
+		  });
+		  const data = await response.json().catch(() => ({}));
+		  if (!response.ok)
+		    throw new Error(typeof data?.error === "string" ? data.error : `HTTP ${response.status}`);
+		  return data;
+		}
+		function probeRepo(path) {
+		  return request("GET", "/probe", void 0, { path });
+		}
+		function createOnDisk(input) {
+		  return request("POST", "/create", input);
+		}
+		function inspectOnDisk(path) {
+		  return request("POST", "/inspect", { path });
+		}
+		function removeOnDisk(input) {
+		  return request("POST", "/remove", input);
+		}
+		function messageOf(error) {
+		  return error instanceof Error ? error.message : String(error);
+		}
+		function errorText(error) {
+		  const raw = messageOf(error);
+		  if (/failed to fetch|networkerror|load failed|fetch failed/i.test(raw))
+		    return "\u65E0\u6CD5\u8FDE\u63A5\u63D2\u4EF6\u670D\u52A1\uFF0C\u8BF7\u91CD\u542F\u5E94\u7528\u540E\u91CD\u8BD5";
+		  if (/enoent|command not found/i.test(raw) && /git/i.test(raw))
+		    return "\u672A\u627E\u5230 git \u547D\u4EE4\uFF0C\u8BF7\u5148\u5B89\u88C5 Git \u5E76\u52A0\u5165 PATH";
+		  if (/already checked out at/i.test(raw))
+		    return "\u8BE5\u5206\u652F\u5DF2\u88AB\u5176\u4ED6 worktree \u68C0\u51FA";
+		  if (/not a git repository/i.test(raw))
+		    return "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93";
+		  if (/is a missing but already registered worktree/i.test(raw))
+		    return "\u8BE5\u76EE\u5F55\u5DF2\u88AB git \u767B\u8BB0\u4E3A worktree\uFF0C\u8BF7\u5148\u6267\u884C git worktree prune";
+		  if (/contains modified or untracked files/i.test(raw))
+		    return "worktree \u5185\u6709\u672A\u63D0\u4EA4\u7684\u6539\u52A8\uFF0C\u65E0\u6CD5\u5220\u9664";
+		  if (/is locked/i.test(raw))
+		    return "worktree \u5DF2\u88AB\u9501\u5B9A\uFF0C\u65E0\u6CD5\u5220\u9664";
+		  if (/invalid reference/i.test(raw))
+		    return "\u5206\u652F\u6216\u63D0\u4EA4\u4E0D\u5B58\u5728";
+		  return raw;
+		}
+		function branchIssue(raw, branches, base, mode) {
+		  const name2 = raw.trim();
+		  if (name2 === "")
+		    return "invalidEmpty";
+		  if (mode === "new" && name2 === base)
+		    return "invalidSame";
+		  if (name2 === "@" || name2 === "HEAD")
+		    return "invalidName";
+		  if (name2.startsWith("-") || name2.endsWith("/") || name2.endsWith(".") || name2.endsWith(".lock"))
+		    return "invalidName";
+		  if (/[\s~^:?*[\\\u0000-\u001f]/.test(name2))
+		    return "invalidName";
+		  if (name2.includes("..") || name2.includes("@{") || name2.includes("//"))
+		    return "invalidName";
+		  const parts = name2.split("/");
+		  if (parts.some((part) => part === "" || part.startsWith(".") || part.endsWith(".") || part.endsWith(".lock")))
+		    return "invalidName";
+		  if (mode === "new" && branches.some((branch) => branch.name === name2))
+		    return "invalidExists";
+		  return null;
+		}
+		function flatten(name2) {
+		  return name2.split("/").join("-");
+		}
+		var STYLE = `
+		.wt-dialog { width: min(460px, 100%) !important; }
+		.wt-dialog-body { display: flex; flex-direction: column; gap: 14px; width: 100%; min-width: 0; box-sizing: border-box; }
+		.wt-dialog-path { font-family: var(--dsh-font-mono, ui-monospace, monospace); overflow-wrap: anywhere; word-break: break-word; }
+		.wt-dialog-list { margin: 0; padding-left: 18px; display: flex; flex-direction: column; gap: 4px; overflow-wrap: anywhere; }
+		`;
+		function ensureStyle() {
+		  if (typeof document === "undefined" || document.querySelector("style[data-simple-worktree-style]") !== null)
+		    return;
+		  const style = document.createElement("style");
+		  style.setAttribute("data-simple-worktree-style", "");
+		  style.textContent = STYLE;
+		  document.head.appendChild(style);
+		}
+		var fieldStyle = {
+		  display: "flex",
+		  flexDirection: "column",
+		  gap: 6,
+		  fontSize: 13,
+		  lineHeight: "20px"
+		};
+		var pickerStyle = {
+		  display: "flex",
+		  alignItems: "center",
+		  justifyContent: "space-between",
+		  gap: 8,
+		  width: "100%",
+		  minWidth: 0,
+		  height: 34,
+		  padding: "0 10px",
+		  boxSizing: "border-box",
+		  borderRadius: 8,
+		  border: "1px solid var(--dsw-alias-line-2, rgba(128,128,128,.35))",
+		  background: "var(--dsw-alias-bg-2, rgba(128,128,128,.08))",
+		  color: "inherit",
+		  fontSize: 13,
+		  cursor: "pointer",
+		  textAlign: "left"
+		};
+		var dangerStyle = {
+		  color: "var(--dsw-alias-text-error, #e5484d)",
+		  fontSize: 12,
+		  lineHeight: "18px"
+		};
+		var mutedStyle = {
+		  opacity: 0.65,
+		  fontSize: 12,
+		  lineHeight: "18px"
+		};
+		function BranchPicker(props) {
+		  const [open, setOpen] = (0, import_react.useState)(false);
+		  const selected = props.branches.find((branch) => branch.name === props.value);
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		    import_dsh_client_ui_primitives.Menu,
+		    {
+		      open,
+		      autoFocus: true,
+		      dense: true,
+		      portal: true,
+		      align: "start",
+		      side: "bottom",
+		      onClose: () => setOpen(false),
+		      anchor: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+		        "button",
+		        {
+		          type: "button",
+		          "data-modal-autofocus": props.autoFocus === true ? "" : void 0,
+		          style: pickerStyle,
+		          onClick: () => setOpen((next) => !next),
+		          children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: selected === void 0 ? props.placeholder : selected.name }),
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { size: 12 })
+		          ]
+		        }
+		      ),
+		      items: props.branches.map((branch) => ({
+		        id: branch.name,
+		        label: props.disableOccupied && branch.worktreePath !== null ? `${branch.name}  \xB7  ${props.t("occupied")}` : branch.name,
+		        disabled: props.disableOccupied && branch.worktreePath !== null
+		      })),
+		      onSelect: (id) => {
+		        setOpen(false);
+		        props.onSelect(id);
+		      }
+		    }
+		  );
+		}
+		function CreateWorktreeDialog(props) {
+		  const { t } = props;
+		  const [mode, setMode] = (0, import_react.useState)("new");
+		  const [branch, setBranch] = (0, import_react.useState)("");
+		  const [base, setBase] = (0, import_react.useState)(props.initial.branch ?? "HEAD");
+		  const [existing, setExisting] = (0, import_react.useState)("");
+		  const [info, setInfo] = (0, import_react.useState)(props.initial);
+		  const [busy, setBusy] = (0, import_react.useState)(false);
+		  const [error, setError] = (0, import_react.useState)("");
+		  (0, import_react.useEffect)(() => {
+		    let alive = true;
+		    probeRepo(props.cwd).then((next) => {
+		      if (!alive || next.isRepo !== true)
+		        return;
+		      setInfo(next);
+		      if (next.branch !== void 0)
+		        setBase((current) => current === "HEAD" ? next.branch : current);
+		    }).catch(() => {
+		    });
+		    return () => {
+		      alive = false;
+		    };
+		  }, [props.cwd]);
+		  const branches = info.branches ?? [];
+		  const draft = mode === "new" ? branch : existing;
+		  const issue = draft.trim() === "" ? null : branchIssue(draft, branches, base, mode);
+		  const valid = draft.trim() !== "" && issue === null;
+		  const separator = info.mainRoot?.includes("\\") === true ? "\\" : "/";
+		  const target = info.mainRoot === void 0 || draft.trim() === "" ? "" : `${info.mainRoot}${separator}.agents${separator}worktree${separator}${flatten(draft.trim())}`;
+		  const submit = async () => {
+		    if (!valid || busy)
+		      return;
+		    setBusy(true);
+		    setError("");
+		    try {
+		      await props.createWorktree({
+		        path: props.cwd,
+		        mode,
+		        branch: draft.trim(),
+		        ...mode === "new" ? { base } : {}
+		      });
+		      props.onClose();
+		    } catch (failure) {
+		      setError(errorText(failure));
+		      setBusy(false);
+		    }
+		  };
+		  const close = () => {
+		    if (!busy)
+		      props.onClose();
+		  };
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		    import_dsh_client_ui_primitives.Modal,
+		    {
+		      open: true,
+		      className: "wt-dialog",
+		      title: t("createTitle"),
+		      closeLabel: t("close"),
+		      onClose: close,
+		      footer: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+		        info.isLinkedWorktree === true && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		          import_dsh_client_ui_primitives.Button,
+		          {
+		            variant: "ghost",
+		            onClick: props.onDeleteCurrent,
+		            disabled: busy,
+		            style: { color: "var(--dsw-alias-text-error, #e5484d)", marginRight: "auto" },
+		            children: t("deleteCurrent")
+		          }
+		        ),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { variant: "ghost", onClick: close, disabled: busy, children: t("cancel") }),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { variant: "primary", onClick: () => {
+		          void submit();
+		        }, disabled: !valid || busy, children: busy ? t("creating") : t("create") })
+		      ] }),
+		      children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "wt-dialog-body", children: [
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		          import_dsh_client_ui_primitives.Checkbox,
+		          {
+		            checked: mode === "new",
+		            onChange: () => setMode("new"),
+		            label: t("modeNew"),
+		            disabled: busy
+		          }
+		        ),
+		        mode === "new" && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: fieldStyle, children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: t("branchName") }),
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		              import_dsh_client_ui_primitives.Input,
+		              {
+		                value: branch,
+		                placeholder: t("branchNamePlaceholder"),
+		                spellCheck: false,
+		                autoComplete: "off",
+		                disabled: busy,
+		                "data-modal-autofocus": "",
+		                onChange: (event) => setBranch(event.target.value),
+		                onKeyDown: (event) => {
+		                  if (event.key === "Enter")
+		                    void submit();
+		                }
+		              }
+		            )
+		          ] }),
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: fieldStyle, children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: t("baseBranch") }),
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		              BranchPicker,
+		              {
+		                value: base,
+		                placeholder: t("chooseBranch"),
+		                branches,
+		                disableOccupied: false,
+		                t,
+		                onSelect: setBase
+		              }
+		            )
+		          ] })
+		        ] }),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		          import_dsh_client_ui_primitives.Checkbox,
+		          {
+		            checked: mode === "existing",
+		            onChange: () => setMode("existing"),
+		            label: t("modeExisting"),
+		            disabled: busy
+		          }
+		        ),
+		        mode === "existing" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: fieldStyle, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		          BranchPicker,
+		          {
+		            value: existing,
+		            placeholder: t("chooseBranch"),
+		            branches,
+		            disableOccupied: true,
+		            autoFocus: true,
+		            t,
+		            onSelect: setExisting
+		          }
+		        ) }),
+		        target !== "" && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: mutedStyle, children: [
+		          t("target"),
+		          ":",
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "wt-dialog-path", style: { marginTop: 2 }, children: target })
+		        ] }),
+		        issue !== null && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: dangerStyle, children: t(issue) }),
+		        error !== "" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: dangerStyle, children: error })
+		      ] })
+		    }
+		  );
+		}
+		function WorktreeButton({ sessionId, useSessions, useWorkspaces, t, createWorktree }) {
+		  const summary = useSessions((state) => state.byId[sessionId]);
+		  const cwd = summary?.cwd;
+		  const workspaceId = useWorkspaces((state) => state.items.find((item) => item.sessionIds.includes(sessionId))?.workspaceId);
+		  const [repo, setRepo] = (0, import_react.useState)(null);
+		  const [open, setOpen] = (0, import_react.useState)(false);
+		  const [error, setError] = (0, import_react.useState)(null);
+		  const busy = (0, import_react.useRef)(false);
+		  (0, import_react.useEffect)(() => {
+		    setOpen(false);
+		  }, [cwd]);
+		  const openDialog = async () => {
+		    if (cwd === void 0 || busy.current)
+		      return;
+		    busy.current = true;
+		    try {
+		      const info = await probeRepo(cwd);
+		      if (info.gitMissing === true) {
+		        setError({ seq: Date.now(), text: t("gitMissing") });
+		        return;
+		      }
+		      if (info.isRepo !== true) {
+		        setError({ seq: Date.now(), text: t("notRepo") });
+		        return;
+		      }
+		      setRepo(info);
+		      setOpen(true);
+		    } catch (failure) {
+		      setError({ seq: Date.now(), text: errorText(failure) });
+		    } finally {
+		      busy.current = false;
+		    }
+		  };
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		      import_dsh_client_ui_primitives.Button,
+		      {
+		        variant: "ghost",
+		        size: "sm",
+		        title: t("buttonTitle"),
+		        "aria-label": t("buttonTitle"),
+		        icon: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconBranchOutlineRegular, { size: 16 }),
+		        style: { width: 28, minWidth: 28, padding: 0, flex: "none" },
+		        onClick: () => {
+		          void openDialog();
+		        }
+		      }
+		    ),
+		    open && repo !== null && cwd !== void 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		      CreateWorktreeDialog,
+		      {
+		        cwd,
+		        initial: repo,
+		        t,
+		        createWorktree,
+		        onClose: () => setOpen(false),
+		        onDeleteCurrent: () => {
+		          setOpen(false);
+		          openDeleteRequest(sessionId, summary?.displayTitle ?? "", workspaceId);
+		        }
+		      }
+		    ),
+		    error !== null && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Toast, { text: error.text, holdMs: 4e3, onDone: () => setError(null) }, error.seq)
+		  ] });
+		}
+		var deleteRequest = null;
+		var deleteSeq = 0;
+		var deleteListeners = /* @__PURE__ */ new Set();
+		function notifyDelete() {
+		  for (const listener of deleteListeners)
+		    listener();
+		}
+		function subscribeDelete(listener) {
+		  deleteListeners.add(listener);
+		  return () => {
+		    deleteListeners.delete(listener);
+		  };
+		}
+		function getDeleteRequest() {
+		  return deleteRequest;
+		}
+		function openDeleteRequest(sessionId, displayTitle, workspaceId) {
+		  deleteSeq += 1;
+		  deleteRequest = { sessionId, displayTitle, workspaceId, seq: deleteSeq };
+		  notifyDelete();
+		}
+		function closeDeleteRequest() {
+		  deleteRequest = null;
+		  notifyDelete();
+		}
+		function DeleteWorktreeMenuItem({ sessionId, displayTitle, useMenuOpenState, useWorkspaces, t, requestDelete }) {
+		  const workspaceId = useWorkspaces((state) => state.items.find((item) => item.sessionIds.includes(sessionId))?.workspaceId);
+		  const [, setMenuOpen] = useMenuOpenState();
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		    import_dsh_client_ui_primitives.MenuItemButton,
+		    {
+		      danger: true,
+		      separatorBefore: true,
+		      icon: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconTrashOutlineRegular, { size: 14 }),
+		      onSelect: () => {
+		        setMenuOpen(false);
+		        requestDelete(sessionId, displayTitle, workspaceId);
+		      },
+		      children: t("deleteMenu")
+		    }
+		  );
+		}
+		function DeleteWorktreeOverlay({ useSessions, useWorkspaces, t, deleteWorktree }) {
+		  const pending = (0, import_react.useSyncExternalStore)(subscribeDelete, getDeleteRequest);
+		  const session = useSessions((state) => pending === null ? void 0 : state.byId[pending.sessionId]);
+		  const workspace = useWorkspaces((state) => pending === null ? void 0 : state.items.find((item) => item.sessionIds.includes(pending.sessionId)));
+		  const [toast, setToast] = (0, import_react.useState)(null);
+		  const skip = (text) => {
+		    closeDeleteRequest();
+		    setToast({ seq: Date.now(), text });
+		  };
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+		    pending !== null && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		      DeleteWorktreeGate,
+		      {
+		        pending,
+		        cwd: session?.cwd,
+		        workspaceId: pending.workspaceId ?? workspace?.workspaceId,
+		        sessionIds: workspace?.sessionIds ?? [],
+		        t,
+		        deleteWorktree,
+		        onClose: closeDeleteRequest,
+		        onSkip: skip,
+		        onDone: (text) => {
+		          closeDeleteRequest();
+		          setToast({ seq: Date.now(), text, tone: "success" });
+		        }
+		      },
+		      pending.seq
+		    ),
+		    toast !== null && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Toast, { text: toast.text, tone: toast.tone, holdMs: 4e3, onDone: () => setToast(null) }, toast.seq)
+		  ] });
+		}
+		function DeleteWorktreeGate(props) {
+		  const [ready, setReady] = (0, import_react.useState)(false);
+		  (0, import_react.useEffect)(() => {
+		    let alive = true;
+		    if (props.cwd === void 0) {
+		      props.onSkip(props.t("notWorktree"));
+		      return () => {
+		        alive = false;
+		      };
+		    }
+		    probeRepo(props.cwd).then((info) => {
+		      if (!alive)
+		        return;
+		      if (info.gitMissing === true) {
+		        props.onSkip(props.t("gitMissing"));
+		        return;
+		      }
+		      if (info.isRepo !== true || info.isLinkedWorktree !== true) {
+		        props.onSkip(props.t("notWorktree"));
+		        return;
+		      }
+		      setReady(true);
+		    }).catch((failure) => {
+		      if (alive)
+		        props.onSkip(errorText(failure));
+		    });
+		    return () => {
+		      alive = false;
+		    };
+		  }, [props.cwd]);
+		  if (!ready)
+		    return null;
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		    DeleteWorktreeDialog,
+		    {
+		      pending: props.pending,
+		      cwd: props.cwd,
+		      workspaceId: props.workspaceId,
+		      sessionIds: props.sessionIds,
+		      t: props.t,
+		      deleteWorktree: props.deleteWorktree,
+		      onClose: props.onClose,
+		      onDone: props.onDone
+		    }
+		  );
+		}
+		function DeleteWorktreeDialog(props) {
+		  const { t } = props;
+		  const [facts, setFacts] = (0, import_react.useState)(null);
+		  const [busy, setBusy] = (0, import_react.useState)(false);
+		  const [error, setError] = (0, import_react.useState)("");
+		  (0, import_react.useEffect)(() => {
+		    let alive = true;
+		    if (props.cwd === void 0)
+		      return () => {
+		        alive = false;
+		      };
+		    inspectOnDisk(props.cwd).then((next) => {
+		      if (alive) setFacts(next);
+		    }).catch((failure) => {
+		      if (alive) setError(errorText(failure));
+		    });
+		    return () => {
+		      alive = false;
+		    };
+		  }, [props.cwd]);
+		  const confirm = async () => {
+		    if (facts === null || props.workspaceId === void 0 || busy)
+		      return;
+		    setBusy(true);
+		    setError("");
+		    try {
+		      await props.deleteWorktree({
+		        sessionId: props.pending.sessionId,
+		        workspaceId: props.workspaceId,
+		        path: facts.path
+		      });
+		      props.onDone(t("deleted", { path: facts.path }));
+		    } catch (failure) {
+		      const message = messageOf(failure);
+		      setError(message === "running" || message.includes("session-active") ? t("running") : message === "workspace-missing" ? t("workspaceMissing") : errorText(failure));
+		      setBusy(false);
+		    }
+		  };
+		  const close = () => {
+		    if (!busy)
+		      props.onClose();
+		  };
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		    import_dsh_client_ui_primitives.Modal,
+		    {
+		      open: true,
+		      className: "wt-dialog",
+		      title: t("deleteTitle"),
+		      closeLabel: t("close"),
+		      onClose: close,
+		      footer: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { variant: "ghost", onClick: close, disabled: busy, children: t("cancel") }),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		          import_dsh_client_ui_primitives.Button,
+		          {
+		            variant: "primary",
+		            onClick: () => {
+		              void confirm();
+		            },
+		            disabled: facts === null || props.workspaceId === void 0 || busy,
+		            children: busy ? t("deleting") : t("confirmDelete")
+		          }
+		        )
+		      ] }),
+		      children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "wt-dialog-body", style: { fontSize: 13, lineHeight: "20px" }, children: [
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 6, fontWeight: 500, minWidth: 0 }, children: [
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconBranchOutlineRegular, { size: 14 }),
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: { minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: facts === null ? t("reading") : facts.branch !== "" ? facts.branch : t("detachedHead") })
+		        ] }),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: { ...dangerStyle, fontSize: 13 }, children: t("deleteWarning") }),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("ul", { className: "wt-dialog-list", children: [
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: t("willArchive", { count: props.sessionIds.length }) }),
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: t("willRemoveWorkspace") }),
+		          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("li", { children: [
+		            t("willRemoveDir"),
+		            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "wt-dialog-path", style: { marginTop: 2 }, children: facts?.path ?? props.cwd ?? "" })
+		          ] }),
+		          facts !== null && facts.dirty > 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { style: dangerStyle, children: t("dirty", { count: facts.dirty }) }),
+		          facts !== null && facts.ahead !== null && facts.ahead > 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: t("ahead", { count: facts.ahead }) }),
+		          facts !== null && facts.branch !== "" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: t("branchKept", { branch: facts.branch }) })
+		        ] }),
+		        error !== "" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: dangerStyle, children: error })
+		      ] })
+		    }
+		  );
+		}
+		function fail(prefix, failure, path) {
+		  return new Error(`${prefix}${errorText(failure)}\uFF08\u8DEF\u5F84\uFF1A${path}\uFF09`);
+		}
+		function apply(ctx) {
+		  ensureStyle();
+		  ctx.effect(() => ctx.locale.register(NS, { zh, en }), "simple-worktree: dictionaries");
+		  const createWorktree = async (input) => {
+		    const created = await createOnDisk(input);
+		    let workspace;
+		    try {
+		      workspace = await ctx.workspaces.create({ path: created.path });
+		    } catch (failure) {
+		      throw fail("worktree \u5DF2\u521B\u5EFA\uFF0C\u4F46\u6CE8\u518C\u5DE5\u4F5C\u533A\u5931\u8D25\uFF1A", failure, created.path);
+		    }
+		    try {
+		      ctx.uiWorkspace.startSession(workspace.workspaceId);
+		    } catch (failure) {
+		      throw fail("\u5DE5\u4F5C\u533A\u5DF2\u6CE8\u518C\uFF0C\u4F46\u65B0\u5EFA\u4F1A\u8BDD\u5931\u8D25\uFF1A", failure, created.path);
+		    }
+		    return created;
+		  };
+		  const deleteWorktree = async (input) => {
+		    const workspaceId = input.workspaceId;
+		    const workspace = ctx.workspaces.list.getSnapshot().items.find((item) => item.workspaceId === workspaceId);
+		    if (workspace !== void 0) {
+		      const sessions = ctx.sessions.list.getSnapshot().byId;
+		      const running = workspace.sessionIds.filter((id) => sessions[id]?.running === true);
+		      if (running.length > 0)
+		        throw new Error("running");
+		      for (const id of workspace.sessionIds)
+		        await ctx.uiWorkspace.archiveSession(id);
+		      await ctx.workspaces.delete(workspaceId);
+		    }
+		    await removeOnDisk({ path: input.path, force: true });
+		  };
+		  ctx.slots.inject("conversation.input.left", () => ctx.slots.register({
+		    name: "conversation.input.left",
+		    id: "simple-worktree.create",
+		    order: 6,
+		    locale: NS,
+		    inject: () => ({ createWorktree })
+		  }, WorktreeButton));
+		  ctx.slots.inject("sidebar.workspaces.session.menu.item", () => ctx.slots.register({
+		    name: "sidebar.workspaces.session.menu.item",
+		    id: "simple-worktree.delete",
+		    order: 500,
+		    locale: NS,
+		    inject: () => ({ requestDelete: openDeleteRequest })
+		  }, DeleteWorktreeMenuItem));
+		  ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+		    name: "shell.overlay",
+		    id: "simple-worktree.delete-dialog",
+		    order: 0,
+		    locale: NS,
+		    inject: () => ({ deleteWorktree })
+		  }, DeleteWorktreeOverlay));
+		}
+
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,389 @@
+// src/host/index.js
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, normalize, resolve } from "node:path";
+var name = "simple-worktree";
+var inject = [];
+var ROUTE_PREFIX = "/plugin/simple-worktree";
+var BODY_LIMIT = 64 * 1024;
+var MAX_SLOT_ATTEMPTS = 200;
+function runGit(cwd, args) {
+  return new Promise((resolvePromise) => {
+    let child;
+    try {
+      child = spawn("git", args, { cwd, windowsHide: true, stdio: ["ignore", "pipe", "pipe"] });
+    } catch (error) {
+      resolvePromise({
+        ok: false,
+        code: -1,
+        missing: error?.code === "ENOENT",
+        stdout: "",
+        stderr: String(error?.message ?? error)
+      });
+      return;
+    }
+    let stdout = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk;
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk;
+    });
+    child.on("error", (error) => {
+      resolvePromise({
+        ok: false,
+        code: -1,
+        missing: error?.code === "ENOENT",
+        stdout,
+        stderr: String(error?.message ?? error)
+      });
+    });
+    child.on("close", (code) => {
+      resolvePromise({ ok: code === 0, code: code ?? -1, stdout, stderr });
+    });
+  });
+}
+function samePath(left, right) {
+  const a = resolve(left);
+  const b = resolve(right);
+  return process.platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
+}
+function firstLine(text) {
+  return String(text ?? "").split(/\r?\n/).map((line) => line.trim()).find((line) => line.length > 0) ?? "";
+}
+function gitMessage(result, fallback) {
+  const line = firstLine(result.stderr);
+  return line.length > 0 ? line.replace(/^(fatal|error):\s*/i, "") : fallback;
+}
+function friendlyGitMessage(result, fallback) {
+  const raw = String(result?.stderr ?? "");
+  if (/already checked out at/i.test(raw))
+    return "\u8BE5\u5206\u652F\u5DF2\u88AB\u5176\u4ED6 worktree \u68C0\u51FA";
+  if (/is a missing but already registered worktree/i.test(raw))
+    return "\u8BE5\u76EE\u5F55\u5DF2\u88AB git \u767B\u8BB0\u4E3A worktree\uFF0C\u8BF7\u5148\u6267\u884C git worktree prune";
+  if (/contains modified or untracked files/i.test(raw))
+    return "worktree \u5185\u6709\u672A\u63D0\u4EA4\u7684\u6539\u52A8\uFF0C\u65E0\u6CD5\u5220\u9664";
+  if (/is locked/i.test(raw))
+    return "worktree \u5DF2\u88AB\u9501\u5B9A\uFF0C\u65E0\u6CD5\u5220\u9664";
+  if (/invalid reference/i.test(raw))
+    return "\u5206\u652F\u6216\u63D0\u4EA4\u4E0D\u5B58\u5728";
+  if (/not a git repository/i.test(raw))
+    return "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93";
+  if (/permission denied/i.test(raw))
+    return "\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u8BE5\u76EE\u5F55";
+  const line = firstLine(raw);
+  return line.length > 0 ? `${fallback}\uFF1A${line}` : fallback;
+}
+async function requireDirectory(value) {
+  if (typeof value !== "string" || value.trim() === "")
+    throw new Error("\u7F3A\u5C11\u76EE\u5F55\u53C2\u6570");
+  if (!isAbsolute(value))
+    throw new Error(`\u76EE\u5F55\u5FC5\u987B\u662F\u7EDD\u5BF9\u8DEF\u5F84\uFF1A${value}`);
+  let info;
+  try {
+    info = await stat(value);
+  } catch {
+    throw new Error(`\u76EE\u5F55\u4E0D\u5B58\u5728\uFF1A${value}`);
+  }
+  if (!info.isDirectory())
+    throw new Error(`\u4E0D\u662F\u76EE\u5F55\uFF1A${value}`);
+  return resolve(value);
+}
+async function checkedOutBranches(top) {
+  const result = await runGit(top, ["worktree", "list", "--porcelain"]);
+  const map = /* @__PURE__ */ new Map();
+  if (!result.ok)
+    return map;
+  let current = "";
+  for (const raw of result.stdout.split(/\r?\n/)) {
+    if (raw.startsWith("worktree ")) {
+      current = raw.slice("worktree ".length);
+    } else if (raw.startsWith("branch refs/heads/")) {
+      map.set(raw.slice("branch refs/heads/".length), current);
+    }
+  }
+  return map;
+}
+async function localBranches(top) {
+  const result = await runGit(top, ["for-each-ref", "--format=%(refname:short)", "refs/heads"]);
+  if (!result.ok)
+    return [];
+  return result.stdout.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+}
+async function probe(directory) {
+  const dir = await requireDirectory(directory);
+  const inside = await runGit(dir, ["rev-parse", "--is-inside-work-tree"]);
+  if (!inside.ok) {
+    if (inside.missing === true)
+      return { isRepo: false, gitMissing: true, error: "\u672A\u627E\u5230 git \u547D\u4EE4\uFF0C\u8BF7\u5148\u5B89\u88C5 Git \u5E76\u52A0\u5165 PATH" };
+    return {
+      isRepo: false,
+      error: /not a git repository/i.test(String(inside.stderr)) ? "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93" : gitMessage(inside, "\u65E0\u6CD5\u8BFB\u53D6 Git \u4ED3\u5E93\u4FE1\u606F")
+    };
+  }
+  const topResult = await runGit(dir, ["rev-parse", "--show-toplevel"]);
+  if (!topResult.ok)
+    return { isRepo: false, error: gitMessage(topResult, "\u65E0\u6CD5\u89E3\u6790\u4ED3\u5E93\u6839\u76EE\u5F55") };
+  const top = normalize(topResult.stdout.trim());
+  const gitDirResult = await runGit(dir, ["rev-parse", "--path-format=absolute", "--git-dir"]);
+  const commonDirResult = await runGit(dir, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
+  let gitDir = gitDirResult.ok ? gitDirResult.stdout.trim() : "";
+  let commonDir = commonDirResult.ok ? commonDirResult.stdout.trim() : "";
+  if (gitDir === "" || commonDir === "") {
+    const legacyGit = await runGit(dir, ["rev-parse", "--git-dir"]);
+    const legacyCommon = await runGit(dir, ["rev-parse", "--git-common-dir"]);
+    gitDir = legacyGit.ok ? legacyGit.stdout.trim() : gitDir;
+    commonDir = legacyCommon.ok ? legacyCommon.stdout.trim() : commonDir;
+  }
+  if (gitDir !== "" && !isAbsolute(gitDir))
+    gitDir = resolve(top, gitDir);
+  if (commonDir !== "" && !isAbsolute(commonDir))
+    commonDir = resolve(top, commonDir);
+  const isLinkedWorktree = gitDir !== "" && commonDir !== "" && !samePath(gitDir, commonDir);
+  const mainRoot = normalize(isLinkedWorktree ? dirname(commonDir) : top);
+  const branchResult = await runGit(dir, ["symbolic-ref", "--quiet", "--short", "HEAD"]);
+  const branch = branchResult.ok ? branchResult.stdout.trim() : void 0;
+  const head = await runGit(dir, ["rev-parse", "--verify", "--quiet", "HEAD"]);
+  const outs = await checkedOutBranches(top);
+  const names = await localBranches(top);
+  const branches = names.map((branchName) => ({
+    name: branchName,
+    worktreePath: outs.get(branchName) ?? null
+  }));
+  return {
+    isRepo: true,
+    top,
+    mainRoot,
+    gitDir,
+    commonDir,
+    isLinkedWorktree,
+    branch,
+    hasCommits: head.ok,
+    branches
+  };
+}
+function flattenBranch(branch) {
+  return branch.split("/").join("-");
+}
+function pickSlot(agentsDir, slug) {
+  for (let index = 1; index <= MAX_SLOT_ATTEMPTS; index += 1) {
+    const candidate = join(agentsDir, index === 1 ? slug : `${slug}-${index}`);
+    if (!existsSync(candidate))
+      return candidate;
+  }
+  throw new Error(`\u65E0\u6CD5\u4E3A ${slug} \u627E\u5230\u7A7A\u95F2\u76EE\u5F55\u540D`);
+}
+async function ensureGitignore(repoRoot) {
+  const file = join(repoRoot, ".gitignore");
+  let text = "";
+  try {
+    text = await readFile(file, "utf8");
+  } catch (error) {
+    if (error?.code !== "ENOENT")
+      throw error;
+  }
+  const covered = text.split(/\r?\n/).some((raw) => {
+    const line = raw.trim();
+    return line === ".agents/worktree" || line === ".agents/worktree/" || line === "/.agents/worktree" || line === "/.agents/worktree/" || line === ".agents" || line === ".agents/" || line === "/.agents" || line === "/.agents/";
+  });
+  if (covered)
+    return false;
+  const separator = text === "" || text.endsWith("\n") ? "" : "\n";
+  await writeFile(file, `${text}${separator}.agents/worktree/
+`, "utf8");
+  return true;
+}
+async function assertBranchName(repoRoot, branch) {
+  const result = await runGit(repoRoot, ["check-ref-format", "--branch", branch]);
+  if (!result.ok)
+    throw new Error(`\u5206\u652F\u540D\u4E0D\u5408\u6CD5\uFF1A${branch}`);
+}
+async function createWorktree(body) {
+  const target = await probe(body?.path);
+  if (target.gitMissing === true)
+    throw new Error("\u672A\u627E\u5230 git \u547D\u4EE4\uFF0C\u8BF7\u5148\u5B89\u88C5 Git \u5E76\u52A0\u5165 PATH");
+  if (!target.isRepo)
+    throw new Error(target.error ?? "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93");
+  if (!target.hasCommits)
+    throw new Error("\u4ED3\u5E93\u8FD8\u6CA1\u6709\u4EFB\u4F55\u63D0\u4EA4\uFF0C\u65E0\u6CD5\u521B\u5EFA worktree");
+  const mode = body?.mode === "existing" ? "existing" : "new";
+  const branch = String(body?.branch ?? "").trim();
+  if (branch === "")
+    throw new Error("\u8BF7\u8F93\u5165\u5206\u652F\u540D");
+  await assertBranchName(target.mainRoot, branch);
+  const existing = target.branches.find((item) => item.name === branch);
+  if (mode === "new") {
+    if (existing !== void 0)
+      throw new Error(`\u672C\u5730\u5DF2\u5B58\u5728\u5206\u652F ${branch}`);
+  } else {
+    if (existing === void 0)
+      throw new Error(`\u672C\u5730\u4E0D\u5B58\u5728\u5206\u652F ${branch}`);
+    if (existing.worktreePath !== null && existing.worktreePath !== "")
+      throw new Error(`\u5206\u652F ${branch} \u5DF2\u88AB worktree \u5360\u7528\uFF1A${existing.worktreePath}`);
+  }
+  let base = "HEAD";
+  if (mode === "new") {
+    const requested = String(body?.base ?? "").trim();
+    base = requested === "" ? target.branch ?? "HEAD" : requested;
+    if (base !== "HEAD" && !target.branches.some((item) => item.name === base))
+      throw new Error(`\u8D77\u70B9\u5206\u652F\u4E0D\u5B58\u5728\uFF1A${base}`);
+  }
+  const agentsDir = join(target.mainRoot, ".agents", "worktree");
+  await mkdir(agentsDir, { recursive: true });
+  await ensureGitignore(target.mainRoot);
+  const directory = pickSlot(agentsDir, flattenBranch(branch));
+  await runGit(target.mainRoot, ["worktree", "prune"]);
+  const args = mode === "new" ? ["worktree", "add", "-b", branch, directory, base] : ["worktree", "add", directory, branch];
+  const result = await runGit(target.mainRoot, args);
+  if (!result.ok) {
+    if (mode === "new") {
+      await runGit(target.mainRoot, ["branch", "-D", branch]);
+    }
+    await runGit(target.mainRoot, ["worktree", "prune"]);
+    throw new Error(friendlyGitMessage(result, "\u521B\u5EFA worktree \u5931\u8D25"));
+  }
+  return {
+    path: directory,
+    branch,
+    repoRoot: target.mainRoot,
+    created: true
+  };
+}
+async function inspectWorktree(body) {
+  const target = await probe(body?.path);
+  if (target.gitMissing === true)
+    throw new Error("\u672A\u627E\u5230 git \u547D\u4EE4\uFF0C\u8BF7\u5148\u5B89\u88C5 Git \u5E76\u52A0\u5165 PATH");
+  if (!target.isRepo)
+    throw new Error(target.error ?? "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93");
+  if (!target.isLinkedWorktree)
+    throw new Error("\u5F53\u524D\u4F1A\u8BDD\u4E0D\u5728 worktree \u4E2D");
+  const status = await runGit(target.top, ["status", "--porcelain"]);
+  const dirty = status.ok ? status.stdout.split(/\r?\n/).filter((line) => line.trim() !== "").length : 0;
+  const upstream = await runGit(target.top, ["rev-list", "--count", "@{upstream}..HEAD"]);
+  const ahead = upstream.ok ? Number.parseInt(upstream.stdout.trim(), 10) || 0 : null;
+  return {
+    path: target.top,
+    branch: target.branch ?? "",
+    dirty,
+    ahead,
+    repoRoot: target.mainRoot
+  };
+}
+async function removeWorktree(body) {
+  const target = await probe(body?.path);
+  if (target.gitMissing === true)
+    throw new Error("\u672A\u627E\u5230 git \u547D\u4EE4\uFF0C\u8BF7\u5148\u5B89\u88C5 Git \u5E76\u52A0\u5165 PATH");
+  if (!target.isRepo)
+    throw new Error(target.error ?? "\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93");
+  if (!target.isLinkedWorktree)
+    throw new Error("\u5F53\u524D\u4F1A\u8BDD\u4E0D\u5728 worktree \u4E2D");
+  if (samePath(target.top, target.mainRoot))
+    throw new Error("\u4E0D\u80FD\u5220\u9664\u4E3B\u4ED3\u5E93\u7684\u5DE5\u4F5C\u76EE\u5F55");
+  const force = body?.force === true;
+  const result = await runGit(target.mainRoot, [
+    "worktree",
+    "remove",
+    ...force ? ["--force"] : [],
+    target.top
+  ]);
+  if (!result.ok) {
+    await runGit(target.mainRoot, ["worktree", "unlock", target.top]);
+    await runGit(target.mainRoot, ["worktree", "prune"]);
+    if (existsSync(target.top))
+      await rm(target.top, { recursive: true, force: true });
+    await runGit(target.mainRoot, ["worktree", "prune"]);
+    if (existsSync(target.top))
+      throw new Error(friendlyGitMessage(result, "\u5220\u9664 worktree \u5931\u8D25"));
+  }
+  if (existsSync(target.top))
+    await rm(target.top, { recursive: true, force: true });
+  await runGit(target.mainRoot, ["worktree", "prune"]);
+  return {
+    removed: true,
+    path: target.top,
+    branch: target.branch ?? ""
+  };
+}
+function readJson(req) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const chunks = [];
+    let size = 0;
+    req.on("data", (chunk) => {
+      size += chunk.length;
+      if (size > BODY_LIMIT) {
+        req.destroy();
+        rejectPromise(new Error("\u8BF7\u6C42\u4F53\u8FC7\u5927"));
+        return;
+      }
+      chunks.push(chunk);
+    });
+    req.on("end", () => {
+      if (chunks.length === 0) {
+        resolvePromise({});
+        return;
+      }
+      try {
+        resolvePromise(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+      } catch (error) {
+        rejectPromise(new Error(`\u8BF7\u6C42\u4F53\u4E0D\u662F\u5408\u6CD5 JSON\uFF1A${error?.message ?? error}`));
+      }
+    });
+    req.on("error", rejectPromise);
+  });
+}
+function send(res, status, body) {
+  res.writeHead(status, {
+    "content-type": "application/json; charset=utf-8",
+    "cache-control": "no-store"
+  });
+  res.end(JSON.stringify(body));
+}
+function apply(ctx) {
+  ctx.inject(["webServer"], (webCtx) => {
+    const get = (path, handler) => {
+      webCtx.effect(() => webCtx.webServer.register({
+        kind: "exact",
+        path,
+        handler: async (req, res) => {
+          try {
+            const query = new URL(req.url ?? "/", "http://x").searchParams;
+            send(res, 200, await handler(query));
+          } catch (error) {
+            send(res, 400, { error: error instanceof Error ? error.message : String(error) });
+          }
+        }
+      }), `simple-worktree: ${path} route`);
+    };
+    const post = (path, handler) => {
+      webCtx.effect(() => webCtx.webServer.register({
+        kind: "exact",
+        path,
+        handler: async (req, res) => {
+          try {
+            send(res, 200, await handler(await readJson(req)));
+          } catch (error) {
+            send(res, 400, { error: error instanceof Error ? error.message : String(error) });
+          }
+        }
+      }), `simple-worktree: ${path} route`);
+    };
+    get(`${ROUTE_PREFIX}/probe`, (query) => probe(query.get("path") ?? ""));
+    post(`${ROUTE_PREFIX}/create`, (body) => createWorktree(body));
+    post(`${ROUTE_PREFIX}/inspect`, (body) => inspectWorktree(body));
+    post(`${ROUTE_PREFIX}/remove`, (body) => removeWorktree(body));
+  });
+}
+export {
+  ROUTE_PREFIX,
+  apply,
+  createWorktree,
+  inject,
+  inspectWorktree,
+  name,
+  probe,
+  removeWorktree
+};

package/package.json

@@ -1,6 +1,85 @@
 {
   "name": "@voltage12/dsh-simple-worktree",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "DSH Web plugin: create and remove git worktrees from the conversation UI",
+  "license": "MIT",
+  "author": "xiejinyang (https://github.com/voltage12)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voltage12/dsh-simple-worktree.git"
+  },
+  "homepage": "https://github.com/voltage12/dsh-simple-worktree#readme",
+  "bugs": {
+    "url": "https://github.com/voltage12/dsh-simple-worktree/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "worktree",
+    "git",
+    "deepseek-harness"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "docs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-workspace",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-session"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "node build.mjs && tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-api-remote-access": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
+    "esbuild": "0.25.10",
+    "playwright-core": "1.55.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "5.9.3"
+  }
+}