@jspg-ai/coding-bb 0.0.3-beta.36 → 0.0.3-beta.37

package/cbb/worktrees/_shared/scripts/junction-ai-config.js

@@ -2,7 +2,7 @@
 /**
  * worktree 模式 AI 配置 junction（ADR 0002，防线 B）。
  *
- * 用法：node junction-ai-config.js <ws_root> <wt_path>
+ * 用法：node junction-ai-config.js <ws_root> <wt_path> [--remove]
  *
  * 目的：让开发会话能开进 worktree（工作树内加载 AI 配置），同时保持
  * 「单层安装」实质——配置唯一物理副本在空间根，cbb update 一处生效。
@@ -18,6 +18,13 @@
  * 幂等：linkPath 已指向同一 target → skip；指向不同 → 重建；
  *       存在同名**物理目录**（非链接）→ warn 跳过（不覆盖用户内容）。
  *
+ * --remove（cbb-worktree-close 调用）：
+ *   - 拆除 worktree 内已建 junction 与复制件，**源文件零接触**：
+ *     只解除链接本身（fs.rmSync 对 reparse point 仅删链接、不穿透目标，
+ *     已由 Windows 实测验证），复制件为普通文件直接删除；
+ *   - 拆除前校验链接目标位于空间根内——目标在空间根外 / readlink 失败
+ *     → 跳过并警告（防误删外部目录）；同名物理目录/文件 → 跳过不碰。
+ *
  * 退出码：0 成功（含全部 skip）；1 参数错误；2 执行失败。
  */
 
@@ -26,9 +33,10 @@ const path = require('path');
 
 const wsRoot = process.argv[2];
 const wtPath = process.argv[3];
+const removeMode = process.argv[4] === '--remove';
 
 if (!wsRoot || !wtPath) {
-  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path>');
+  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path> [--remove]');
   process.exit(1);
 }
 
@@ -49,6 +57,63 @@ function normLinkTarget(p) {
   return path.resolve(String(p).replace(/^\\\\\?\\/, ''));
 }
 
+/** 目标是否位于空间根内（防误删空间根外目录的守卫） */
+function isWithin(p, root) {
+  const r = path.resolve(root) + path.sep;
+  return path.resolve(p).startsWith(r);
+}
+
+// ── remove 模式：显式拆除 junction 与复制件（源文件零接触）──
+if (removeMode) {
+  const removed = [];
+  const guarded = [];
+
+  for (const root of CONFIG_ROOTS) {
+    for (const sub of CONTENT_SUBDIRS) {
+      const linkPath = path.join(wtPath, root, sub);
+      const label = root + '/' + sub;
+      let st;
+      try { st = fs.lstatSync(linkPath); } catch (e) { continue; } // 不存在 → 跳过（dangling 链接 lstat 仍成功，可拆）
+      if (!st.isSymbolicLink()) continue; // 物理目录/文件（工具状态空壳或用户内容）→ 不碰
+
+      const target = normLinkTarget(fs.readlinkSync(linkPath));
+      if (!isWithin(target, wsRoot)) {
+        guarded.push(label + ' → ' + target + '（目标不在空间根内，跳过）');
+        continue;
+      }
+
+      try {
+        // 只解除链接：Node 对 reparse point 仅删除链接本身，不递归、不触达目标内容
+        fs.rmSync(linkPath, { recursive: true, force: true });
+        removed.push(label);
+      } catch (e) {
+        console.error('❌ 拆除失败 ' + label + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+
+    for (const file of (CONTENT_FILES[root] || [])) {
+      const linkPath = path.join(wtPath, root, file);
+      if (!fs.existsSync(linkPath)) continue;
+      try {
+        fs.unlinkSync(linkPath); // 复制件为普通文件，删除不影响源
+        removed.push(root + '/' + file);
+      } catch (e) {
+        console.error('❌ 删除失败 ' + root + '/' + file + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+  }
+
+  if (removed.length) console.log('✅ 已拆除 junction/复制件：' + removed.join(', '));
+  if (guarded.length) console.log('⚠️  ' + guarded.join('；'));
+  if (removed.length === 0 && guarded.length === 0) console.log('ℹ️  无待拆除项（幂等）');
+
+  console.log('---');
+  console.log('JUNCTION_REMOVE_RESULT', JSON.stringify({ removed, guarded, wt: wtPath }));
+  process.exit(hasFailure ? 2 : 0);
+}
+
 function linkDir(target, linkPath, label) {
   if (fs.existsSync(linkPath)) {
     const st = fs.lstatSync(linkPath);
@@ -124,4 +189,4 @@ if (linked.length === 0 && copied.length === 0 && skipped.length === 0 && warned
 
 console.log('---');
 console.log('JUNCTION_RESULT', JSON.stringify({ linked, copied, skipped, warned, wt: wtPath }));
-process.exit(hasFailure ? 2 : 0);
+process.exit(hasFailure ? 2 : 0);

package/cbb/worktrees/skills/cbb-worktree-close/SKILL.md

@@ -105,7 +105,7 @@ node "<skill_dir>/scripts/discover-apps.js "<ws_root>" "<branch>"
 - `workspace` 字段：workspace worktree 绝对路径（AI agent 记录供后续命令使用）
 - `apps` 数组：实际存在的应用 worktree 列表（每项含 `name`, `repo`, `side`, `wt_path`, `app_path`）
 
-> 说明：app worktree 物理嵌套在 workspace worktree 的 `.codespace/` 容器内，移除 workspace worktree 时嵌套的子目录会一并消失，但各 app 仓库的 git worktree 元数据（`.git/worktrees/`）仍需通过 `git worktree remove` 逐个清理。AI 配置经 junction 链入 worktree（只读内容子目录指向空间根唯一物理副本），随 worktree 目录一并消失，无需特殊处理。
+> 说明：app worktree 物理嵌套在 workspace worktree 的 `.codespace/` 容器内，移除 workspace worktree 时嵌套的子目录会一并消失，但各 app 仓库的 git worktree 元数据（`.git/worktrees/`）仍需通过 `git worktree remove` 逐个清理。AI 配置经 junction 链入 worktree（只读内容子目录指向空间根唯一物理副本），关闭时由 remove-worktrees.js 在物理删除前**显式拆除**（只解除链接、源文件零接触），见 4.2 与附录 `junction-ai-config.js`。
 
 ### 1.3 检查未归档 change
 
@@ -329,10 +329,11 @@ node "<skill_dir>/scripts/deprecate-branches.js" "<ws_root>" "<branch>" --apps "
 node "<skill_dir>/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
 ```
 
-**三层降级策略**：`git worktree remove` 实际包含两个动作——①清理 git 元数据（`.git/worktrees/`）②删除物理目录。当 IDE 占用目录时 ② 会被 Windows 文件锁阻塞，但 ① 永远不受影响。脚本将这两个动作解耦：
+**移除流程**：`git worktree remove` 实际包含两个动作——①清理 git 元数据（`.git/worktrees/`）②删除物理目录。当 IDE 占用目录时 ② 会被 Windows 文件锁阻塞，但 ① 永远不受影响。脚本将这两个动作解耦，并在物理删除前**先显式拆除 AI 配置 junction**（`junction-ai-config.js --remove`：只解除链接、目标在空间根内校验、源文件零接触）：
 
-- **第 1 层（正常路径）：** `git worktree remove` 一步完成元数据 + 物理目录清理
-- **第 2 层（解耦清理）：** 当目录被锁时，先 `prune` 清理 git 元数据（始终成功），再 `rmdir`/`rm -rf` 尝试物理删除
+- **第 1 层（正常路径）：** junction 拆除 → `git worktree remove` 一步完成元数据 + 物理目录清理，并**验证物理目录已真消失**
+- **第 1.5 层（git 静默失败兜底）：** 实测 Windows 上 `git worktree remove` 遇 junction 时可能**返回成功但物理目录残留**（本次修复前 junction 遗留的根因）——检测目录仍存在即自动走第 2 层
+- **第 2 层（解耦清理）：** 先 `prune` 清理 git 元数据（始终成功），再 `fs.rmSync`（Node 原生，对 reparse point 只删链接不穿透）尝试物理删除
 - **第 3 层（延迟清理）：** Windows 下 IDE 持有排他句柄时触发。元数据已清理保证分支删除不受影响；物理目录**不会被 init 自动删除**（0.0.3-beta.11 起 init 只 prune 元数据、绝不删目录，防误删活跃 worktree），需用户关闭 IDE 后手动删除，或重跑 close 补删
 
 **解读末行 `REMOVE_RESULT`**：
@@ -480,7 +481,7 @@ git -C "<ws_root>" worktree list
 - **合并判定依赖刷新后的远程引用，故 Step 2.0 先主动 `git fetch`**：feature 多由他人经 MR 合入远端，本地引用否则会陈旧误判
 - **并行块用临时文件收结果、不用共享变量**：原 bash 版本中 `&` 后台任务跑在独立子 shell；Node.js 同步执行无此问题
 - **`.gitignore` 无需清理**：创建时的 `.worktrees/` 条目提交在 feature 分支上，删分支时随分支消失（未合并）或无害保留（已合并）
-- **AI 配置在 worktree 内是 junction（链接）**：物理副本只在空间根（单层安装），worktree 删除时链接随目录树消失，无需清理动作
+- **AI 配置在 worktree 内是 junction（链接）**：物理副本只在空间根（单层安装）。**不可依赖「随目录树消失」**——Windows 上 `git worktree remove` 遇 junction 会静默失败、残留整个目录树（实测复现）。关闭流程在物理删除前用 Node 显式拆除（只解除链接，目标在空间根内校验，源文件零接触）
 - **部分 `worktree remove` 失败**：已移除的无需回退，未移除的报告详情让用户处理后重跑
 - **Windows IDE 目录锁的三层降级**：`git worktree remove` 内部做两件事——①清元数据 ②删目录。Windows 文件锁只阻塞 ②，不阻塞 ①
 
@@ -496,7 +497,8 @@ git -C "<ws_root>" worktree list
 | `discover-apps.js` | 发现关联应用 worktree | ws_root, branch | 0/1/2 |
 | `check-unarchived.js` | 检查未归档 change（双扫空间根 + worktree） | ws_root, branch | 0/1 |
 | `safety-check.js` | 安全评估（合并判定 + 未提交 + 远程） | ws_root, branch | 0/1 |
-| `remove-worktrees.js` | 移除 worktree（三层降级） | ws_root, branch, force | 0/1 |
+| `remove-worktrees.js` | 移除 worktree（先拆 junction，三层降级 + 残留验证） | ws_root, branch, force | 0/1 |
+| `junction-ai-config.js` | AI 配置 junction 创建 / `--remove` 拆除（共享脚本，源仓库真源在 `_shared/scripts/`） | ws_root, wt_path, [--remove] | 0/1/2 |
 | `delete-branches.js` | 删除分支（按 mode；交付完成后由 Step 4.4 自动以 local_remote 调用） | ws_root, branch, mode | 0/1/2 |
 | `merge-branches.js` | 收尾合并门禁·直合并（预检 → merge --no-ff → push 主干，共享脚本，真源在 `_shared/scripts/`） | ws_root, branch, --apps / --target / --allow-checkout / --dry-run / --check | 0/1/2 |
 | `deprecate-branches.js` | 收尾合并门禁·废弃（远程分支重命名为 `<分支>-deprecated`，共享脚本） | ws_root, branch, --apps | 0/1/2 |

package/cbb/worktrees/skills/cbb-worktree-close/scripts/junction-ai-config.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+/**
+ * worktree 模式 AI 配置 junction（ADR 0002，防线 B）。
+ *
+ * 用法：node junction-ai-config.js <ws_root> <wt_path> [--remove]
+ *
+ * 目的：让开发会话能开进 worktree（工作树内加载 AI 配置），同时保持
+ * 「单层安装」实质——配置唯一物理副本在空间根，cbb update 一处生效。
+ *
+ * 策略（规避 ADR 0001 否决时的状态污染）：
+ *   - 只 junction **只读内容子目录**（rules / skills / commands）：
+ *     工具向配置根写状态（如 settings.local.json）落在 worktree 自建的
+ *     物理（空壳）配置目录里，按项目隔离，不互相覆盖；
+ *   - 配置根目录本身在 worktree 侧是物理目录（不是链接）；
+ *   - .opencode/opencode.json 为文件（junction 不支持文件）：直接复制
+ *     （cbb update 后需重跑本脚本同步；worktree 为瞬态，影响可控）。
+ *
+ * 幂等：linkPath 已指向同一 target → skip；指向不同 → 重建；
+ *       存在同名**物理目录**（非链接）→ warn 跳过（不覆盖用户内容）。
+ *
+ * --remove（cbb-worktree-close 调用）：
+ *   - 拆除 worktree 内已建 junction 与复制件，**源文件零接触**：
+ *     只解除链接本身（fs.rmSync 对 reparse point 仅删链接、不穿透目标，
+ *     已由 Windows 实测验证），复制件为普通文件直接删除；
+ *   - 拆除前校验链接目标位于空间根内——目标在空间根外 / readlink 失败
+ *     → 跳过并警告（防误删外部目录）；同名物理目录/文件 → 跳过不碰。
+ *
+ * 退出码：0 成功（含全部 skip）；1 参数错误；2 执行失败。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const wtPath = process.argv[3];
+const removeMode = process.argv[4] === '--remove';
+
+if (!wsRoot || !wtPath) {
+  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path> [--remove]');
+  process.exit(1);
+}
+
+// 各工具的项目级配置根（存在才处理）与本包部署的内容子目录
+const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae', '.minimax'];
+const CONTENT_SUBDIRS = ['rules', 'skills', 'commands'];
+// 文件级内容（复制而非 junction）：opencode 的 instructions 登记
+const CONTENT_FILES = { '.opencode': ['opencode.json'] };
+
+const linked = [];
+const copied = [];
+const skipped = [];
+const warned = [];
+let hasFailure = false;
+
+/** 归一化 junction 目标路径（Windows readlink 返回 \\?\ 前缀） */
+function normLinkTarget(p) {
+  return path.resolve(String(p).replace(/^\\\\\?\\/, ''));
+}
+
+/** 目标是否位于空间根内（防误删空间根外目录的守卫） */
+function isWithin(p, root) {
+  const r = path.resolve(root) + path.sep;
+  return path.resolve(p).startsWith(r);
+}
+
+// ── remove 模式：显式拆除 junction 与复制件（源文件零接触）──
+if (removeMode) {
+  const removed = [];
+  const guarded = [];
+
+  for (const root of CONFIG_ROOTS) {
+    for (const sub of CONTENT_SUBDIRS) {
+      const linkPath = path.join(wtPath, root, sub);
+      const label = root + '/' + sub;
+      let st;
+      try { st = fs.lstatSync(linkPath); } catch (e) { continue; } // 不存在 → 跳过（dangling 链接 lstat 仍成功，可拆）
+      if (!st.isSymbolicLink()) continue; // 物理目录/文件（工具状态空壳或用户内容）→ 不碰
+
+      const target = normLinkTarget(fs.readlinkSync(linkPath));
+      if (!isWithin(target, wsRoot)) {
+        guarded.push(label + ' → ' + target + '（目标不在空间根内，跳过）');
+        continue;
+      }
+
+      try {
+        // 只解除链接：Node 对 reparse point 仅删除链接本身，不递归、不触达目标内容
+        fs.rmSync(linkPath, { recursive: true, force: true });
+        removed.push(label);
+      } catch (e) {
+        console.error('❌ 拆除失败 ' + label + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+
+    for (const file of (CONTENT_FILES[root] || [])) {
+      const linkPath = path.join(wtPath, root, file);
+      if (!fs.existsSync(linkPath)) continue;
+      try {
+        fs.unlinkSync(linkPath); // 复制件为普通文件，删除不影响源
+        removed.push(root + '/' + file);
+      } catch (e) {
+        console.error('❌ 删除失败 ' + root + '/' + file + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+  }
+
+  if (removed.length) console.log('✅ 已拆除 junction/复制件：' + removed.join(', '));
+  if (guarded.length) console.log('⚠️  ' + guarded.join('；'));
+  if (removed.length === 0 && guarded.length === 0) console.log('ℹ️  无待拆除项（幂等）');
+
+  console.log('---');
+  console.log('JUNCTION_REMOVE_RESULT', JSON.stringify({ removed, guarded, wt: wtPath }));
+  process.exit(hasFailure ? 2 : 0);
+}
+
+function linkDir(target, linkPath, label) {
+  if (fs.existsSync(linkPath)) {
+    const st = fs.lstatSync(linkPath);
+    if (st.isSymbolicLink()) {
+      const existing = normLinkTarget(fs.readlinkSync(linkPath));
+      if (existing === path.resolve(target)) {
+        skipped.push(label);
+        return;
+      }
+      fs.unlinkSync(linkPath); // 指向不同 → 重建
+    } else if (st.isDirectory()) {
+      warned.push(label + '（存在同名物理目录，未覆盖）');
+      return;
+    } else {
+      fs.unlinkSync(linkPath); // 同名文件，罕见，重建
+    }
+  }
+  fs.mkdirSync(path.dirname(linkPath), { recursive: true });
+  try {
+    if (process.platform === 'win32') {
+      fs.symlinkSync(path.resolve(target), linkPath, 'junction');
+    } else {
+      fs.symlinkSync(path.resolve(target), linkPath, 'dir');
+    }
+    linked.push(label);
+  } catch (e) {
+    console.error('❌ junction 失败 ' + label + ' — ' + e.message);
+    hasFailure = true;
+  }
+}
+
+function copyFile(target, dest, label) {
+  if (fs.existsSync(dest) && fs.existsSync(target) &&
+      fs.readFileSync(dest, 'utf-8') === fs.readFileSync(target, 'utf-8')) {
+    skipped.push(label);
+    return;
+  }
+  try {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(target, dest);
+    copied.push(label);
+  } catch (e) {
+    console.error('❌ 复制失败 ' + label + ' — ' + e.message);
+    hasFailure = true;
+  }
+}
+
+for (const root of CONFIG_ROOTS) {
+  const srcRoot = path.join(wsRoot, root);
+  if (!fs.existsSync(srcRoot) || !fs.statSync(srcRoot).isDirectory()) continue;
+
+  for (const sub of CONTENT_SUBDIRS) {
+    const src = path.join(srcRoot, sub);
+    if (!fs.existsSync(src) || !fs.statSync(src).isDirectory()) continue;
+    linkDir(src, path.join(wtPath, root, sub), root + '/' + sub);
+  }
+
+  for (const file of (CONTENT_FILES[root] || [])) {
+    const src = path.join(srcRoot, file);
+    if (!fs.existsSync(src) || !fs.statSync(src).isFile()) continue;
+    copyFile(src, path.join(wtPath, root, file), root + '/' + file);
+  }
+}
+
+if (linked.length === 0 && copied.length === 0 && skipped.length === 0 && warned.length === 0) {
+  console.log('ℹ️  空间根无 AI 配置目录，跳过（cbb setup 选择工具后再装）');
+} else {
+  if (linked.length) console.log('✅ junction：' + linked.join(', '));
+  if (copied.length) console.log('✅ 复制：' + copied.join(', '));
+  if (skipped.length) console.log('⏭️  已就绪：' + skipped.join(', '));
+  if (warned.length) console.log('⚠️  ' + warned.join('；'));
+}
+
+console.log('---');
+console.log('JUNCTION_RESULT', JSON.stringify({ linked, copied, skipped, warned, wt: wtPath }));
+process.exit(hasFailure ? 2 : 0);

package/cbb/worktrees/skills/cbb-worktree-close/scripts/remove-worktrees.js

@@ -7,6 +7,8 @@ require('./silence-popup');
  *   force: "true" 启用 --force，"false" 不启用
  *
  * 行为：
+ *   0. 物理删除前先显式拆除 AI 配置 junction（源文件零接触，防 Windows
+ *      删除例程遗留/穿透——实测 git worktree remove 遇 junction 会静默残留）
  *   1. 先移除各应用 worktree
  *   2. 再移除 workspace worktree
  *   3. 三层降级：git worktree remove → prune+rm → 仅 prune
@@ -32,6 +34,8 @@ if (!wsRoot || !branch || !forceStr) {
 
 const force = forceStr === 'true';
 const wtDir = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
+// AI 配置 junction 拆除脚本（close 自包含副本；源真 _shared/scripts/junction-ai-config.js）
+const junctionScript = path.join(__dirname, 'junction-ai-config.js');
 
 function run(cmd, cwd) {
   try {
@@ -42,11 +46,14 @@ function run(cmd, cwd) {
 }
 
 function removePhysicalDir(dir) {
-  // Windows 用 rmdir /s /q，Unix 用 rm -rf
-  if (process.platform === 'win32') {
-    return run('rmdir /s /q "' + dir + '"');
+  // 统一 Node fs.rmSync：跨平台；对 reparse point（junction/symlink）只删链接不穿透目标。
+  // 不用 rmdir /s /q / rm -rf——两者对 junction 的行为因实现/版本而异（实测 git 会静默残留目录树）
+  try {
+    fs.rmSync(dir, { recursive: true, force: true });
+    return { ok: true, out: '' };
+  } catch (e) {
+    return { ok: false, err: e.message };
   }
-  return run('rm -rf "' + dir + '"');
 }
 
 const lockedDirs = [];
@@ -58,14 +65,33 @@ function removeWt(repoPath, wtPath, name) {
     return;
   }
 
+  // 第 0 层：显式拆除 AI 配置 junction（只解除链接、源文件零接触；
+  // 实测 Windows 删除例程遇 junction 会静默失败、残留整个目录树）
+  const jr = run('node "' + junctionScript + '" "' + wsRoot + '" "' + wtPath + '" --remove');
+  if (jr.ok) {
+    const m = (jr.out || '').match(/JUNCTION_REMOVE_RESULT (.+)$/m);
+    if (m) {
+      try {
+        const data = JSON.parse(m[1]);
+        if (data.removed && data.removed.length) console.log('🔗 ' + name + ' AI 配置 junction 已拆除：' + data.removed.join(', '));
+      } catch (e) {}
+    }
+  } else {
+    console.log('⚠️ ' + name + ' junction 拆除失败（继续移除）：' + (jr.err || ''));
+  }
+
   const forceFlag = force ? ' --force' : '';
   // 第 1 层：git worktree remove
   const r1 = run('git worktree remove' + forceFlag + ' "' + wtPath + '"', repoPath);
-  if (r1.ok) {
+  if (r1.ok && !fs.existsSync(wtPath)) {
     console.log('✅ ' + name + ' worktree 已移除');
     results.push({ name, status: 'removed' });
     return;
   }
+  if (r1.ok && fs.existsSync(wtPath)) {
+    // git 报成功但物理目录残留（Windows + junction/系统差异的静默失败）→ 物理兜底
+    console.log('⚠️ ' + name + '：git 元数据已移除但物理目录残留，执行物理清理');
+  }
 
   // 第 2 层：prune + 物理目录清理（解耦）
   run('git worktree prune', repoPath);

package/cbb/worktrees/skills/cbb-worktree-init/SKILL.md

@@ -307,7 +307,7 @@ WT_PATH d:\workspace\xxx\.worktrees\worktree-feature-login
 node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 ```
 
-脚本把根的 AI 配置**内容子目录**（`.claude/`、`.qoder/`、`.opencode/`、`.workbuddy/`、`.trae/`、`.minimax/` 下的 rules / skills / commands）junction 进工作树；`.opencode/opencode.json` 为文件则复制。
+脚本把根的 AI 配置**内容子目录**（`.claude/`、`.qoder/`、`.opencode/`、`.workbuddy/`、`.trae/`、`.minimax/` 下的 rules / skills / commands）junction 进工作树；`.opencode/opencode.json` 为文件则复制。关闭（`cbb-worktree-close`）时由同一脚本 `--remove` **显式拆除**——只解除链接、源文件零接触（防 Windows 删除例程遗留/穿透）。
 
 **解读末行 `JUNCTION_RESULT`**：
 - 退出码 0 → linked / copied / skipped（幂等）任一组合均成功

package/cbb/worktrees/skills/cbb-worktree-init/scripts/junction-ai-config.js

@@ -2,7 +2,7 @@
 /**
  * worktree 模式 AI 配置 junction（ADR 0002，防线 B）。
  *
- * 用法：node junction-ai-config.js <ws_root> <wt_path>
+ * 用法：node junction-ai-config.js <ws_root> <wt_path> [--remove]
  *
  * 目的：让开发会话能开进 worktree（工作树内加载 AI 配置），同时保持
  * 「单层安装」实质——配置唯一物理副本在空间根，cbb update 一处生效。
@@ -18,6 +18,13 @@
  * 幂等：linkPath 已指向同一 target → skip；指向不同 → 重建；
  *       存在同名**物理目录**（非链接）→ warn 跳过（不覆盖用户内容）。
  *
+ * --remove（cbb-worktree-close 调用）：
+ *   - 拆除 worktree 内已建 junction 与复制件，**源文件零接触**：
+ *     只解除链接本身（fs.rmSync 对 reparse point 仅删链接、不穿透目标，
+ *     已由 Windows 实测验证），复制件为普通文件直接删除；
+ *   - 拆除前校验链接目标位于空间根内——目标在空间根外 / readlink 失败
+ *     → 跳过并警告（防误删外部目录）；同名物理目录/文件 → 跳过不碰。
+ *
  * 退出码：0 成功（含全部 skip）；1 参数错误；2 执行失败。
  */
 
@@ -26,9 +33,10 @@ const path = require('path');
 
 const wsRoot = process.argv[2];
 const wtPath = process.argv[3];
+const removeMode = process.argv[4] === '--remove';
 
 if (!wsRoot || !wtPath) {
-  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path>');
+  console.error('Usage: node junction-ai-config.js <ws_root> <wt_path> [--remove]');
   process.exit(1);
 }
 
@@ -49,6 +57,63 @@ function normLinkTarget(p) {
   return path.resolve(String(p).replace(/^\\\\\?\\/, ''));
 }
 
+/** 目标是否位于空间根内（防误删空间根外目录的守卫） */
+function isWithin(p, root) {
+  const r = path.resolve(root) + path.sep;
+  return path.resolve(p).startsWith(r);
+}
+
+// ── remove 模式：显式拆除 junction 与复制件（源文件零接触）──
+if (removeMode) {
+  const removed = [];
+  const guarded = [];
+
+  for (const root of CONFIG_ROOTS) {
+    for (const sub of CONTENT_SUBDIRS) {
+      const linkPath = path.join(wtPath, root, sub);
+      const label = root + '/' + sub;
+      let st;
+      try { st = fs.lstatSync(linkPath); } catch (e) { continue; } // 不存在 → 跳过（dangling 链接 lstat 仍成功，可拆）
+      if (!st.isSymbolicLink()) continue; // 物理目录/文件（工具状态空壳或用户内容）→ 不碰
+
+      const target = normLinkTarget(fs.readlinkSync(linkPath));
+      if (!isWithin(target, wsRoot)) {
+        guarded.push(label + ' → ' + target + '（目标不在空间根内，跳过）');
+        continue;
+      }
+
+      try {
+        // 只解除链接：Node 对 reparse point 仅删除链接本身，不递归、不触达目标内容
+        fs.rmSync(linkPath, { recursive: true, force: true });
+        removed.push(label);
+      } catch (e) {
+        console.error('❌ 拆除失败 ' + label + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+
+    for (const file of (CONTENT_FILES[root] || [])) {
+      const linkPath = path.join(wtPath, root, file);
+      if (!fs.existsSync(linkPath)) continue;
+      try {
+        fs.unlinkSync(linkPath); // 复制件为普通文件，删除不影响源
+        removed.push(root + '/' + file);
+      } catch (e) {
+        console.error('❌ 删除失败 ' + root + '/' + file + ' — ' + e.message);
+        hasFailure = true;
+      }
+    }
+  }
+
+  if (removed.length) console.log('✅ 已拆除 junction/复制件：' + removed.join(', '));
+  if (guarded.length) console.log('⚠️  ' + guarded.join('；'));
+  if (removed.length === 0 && guarded.length === 0) console.log('ℹ️  无待拆除项（幂等）');
+
+  console.log('---');
+  console.log('JUNCTION_REMOVE_RESULT', JSON.stringify({ removed, guarded, wt: wtPath }));
+  process.exit(hasFailure ? 2 : 0);
+}
+
 function linkDir(target, linkPath, label) {
   if (fs.existsSync(linkPath)) {
     const st = fs.lstatSync(linkPath);
@@ -124,4 +189,4 @@ if (linked.length === 0 && copied.length === 0 && skipped.length === 0 && warned
 
 console.log('---');
 console.log('JUNCTION_RESULT', JSON.stringify({ linked, copied, skipped, warned, wt: wtPath }));
-process.exit(hasFailure ? 2 : 0);
+process.exit(hasFailure ? 2 : 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.36",
+  "version": "0.0.3-beta.37",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {