@cannbot-ai/install-helper 1.0.7 → 1.1.2

package/README.md

@@ -3,77 +3,58 @@
 > CANNBot Install Helper — CANNBot 交互式安装助手
 
 [![npm version](https://img.shields.io/npm/v/@cannbot-ai/install-helper.svg)](https://www.npmjs.com/package/@cannbot-ai/install-helper)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
 
 ## 快速开始
 
-```bash
-# 全局安装（推荐）
-npm install -g @cannbot-ai/install-helper
-install-helper
+### Linux / macOS
 
-# 或 npx 即用（无需安装）
-npx @cannbot-ai/install-helper
+```bash
+curl -fsSL https://raw.gitcode.com/cann/cannbot-skills/raw/master/install.sh | bash
 ```
 
-交互式向导会自动检测已安装的 AI 编程工具（OpenCode / Claude Code / Trae / Cursor / GitHub Copilot），通过箭头键选择场景即可完成安装。
+### Windows
 
-## 一键安装所有 Skills
+```powershell
+irm https://cdn.jsdelivr.net/npm/@cannbot-ai/install-helper@latest/dist/install.ps1 | iex
+```
 
-如果 AI 编程工具已安装，可直接一键安装全部 Skills（无需逐个点选）。支持所有工具（opencode / claude / trae / cursor / copilot）：
+### npm（全平台，需要 Node.js 18+）
 
 ```bash
-# 一键安装全部 Skills 到当前项目（跳过确认）
-install-helper install --all --tool opencode --yes
-
-# 一键安装全部 Skills 到全局
-install-helper install --all --tool opencode --level global --yes
+npm install -g @cannbot-ai/install-helper
+```
 
-# 指定其他 AI 工具
-install-helper install --all --tool claude --yes
-install-helper install --all --tool trae --yes
+> 也可以免安装直接运行：`npx @cannbot-ai/install-helper`
 
-# 不指定 --tool，交互式选择工具
-install-helper install --all --yes
-```
+---
 
-> 交互式向导也支持「全选所有 Skills」和「全选当前类别」，详见下文。
+安装完成后运行 `install-helper` 启动向导。
 
-## 主要特性
+## 一键安装所有 Skills
 
-### 核心功能
-- **动态 Skill 发现**：自动扫描仓库中的 SKILL.md 文件，实时发现可用 Skills
-- **智能缓存机制**：扫描结果缓存 24 小时，大幅提升后续命令执行速度
-- **备份与恢复**：安装新插件时自动备份 AGENTS.md，支持一键恢复
-- **参数校验**：`--tool` 和 `--level` 参数支持校验，提供友好的错误提示（支持中英文）
-- **智能记忆**：记住上次选择的工具和安装级别，下次运行自动填充
+```bash
+# 安装全部 Skills 到当前项目
+install-helper install --all --tool opencode --yes
 
-### 安装管理
-- **交互式向导**：箭头键选择，空格切换，回车确认
-- **列表排序**：插件和 Skills 列表按名称升序排列
-- **描述聚焦**：光标聚焦某项时，下方以青色 + 💡 前缀显示详细描述，支持中文自适应换行
-- **批量选择**：支持全选所有 Skills、全选当前类别、跨类别累积选择
-- **插件安装**：支持 10 个官方插件，自动处理依赖
-- **Skill 安装**：支持 91 个 Skills，按 11 个类别组织
-- **智能卸载**：根据安装记录精确删除，自动清理空目录
-- **健康检查**：检测安装状态，自动修复常见问题
+# 安装全部 Skills 到全局
+install-helper install --all --tool opencode --level global --yes
+```
 
 ## 命令一览
 
 | 命令 | 说明 |
 |------|------|
-| `install-helper` / `install-helper init` | 交互式安装向导 |
+| `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 update [plugin]` | 更新已安装的插件 |
+| `install-helper uninstall <plugin>` | 卸载指定插件 |
 | `install-helper status` | 查看已安装插件详情 |
 | `install-helper doctor` | 健康检查 |
 | `install-helper doctor --fix` | 健康检查 + 自动修复 |
 | `install-helper info <plugin>` | 查看插件详情 |
-| `install-helper lang show` | 显示当前语言 |
 | `install-helper lang set en_US` | 切换语言 |
 
 ## 命令详解
@@ -82,22 +63,13 @@ install-helper install --all --yes
 
 ```bash
 install-helper
-# 或
-install-helper init
 ```
 
-向导会引导你完成：
-1. 选择安装类型（Plugin 完整工作流 / Skill 轻量知识）
-2. 自动检测已安装的 AI 编程工具
-3. 选择安装级别（project / global）
-4. 多选要安装的插件或 Skills（空格切换，回车确认）
-5. 确认并执行安装
+向导引导：选择类型（Plugin/Skill）→ 检测工具 → 选择位置 → 选择插件/Skill → 确认安装。
 
-**列表展示**：插件和 Skill 列表均按名称升序排列。光标聚焦某项时，下方会以青色 + 💡 前缀显示该项的详细描述，支持中文自适应换行。
+已安装的插件会自动标记，上次选择的工具和级别会被记住。
 
-**智能记忆**：向导会记住你上次选择的工具和级别，下次运行无需重新选择。已安装的插件会自动标记并默认不勾选。
-
-### 安装指定场景
+### 安装指定插件
 
 ```bash
 install-helper install ops-direct-invoke              # 安装单个
@@ -106,42 +78,19 @@ install-helper install ops-direct-invoke --yes        # 跳过确认
 install-helper install ops-direct-invoke --level global  # 全局安装
 ```
 
-**重要说明**：
+> 每个插件有独立的 `AGENTS.md`，建议每个项目只安装一个插件。
 
-每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。建议每个项目只安装一个插件，如需使用多个插件，在不同目录下分别安装。
-
-**示例**：
-```bash
-# 项目 A：使用 Kernel 直调
-cd project-a
-install-helper install ops-direct-invoke --tool opencode
-
-# 项目 B：使用 Triton
-cd project-b
-install-helper install triton --tool opencode
-```
-
-### 安装单个 Skill（轻量模式）
-
-如果只需要让 AI agent 掌握特定领域知识，不需要完整工作流，可以直接安装单个 Skill：
+### 安装单个 Skill
 
 ```bash
 install-helper install npu-arch                          # 安装 NPU 架构知识
 install-helper install ascendc-precision-debug           # 安装精度调试技能
-install-helper install model-infer-kvcache               # 安装 KVCache 优化技能
 install-helper install --list                            # 查看所有可用 Skills
 ```
 
-Skills 按 11 个大类组织（另有「其他」兜底类别）：知识与参考、环境与工具、调试与诊断、测试与质量、AscendC 开发、PyPTO 开发、TileLang 开发、Triton 开发、模型推理优化、图模式、平台工具。
-
-`install` 命令自动识别输入是插件还是 Skill，无需区分。
+`install` 命令自动识别输入是插件还是 Skill。
 
-**交互式批量选择**：运行 `install-helper install`（不带参数）进入交互式选择时，支持以下批量操作：
-
-- **全选所有 Skills**：类别列表顶部有「全选所有 Skills（共 N 个）」，选中即一键安装全部。
-- **全选当前类别**：进入某类别后，顶部有「全选当前类别」，勾选后回车即选中该类别全部 Skills。
-- **跨类别累积选择**：选完一个类别后，可选择「继续选择其他类别」，已选 Skills 会保留累积，不丢失。类别列表中实时显示「确认安装（已选 N 个 Skills）」快捷入口，随时可确认安装。
-- **单选/多选**：在类别内用空格勾选任意多个 Skills，回车确认。
+交互式选择时支持：全选所有 Skills、全选当前类别、跨类别累积选择。
 
 **选项：**
 
@@ -149,27 +98,23 @@ Skills 按 11 个大类组织（另有「其他」兜底类别）：知识与参
 |------|------|
 | `--tool <tool>` | 指定 AI 工具（opencode, claude, trae, cursor, copilot） |
 | `--level <level>` | 安装级别（project, global），默认 project |
-| `--all` `-a` | 安装全部 Skills（一键安装） |
+| `--all` `-a` | 安装全部 Skills |
 | `--yes` `-y` | 跳过所有确认提示 |
 
-**已装检测**：如果插件已安装，会提示是否覆盖安装。使用 `--yes` 可跳过提示直接覆盖。
-
-### 更新已安装的 Skills
+### 更新
 
 ```bash
 install-helper update              # 更新所有已安装插件
 install-helper update triton       # 更新指定插件
 ```
 
-更新流程：`git pull` 拉取最新 Skills 仓库 → 重新执行安装脚本 → 软链接自动指向最新内容。
-
-### 查看插件详情
+### 卸载
 
 ```bash
-install-helper info ops-direct-invoke
+install-helper uninstall ops-direct-invoke --tool opencode
 ```
 
-输出插件描述、包含的 Skills/Agents 列表、quickstart 文档路径、安装状态。
+根据安装记录精确删除所有产物，自动清理空目录。
 
 ### 健康检查
 
@@ -178,44 +123,14 @@ install-helper doctor              # 仅检测
 install-helper doctor --fix        # 检测 + 自动修复
 ```
 
-检查项目：
-- AI 工具安装状态
-- 已安装插件状态
-- 软链接完整性
-- 配置文件存在性
-
-`--fix` 会自动修复：清理失效软链接、重建缺失目录。
-
 ### 语言管理
 
 ```bash
 install-helper lang show           # 显示当前语言
-install-helper lang set zh_CN      # 设置为中文（默认）
-install-helper lang set en_US      # 设置为英文
+install-helper lang set en_US      # 切换为英文
 ```
 
-语言设置保存在 `~/.cannbot/config.yaml`，重启后自动生效。
-
-### 卸载
-
-```bash
-install-helper uninstall ops-direct-invoke --tool opencode
-```
-
-卸载时根据安装记录（`~/.cannbot/installs/<plugin>.json`）精确删除所有安装产物：
-- Skills 软链接
-- Agents 软链接
-- Workflows 链接
-- 配置文件（AGENTS.md / CLAUDE.md）
-- Manifest 文件
-- 参考仓库链接（asc-devkit 等）
-- 空目录清理
-
-## 可用场景
-
-install-helper 支持 **10 个官方插件** 和 **91 个 Skills**（动态发现，数量可能随仓库更新而变化）。
-
-#### 官方插件
+## 可用插件
 
 | # | 场景 | ID | 别名 |
 |---|------|----|------|
@@ -230,78 +145,11 @@ install-helper 支持 **10 个官方插件** 和 **91 个 Skills**（动态发
 | 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 / GitHub Copilot）
 - Git（用于克隆 Skills 仓库）
 
-## 工作原理
-
-install-helper 是一个编排工具：
-
-1. **自动检测**已安装的 AI 编程工具
-2. **动态扫描**仓库中的 SKILL.md 文件，发现可用 Skills
-3. **缓存扫描结果**到 `~/.cannbot/scan-cache.json`（24 小时有效）
-4. **克隆或更新** cannbot-skills 仓库（缓存到 `~/.cannbot/repo/`）
-5. **备份现有配置**（如果检测到已安装的 AGENTS.md）
-6. **调用**各插件的 `init.sh` / `install.sh` 脚本执行实际安装
-7. **追踪**安装状态（`~/.cannbot/config.yaml` + manifest）
-
-安装逻辑仍由各插件的 init.sh 脚本负责，install-helper 提供统一的交互式入口和状态管理。
-
-## 配置文件
-
-配置保存在 `~/.cannbot/` 目录：
-
-```yaml
-# config.yaml - 用户配置
-language: zh_CN           # 界面语言
-lastTool: opencode        # 上次使用的 AI 工具
-lastLevel: project        # 上次安装级别
-installedPlugins:         # 已安装的插件列表
-  - ops-direct-invoke
-  - 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
@@ -314,5 +162,3 @@ npm run build        # 构建
 npm link             # 全局注册
 install-helper list  # 测试
 ```
-
-

package/bin/install-helper.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// ----------------------------------------------------------------------------------------------------------
+// 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.
+// ----------------------------------------------------------------------------------------------------------
+
+
+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

@@ -19,7 +19,10 @@ scanDirs:
   - graph
   - infra
   - ops-lab
+  - runtime
 
 pluginDirs:
   - plugins-official
   - plugins-community
+
+scanCacheTtlHours: 24