@cannbot-ai/install-helper 0.0.2-beta.2 → 0.0.2-beta.20

package/README.md

@@ -18,6 +18,36 @@ npx @cannbot-ai/install-helper
 
 交互式向导会自动检测已安装的 AI 编程工具（OpenCode / Claude Code / Trae / Cursor），通过箭头键选择场景即可完成安装。
 
+## 一键安装所有 Skills
+
+如果 opencode 等工具已安装，可直接一键安装全部 Skills（无需逐个点选）：
+
+```bash
+# 一键安装全部 Skills 到当前项目（跳过确认）
+install-helper install --all --tool opencode --yes
+
+# 一键安装全部 Skills 到全局
+install-helper install --all --tool opencode --level global --yes
+```
+
+> 交互式向导也支持「全选所有 Skills」和「全选当前类别」，详见下文。
+
+## 主要特性
+
+### 核心功能
+- **动态 Skill 发现**：自动扫描仓库中的 SKILL.md 文件，实时发现可用 Skills
+- **智能缓存机制**：扫描结果缓存 24 小时，大幅提升后续命令执行速度
+- **备份与恢复**：安装新插件时自动备份 AGENTS.md，支持一键恢复
+- **参数校验**：`--tool` 和 `--level` 参数支持校验，提供友好的错误提示（支持中英文）
+- **智能记忆**：记住上次选择的工具和安装级别，下次运行自动填充
+
+### 安装管理
+- **交互式向导**：箭头键选择，空格切换，回车确认
+- **插件安装**：支持 10 个官方插件，自动处理依赖
+- **Skill 安装**：支持 89 个 Skills，按 11 个类别组织
+- **智能卸载**：根据安装记录精确删除，自动清理空目录
+- **健康检查**：检测安装状态，自动修复常见问题
+
 ## 命令一览
 
 | 命令 | 说明 |
@@ -26,6 +56,7 @@ npx @cannbot-ai/install-helper
 | `install-helper list` | 列出可用场景及安装状态 |
 | `install-helper install <name>` | 安装指定插件或 Skill（自动识别） |
 | `install-helper install --list` | 按类别列出所有可用 Skills |
+| `install-helper install --all --tool opencode --yes` | 一键安装全部 Skills |
 | `install-helper update [plugin]` | 更新已安装的 Skills |
 | `install-helper uninstall <plugin>` | 卸载指定场景 |
 | `install-helper status` | 查看已安装插件详情 |
@@ -98,14 +129,19 @@ Skills 按 11 个大类组织：知识与参考、环境与工具、调试与诊
 
 `install` 命令自动识别输入是插件还是 Skill，无需区分。
 
+**交互式「全选」**：运行 `install-helper install`（不带参数）进入交互式选择时：
+- 类别列表顶部有 **「全选所有 Skills」**，选中即一键安装全部 Skills。
+- 进入某类别后，顶部有 **「全选当前类别」**，勾选后回车即选中该类别全部 Skills。
+- 选完一个类别后会提示「继续选择其他类别 / 确认安装」，可跨类别累积选择后再统一安装。
+
 **选项：**
 
 | 选项 | 说明 |
 |------|------|
 | `--tool <tool>` | 指定 AI 工具（opencode, claude, trae, cursor, copilot） |
 | `--level <level>` | 安装级别（project, global），默认 project |
-| `--all` | 安装全部场景 |
-| `--yes` | 跳过所有确认提示 |
+| `--all` `-a` | 安装全部 Skills（一键安装） |
+| `--yes` `-y` | 跳过所有确认提示 |
 
 **已装检测**：如果插件已安装，会提示是否覆盖安装。使用 `--yes` 可跳过提示直接覆盖。
 
@@ -168,6 +204,10 @@ install-helper uninstall ops-direct-invoke --tool opencode
 
 ## 可用场景
 
+install-helper 支持 **10 个官方插件** 和 **89 个 Skills**（动态发现，数量可能随仓库更新而变化）。
+
+#### 官方插件
+
 | # | 场景 | ID | 别名 |
 |---|------|----|------|
 | 1 | AscendC Kernel 直调 | ops-direct-invoke | ops-direct, direct, kernel |
@@ -181,6 +221,23 @@ install-helper uninstall ops-direct-invoke --tool opencode
 | 9 | 代码检视 | ops-code-reviewer | code-review, reviewer |
 | 10 | torch.compile 图模式 | torch-compile | torch, compile |
 
+#### Skills 类别
+
+Skills 按 11 个类别组织（动态发现，数量可能随仓库更新而变化）：
+- 知识与参考
+- 环境与工具
+- 调试与诊断
+- 测试与质量
+- AscendC 开发
+- PyPTO 开发
+- TileLang 开发
+- Triton 开发
+- 模型推理优化
+- 图模式
+- 平台工具
+
+使用 `install-helper install --list` 查看完整的 Skills 列表。
+
 ## 前置条件
 
 - Node.js >= 18
@@ -192,17 +249,21 @@ install-helper uninstall ops-direct-invoke --tool opencode
 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. **调用**各插件的 `init.sh` / `install.sh` 脚本执行实际安装
+7. **追踪**安装状态（`~/.cannbot/config.yaml` + manifest）
 
 安装逻辑仍由各插件的 init.sh 脚本负责，install-helper 提供统一的交互式入口和状态管理。
 
 ## 配置文件
 
-配置保存在 `~/.cannbot/config.yaml`：
+配置保存在 `~/.cannbot/` 目录：
 
 ```yaml
+# config.yaml - 用户配置
 language: zh_CN           # 界面语言
 lastTool: opencode        # 上次使用的 AI 工具
 lastLevel: project        # 上次安装级别
@@ -211,11 +272,31 @@ installedPlugins:         # 已安装的插件列表
   - pypto-op-orchestrator
 ```
 
+```json
+// scan-cache.json - 扫描缓存（自动生成，24 小时有效）
+{
+  "skills": [...],
+  "timestamp": 1234567890,
+  "repoPath": "/path/to/repo"
+}
+```
+
+```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/dist/config/repository.yaml

@@ -0,0 +1,25 @@
+# ----------------------------------------------------------------------------------------------------------
+# 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/cann/cannbot-skills.git"
+  name: "cannbot-skills"
+
+scanDirs:
+  - ops
+  - model
+  - graph
+  - infra
+  - ops-lab
+
+pluginDirs:
+  - plugins-official
+  - plugins-community