@cannbot-ai/install-helper 1.1.6-beta.9 → 1.1.6

package/README.md

@@ -125,13 +125,45 @@ install-helper uninstall --all --tool opencode --level project  # 指定范围
 
 根据安装记录精确删除所有产物，自动清理空目录。
 
-交互式卸载：已安装项全部预勾选（✓=保留），取消勾选后确认即可批量卸载。
+**交互式卸载**：
+
+```bash
+install-helper uninstall
+```
+
+- 自动检测已安装内容，跳过只有单一选项的步骤（如仅一个工具/级别有内容时自动选中）
+- 若 Skills 和 Plugins 都已安装，先选择卸载类型
+- ≤15 个已安装 Skill 时显示扁平列表，>15 个时按类别导航
+- **勾选=卸载**（标准 checkbox 语义），勾选后确认即可批量卸载
+- 支持跨类别累积选择
+
+**`--all` 一键卸载**：
+
+```bash
+install-helper uninstall --all --yes
+```
+
+卸载指定范围内全部已安装的 Skills 和 Plugins。通过 `--tool` / `--level` 限定范围，未指定时默认 project 级别。
+
+**`--recent` 批次卸载**：
+
+```bash
+install-helper uninstall --recent --yes
+```
+
+仅卸载最近一次安装批次中的 Skills。每次 `install-helper install` 会自动记录安装批次，`--recent` 精确卸载最后一批，不影响更早安装的内容。
+
+**安全机制**：
+
+- 仅删除 `install-helper` 安装的 symlink，不影响用户手动创建的目录或文件
+- 无安装记录时自动回退到文件系统扫描（识别 symlink）和 manifest 文件，确保残留内容可清理
+- Plugin 卸载时完整清理 skills、agents、配置文件（AGENTS.md/CLAUDE.md）、manifest、外部仓库链接
 
 **选项：**
 
 | 选项 | 说明 |
 |------|------|
-| `--tool <tool>` | 指定 AI 工具 |
+| `--tool <tool>` | 指定 AI 工具（opencode, claude, trae, cursor, copilot, codearts） |
 | `--level <level>` | 安装级别（project, global），默认 project |
 | `--yes` `-y` | 跳过确认提示 |
 | `--all` `-a` | 卸载全部已安装 Skills 和 Plugins |

package/dist/index.js

@@ -1467,20 +1467,21 @@ function verifyPluginFilesExist(configRoot, manifest, tool, level) {
   if (manifest.installed_skills && manifest.installed_skills.length > 0) {
     const hasAnySkill = manifest.installed_skills.some((skillId) => {
       const skillPath = join5(skillsDir, skillId);
-      return existsSync5(skillPath);
+      return existsSync5(skillPath) || isSymlink(skillPath);
     });
     if (hasAnySkill) hasAnyComponent = true;
   }
   if (manifest.installed_agents && manifest.installed_agents.length > 0) {
     const hasAnyAgent = manifest.installed_agents.some((agentId) => {
       const agentPath = join5(agentsDir, agentId);
-      return existsSync5(agentPath);
+      const agentPathMd = join5(agentsDir, agentId + ".md");
+      return existsSync5(agentPath) || isSymlink(agentPath) || existsSync5(agentPathMd) || isSymlink(agentPathMd);
     });
     if (hasAnyAgent) hasAnyComponent = true;
   }
   const agentsFileName = getAgentsFileName(tool);
   const configFilePath = level === "project" ? join5(configRoot, "..", agentsFileName) : join5(configRoot, agentsFileName);
-  if (existsSync5(configFilePath)) hasAnyComponent = true;
+  if (existsSync5(configFilePath) || isSymlink(configFilePath)) hasAnyComponent = true;
   const pluginManifestPath = join5(configRoot, `${manifest.team}-manifest.json`);
   if (existsSync5(pluginManifestPath)) hasAnyComponent = true;
   return hasAnyComponent;
@@ -1490,6 +1491,7 @@ var init_manifest = __esm({
     "use strict";
     init_paths();
     init_registry();
+    init_fs_helpers();
   }
 });
 
@@ -2854,12 +2856,14 @@ function addSkillsToRecord(skillIds, tool, level, installPath) {
     }
   }
   entry.installTime = now;
-  if (!entry.batches) entry.batches = [];
-  entry.batches.push({
-    batchId: `batch-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-    installedAt: now,
-    skills: newSkills.length > 0 ? newSkills : [...skillIds]
-  });
+  if (newSkills.length > 0) {
+    if (!entry.batches) entry.batches = [];
+    entry.batches.push({
+      batchId: `batch-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+      installedAt: now,
+      skills: newSkills
+    });
+  }
   writeSkillRecord(record);
 }
 function removeSkillsFromRecord(skillIds, tool, level, installPath) {
@@ -4991,7 +4995,7 @@ async function installPlugins(pluginIds, tool, level, repoPath, installPath, yes
 
 // src/commands/uninstall.ts
 init_registry();
-import { existsSync as existsSync18, unlinkSync as unlinkSync6, rmdirSync, readdirSync as readdirSync7 } from "fs";
+import { existsSync as existsSync18, unlinkSync as unlinkSync6, rmdirSync, readdirSync as readdirSync7, readFileSync as readFileSync9 } from "fs";
 import { resolve, basename as basename3, sep, join as join18 } from "path";
 import chalk11 from "chalk";
 import { select as select5, checkbox as checkbox2, Separator as Separator4, confirm as confirm3 } from "@inquirer/prompts";
@@ -5004,6 +5008,8 @@ init_manifest();
 init_theme();
 init_wizard();
 async function uninstallCommand(names, options) {
+  const userSpecifiedTool = !!options.tool;
+  const userSpecifiedLevel = !!options.level;
   const tool = options.tool ? validateTool(options.tool) : "opencode";
   const level = options.level ? validateLevel(options.level) : "project";
   if (options.all) {
@@ -5015,7 +5021,7 @@ async function uninstallCommand(names, options) {
     return;
   }
   if (names.length === 0) {
-    await uninstallInteractive(tool, level);
+    await uninstallInteractive(tool, level, userSpecifiedTool, userSpecifiedLevel);
     return;
   }
   const plugins = [];
@@ -5107,18 +5113,18 @@ async function uninstallRecent(tool, level, yes) {
   logger.success(t("skill_uninstall_done"));
   logger.blank();
 }
-async function uninstallInteractive(defaultTool, defaultLevel) {
+async function uninstallInteractive(defaultTool, defaultLevel, userSpecifiedTool, userSpecifiedLevel) {
   let tool = defaultTool;
   let level = defaultLevel;
   const allInstalledPlugins = scanInstalled();
   const toolsWithPlugins = new Set(allInstalledPlugins.map((p) => `${p.tool}:${p.level}`));
   const toolsWithSkills = /* @__PURE__ */ new Set();
-  for (const t2 of ["opencode", "claude", "trae", "cursor", "copilot", "codearts"]) {
-    for (const l of ["project", "global"]) {
-      const ip = l === "project" ? process.cwd() : getConfigRoot(t2, l);
-      const skills = getInstalledSkills(t2, l, ip);
+  for (const toolName of ["opencode", "claude", "trae", "cursor", "copilot", "codearts"]) {
+    for (const lvl of ["project", "global"]) {
+      const ip = lvl === "project" ? process.cwd() : getConfigRoot(toolName, lvl);
+      const skills = getInstalledSkills(toolName, lvl, ip);
       if (skills.length > 0) {
-        toolsWithSkills.add(`${t2}:${l}`);
+        toolsWithSkills.add(`${toolName}:${lvl}`);
       }
     }
   }
@@ -5132,9 +5138,9 @@ async function uninstallInteractive(defaultTool, defaultLevel) {
   if (hasSkills && hasPlugins) {
     printBoxTitle(t("uninstall_interactive_title"));
     const skillCount = [...toolsWithSkills].reduce((sum, key) => {
-      const [t2, l] = key.split(":");
-      const ip = l === "project" ? process.cwd() : getConfigRoot(t2, l);
-      return sum + getInstalledSkills(t2, l, ip).length;
+      const [toolName, lvl] = key.split(":");
+      const ip = lvl === "project" ? process.cwd() : getConfigRoot(toolName, lvl);
+      return sum + getInstalledSkills(toolName, lvl, ip).length;
     }, 0);
     const pluginCount = allInstalledPlugins.length;
     const typeChoices = [
@@ -5167,7 +5173,9 @@ async function uninstallInteractive(defaultTool, defaultLevel) {
   }
   if (toolsWithContent.size === 1) {
     tool = [...toolsWithContent][0];
-  } else if (!process.env.INSTALL_HELPER_TOOL) {
+  } else if (userSpecifiedTool && toolsWithContent.has(defaultTool)) {
+    tool = defaultTool;
+  } else {
     const detected = await selectToolWithDetection();
     if (detected === "back" || detected === "cancel") {
       logger.info(t("init_cancelled"));
@@ -5177,14 +5185,16 @@ async function uninstallInteractive(defaultTool, defaultLevel) {
   }
   const levelsWithContent = /* @__PURE__ */ new Set();
   for (const key of relevantKeys) {
-    const [t2, l] = key.split(":");
-    if (t2 === tool) {
-      levelsWithContent.add(l);
+    const [toolName, lvl] = key.split(":");
+    if (toolName === tool) {
+      levelsWithContent.add(lvl);
     }
   }
   if (levelsWithContent.size === 1) {
     level = [...levelsWithContent][0];
-  } else if (!process.env.INSTALL_HELPER_LEVEL) {
+  } else if (userSpecifiedLevel && levelsWithContent.has(defaultLevel)) {
+    level = defaultLevel;
+  } else {
     const { stepLevel: stepLevel2 } = await Promise.resolve().then(() => (init_wizard(), wizard_exports));
     const levelResult = await stepLevel2();
     if (levelResult === "__back__" || levelResult === "__cancel__") {
@@ -5267,7 +5277,36 @@ async function uninstallPlugins(pluginIds, batchMode) {
 async function uninstallPluginById(pluginId, batchMode) {
   const plugin = findPlugin(pluginId);
   if (!plugin) return;
-  const record = readRecord(plugin.id);
+  let record = readRecord(plugin.id);
+  if (!record) {
+    for (const toolName of VALID_TOOLS) {
+      for (const lvl of ["project", "global"]) {
+        const configRoot2 = getConfigRoot(toolName, lvl);
+        const manifestPath = join18(configRoot2, `${pluginId}-manifest.json`);
+        if (!existsSync18(manifestPath)) continue;
+        let manifest = null;
+        try {
+          manifest = JSON.parse(readFileSync9(manifestPath, "utf-8"));
+        } catch {
+          continue;
+        }
+        const installPath = lvl === "project" ? process.cwd() : configRoot2;
+        record = scanInstalledFiles(
+          pluginId,
+          plugin.displayName,
+          toolName,
+          lvl,
+          installPath,
+          configRoot2,
+          manifest,
+          plugin.externalRepos?.map((r) => basename3(r.dir)),
+          plugin.configRootConfigLink
+        );
+        break;
+      }
+      if (record) break;
+    }
+  }
   if (!record) {
     logger.warn(`${plugin.displayName} ${t("uninstall_no_record")}`);
     logger.info(`${t("uninstall_no_record_hint")}`);
@@ -5559,7 +5598,7 @@ async function langCommand(action, value) {
 // src/cli.ts
 init_config();
 init_i18n();
-import { readFileSync as readFileSync9, existsSync as existsSync20 } from "fs";
+import { readFileSync as readFileSync10, existsSync as existsSync20 } from "fs";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { dirname as dirname6, join as join20 } from "path";
 function readVersion() {
@@ -5579,7 +5618,7 @@ function readVersion() {
     ];
     for (const pkgPath of candidates) {
       if (existsSync20(pkgPath)) {
-        const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync10(pkgPath, "utf-8"));
         if (pkg.version && (pkg.name === "@cannbot-ai/install-helper" || pkg.name?.startsWith("@cannbot-ai/install-helper-"))) {
           return pkg.version;
         }