@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/INSTALL.md

@@ -15,17 +15,27 @@ ultrapower v5.6.6 完整安装指南，覆盖从零开始到完全配置的所
 
 ## 目录
 
-- [前提条件](#前提条件)
-- [方式一：插件市场安装（推荐，唯一官方支持）](#方式一插件市场安装推荐)
-- [方式二：本地开发安装（不支持）](#方式二本地开发安装)
-- [方式三：npm 全局安装（不支持）](#方式三npm-全局安装)
-- [安装后配置](#安装后配置)
-- [Axiom 系统初始化](#axiom-系统初始化)
-- [MCP 服务器配置](#mcp-服务器配置)
-- [验证安装](#验证安装)
-- [多平台适配器](#多平台适配器)
-- [更新与卸载](#更新与卸载)
-- [故障排除](#故障排除)
+* [前提条件](#前提条件)
+
+* [方式一：插件市场安装（推荐，唯一官方支持）](#方式一插件市场安装推荐)
+
+* [方式二：本地开发安装（不支持）](#方式二本地开发安装)
+
+* [方式三：npm 全局安装（不支持）](#方式三npm-全局安装)
+
+* [安装后配置](#安装后配置)
+
+* [Axiom 系统初始化](#axiom-系统初始化)
+
+* [MCP 服务器配置](#mcp-服务器配置)
+
+* [验证安装](#验证安装)
+
+* [多平台适配器](#多平台适配器)
+
+* [更新与卸载](#更新与卸载)
+
+* [故障排除](#故障排除)
 
 ---
 
@@ -34,7 +44,7 @@ ultrapower v5.6.6 完整安装指南，覆盖从零开始到完全配置的所
 ### 必需
 
 | 依赖 | 最低版本 | 说明 |
-|------|---------|------|
+| ------ | --------- | ------ |
 | [Claude Code](https://claude.ai/code) | 最新版 | 核心运行环境 |
 | [Node.js](https://nodejs.org) | 18.0+ | JavaScript 运行时 |
 | [Git](https://git-scm.com) | 2.30+ | 版本控制 |
@@ -42,7 +52,7 @@ ultrapower v5.6.6 完整安装指南，覆盖从零开始到完全配置的所
 ### 可选（增强功能）
 
 | 依赖 | 用途 |
-|------|------|
+| ------ | ------ |
 | Python 3.8+ | python_repl 工具、nexus 守护进程 |
 | TypeScript LSP | lsp_* 代码智能工具 |
 | ast-grep | ast_grep_search/replace 工具 |
@@ -50,13 +60,17 @@ ultrapower v5.6.6 完整安装指南，覆盖从零开始到完全配置的所
 ### 验证环境
 
 ```bash
+
 # 检查 Node.js 版本
+
 node --version   # 应显示 v18.0.0 或更高
 
 # 检查 Claude Code
+
 claude --version
 
 # 检查 Git
+
 git --version
 ```
 
@@ -71,13 +85,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：安装插件
@@ -107,10 +121,14 @@ Plugin installed successfully.
 ```
 
 向导会自动完成：
-- 配置 hooks（PreToolUse / PostToolUse / SessionStart / Stop）
-- 设置权限（避免每次工具调用弹出确认）
-- 可选配置 MCP 服务器
-- 可选配置 HUD 状态栏
+
+* 配置 hooks（PreToolUse / PostToolUse / SessionStart / Stop）
+
+* 设置权限（避免每次工具调用弹出确认）
+
+* 可选配置 MCP 服务器
+
+* 可选配置 HUD 状态栏
 
 ---
 
@@ -126,7 +144,7 @@ Plugin installed successfully.
 ### 步骤 1：克隆仓库
 
 ```bash
-git clone https://github.com/liangjie559567/ultrapower.git
+git clone <https://github.com/liangjie559567/ultrapower.git>
 cd ultrapower
 ```
 
@@ -154,13 +172,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
 ```
 
@@ -175,16 +197,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 会话
+
 ```
 
 ---
@@ -203,9 +230,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 插件系统，路径隔离更好。
 
@@ -231,7 +261,7 @@ npm install -g @liangjie559567/ultrapower
 ### 执行模式配置
 
 | 模式 | 说明 | 适用场景 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | `ultrawork` | 最大并行度（默认） | 复杂多文件任务 |
 | `autopilot` | 全自主执行 | 明确需求的功能开发 |
 | `ralph` | 持续执行直到验证通过 | 需要高质量保证的任务 |
@@ -240,7 +270,9 @@ npm install -g @liangjie559567/ultrapower
 修改默认模式：
 
 ```bash
+
 # 在 Claude Code 中
+
 /ultrapower:wizard
 ```
 
@@ -360,7 +392,7 @@ MCP（Model Context Protocol）服务器提供额外的 AI 能力。
 ### 可用 MCP 服务器
 
 | 服务器 | 用途 | 需要 API Key |
-|--------|------|-------------|
+| -------- | ------ | ------------- |
 | context7 | 实时文档查询 | 否 |
 | sequential-thinking | 结构化推理 | 否 |
 | software-planning-tool | 任务规划分解 | 否 |
@@ -375,17 +407,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
 ```
 
@@ -394,13 +432,17 @@ claude plugin list
 在 Claude Code 中测试以下命令：
 
 ```
+
 # 测试基础 skill
+
 /ax-status
 
 # 测试 agent 委派
+
 analyze this codebase
 
 # 测试执行模式
+
 ultrawork: list all TypeScript files
 ```
 
@@ -408,13 +450,17 @@ ultrawork: list all TypeScript files
 
 ```bash
 npm test
+
 # 预期：4589 passed, 0 failed
 
 npm run build
+
 # 预期：无错误
 
 npm run lint
+
 # 预期：0 warnings, 0 errors
+
 ```
 
 ---
@@ -424,7 +470,7 @@ npm run lint
 ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 
 | 文件 | 目标工具 | 说明 |
-|------|---------|------|
+| ------ | --------- | ------ |
 | `.kiro/steering/axiom.md` | Kiro | Kiro IDE 集成 |
 | `.cursorrules` | Cursor | Cursor 编辑器规则 |
 | `.gemini/GEMINI.md` | Gemini CLI | Google Gemini CLI |
@@ -448,7 +494,9 @@ ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 或指定版本：
 
 ```bash
+
 # 在 Claude Code 中
+
 /plugin install omc@ultrapower@5.5.33
 ```
 
@@ -461,13 +509,17 @@ ultrapower 支持多种 AI 工具，安装后自动生成适配器文件：
 ### 卸载
 
 ```bash
+
 # 卸载插件
+
 /plugin uninstall ultrapower
 
 # 移除 marketplace（可选）
+
 /plugin marketplace remove omc
 
 # 清理 Axiom 数据（可选，会删除知识库）
+
 rm -rf .omc/axiom/
 ```
 
@@ -481,12 +533,15 @@ rm -rf .omc/axiom/
 
 **解决**：
 ```bash
+
 # 1. 确认插件已启用
+
 claude plugin list
 
 # 2. 重启 Claude Code
 
 # 3. 重新运行安装向导
+
 /ultrapower:omc-setup
 ```
 
@@ -496,13 +551,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"
 ```
 
@@ -514,10 +572,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
 ```
 
@@ -528,7 +589,9 @@ cat ~/.claude/settings.json | grep hooks
 **解决**：确保 Node.js 在 PATH 中，LSP 服务器需要 `.cmd` 扩展名支持（v5.5.33 已修复）。
 
 ```bash
+
 # 验证 Node.js 可访问
+
 node --version
 which node  # Linux/macOS
 where node  # Windows
@@ -545,17 +608,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) — 本地开发安装

package/docs/INSTALL_FIX_SUMMARY.md

@@ -5,47 +5,65 @@
 用户报错：`npm install -g ultrapower` 返回 404 Not Found
 
 **根本原因**：包名不匹配
-- npm 上的实际包名：`@liangjie559567/ultrapower`（scoped package）
-- 错误的命令：`npm install -g ultrapower`（缺少 scope 前缀）
+
+* npm 上的实际包名：`@liangjie559567/ultrapower`（scoped package）
+
+* 错误的命令：`npm install -g ultrapower`（缺少 scope 前缀）
 
 **第二个问题**：插件安装命令不一致
-- 正确命令：`/plugin install omc@ultrapower`
-- 错误命令：`/plugin install ultrapower`
+
+* 正确命令：`/plugin install omc@ultrapower`
+
+* 错误命令：`/plugin install ultrapower`
 
 ## 已修复的文档
 
 ### 1. README.md ✅
-- 更新安装章节，添加完整的 Claude Code 插件市场安装流程
-- 添加 npm 全局安装方式（使用正确的 scoped 包名）
-- 添加安装向导步骤 `/ultrapower:omc-setup`
+
+* 更新安装章节，添加完整的 Claude Code 插件市场安装流程
+
+* 添加 npm 全局安装方式（使用正确的 scoped 包名）
+
+* 添加安装向导步骤 `/ultrapower:omc-setup`
 
 ### 2. docs/INSTALL.md ✅
-- 修复"方式三：npm 全局安装"中的包名
-- 从 `npm install -g ultrapower` 改为 `npm install -g @liangjie559567/ultrapower`
-- 修复插件安装命令：`/plugin install omc@ultrapower`
-- 修复版本号引用：`/plugin install omc@ultrapower@5.2.2`
+
+* 修复"方式三：npm 全局安装"中的包名
+
+* 从 `npm install -g ultrapower` 改为 `npm install -g @liangjie559567/ultrapower`
+
+* 修复插件安装命令：`/plugin install omc@ultrapower`
+
+* 修复版本号引用：`/plugin install omc@ultrapower@5.2.2`
 
 ### 3. docs/LOCAL_INSTALL_VERIFICATION.md ✅
-- 修复插件安装命令：`/plugin install omc@ultrapower`
+
+* 修复插件安装命令：`/plugin install omc@ultrapower`
 
 ### 4. docs/PLUGIN_MARKETPLACE_VERIFICATION.md ✅
-- 修复所有插件安装命令引用
+
+* 修复所有插件安装命令引用
 
 ### 5. docs/UPGRADE_VERIFICATION.md ✅
-- 修复所有插件安装命令引用
+
+* 修复所有插件安装命令引用
 
 ## 正确的安装方式
 
 ### 方式一：Claude Code 插件市场（推荐）
 
 ```bash
+
 # 第一步：添加插件市场
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 
 # 第二步：安装插件
+
 /plugin install omc@ultrapower
 
 # 第三步：运行安装向导
+
 /ultrapower:omc-setup
 ```
 
@@ -59,10 +77,13 @@ npm install -g @liangjie559567/ultrapower
 
 以下文档已经使用了正确的包名，无需修改：
 
-- ✅ `docs/MIGRATION.md` - 所有安装命令都使用 `@liangjie559567/ultrapower`
-- ✅ `.omc/axiom/evolution/learning_queue.md` - 使用正确的包名
-- ✅ `docs/guides/v5.5.13-new-features.md` - 使用正确的包名
-- ✅ `docs/RELEASE_NOTES_v5.5.14.md` - 使用正确的包名
+* ✅ `docs/MIGRATION.md` - 所有安装命令都使用 `@liangjie559567/ultrapower`
+
+* ✅ `.omc/axiom/evolution/learning_queue.md` - 使用正确的包名
+
+* ✅ `docs/guides/v5.5.13-new-features.md` - 使用正确的包名
+
+* ✅ `docs/RELEASE_NOTES_v5.5.14.md` - 使用正确的包名
 
 ## 验证
 
@@ -74,15 +95,16 @@ npm install -g @liangjie559567/ultrapower
    - 支持自动更新
    - 命令：`/plugin install omc@ultrapower`
 
-2. **npm 全局安装**：
+1. **npm 全局安装**：
    ```bash
    npm install -g @liangjie559567/ultrapower
    ```
 
 ## 修复统计
 
-- 修复文档数量：5 个
-- 修复的错误命令：
+* 修复文档数量：5 个
+
+* 修复的错误命令：
   - `npm install -g ultrapower` → `npm install -g @liangjie559567/ultrapower`
   - `/plugin install ultrapower` → `/plugin install omc@ultrapower`
 
@@ -92,6 +114,6 @@ npm install -g @liangjie559567/ultrapower
 
 ## 相关 Issue
 
-用户报错：`npm error 404 Not Found - GET https://registry.npmjs.org/ultrapower`
+用户报错：`npm error 404 Not Found - GET <https://registry.npmjs.org/ultrapower`>
 
 已通过更新文档解决。所有安装文档现在使用正确的包名和插件安装命令。

package/docs/INSTALL_FIX_VERIFICATION.md

@@ -6,6 +6,7 @@
 ## ✅ 验证结果
 
 ### npm 包名检查
+
 ```bash
 grep -r "npm install -g ultrapower[^@]" --include="*.md" docs/ | grep -v "INSTALL_FIX_SUMMARY"
 ```
@@ -14,6 +15,7 @@ grep -r "npm install -g ultrapower[^@]" --include="*.md" docs/ | grep -v "INSTAL
 所有 npm 安装命令都使用正确的 scoped 包名：`@liangjie559567/ultrapower`
 
 ### 插件安装命令检查
+
 ```bash
 grep -r "/plugin install ultrapower[^@]" --include="*.md" docs/ | grep -v "INSTALL_FIX_SUMMARY"
 ```
@@ -22,6 +24,7 @@ grep -r "/plugin install ultrapower[^@]" --include="*.md" docs/ | grep -v "INSTA
 所有插件安装命令都使用正确的格式：`/plugin install omc@ultrapower`
 
 ### 插件更新命令检查
+
 ```bash
 grep -r "/plugin update ultrapower" --include="*.md" docs/
 ```
@@ -40,18 +43,21 @@ grep -r "/plugin update ultrapower" --include="*.md" docs/
 ## 正确的命令格式
 
 ### 插件市场安装（推荐）
+
 ```bash
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 /plugin install omc@ultrapower
 /ultrapower:omc-setup
 ```
 
 ### npm 全局安装
+
 ```bash
 npm install -g @liangjie559567/ultrapower
 ```
 
 ### 更新
+
 ```bash
 /plugin update omc@ultrapower
 ```

package/docs/INSTALL_VERIFICATION_REPORT.md

@@ -9,27 +9,42 @@
 ## 验证项目
 
 ### 1. 包配置 ✅
-- **包名**: `@liangjie559567/ultrapower`
-- **版本**: `5.5.15`
-- **状态**: 正确
+
+* **包名**: `@liangjie559567/ultrapower`
+
+* **版本**: `5.5.15`
+
+* **状态**: 正确
 
 ### 2. 文档命令检查 ✅
-- **npm 命令**: 所有文档使用 `npm install -g @liangjie559567/ultrapower`
-- **插件命令**: 所有文档使用 `/plugin install omc@ultrapower`
-- **更新命令**: 所有文档使用 `/plugin update omc@ultrapower`
-- **状态**: 无错误
+
+* **npm 命令**: 所有文档使用 `npm install -g @liangjie559567/ultrapower`
+
+* **插件命令**: 所有文档使用 `/plugin install omc@ultrapower`
+
+* **更新命令**: 所有文档使用 `/plugin update omc@ultrapower`
+
+* **状态**: 无错误
 
 ### 3. 关键文件 ✅
-- ✅ README.md
-- ✅ docs/INSTALL.md
-- ✅ .claude-plugin/plugin.json
-- ✅ .claude-plugin/marketplace.json
+
+* ✅ README.md
+
+* ✅ docs/INSTALL.md
+
+* ✅ .claude-plugin/plugin.json
+
+* ✅ .claude-plugin/marketplace.json
 
 ### 4. 版本一致性 ✅
-- package.json: `5.5.15`
-- plugin.json: `5.5.15`
-- marketplace.json: `5.5.15`
-- **状态**: 一致
+
+* package.json: `5.5.15`
+
+* plugin.json: `5.5.15`
+
+* marketplace.json: `5.5.15`
+
+* **状态**: 一致
 
 ---
 
@@ -48,7 +63,7 @@
 ### 方式一：Claude Code 插件市场（推荐）
 
 ```bash
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 /plugin install omc@ultrapower
 /ultrapower:omc-setup
 ```