@cannbot-ai/install-helper 0.0.2-beta.28 → 0.0.2-beta.29

package/README.md

@@ -16,11 +16,13 @@ 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
 
-如果 opencode 等工具已安装，可直接一键安装全部 Skills（无需逐个点选）：
+如果 AI 编程工具已安装，可直接一键安装全部 Skills（无需逐个点选）。支持所有工具（opencode / claude / trae / cursor / copilot）：
 
 ```bash
 # 一键安装全部 Skills 到当前项目（跳过确认）
@@ -28,6 +30,13 @@ 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」和「全选当前类别」，详见下文。
@@ -43,8 +52,11 @@ install-helper install --all --tool opencode --level global --yes
 
 ### 安装管理
 - **交互式向导**：箭头键选择，空格切换，回车确认
+- **列表排序**：插件和 Skills 列表按名称升序排列
+- **描述聚焦**：光标聚焦某项时，下方以青色 + 💡 前缀显示详细描述，支持中文自适应换行
+- **批量选择**：支持全选所有 Skills、全选当前类别、跨类别累积选择
 - **插件安装**：支持 10 个官方插件，自动处理依赖
-- **Skill 安装**：支持 89 个 Skills，按 11 个类别组织
+- **Skill 安装**：支持 91 个 Skills，按 11 个类别组织
 - **智能卸载**：根据安装记录精确删除，自动清理空目录
 - **健康检查**：检测安装状态，自动修复常见问题
 
@@ -56,7 +68,7 @@ install-helper install --all --tool opencode --level global --yes
 | `install-helper list` | 列出可用场景及安装状态 |
 | `install-helper install <name>` | 安装指定插件或 Skill（自动识别） |
 | `install-helper install --list` | 按类别列出所有可用 Skills |
-| `install-helper install --all --tool opencode --yes` | 一键安装全部 Skills |
+| `install-helper install --all --tool <tool> --yes` | 一键安装全部 Skills |
 | `install-helper update [plugin]` | 更新已安装的 Skills |
 | `install-helper uninstall <plugin>` | 卸载指定场景 |
 | `install-helper status` | 查看已安装插件详情 |
@@ -77,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 列表均按名称升序排列。光标聚焦某项时，下方会以青色 + 💡 前缀显示该项的详细描述，支持中文自适应换行。
 
 **智能记忆**：向导会记住你上次选择的工具和级别，下次运行无需重新选择。已安装的插件会自动标记并默认不勾选。
 
@@ -95,11 +110,7 @@ install-helper install ops-direct-invoke --level global  # 全局安装
 
 **重要说明**：
 
-每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。
-
-**推荐做法**：
-- 每个项目只安装一个插件
-- 如需使用多个插件，在不同目录下分别安装
+每个插件都有独立的 `AGENTS.md` 配置文件。如果在同一目录下安装多个插件，后安装的会覆盖前一个的配置文件。建议每个项目只安装一个插件，如需使用多个插件，在不同目录下分别安装。
 
 **示例**：
 ```bash
@@ -112,8 +123,6 @@ cd project-b
 install-helper install triton --tool opencode
 ```
 
-> **注意**：每个插件有独立的 `AGENTS.md` 配置文件。同一项目目录下安装多个插件时，后安装的会覆盖前一个的 `AGENTS.md`。如需同时使用多个插件，建议分别在不同项目目录中安装。
-
 ### 安装单个 Skill（轻量模式）
 
 如果只需要让 AI agent 掌握特定领域知识，不需要完整工作流，可以直接安装单个 Skill：
@@ -125,14 +134,16 @@ 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。
-- 进入某类别后，顶部有 **「全选当前类别」**，勾选后回车即选中该类别全部 Skills。
-- 选完一个类别后会提示「继续选择其他类别 / 确认安装」，可跨类别累积选择后再统一安装。
+**交互式批量选择**：运行 `install-helper install`（不带参数）进入交互式选择时，支持以下批量操作：
+
+- **全选所有 Skills**：类别列表顶部有「全选所有 Skills（共 N 个）」，选中即一键安装全部。
+- **全选当前类别**：进入某类别后，顶部有「全选当前类别」，勾选后回车即选中该类别全部 Skills。
+- **跨类别累积选择**：选完一个类别后，可选择「继续选择其他类别」，已选 Skills 会保留累积，不丢失。类别列表中实时显示「确认安装（已选 N 个 Skills）」快捷入口，随时可确认安装。
+- **单选/多选**：在类别内用空格勾选任意多个 Skills，回车确认。
 
 **选项：**
 
@@ -204,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 个类别组织（另有「其他」兜底类别，动态发现，数量可能随仓库更新而变化）：
 - 知识与参考
 - 环境与工具
 - 调试与诊断
@@ -235,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 仓库）
 
 ## 工作原理
@@ -276,8 +288,8 @@ installedPlugins:         # 已安装的插件列表
 // scan-cache.json - 扫描缓存（自动生成，24 小时有效）
 {
   "skills": [...],
-  "timestamp": 1234567890,
-  "repoPath": "/path/to/repo"
+  "repoCommit": "a1b2c3d4e5f6...",
+  "timestamp": 1234567890
 }
 ```
 

package/dist/index.js

@@ -878,7 +878,7 @@ import { parse as parseYaml3 } from "yaml";
 
 // src/core/scanner.ts
 import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
-import { join as join7, dirname as dirname3 } from "path";
+import { join as join7, dirname as dirname3, relative } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { parse as parseYaml2 } from "yaml";
 var __filename3 = fileURLToPath3(import.meta.url);
@@ -1037,7 +1037,7 @@ function scanDirectory(dirPath, repoPath, sourcePrefix, skills, seen) {
       skills.push({
         id: frontmatter.name,
         description: frontmatter.description,
-        source: sourcePrefix,
+        source: dirname3(relative(repoPath, dirPath)),
         filePath: selfSkillMd
       });
     }
@@ -1061,7 +1061,7 @@ function scanDirectory(dirPath, repoPath, sourcePrefix, skills, seen) {
       }
       continue;
     }
-    scanDirectory(fullPath, repoPath, sourcePrefix, skills, seen);
+    scanDirectory(fullPath, repoPath, sourcePrefix + "/" + entry, skills, seen);
   }
 }
 function safeReaddir(dir) {
@@ -3228,7 +3228,7 @@ function createCLI() {
     setLanguage(config.language);
   }
   const program2 = new Command();
-  program2.name("install-helper").description("CANNBot Install Helper - Interactive installer for CANN operator development skills").version("0.0.2-beta.28");
+  program2.name("install-helper").description("CANNBot Install Helper - Interactive installer for CANN operator development skills").version("0.0.2-beta.29");
   program2.command("init", { isDefault: false }).description("Run interactive installation wizard").action(async () => {
     await initCommand();
   });