@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/api/media/INSTALL.md

@@ -6,17 +6,27 @@ ultrapower v5.2.2 完整安装指南，覆盖从零开始到完全配置的所
 
 ## 目录
 
-- [前提条件](#前提条件)
-- [方式一：插件市场安装（推荐）](#方式一插件市场安装推荐)
-- [方式二：本地开发安装](#方式二本地开发安装)
-- [方式三：npm 全局安装](#方式三npm-全局安装)
-- [安装后配置](#安装后配置)
-- [Axiom 系统初始化](#axiom-系统初始化)
-- [MCP 服务器配置](#mcp-服务器配置)
-- [验证安装](#验证安装)
-- [多平台适配器](#多平台适配器)
-- [更新与卸载](#更新与卸载)
-- [故障排除](#故障排除)
+* [前提条件](#前提条件)
+
+* [方式一：插件市场安装（推荐）](#方式一插件市场安装推荐)
+
+* [方式二：本地开发安装](#方式二本地开发安装)
+
+* [方式三：npm 全局安装](#方式三npm-全局安装)
+
+* [安装后配置](#安装后配置)
+
+* [Axiom 系统初始化](#axiom-系统初始化)
+
+* [MCP 服务器配置](#mcp-服务器配置)
+
+* [验证安装](#验证安装)
+
+* [多平台适配器](#多平台适配器)
+
+* [更新与卸载](#更新与卸载)
+
+* [故障排除](#故障排除)
 
 ---
 
@@ -25,7 +35,7 @@ ultrapower v5.2.2 完整安装指南，覆盖从零开始到完全配置的所
 ### 必需
 
 | 依赖 | 最低版本 | 说明 |
-|------|---------|------|
+| ------ | --------- | ------ |
 | [Claude Code](https://claude.ai/code) | 最新版 | 核心运行环境 |
 | [Node.js](https://nodejs.org) | 18.0+ | JavaScript 运行时 |
 | [Git](https://git-scm.com) | 2.30+ | 版本控制 |
@@ -33,7 +43,7 @@ ultrapower v5.2.2 完整安装指南，覆盖从零开始到完全配置的所
 ### 可选（增强功能）
 
 | 依赖 | 用途 |
-|------|------|
+| ------ | ------ |
 | Python 3.8+ | python_repl 工具、nexus 守护进程 |
 | TypeScript LSP | lsp_* 代码智能工具 |
 | ast-grep | ast_grep_search/replace 工具 |
@@ -41,13 +51,17 @@ ultrapower v5.2.2 完整安装指南，覆盖从零开始到完全配置的所
 ### 验证环境
 
 ```bash
+
 # 检查 Node.js 版本
+
 node --version   # 应显示 v18.0.0 或更高
 
 # 检查 Claude Code
+
 claude --version
 
 # 检查 Git
+
 git --version
 ```
 
@@ -62,13 +76,13 @@ git --version
 在 Claude Code 会话中运行：
 
 ```
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 ```
 
 **预期输出：**
 ```
 ✓ Marketplace added: ultrapower
-  Source: https://github.com/liangjie559567/ultrapower
+  Source: <https://github.com/liangjie559567/ultrapower>
 ```
 
 ### 步骤 2：安装插件
@@ -98,10 +112,14 @@ Plugin installed successfully.
 ```
 
 向导会自动完成：
-- 配置 hooks（PreToolUse / PostToolUse / SessionStart / Stop）
-- 设置权限（避免每次工具调用弹出确认）
-- 可选配置 MCP 服务器
-- 可选配置 HUD 状态栏
+
+* 配置 hooks（PreToolUse / PostToolUse / SessionStart / Stop）
+
+* 设置权限（避免每次工具调用弹出确认）
+
+* 可选配置 MCP 服务器
+
+* 可选配置 HUD 状态栏
 
 ---
 
@@ -112,7 +130,7 @@ Plugin installed successfully.
 ### 步骤 1：克隆仓库
 
 ```bash
-git clone https://github.com/liangjie559567/ultrapower.git
+git clone <https://github.com/liangjie559567/ultrapower.git>
 cd ultrapower
 ```
 
@@ -140,13 +158,17 @@ npm run build
 ### 步骤 4：添加为本地 marketplace
 
 ```bash
+
 # 在 Claude Code 中运行（替换为实际路径）
+
 /plugin marketplace add /path/to/ultrapower
 
 # Windows 示例
+
 /plugin marketplace add C:/Users/yourname/ultrapower
 
 # macOS/Linux 示例
+
 /plugin marketplace add ~/projects/ultrapower
 ```
 
@@ -161,16 +183,21 @@ npm run build
 修改代码后更新插件：
 
 ```bash
+
 # 1. 重新构建
+
 npm run build
 
 # 2. 更新 marketplace 缓存
+
 claude plugin marketplace update omc
 
 # 3. 更新已安装插件
+
 claude plugin update omc@ultrapower
 
 # 4. 重启 Claude Code 会话
+
 ```
 
 ---
@@ -184,9 +211,12 @@ npm install -g @liangjie559567/ultrapower
 ```
 
 安装后文件会复制到：
-- `~/.claude/agents/` — Agent 提示模板
-- `~/.claude/commands/` — 斜杠命令
-- `~/.claude/skills/` — Skills 定义
+
+* `~/.claude/agents/` — Agent 提示模板
+
+* `~/.claude/commands/` — 斜杠命令
+
+* `~/.claude/skills/` — Skills 定义
 
 > **注意**：插件模式（方式一/二）优于 npm 全局安装，因为它使用原生 Claude Code 插件系统，路径隔离更好。
 
@@ -212,7 +242,7 @@ npm install -g @liangjie559567/ultrapower
 ### 执行模式配置
 
 | 模式 | 说明 | 适用场景 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | `ultrawork` | 最大并行度（默认） | 复杂多文件任务 |
 | `autopilot` | 全自主执行 | 明确需求的功能开发 |
 | `ralph` | 持续执行直到验证通过 | 需要高质量保证的任务 |
@@ -221,7 +251,9 @@ npm install -g @liangjie559567/ultrapower
 修改默认模式：
 
 ```bash
+
 # 在 Claude Code 中
+
 /ultrapower:wizard
 ```
 
@@ -341,7 +373,7 @@ MCP（Model Context Protocol）服务器提供额外的 AI 能力。
 ### 可用 MCP 服务器
 
 | 服务器 | 用途 | 需要 API Key |
-|--------|------|-------------|
+| -------- | ------ | ------------- |
 | context7 | 实时文档查询 | 否 |
 | sequential-thinking | 结构化推理 | 否 |
 | software-planning-tool | 任务规划分解 | 否 |
@@ -356,17 +388,23 @@ MCP（Model Context Protocol）服务器提供额外的 AI 能力。
 ### 完整验证流程
 
 ```bash
+
 # 1. 检查插件状态
+
 claude plugin list
+
 # 应显示 ultrapower 状态为 enabled
 
 # 2. 在 Claude Code 中验证 skills
+
 /ultrapower:omc-help
 
 # 3. 运行诊断
+
 /ultrapower:omc-doctor
 
 # 4. 检查 HUD（如已启用）
+
 /ultrapower:hud
 ```
 
@@ -375,13 +413,17 @@ claude plugin list
 在 Claude Code 中测试以下命令：
 
 ```
+
 # 测试基础 skill
+
 /ax-status
 
 # 测试 agent 委派
+
 analyze this codebase
 
 # 测试执行模式
+
 ultrawork: list all TypeScript files
 ```
 
@@ -389,13 +431,17 @@ ultrawork: list all TypeScript files
 
 ```bash
 npm test
+
 # 预期：4589 passed, 0 failed
 
 npm run build
+
 # 预期：无错误
 
 npm run lint
+
 # 预期：0 warnings, 0 errors
+
 ```
 
 ---
@@ -405,7 +451,7 @@ npm run lint
 ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 
 | 文件 | 目标工具 | 说明 |
-|------|---------|------|
+| ------ | --------- | ------ |
 | `.kiro/steering/axiom.md` | Kiro | Kiro IDE 集成 |
 | `.cursorrules` | Cursor | Cursor 编辑器规则 |
 | `.gemini/GEMINI.md` | Gemini CLI | Google Gemini CLI |
@@ -429,7 +475,9 @@ ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 或指定版本：
 
 ```bash
+
 # 在 Claude Code 中
+
 /plugin install omc@ultrapower@5.2.2
 ```
 
@@ -442,13 +490,17 @@ ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 ### 卸载
 
 ```bash
+
 # 卸载插件
+
 /plugin uninstall ultrapower
 
 # 移除 marketplace（可选）
+
 /plugin marketplace remove omc
 
 # 清理 Axiom 数据（可选，会删除知识库）
+
 rm -rf .omc/axiom/
 ```
 
@@ -462,12 +514,15 @@ rm -rf .omc/axiom/
 
 **解决**：
 ```bash
+
 # 1. 确认插件已启用
+
 claude plugin list
 
 # 2. 重启 Claude Code
 
 # 3. 重新运行安装向导
+
 /ultrapower:omc-setup
 ```
 
@@ -477,13 +532,16 @@ claude plugin list
 
 **解决**：
 ```powershell
+
 # 方法一：使用 robocopy 清空（推荐，适用于路径过深）
+
 mkdir C:\empty_temp
 robocopy C:\empty_temp "C:\Users\<name>\.claude\plugins\marketplaces\omc" /MIR
 rmdir "C:\Users\<name>\.claude\plugins\marketplaces\omc" /s /q
 rmdir C:\empty_temp
 
 # 方法二：直接删除（路径不太深时）
+
 Remove-Item -Recurse -Force "C:\Users\<name>\.claude\plugins\marketplaces\omc"
 ```
 
@@ -495,10 +553,13 @@ Remove-Item -Recurse -Force "C:\Users\<name>\.claude\plugins\marketplaces\omc"
 
 **解决**：
 ```bash
+
 # 检查 hooks 配置
+
 cat ~/.claude/settings.json | grep hooks
 
 # 重新安装 hooks
+
 /ultrapower:omc-setup --force
 ```
 
@@ -509,7 +570,9 @@ cat ~/.claude/settings.json | grep hooks
 **解决**：确保 Node.js 在 PATH 中，LSP 服务器需要 `.cmd` 扩展名支持（v5.2.2 已修复）。
 
 ```bash
+
 # 验证 Node.js 可访问
+
 node --version
 which node  # Linux/macOS
 where node  # Windows
@@ -526,17 +589,24 @@ where node  # Windows
 
 ### 获取帮助
 
-- **Issues**: https://github.com/liangjie559567/ultrapower/issues
-- **诊断工具**: `/ultrapower:omc-doctor`
-- **完整参考**: [docs/REFERENCE.md](./REFERENCE.md)
-- **进化系统**: [docs/EVOLUTION.md](./EVOLUTION.md)
+* **Issues**: <https://github.com/liangjie559567/ultrapower/issues>
+
+* **诊断工具**: `/ultrapower:omc-doctor`
+
+* **完整参考**: [docs/REFERENCE.md](./REFERENCE.md)
+
+* **进化系统**: [docs/EVOLUTION.md](./EVOLUTION.md)
 
 ---
 
 ## 相关文档
 
-- [REFERENCE.md](./REFERENCE.md) — 完整 API 参考
-- [EVOLUTION.md](./EVOLUTION.md) — Axiom 自我进化系统
-- [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
-- [MIGRATION.md](./MIGRATION.md) — 版本迁移指南
-- [LOCAL_PLUGIN_INSTALL.md](./LOCAL_PLUGIN_INSTALL.md) — 本地开发安装
+* [REFERENCE.md](./REFERENCE.md) — 完整 API 参考
+
+* [EVOLUTION.md](./EVOLUTION.md) — Axiom 自我进化系统
+
+* [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
+
+* [MIGRATION.md](./MIGRATION.md) — 版本迁移指南
+
+* [LOCAL_PLUGIN_INSTALL.md](./LOCAL_PLUGIN_INSTALL.md) — 本地开发安装