@cannbot-ai/install-helper 0.0.2-beta.49 → 0.0.2-beta.50

package/README.md

@@ -12,7 +12,7 @@
 curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh | bash
 
 # Windows PowerShell 一键安装（零依赖）
-irm https://cdn.jsdelivr.net/npm/@cannbot-ai/install-helper@beta/dist/install.ps1 | iex
+irm https://cdn.jsdelivr.net/npm/@cannbot-ai/install-helper@latest/dist/install.ps1 | iex
 
 # 或通过 npm 全局安装（需要 Node.js 18+）
 npm install -g @cannbot-ai/install-helper
@@ -271,7 +271,7 @@ install-helper 是一个编排工具：
 3. **缓存扫描结果**到 `~/.cannbot/scan-cache.json`（24 小时有效）
 4. **克隆或更新** cannbot-skills 仓库（缓存到 `~/.cannbot/repo/`）
 5. **备份现有配置**（如果检测到已安装的 AGENTS.md）
-6. **声明式安装**：优先读取插件的 `plugin-manifest.json`，通过 Node.js 原生引擎执行安装（创建 symlink、克隆外部仓库、写 manifest），无需 bash/sh；无 manifest 时 fallback 到 `init.sh` 脚本
+6. **声明式安装**：从 `plugins.d/*.yml` 读取安装清单（installSkills/installAgents/configFile/externalRepos），通过 Node.js 原生引擎执行安装（创建 symlink、克隆外部仓库、写 manifest），无需 bash/sh；无安装清单时 fallback 到 `init.sh` 脚本
 7. **追踪**安装状态（`~/.cannbot/config.yaml` + manifest）
 
 安装逻辑优先由 manifest 引擎（Node.js 原生，跨平台）负责，install-helper 提供统一的交互式入口和状态管理。

package/bin/install-helper.js

@@ -1,3 +1,13 @@
+// ----------------------------------------------------------------------------------------------------------
+// Copyright (c) 2026 Huawei Technologies Co., Ltd.
+// This program is free software, you can redistribute it and/or modify it under the terms and conditions of
+// CANN Open Software License Agreement Version 2.0 (the "License").
+// Please refer to the License for details. You may not use this file except in compliance with the License.
+// THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+// INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
+// See LICENSE in the root of the software repository for the full text of the License.
+// ----------------------------------------------------------------------------------------------------------
+
 #!/usr/bin/env node
 
 const { spawn } = require("child_process");

package/dist/index.js

@@ -586,6 +586,7 @@ var embedded_plugins_default = [
     description: "Ascend C \u76F4\u8C03\u5168\u6D41\u7A0B\uFF1A\u73AF\u5883\u2192\u8BBE\u8BA1\u2192\u5F00\u53D1\u2192\u5BA1\u67E5\u2192\u6027\u80FD\u9A8C\u6536",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: false,
     installSkills: [
       {
         dir: "ops",
@@ -626,7 +627,8 @@ var embedded_plugins_default = [
     externalRepos: [
       {
         url: "https://gitcode.com/cann/asc-devkit.git",
-        dir: "plugins-official/ops-direct-invoke/asc-devkit"
+        dir: "plugins-official/ops-direct-invoke/asc-devkit",
+        configRootLink: false
       }
     ]
   },
@@ -644,6 +646,7 @@ var embedded_plugins_default = [
     description: "\u4ECE\u6570\u5B66\u516C\u5F0F\u6216\u4EE3\u7801\u7247\u6BB5\u5FEB\u901F\u6784\u5EFA\u5E76\u9A8C\u8BC1 Ascend NPU \u6838\u51FD\u6570",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: true,
     installSkills: [
       {
         dir: "plugins-official/ops-direct-invoke-flash/skills",
@@ -687,6 +690,7 @@ var embedded_plugins_default = [
     description: "\u751F\u4EA7\u7EA7 ACLNN \u6CE8\u518C\u7B97\u5B50\u5168\u6D41\u7A0B\uFF1A\u4EE3\u7801\u2192UT/ST\u2192\u4E0A\u5E93",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: false,
     installSkills: [
       {
         dir: "ops",
@@ -741,7 +745,8 @@ var embedded_plugins_default = [
     externalRepos: [
       {
         url: "https://gitcode.com/cann/asc-devkit.git",
-        dir: "plugins-official/ops-registry-invoke/asc-devkit"
+        dir: "plugins-official/ops-registry-invoke/asc-devkit",
+        configRootLink: false
       }
     ]
   },
@@ -758,6 +763,7 @@ var embedded_plugins_default = [
     description: "Catlass \u6A21\u677F\u62FC\u88C5 GEMM/Matmul/Epilogue \u7B97\u5B50\u5F00\u53D1",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: true,
     installSkills: [
       {
         dir: "ops",
@@ -787,7 +793,8 @@ var embedded_plugins_default = [
     externalRepos: [
       {
         url: "https://gitcode.com/cann/asc-devkit.git",
-        dir: "plugins-official/catlass-op-generator/asc-devkit"
+        dir: "plugins-official/catlass-op-generator/asc-devkit",
+        configRootLink: false
       }
     ]
   },
@@ -806,6 +813,7 @@ var embedded_plugins_default = [
     description: "NPU \u6A21\u578B\u63A8\u7406\u7AEF\u5230\u7AEF\u4F18\u5316\uFF08\u5E76\u884C/KVCache/\u878D\u5408/\u91CF\u5316/\u56FE\u6A21\u5F0F/\u591A\u6D41/SuperKernel\uFF09",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: true,
     installSkills: [
       {
         dir: "model",
@@ -834,7 +842,8 @@ var embedded_plugins_default = [
       {
         url: "https://gitcode.com/cann/cann-recipes-infer.git",
         dir: "plugins-official/model-infer-optimize/cann-recipes-infer",
-        depth: 1
+        depth: 1,
+        configRootLink: true
       }
     ]
   },
@@ -852,6 +861,7 @@ var embedded_plugins_default = [
     description: "PyPTO Python API \u7B97\u5B50\u5168\u6D41\u7A0B\u5F00\u53D1\uFF0C\u8986\u76D6\u9700\u6C42\u7406\u89E3\u3001API \u63A2\u7D22\u3001\u5B9E\u73B0\u4E0E\u8C03\u4F18",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: false,
     installSkills: [
       {
         dir: "ops",
@@ -875,7 +885,8 @@ var embedded_plugins_default = [
     externalRepos: [
       {
         url: "https://gitcode.com/cann/pypto.git",
-        dir: "plugins-official/pypto-op-orchestrator/pypto"
+        dir: "plugins-official/pypto-op-orchestrator/pypto",
+        configRootLink: false
       }
     ]
   },
@@ -892,6 +903,7 @@ var embedded_plugins_default = [
     description: "TileLang Python DSL + @tilelang.jit \u7B97\u5B50\u5F00\u53D1\uFF08\u652F\u6301 Developer/Expert \u53CC\u6A21\u5F0F\uFF09",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: false,
     installSkills: [
       {
         dir: "ops",
@@ -918,7 +930,8 @@ var embedded_plugins_default = [
         url: "https://github.com/tile-ai/tilelang-ascend.git",
         dir: "plugins-official/tilelang-op-orchestrator/tilelang-ascend",
         depth: 1,
-        recursive: true
+        recursive: true,
+        configRootLink: false
       }
     ]
   },
@@ -935,6 +948,7 @@ var embedded_plugins_default = [
     description: "Triton-Ascend \u7B97\u5B50 6 \u9636\u6BB5\u81EA\u52A8\u751F\u6210\u4E0E\u4F18\u5316\uFF08\u63CF\u8FF0\u2192\u4EE3\u7801\u2192\u9A8C\u8BC1\u2192\u4F18\u5316\uFF09",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: false,
     installSkills: [
       {
         dir: "ops",
@@ -965,6 +979,7 @@ var embedded_plugins_default = [
     description: "NPU \u56FE\u6A21\u5F0F npugraph_ex \u914D\u7F6E\u3001\u811A\u672C\u8FC1\u79FB\u3001\u7F16\u8BD1\u8BCA\u65AD\u4E0E\u81EA\u5B9A\u4E49\u7B97\u5B50\u5165\u56FE",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: true,
     installSkills: [
       {
         dir: "graph",
@@ -997,6 +1012,7 @@ var embedded_plugins_default = [
     description: "Ascend C \u7B97\u5B50\u4EE3\u7801 4 \u9636\u6BB5\u5168\u91CF\u68C0\u89C6\uFF08\u4E3B Agent \u7F16\u6392 + \u5B50 Agent \u5E76\u884C\u68C0\u89C6\uFF09",
     version: "1.2.2",
     configFile: "AGENTS.md",
+    configRootConfigLink: false,
     installSkills: [
       {
         dir: "ops",
@@ -1056,6 +1072,7 @@ function loadPluginsFromYaml() {
           description: content.description || "",
           version: content.version,
           configFile: content.configFile,
+          configRootConfigLink: content.configRootConfigLink,
           installSkills: content.installSkills,
           installAgents: content.installAgents,
           externalRepos: content.externalRepos
@@ -2706,7 +2723,7 @@ function installLink(source, target) {
     return "failed";
   }
 }
-function installConfigFile(pluginDir, configFile, tool, level, configRoot, installPath) {
+function installConfigFile(pluginDir, configFile, tool, level, configRoot, installPath, configRootConfigLink) {
   const sourcePath = join11(pluginDir, configFile);
   if (!existsSync12(sourcePath)) return;
   const agentsFileName = getAgentsFileName(tool);
@@ -2730,6 +2747,7 @@ function installConfigFile(pluginDir, configFile, tool, level, configRoot, insta
     }
   }
   if (isProjectLevel && primaryTarget !== join11(configRoot, agentsFileName)) {
+    if (configRootConfigLink === false) return;
     const configRootTarget = join11(configRoot, agentsFileName);
     if (existsSync12(configRootTarget) || isSymlink(configRootTarget)) {
       unlinkSync4(configRootTarget);
@@ -2765,20 +2783,23 @@ async function installExternalRepos(repos, repoPath, configRoot, installPath, le
     }
     const linkName = basename(repo.dir);
     const resolved = realpathSync(targetDir);
-    const configRootLink = join11(configRoot, linkName);
-    try {
-      if (existsSync12(configRootLink) || isSymlink(configRootLink)) {
-        unlinkSync4(configRootLink);
-      }
+    const shouldConfigRootLink = repo.configRootLink !== false && (level === "global" || repo.configRootLink === true);
+    if (shouldConfigRootLink) {
+      const configRootLink = join11(configRoot, linkName);
       try {
-        symlinkSync(resolved, configRootLink);
-      } catch (e) {
-        if (e.code === "EPERM") {
-          cpSync(resolved, configRootLink, { recursive: true });
+        if (existsSync12(configRootLink) || isSymlink(configRootLink)) {
+          unlinkSync4(configRootLink);
+        }
+        try {
+          symlinkSync(resolved, configRootLink);
+        } catch (e) {
+          if (e.code === "EPERM") {
+            cpSync(resolved, configRootLink, { recursive: true });
+          }
         }
+      } catch {
+        logger.warn(`  Failed to link ${linkName} to config directory`);
       }
-    } catch {
-      logger.warn(`  Failed to link ${linkName} to config directory`);
     }
     if (level === "project") {
       const projectLink = join11(installPath, linkName);
@@ -2884,7 +2905,7 @@ async function installViaManifest(plugin, repoPath, tool, level, installPath) {
         logger.warn(`  Failed to install agent: ${agentFile}`);
       }
     }
-    installConfigFile(pluginDir, plugin.configFile || "AGENTS.md", tool, level, configRoot, cwd);
+    installConfigFile(pluginDir, plugin.configFile || "AGENTS.md", tool, level, configRoot, cwd, plugin.configRootConfigLink);
     installWorkflows(pluginDir, configRoot);
     await installExternalRepos(plugin.externalRepos, repoPath, configRoot, cwd, level);
     const cannbotManifest = writeCannbotManifest(