@cannbot-ai/install-helper 1.1.6-beta.8 → 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();
   }
 });
 
@@ -2739,7 +2741,7 @@ function deleteRecord(pluginId) {
     unlinkSync3(recordPath);
   }
 }
-function scanInstalledFiles(pluginId, displayName, tool, level, installPath, configRoot, manifest, externalRepoNames) {
+function scanInstalledFiles(pluginId, displayName, tool, level, installPath, configRoot, manifest, externalRepoNames, configRootConfigLink) {
   const files = [];
   const directories = [];
   if (manifest) {
@@ -2781,9 +2783,15 @@ function scanInstalledFiles(pluginId, displayName, tool, level, installPath, con
   }
   const configFileName = tool === "claude" ? "CLAUDE.md" : "AGENTS.md";
   const configFilePath = level === "project" ? join10(installPath, configFileName) : join10(configRoot, configFileName);
-  if (existsSync11(configFilePath)) {
+  if (existsSync11(configFilePath) || isSymlink(configFilePath)) {
     files.push(configFilePath);
   }
+  if (level === "project" && configRootConfigLink !== false) {
+    const configRootConfigPath = join10(configRoot, configFileName);
+    if (configRootConfigPath !== configFilePath && (existsSync11(configRootConfigPath) || isSymlink(configRootConfigPath))) {
+      files.push(configRootConfigPath);
+    }
+  }
   const repoLinks = externalRepoNames && externalRepoNames.length > 0 ? externalRepoNames : ["asc-devkit", "pypto", "tilelang-ascend", "cann-recipes-infer", "cann-samples"];
   for (const repoName of repoLinks) {
     const repoLinkPath = join10(installPath, repoName);
@@ -2848,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) {
@@ -3454,7 +3464,8 @@ async function installPlugin(opts) {
           cwd,
           configRoot,
           result.manifest,
-          plugin.externalRepos?.map((r) => basename2(r.dir))
+          plugin.externalRepos?.map((r) => basename2(r.dir)),
+          plugin.configRootConfigLink
         );
         if (backupInfo) {
           record.backup = {
@@ -3540,7 +3551,8 @@ async function installPlugin(opts) {
         cwd,
         configRoot,
         manifest,
-        plugin.externalRepos?.map((r) => basename2(r.dir))
+        plugin.externalRepos?.map((r) => basename2(r.dir)),
+        plugin.configRootConfigLink
       );
       if (backupInfo) {
         record.backup = {
@@ -4983,8 +4995,8 @@ 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 { resolve, basename as basename3, sep } from "path";
+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";
 init_config();
@@ -4996,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) {
@@ -5007,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 = [];
@@ -5099,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}`);
       }
     }
   }
@@ -5124,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 = [
@@ -5159,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"));
@@ -5169,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__") {
@@ -5259,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")}`);
@@ -5274,7 +5321,15 @@ async function uninstallPluginById(pluginId, batchMode) {
   };
   let removedFiles = 0;
   let removedDirs = 0;
-  for (const filePath of record.files) {
+  const configFileName = record.tool === "claude" ? "CLAUDE.md" : "AGENTS.md";
+  const configRootConfigPath = join18(configRoot, configFileName);
+  const installPathConfigPath = join18(record.installPath, configFileName);
+  const extraFiles = [];
+  if (record.level === "project" && configRootConfigPath !== installPathConfigPath && !record.files.includes(configRootConfigPath) && (existsSync18(configRootConfigPath) || isSymlink(configRootConfigPath))) {
+    extraFiles.push(configRootConfigPath);
+  }
+  const allFiles = [...record.files, ...extraFiles];
+  for (const filePath of allFiles) {
     if (!isSafePath(filePath)) continue;
     try {
       if (existsSync18(filePath) || isSymlink(filePath)) {
@@ -5455,7 +5510,7 @@ async function updateCommand(pluginNames, options) {
 init_registry();
 import chalk13 from "chalk";
 import { existsSync as existsSync19, readdirSync as readdirSync8 } from "fs";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 init_manifest();
 init_i18n();
 async function infoCommand(pluginName) {
@@ -5482,11 +5537,11 @@ async function infoCommand(pluginName) {
   try {
     const repoManager = createRepositoryManager();
     const repoPath = await repoManager.ensureRepo();
-    const quickstartPath = join18(repoPath, plugin.dir, "quickstart.md");
+    const quickstartPath = join19(repoPath, plugin.dir, "quickstart.md");
     if (existsSync19(quickstartPath)) {
       console.log(`  ${chalk13.dim(t("info_quickstart") + ":")} ${quickstartPath}`);
     }
-    const agentsDir = join18(repoPath, plugin.dir, "agents");
+    const agentsDir = join19(repoPath, plugin.dir, "agents");
     if (existsSync19(agentsDir)) {
       const agentFiles = readdirSync8(agentsDir).filter((f) => f.endsWith(".md"));
       if (agentFiles.length > 0) {
@@ -5543,9 +5598,9 @@ 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 join19 } from "path";
+import { dirname as dirname6, join as join20 } from "path";
 function readVersion() {
   try {
     if (typeof INSTALL_HELPER_VERSION !== "undefined" && INSTALL_HELPER_VERSION) {
@@ -5557,13 +5612,13 @@ function readVersion() {
     const __filename4 = fileURLToPath4(import.meta.url);
     const __dirname4 = dirname6(__filename4);
     const candidates = [
-      join19(__dirname4, "..", "package.json"),
-      join19(__dirname4, "package.json"),
-      join19(process.cwd(), "package.json")
+      join20(__dirname4, "..", "package.json"),
+      join20(__dirname4, "package.json"),
+      join20(process.cwd(), "package.json")
     ];
     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;
         }