@cannbot-ai/install-helper 0.0.2-beta.9 → 1.0.2

package/README.md

@@ -18,6 +18,22 @@ npx @cannbot-ai/install-helper
 
 交互式向导会自动检测已安装的 AI 编程工具（OpenCode / Claude Code / Trae / Cursor），通过箭头键选择场景即可完成安装。
 
+## 主要特性
+
+### 核心功能
+- **动态 Skill 发现**：自动扫描仓库中的 SKILL.md 文件，实时发现可用 Skills
+- **智能缓存机制**：扫描结果缓存 24 小时，大幅提升后续命令执行速度
+- **备份与恢复**：安装新插件时自动备份 AGENTS.md，支持一键恢复
+- **参数校验**：`--tool` 和 `--level` 参数支持校验，提供友好的错误提示（支持中英文）
+- **智能记忆**：记住上次选择的工具和安装级别，下次运行自动填充
+
+### 安装管理
+- **交互式向导**：箭头键选择，空格切换，回车确认
+- **插件安装**：支持 10 个官方插件，自动处理依赖
+- **Skill 安装**：支持 89 个 Skills，按 11 个类别组织
+- **智能卸载**：根据安装记录精确删除，自动清理空目录
+- **健康检查**：检测安装状态，自动修复常见问题
+
 ## 命令一览
 
 | 命令 | 说明 |
@@ -168,6 +184,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 +201,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 +229,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,6 +252,26 @@ 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