@cannbot-ai/install-helper 0.0.2-beta.6 → 0.0.2-beta.61

package/README.md

@@ -8,15 +8,63 @@
 ## 快速开始
 
 ```bash
-# 全局安装（推荐）
+# Linux/macOS 一键安装（零依赖，无需 Node.js）
+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@latest/dist/install.ps1 | iex
+
+# 或通过 npm 全局安装（需要 Node.js 18+）
 npm install -g @cannbot-ai/install-helper
 install-helper
 
-# 或 npx 即用（无需安装）
+# 或 npx 即用（无需安装，需要 Node.js 18+）
 npx @cannbot-ai/install-helper
 ```
 
-交互式向导会自动检测已安装的 AI 编程工具（OpenCode / Claude Code / Trae / Cursor），通过箭头键选择场景即可完成安装。
+curl 和 PowerShell 方式从 npm registry 下载预编译二进制（Bun 编译的独立可执行文件），无需 Node.js、无需 npm。安装后 `install-helper` 命令可直接使用。
+
+交互式向导会自动检测已安装的 AI 编程工具（OpenCode / Claude Code / Trae / Cursor / GitHub Copilot），通过箭头键选择场景即可完成安装。
+
+## 一键安装所有 Skills
+
+如果 AI 编程工具已安装，可直接一键安装全部 Skills（无需逐个点选）。支持所有工具（opencode / claude / trae / cursor / copilot）：
+
+```bash
+# 一键安装全部 Skills 到当前项目（跳过确认）
+install-helper install --all --tool opencode --yes
+
+# 一键安装全部 Skills 到全局
+install-helper install --all --tool opencode --level global --yes
+
+# 指定其他 AI 工具
+install-helper install --all --tool claude --yes
+install-helper install --all --tool trae --yes
+
+# 不指定 --tool，交互式选择工具
+install-helper install --all --yes
+```
+
+> 交互式向导也支持「全选所有 Skills」和「全选当前类别」，详见下文。
+
+## 主要特性
+
+### 核心功能
+- **动态 Skill 发现**：自动扫描仓库中的 SKILL.md 文件，实时发现可用 Skills
+- **智能缓存机制**：扫描结果缓存 24 小时，大幅提升后续命令执行速度
+- **备份与恢复**：安装新插件时自动备份 AGENTS.md，支持一键恢复
+- **参数校验**：`--tool` 和 `--level` 参数支持校验，提供友好的错误提示（支持中英文）
+- **智能记忆**：记住上次选择的工具和安装级别，下次运行自动填充
+
+### 安装管理
+- **交互式向导**：箭头键选择，空格切换，回车确认
+- **列表排序**：插件和 Skills 列表按名称升序排列
+- **描述聚焦**：光标聚焦某项时，下方以青色 + 💡 前缀显示详细描述，支持中文自适应换行
+- **批量选择**：支持全选所有 Skills、全选当前类别、跨类别累积选择
+- **插件安装**：支持 10 个官方插件，自动处理依赖
+- **Skill 安装**：支持 91 个 Skills，按 11 个类别组织
+- **智能卸载**：根据安装记录精确删除，自动清理空目录
+- **健康检查**：检测安装状态，自动修复常见问题
 
 ## 命令一览
 
@@ -26,6 +74,7 @@ npx @cannbot-ai/install-helper
 | `install-helper list` | 列出可用场景及安装状态 |
 | `install-helper install <name>` | 安装指定插件或 Skill（自动识别） |
 | `install-helper install --list` | 按类别列出所有可用 Skills |
+| `install-helper install --all --tool <tool> --yes` | 一键安装全部 Skills |
 | `install-helper update [plugin]` | 更新已安装的 Skills |
 | `install-helper uninstall <plugin>` | 卸载指定场景 |
 | `install-helper status` | 查看已安装插件详情 |
@@ -46,10 +95,13 @@ install-helper init
 ```
 
 向导会引导你完成：
-1. 自动检测已安装的 AI 编程工具
-2. 选择安装级别（project / global）
-3. 多选要安装的场景（空格切换，回车确认）
-4. 确认并执行安装
+1. 选择安装类型（Plugin 完整工作流 / Skill 轻量知识）
+2. 自动检测已安装的 AI 编程工具
+3. 选择安装级别（project / global）
+4. 多选要安装的插件或 Skills（空格切换，回车确认）
+5. 确认并执行安装
+
+**列表展示**：插件和 Skill 列表均按名称升序排列。光标聚焦某项时，下方会以青色 + 💡 前缀显示该项的详细描述，支持中文自适应换行。
 
 **智能记忆**：向导会记住你上次选择的工具和级别，下次运行无需重新选择。已安装的插件会自动标记并默认不勾选。
 
@@ -64,11 +116,7 @@ install-helper install ops-direct-invoke --level global  # 全局安装
 
 **重要说明**：
 
-每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。
-
-**推荐做法**：
-- 每个项目只安装一个插件
-- 如需使用多个插件，在不同目录下分别安装
+每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。建议每个项目只安装一个插件，如需使用多个插件，在不同目录下分别安装。
 
 **示例**：
 ```bash
@@ -81,8 +129,6 @@ cd project-b
 install-helper install triton --tool opencode
 ```
 
-> **注意**：每个插件有独立的 `AGENTS.md` 配置文件。同一项目目录下安装多个插件时，后安装的会覆盖前一个的 `AGENTS.md`。如需同时使用多个插件，建议分别在不同项目目录中安装。
-
 ### 安装单个 Skill（轻量模式）
 
 如果只需要让 AI agent 掌握特定领域知识，不需要完整工作流，可以直接安装单个 Skill：
@@ -94,18 +140,25 @@ install-helper install model-infer-kvcache               # 安装 KVCache 优化
 install-helper install --list                            # 查看所有可用 Skills
 ```
 
-Skills 按 11 个大类组织：知识与参考、环境与工具、调试与诊断、测试与质量、AscendC 开发、PyPTO 开发、TileLang 开发、Triton 开发、模型推理优化、图模式、平台工具。
+Skills 按 11 个大类组织（另有「其他」兜底类别）：知识与参考、环境与工具、调试与诊断、测试与质量、AscendC 开发、PyPTO 开发、TileLang 开发、Triton 开发、模型推理优化、图模式、平台工具。
 
 `install` 命令自动识别输入是插件还是 Skill，无需区分。
 
+**交互式批量选择**：运行 `install-helper install`（不带参数）进入交互式选择时，支持以下批量操作：
+
+- **全选所有 Skills**：类别列表顶部有「全选所有 Skills（共 N 个）」，选中即一键安装全部。
+- **全选当前类别**：进入某类别后，顶部有「全选当前类别」，勾选后回车即选中该类别全部 Skills。
+- **跨类别累积选择**：选完一个类别后，可选择「继续选择其他类别」，已选 Skills 会保留累积，不丢失。类别列表中实时显示「确认安装（已选 N 个 Skills）」快捷入口，随时可确认安装。
+- **单选/多选**：在类别内用空格勾选任意多个 Skills，回车确认。
+
 **选项：**
 
 | 选项 | 说明 |
 |------|------|
 | `--tool <tool>` | 指定 AI 工具（opencode, claude, trae, cursor, copilot） |
 | `--level <level>` | 安装级别（project, global），默认 project |
-| `--all` | 安装全部场景 |
-| `--yes` | 跳过所有确认提示 |
+| `--all` `-a` | 安装全部 Skills（一键安装） |
+| `--yes` `-y` | 跳过所有确认提示 |
 
 **已装检测**：如果插件已安装，会提示是否覆盖安装。使用 `--yes` 可跳过提示直接覆盖。
 
@@ -168,41 +221,67 @@ install-helper uninstall ops-direct-invoke --tool opencode
 
 ## 可用场景
 
+install-helper 支持 **10 个官方插件** 和 **91 个 Skills**（动态发现，数量可能随仓库更新而变化）。
+
+#### 官方插件
+
 | # | 场景 | ID | 别名 |
 |---|------|----|------|
-| 1 | AscendC Kernel 直调 | ops-direct-invoke | ops-direct, direct, kernel |
-| 2 | AscendC Kernel 从零构建 | ops-direct-invoke-flash | flash |
-| 3 | AscendC 算子注册调用 | ops-registry-invoke | ops-registry, registry |
-| 4 | PyPTO 算子 | pypto-op-orchestrator | pypto |
-| 5 | Triton 算子生成 | triton-op-generator | triton |
-| 6 | TileLang 算子 | tilelang-op-orchestrator | tilelang |
-| 7 | NPU 推理优化 | model-infer-optimize | model-infer, infer |
-| 8 | Catlass 算子直调 | catlass-op-generator | catlass |
-| 9 | 代码检视 | ops-code-reviewer | code-review, reviewer |
-| 10 | torch.compile 图模式 | torch-compile | torch, compile |
+| 1 | AscendC Kernel 直调 | ops-direct-invoke | ops-direct, ascendc-direct, direct, kernel |
+| 2 | AscendC Kernel 直调（快速版） | ops-direct-invoke-flash | flash, kernel-flash |
+| 3 | AscendC 算子注册调用 | ops-registry-invoke | ops-registry, ascendc-registry, registry |
+| 4 | Catlass 算子直调 | catlass-op-generator | catlass |
+| 5 | NPU 推理优化 | model-infer-optimize | model-infer, infer, inference |
+| 6 | PyPTO 算子开发 | pypto-op-orchestrator | pypto, pytorch |
+| 7 | TileLang 算子开发 | tilelang-op-orchestrator | tilelang |
+| 8 | Triton 算子开发 | triton-op-generator | triton |
+| 9 | torch.compile 图模式 | torch-compile | torch, compile, graph |
+| 10 | 代码检视 | ops-code-reviewer | code-review, reviewer, review |
+
+#### Skills 类别
+
+Skills 按 11 个类别组织（另有「其他」兜底类别，动态发现，数量可能随仓库更新而变化）：
+- 知识与参考
+- 环境与工具
+- 调试与诊断
+- 测试与质量
+- AscendC 开发
+- PyPTO 开发
+- TileLang 开发
+- Triton 开发
+- 模型推理优化
+- 图模式
+- 平台工具
+- 其他 Skills
+
+使用 `install-helper install --list` 查看完整的 Skills 列表。
 
 ## 前置条件
 
-- Node.js >= 18
-- 已安装至少一个 AI 编程工具（OpenCode / Claude Code / Trae / Cursor）
+- 已安装至少一个 AI 编程工具（OpenCode / Claude Code / Trae / Cursor / GitHub Copilot）
 - Git（用于克隆 Skills 仓库）
+- curl/PowerShell 方式无需 Node.js；npm/npx 方式需要 Node.js >= 18
 
 ## 工作原理
 
 install-helper 是一个编排工具：
 
 1. **自动检测**已安装的 AI 编程工具
-2. **克隆或更新** cannbot-skills 仓库（缓存到 `~/.cannbot/repo/`）
-3. **调用**各插件的 `init.sh` / `install.sh` 脚本执行实际安装
-4. **追踪**安装状态（`~/.cannbot/config.yaml` + manifest）
+2. **动态扫描**仓库中的 SKILL.md 文件，发现可用 Skills
+3. **缓存扫描结果**到 `~/.cannbot/scan-cache.json`（24 小时有效）
+4. **克隆或更新** cannbot-skills 仓库（缓存到 `~/.cannbot/repo/`）
+5. **备份现有配置**（如果检测到已安装的 AGENTS.md）
+6. **声明式安装**：从 `plugins.d/*.yml` 读取安装清单（installSkills/installAgents/configFile/externalRepos），通过 Node.js 原生引擎执行安装（创建 symlink、克隆外部仓库、写 manifest），无需 bash/sh；无安装清单时 fallback 到 `init.sh` 脚本
+7. **追踪**安装状态（`~/.cannbot/config.yaml` + manifest）
 
-安装逻辑仍由各插件的 init.sh 脚本负责，install-helper 提供统一的交互式入口和状态管理。
+安装逻辑优先由 manifest 引擎（Node.js 原生，跨平台）负责，install-helper 提供统一的交互式入口和状态管理。
 
 ## 配置文件
 
-配置保存在 `~/.cannbot/config.yaml`：
+配置保存在 `~/.cannbot/` 目录：
 
 ```yaml
+# config.yaml - 用户配置
 language: zh_CN           # 界面语言
 lastTool: opencode        # 上次使用的 AI 工具
 lastLevel: project        # 上次安装级别
@@ -211,11 +290,31 @@ installedPlugins:         # 已安装的插件列表
   - pypto-op-orchestrator
 ```
 
+```json
+// scan-cache.json - 扫描缓存（自动生成，24 小时有效）
+{
+  "skills": [...],
+  "repoCommit": "a1b2c3d4e5f6...",
+  "timestamp": 1234567890
+}
+```
+
+```json
+// installs/<plugin>.json - 安装记录（每个插件一个文件）
+{
+  "pluginId": "ops-direct-invoke",
+  "installTime": "2026-06-23T10:00:00Z",
+  "configRoot": "/path/to/config",
+  "files": [...],
+  "directories": [...]
+}
+```
+
 ## 开发
 
 ```bash
 git clone https://gitcode.com/cann/cannbot-skills.git
-cd cannbot-skills/packages/install-helper
+cd cannbot-skills/plugins-community/install-helper
 
 npm install
 npm run dev          # watch 模式

package/bin/install-helper.js

@@ -0,0 +1,59 @@
+// ----------------------------------------------------------------------------------------------------------
+// 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");
+const { existsSync } = require("fs");
+const { join, dirname } = require("path");
+
+const PLATFORM_MAP = {
+  "linux-x64": "@cannbot-ai/install-helper-linux-x64",
+  "linux-arm64": "@cannbot-ai/install-helper-linux-arm64",
+  "darwin-x64": "@cannbot-ai/install-helper-darwin-x64",
+  "darwin-arm64": "@cannbot-ai/install-helper-darwin-arm64",
+  "win32-x64": "@cannbot-ai/install-helper-windows-x64",
+};
+
+const key = `${process.platform}-${process.arch}`;
+const pkgName = PLATFORM_MAP[key];
+const binaryName = process.platform === "win32" ? "install-helper.exe" : "install-helper";
+const args = process.argv.slice(2);
+
+if (pkgName) {
+  try {
+    const pkgPath = require.resolve(`${pkgName}/package.json`);
+    const binaryPath = join(dirname(pkgPath), binaryName);
+    if (existsSync(binaryPath)) {
+      const child = spawn(binaryPath, args, { stdio: "inherit" });
+      child.on("exit", (code, signal) => { process.exit(code ?? (signal ? 1 : 0)); });
+      child.on("error", () => runJSFallback());
+      return;
+    }
+  } catch {}
+}
+
+runJSFallback();
+
+function runJSFallback() {
+  const jsPath = join(__dirname, "..", "dist", "index.js");
+  if (existsSync(jsPath)) {
+    const child = spawn(process.execPath, [jsPath, ...args], { stdio: "inherit" });
+    child.on("exit", (code, signal) => { process.exit(code ?? (signal ? 1 : 0)); });
+    child.on("error", () => {
+      console.error("install-helper: failed to run");
+      process.exit(1);
+    });
+    return;
+  }
+  console.error(`install-helper binary not found for ${key}`);
+  console.error("Try: npm install -g @cannbot-ai/install-helper");
+  process.exit(1);
+}

package/bin/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/config/repository.yaml

@@ -0,0 +1,28 @@
+# ----------------------------------------------------------------------------------------------------------
+# 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.
+# ----------------------------------------------------------------------------------------------------------
+
+# Default configuration for install-helper
+repository:
+  url: "https://gitcode.com/yanhf/cann_skills.git"
+  name: "cannbot-skills"
+
+scanDirs:
+  - ops
+  - model
+  - graph
+  - infra
+  - ops-lab
+  - runtime
+
+pluginDirs:
+  - plugins-official
+  - plugins-community
+
+scanCacheTtlHours: 24