@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/UPGRADE_VERIFICATION.md

@@ -33,9 +33,12 @@ ACTION: Use AskUserQuestion to ask the user if they want to upgrade now.
 ### 提示来源
 
 升级提示通过 `SessionStart` hook 注入，位置：
-- Hook: `src/hooks/session-start/`
-- 触发时机: 每次新会话启动
-- 版本检查: 对比 `package.json` 版本与用户当前安装版本
+
+* Hook: `src/hooks/session-start/`
+
+* 触发时机: 每次新会话启动
+
+* 版本检查: 对比 `package.json` 版本与用户当前安装版本
 
 ---
 
@@ -127,13 +130,17 @@ omc install --force --skip-claude-check --refresh-hooks
 **步骤 1: 完全卸载**
 
 ```bash
+
 # 卸载 npm 全局包
+
 npm uninstall -g @liangjie559567/ultrapower
 
 # 卸载插件
+
 /plugin uninstall ultrapower
 
 # 清理缓存（可选）
+
 rm -rf ~/.claude/plugins/cache/omc
 rm -rf ~/.claude/plugins/marketplaces/omc
 ```
@@ -141,12 +148,15 @@ rm -rf ~/.claude/plugins/marketplaces/omc
 **步骤 2: 重新安装**
 
 ```bash
+
 # 方式 A: npm 全局安装
+
 npm install -g @liangjie559567/ultrapower@latest
 omc install --force
 
 # 方式 B: 插件市场安装
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 /plugin install omc@ultrapower
 ```
 
@@ -163,10 +173,13 @@ omc install --force
 ### 检查点 1: 版本号确认
 
 ```bash
+
 # 命令行检查
+
 omc --version
 
 # Claude Code 内检查
+
 /ultrapower:omc-help
 ```
 
@@ -179,10 +192,14 @@ cat ~/.claude/settings.json | grep -A 20 hooks
 ```
 
 **预期**: 应包含以下 hook 事件类型：
-- `PreToolUse`
-- `PostToolUse`
-- `SessionStart`
-- `Stop`
+
+* `PreToolUse`
+
+* `PostToolUse`
+
+* `SessionStart`
+
+* `Stop`
 
 ### 检查点 3: Skills 可用性
 
@@ -203,8 +220,11 @@ analyze this codebase
 ### 检查点 5: 工具可用性
 
 ```bash
+
 # 在 Claude Code 中测试 LSP 工具
+
 # （需要在 TypeScript 项目中）
+
 ```
 
 AI 应能调用 `lsp_hover`、`lsp_diagnostics` 等工具。
@@ -231,8 +251,11 @@ ls -la .omc/state/
 
 **手动修复**:
 ```bash
+
 # 编辑 ~/.claude/plugins/npm-cache/package.json
+
 # 将 "^5.2.3" 改为 "5.5.14"
+
 ```
 
 ### 问题 2: plugin.json 缺失
@@ -260,7 +283,9 @@ cat ~/.claude/plugins/cache/omc/ultrapower/5.5.14/.claude-plugin/plugin.json
 
 **手动修复**:
 ```powershell
+
 # Windows (路径过深时使用 robocopy)
+
 mkdir C:\empty_temp
 robocopy C:\empty_temp "C:\Users\<name>\.claude\plugins\cache\omc" /MIR
 rmdir "C:\Users\<name>\.claude\plugins\cache\omc" /s /q
@@ -274,7 +299,7 @@ rmdir "C:\Users\<name>\.claude\plugins\cache\omc" /s /q
 
 **验证**:
 ```bash
-cat ~/.claude/plugins/known_marketplaces.json | grep -E "(omc|ultrapower)"
+cat ~/.claude/plugins/known_marketplaces.json | grep -E "(omc | ultrapower)"
 ```
 
 应只显示 `omc`，不应有 `ultrapower` 键。
@@ -303,13 +328,17 @@ ls ~/.claude/plugins/cache/omc/ultrapower/5.5.14/templates/hooks/
 **回滚到上一个稳定版本**:
 
 ```bash
+
 # 卸载当前版本
+
 npm uninstall -g @liangjie559567/ultrapower
 
 # 安装指定版本
+
 npm install -g @liangjie559567/ultrapower@5.5.13
 
 # 刷新配置
+
 omc install --force --refresh-hooks
 ```
 
@@ -318,13 +347,17 @@ omc install --force --refresh-hooks
 **重置配置文件**:
 
 ```bash
+
 # 备份当前配置
+
 cp ~/.claude/.omc-config.json ~/.claude/.omc-config.json.bak
 
 # 删除配置（下次启动时重建）
+
 rm ~/.claude/.omc-config.json
 
 # 重新运行安装向导
+
 /ultrapower:omc-setup
 ```
 
@@ -333,20 +366,25 @@ rm ~/.claude/.omc-config.json
 **清除所有 ultrapower 数据**:
 
 ```bash
+
 # 卸载
+
 npm uninstall -g @liangjie559567/ultrapower
 /plugin uninstall ultrapower
 
 # 清理所有缓存和配置
+
 rm -rf ~/.claude/plugins/cache/omc
 rm -rf ~/.claude/plugins/marketplaces/omc
 rm -rf ~/.claude/.omc-config.json
 rm -rf ~/.claude/hud/omc-hud.mjs
 
 # 清理项目级数据（可选，会丢失 Axiom 知识库）
+
 rm -rf .omc/
 
 # 重新安装
+
 npm install -g @liangjie559567/ultrapower@latest
 omc install --force
 ```
@@ -362,12 +400,12 @@ omc install --force
    - 新: `{worktree}/.omc/state/`
    - 迁移: 自动，首次运行时检测并迁移
 
-2. **Marketplace 名称变更**
+1. **Marketplace 名称变更**
    - 旧: `ultrapower`
    - 新: `omc`
    - 迁移: `migrateMarketplaceName()` 自动处理
 
-3. **plugin.json 格式变更**
+1. **plugin.json 格式变更**
    - 旧: 包含 `hooks` 和 `agents` 字段
    - 新: 仅元数据，组件通过目录自动发现
    - 迁移: `fixMissingPluginJson()` 自动修复
@@ -377,30 +415,39 @@ omc install --force
 ## 故障排除命令
 
 ```bash
+
 # 诊断工具
+
 /ultrapower:omc-doctor
 
 # 检查版本
+
 omc --version
 /ultrapower:omc-help
 
 # 检查插件状态
+
 /plugin list
 
 # 检查 hooks 注册
+
 cat ~/.claude/settings.json | grep -A 30 hooks
 
 # 检查缓存完整性
+
 ls -R ~/.claude/plugins/cache/omc/ultrapower/
 
 # 检查 npm-cache 版本
+
 cat ~/.claude/plugins/npm-cache/package.json | grep ultrapower
 
 # 测试 skills
+
 /ax-status
 /ultrapower:trace
 
 # 测试 agents
+
 analyze this file
 ```
 
@@ -410,6 +457,7 @@ analyze this file
 
 ```bash
 #!/bin/bash
+
 # verify-upgrade.sh - 验证 ultrapower 升级是否成功
 
 set -e
@@ -417,8 +465,9 @@ set -e
 echo "=== ultrapower 升级验证 ==="
 
 # 1. 版本检查
+
 echo "1. 检查版本..."
-VERSION=$(omc --version 2>/dev/null || echo "未安装")
+VERSION=$(omc --version 2>/dev/null | | echo "未安装")
 echo "   当前版本: $VERSION"
 if [[ "$VERSION" != "5.5.14" ]]; then
   echo "   ❌ 版本不匹配"
@@ -427,6 +476,7 @@ fi
 echo "   ✓ 版本正确"
 
 # 2. plugin.json 检查
+
 echo "2. 检查 plugin.json..."
 PLUGIN_JSON="$HOME/.claude/plugins/cache/omc/ultrapower/5.5.14/.claude-plugin/plugin.json"
 if [[ ! -f "$PLUGIN_JSON" ]]; then
@@ -436,6 +486,7 @@ fi
 echo "   ✓ plugin.json 存在"
 
 # 3. templates/hooks/ 检查
+
 echo "3. 检查 templates/hooks/..."
 TEMPLATES_DIR="$HOME/.claude/plugins/cache/omc/ultrapower/5.5.14/templates/hooks"
 if [[ ! -d "$TEMPLATES_DIR" ]]; then
@@ -451,6 +502,7 @@ fi
 echo "   ✓ templates/hooks/ 完整"
 
 # 4. npm-cache 版本检查
+
 echo "4. 检查 npm-cache 版本锁定..."
 NPM_CACHE_PKG="$HOME/.claude/plugins/npm-cache/package.json"
 if [[ -f "$NPM_CACHE_PKG" ]]; then
@@ -464,6 +516,7 @@ if [[ -f "$NPM_CACHE_PKG" ]]; then
 fi
 
 # 5. 嵌套目录检查
+
 echo "5. 检查嵌套缓存目录..."
 NESTED_DIR="$HOME/.claude/plugins/cache/omc/ultrapower/ultrapower"
 if [[ -d "$NESTED_DIR" ]]; then
@@ -486,15 +539,18 @@ chmod +x verify-upgrade.sh
 
 ## 相关文档
 
-- [INSTALL.md](./INSTALL.md) — 完整安装指南
-- [MIGRATION.md](./MIGRATION.md) — 版本迁移指南
-- [REFERENCE.md](./REFERENCE.md) — API 参考
-- [scripts/plugin-setup.mjs](../scripts/plugin-setup.mjs) — postinstall 修复逻辑
+* [INSTALL.md](./INSTALL.md) — 完整安装指南
+
+* [MIGRATION.md](./MIGRATION.md) — 版本迁移指南
+
+* [REFERENCE.md](./REFERENCE.md) — API 参考
+
+* [scripts/plugin-setup.mjs](../scripts/plugin-setup.mjs) — postinstall 修复逻辑
 
 ---
 
 ## 更新日志
 
 | 日期 | 版本 | 变更 |
-|------|------|------|
+| ------ | ------ | ------ |
 | 2026-03-05 | 5.5.14 | 初始版本，记录完整升级流程和已知问题 |

package/docs/UPGRADE_VERIFICATION_REPORT.md

@@ -8,12 +8,17 @@
 ## ✅ 验证通过项
 
 ### 1. 构建系统
-- TypeScript 编译成功
-- Skill bridge 构建完成
-- MCP servers 打包完成 (codex/gemini/team)
-- 文档组合完成
+
+* TypeScript 编译成功
+
+* Skill bridge 构建完成
+
+* MCP servers 打包完成 (codex/gemini/team)
+
+* 文档组合完成
 
 ### 2. plugin.json 格式
+
 ```json
 {
   "name": "ultrapower",
@@ -26,12 +31,17 @@
 ✓ 无 `agents` 字段（正确，通过目录自动发现）
 
 ### 3. postinstall 修复
-- ✓ npm-cache 版本已更新: `^5.5.13` → `5.5.14`
-- ✓ plugin.json 已重建
-- ✓ HUD wrapper 已安装
-- ✓ settings.json 已配置
+
+* ✓ npm-cache 版本已更新: `^5.5.13` → `5.5.14`
+
+* ✓ plugin.json 已重建
+
+* ✓ HUD wrapper 已安装
+
+* ✓ settings.json 已配置
 
 ### 4. templates/hooks/ 完整性
+
 ```
 templates/hooks/
 ├── AGENTS.md
@@ -52,16 +62,22 @@ templates/hooks/
 ## 📋 升级流程验证
 
 ### 方式一：npm 全局安装（已验证）
+
 ```bash
 npm install -g @liangjie559567/ultrapower@5.5.14
+
 # postinstall 自动运行，修复所有已知问题
+
 ```
 
 ### 方式二：本地构建（已验证）
+
 ```bash
 cd ultrapower
 npm run build
+
 # 构建成功，所有产物正常生成
+
 ```
 
 ---
@@ -69,7 +85,7 @@ npm run build
 ## 🔧 自动修复机制验证
 
 | 修复函数 | 状态 | 说明 |
-|---------|------|------|
+| --------- | ------ | ------ |
 | `fixNpmCacheVersion()` | ✅ 已执行 | 版本范围 `^5.5.13` → `5.5.14` |
 | `fixMissingPluginJson()` | ✅ 已执行 | 重建 plugin.json |
 | `copyTemplatesToCache()` | ⏭️ 跳过 | 缓存目录不存在（首次安装） |