@cannbot-ai/install-helper 1.0.4 → 1.0.6

package/README.md

@@ -16,7 +16,30 @@ install-helper
 npx @cannbot-ai/install-helper
 ```
 
-交互式向导会自动检测已安装的 AI 编程工具（OpenCode / Claude Code / Trae / Cursor），通过箭头键选择场景即可完成安装。
+> 全局安装后也可使用短命令 `ihelper`，如 `ihelper list`、`ihelper install --all --tool opencode --yes`。
+
+交互式向导会自动检测已安装的 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」和「全选当前类别」，详见下文。
 
 ## 主要特性
 
@@ -29,8 +52,11 @@ npx @cannbot-ai/install-helper
 
 ### 安装管理
 - **交互式向导**：箭头键选择，空格切换，回车确认
+- **列表排序**：插件和 Skills 列表按名称升序排列
+- **描述聚焦**：光标聚焦某项时，下方以青色 + 💡 前缀显示详细描述，支持中文自适应换行
+- **批量选择**：支持全选所有 Skills、全选当前类别、跨类别累积选择
 - **插件安装**：支持 10 个官方插件，自动处理依赖
-- **Skill 安装**：支持 89 个 Skills，按 11 个类别组织
+- **Skill 安装**：支持 91 个 Skills，按 11 个类别组织
 - **智能卸载**：根据安装记录精确删除，自动清理空目录
 - **健康检查**：检测安装状态，自动修复常见问题
 
@@ -42,6 +68,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` | 查看已安装插件详情 |
@@ -62,10 +89,13 @@ install-helper init
 ```
 
 向导会引导你完成：
-1. 自动检测已安装的 AI 编程工具
-2. 选择安装级别（project / global）
-3. 多选要安装的场景（空格切换，回车确认）
-4. 确认并执行安装
+1. 选择安装类型（Plugin 完整工作流 / Skill 轻量知识）
+2. 自动检测已安装的 AI 编程工具
+3. 选择安装级别（project / global）
+4. 多选要安装的插件或 Skills（空格切换，回车确认）
+5. 确认并执行安装
+
+**列表展示**：插件和 Skill 列表均按名称升序排列。光标聚焦某项时，下方会以青色 + 💡 前缀显示该项的详细描述，支持中文自适应换行。
 
 **智能记忆**：向导会记住你上次选择的工具和级别，下次运行无需重新选择。已安装的插件会自动标记并默认不勾选。
 
@@ -80,11 +110,7 @@ install-helper install ops-direct-invoke --level global  # 全局安装
 
 **重要说明**：
 
-每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。
-
-**推荐做法**：
-- 每个项目只安装一个插件
-- 如需使用多个插件，在不同目录下分别安装
+每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。建议每个项目只安装一个插件，如需使用多个插件，在不同目录下分别安装。
 
 **示例**：
 ```bash
@@ -97,8 +123,6 @@ cd project-b
 install-helper install triton --tool opencode
 ```
 
-> **注意**：每个插件有独立的 `AGENTS.md` 配置文件。同一项目目录下安装多个插件时，后安装的会覆盖前一个的 `AGENTS.md`。如需同时使用多个插件，建议分别在不同项目目录中安装。
-
 ### 安装单个 Skill（轻量模式）
 
 如果只需要让 AI agent 掌握特定领域知识，不需要完整工作流，可以直接安装单个 Skill：
@@ -110,18 +134,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` 可跳过提示直接覆盖。
 
@@ -184,26 +215,26 @@ install-helper uninstall ops-direct-invoke --tool opencode
 
 ## 可用场景
 
-install-helper 支持 **10 个官方插件** 和 **89 个 Skills**（动态发现，数量可能随仓库更新而变化）。
+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 个类别组织（动态发现，数量可能随仓库更新而变化）：
+Skills 按 11 个类别组织（另有「其他」兜底类别，动态发现，数量可能随仓库更新而变化）：
 - 知识与参考
 - 环境与工具
 - 调试与诊断
@@ -215,13 +246,14 @@ Skills 按 11 个类别组织（动态发现，数量可能随仓库更新而变
 - 模型推理优化
 - 图模式
 - 平台工具
+- 其他 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 仓库）
 
 ## 工作原理
@@ -256,8 +288,8 @@ installedPlugins:         # 已安装的插件列表
 // scan-cache.json - 扫描缓存（自动生成，24 小时有效）
 {
   "skills": [...],
-  "timestamp": 1234567890,
-  "repoPath": "/path/to/repo"
+  "repoCommit": "a1b2c3d4e5f6...",
+  "timestamp": 1234567890
 }
 ```