@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/KNOWN_ISSUES.md

@@ -5,6 +5,7 @@
 ## P0 - 立即修复（计划 v5.5.19）
 
 ### 1. State File Caching Missing
+
 **优先级**: P0 - 性能
 **影响**: 100+ sessions 时状态查询延迟 500ms
 **位置**: `src/tools/state-tools.ts:150-198`
@@ -13,6 +14,7 @@
 **目标版本**: v5.5.19
 
 ### 2. Hook Synchronous I/O Blocking
+
 **优先级**: P0 - 性能
 **影响**: Hook 执行延迟 5-15ms
 **位置**: `src/hooks/bridge.ts:112,174,601-654`
@@ -21,6 +23,7 @@
 **目标版本**: v5.5.19
 
 ### 3. Database Missing Composite Indexes
+
 **优先级**: P0 - 性能
 **影响**: 查询时间 80-90% 可优化
 **位置**: `src/mcp/job-state-db.ts:198-201`
@@ -31,6 +34,7 @@
 ## P1 - 短期修复（1个月内）
 
 ### 4. Code Duplication in Path Resolution
+
 **优先级**: P1 - 代码质量
 **影响**: 维护性和可读性
 **位置**: `src/tools/state-tools.ts`
@@ -39,6 +43,7 @@
 **目标版本**: v5.5.20
 
 ### 5. Oversized definitions.ts
+
 **优先级**: P1 - 代码质量
 **影响**: 文件可维护性
 **位置**: `src/agents/definitions.ts` (856 行)
@@ -47,6 +52,7 @@
 **目标版本**: v5.5.20
 
 ### 6. Incomplete API Contract Documentation
+
 **优先级**: P1 - API 设计
 **影响**: 开发者体验
 **位置**: `src/tools/index.ts`, `src/hooks/bridge-types.ts`
@@ -57,6 +63,7 @@
 ## P2 - 中期改进（3个月）
 
 ### 7. Git Command Performance
+
 **优先级**: P2 - 性能
 **影响**: 大型仓库操作
 **位置**: `src/tools/git-tools.ts`
@@ -65,6 +72,7 @@
 **目标版本**: v5.5.21+
 
 ### 8. String Concatenation in Hot Paths
+
 **优先级**: P2 - 性能
 **影响**: 高频操作延迟
 **位置**: 多个文件
@@ -73,6 +81,7 @@
 **目标版本**: v5.5.21+
 
 ### 9. JSON Repeated Parsing
+
 **优先级**: P2 - 性能
 **影响**: 内存和 CPU 使用
 **描述**: 同一 JSON 多次解析
@@ -80,6 +89,7 @@
 **目标版本**: v5.5.21+
 
 ### 10. Large File Streaming
+
 **优先级**: P2 - 性能
 **影响**: 大文件处理
 **描述**: 缺少流式处理
@@ -89,16 +99,23 @@
 ## 环境特定问题
 
 ### Windows 平台
-- 命令注入风险已在 v5.5.18 修复
-- 路径分隔符处理已验证
+
+* 命令注入风险已在 v5.5.18 修复
+
+* 路径分隔符处理已验证
 
 ### macOS/Linux
-- 无已知平台特定问题
+
+* 无已知平台特定问题
 
 ## 反馈和报告
 
 如发现新问题，请提交 issue 并包含：
-- 版本号
-- 复现步骤
-- 预期行为 vs 实际行为
-- 环境信息（OS、Node 版本等）
+
+* 版本号
+
+* 复现步骤
+
+* 预期行为 vs 实际行为
+
+* 环境信息（OS、Node 版本等）

package/docs/LOCAL_INSTALL_VERIFICATION.md

@@ -9,9 +9,12 @@
 ## ✅ npm pack 验证
 
 ### 打包统计
-- 总文件数: **3521**
-- 包大小: ~10MB
-- Tarball: `liangjie559567-ultrapower-5.5.14.tgz`
+
+* 总文件数: **3521**
+
+* 包大小: ~10MB
+
+* Tarball: `liangjie559567-ultrapower-5.5.14.tgz`
 
 ### 关键文件包含确认
 
@@ -28,12 +31,14 @@
 ## ✅ Tarball 内容验证
 
 ### 解压验证
+
 ```bash
 tar -xzf liangjie559567-ultrapower-5.5.14.tgz
 cd package/
 ```
 
 ### plugin.json 格式
+
 ```json
 {
   "name": "ultrapower",
@@ -48,14 +53,17 @@ cd package/
 ✓ 格式符合 Claude Code 插件规范
 
 ### templates/hooks/ 完整性
-- 17 个 `.mjs` 文件
-- 包含所有 hook 实现
+
+* 17 个 `.mjs` 文件
+
+* 包含所有 hook 实现
 
 ---
 
 ## ✅ postinstall 执行验证
 
 ### 运行输出
+
 ```
 [OMC] Running post-install setup...
 [OMC] Wrote .claude-plugin/plugin.json in install dir
@@ -90,25 +98,33 @@ ls -la ~/.claude/hud/omc-hud.mjs
 ## ✅ 完整安装流程模拟
 
 ### 步骤 1: 打包
+
 ```bash
 cd ultrapower/
 npm pack
+
 # 生成: liangjie559567-ultrapower-5.5.14.tgz
+
 ```
 
 ### 步骤 2: 解压
+
 ```bash
 tar -xzf liangjie559567-ultrapower-5.5.14.tgz
 cd package/
 ```
 
 ### 步骤 3: postinstall
+
 ```bash
 node scripts/plugin-setup.mjs
+
 # 自动配置 HUD + settings.json
+
 ```
 
 ### 步骤 4: 验证
+
 ```bash
 cat .claude-plugin/plugin.json  # ✓ 格式正确
 ls templates/hooks/*.mjs        # ✓ 17 个文件
@@ -120,18 +136,23 @@ ls ~/.claude/hud/omc-hud.mjs    # ✓ 已创建
 ## 🎯 用户安装流程
 
 ### 方式一: npm 全局安装
+
 ```bash
 npm install -g @liangjie559567/ultrapower@5.5.14
+
 # postinstall 自动运行
+
 ```
 
 ### 方式二: 插件市场
+
 ```
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 /plugin install omc@ultrapower
 ```
 
 ### 方式三: 本地 tarball
+
 ```bash
 npm install -g ./liangjie559567-ultrapower-5.5.14.tgz
 ```
@@ -140,15 +161,23 @@ npm install -g ./liangjie559567-ultrapower-5.5.14.tgz
 
 ## ✅ 验证检查清单
 
-- [x] npm pack 成功生成 tarball
-- [x] tarball 包含所有必需文件
-- [x] .claude-plugin/ 目录存在
-- [x] plugin.json 格式正确
-- [x] templates/hooks/ 完整
-- [x] postinstall 脚本正常执行
-- [x] HUD wrapper 已创建
-- [x] settings.json 已配置
-- [x] 无 hooks/agents 字段冲突
+* [x] npm pack 成功生成 tarball
+
+* [x] tarball 包含所有必需文件
+
+* [x] .claude-plugin/ 目录存在
+
+* [x] plugin.json 格式正确
+
+* [x] templates/hooks/ 完整
+
+* [x] postinstall 脚本正常执行
+
+* [x] HUD wrapper 已创建
+
+* [x] settings.json 已配置
+
+* [x] 无 hooks/agents 字段冲突
 
 ---
 

package/docs/LOCAL_PLUGIN_INSTALL.md

@@ -5,34 +5,45 @@
 ## 快速安装
 
 ```bash
+
 # 1. 将本地目录添加为 marketplace
+
 claude plugin marketplace add /path/to/ultrapower
 
 # 2. 从本地 marketplace 安装插件
+
 claude plugin install omc@ultrapower
 
 # 3. 重启 Claude Code 以加载插件
+
 ```
 
 ## 命令参考
 
 ```bash
+
 # 列出已配置的 marketplace
+
 claude plugin marketplace list
 
 # 更新 marketplace（从源重新读取）
+
 claude plugin marketplace update omc
 
 # 更新已安装的插件
+
 claude plugin update omc@ultrapower
 
 # 列出已安装的插件
+
 claude plugin list
 
 # 卸载
+
 claude plugin uninstall omc@ultrapower
 
 # 移除 marketplace
+
 claude plugin marketplace remove omc
 ```
 
@@ -61,22 +72,27 @@ claude plugin marketplace remove omc
 对插件进行修改后：
 
 ```bash
+
 # 1. 构建（如有 TypeScript 变更）
+
 npm run build
 
 # 2. 更新 marketplace 缓存
+
 claude plugin marketplace update omc
 
 # 3. 更新已安装的插件
+
 claude plugin update omc@ultrapower
 
 # 4. 重启 Claude Code 会话
+
 ```
 
 ## 与 npm 全局安装的对比
 
 | 方式 | 命令 | 文件位置 |
-|--------|---------|----------------|
+| -------- | --------- | ---------------- |
 | 插件 | `claude plugin install` | `~/.claude/plugins/cache/` |
 | npm 全局 | `npm install -g` | `~/.claude/agents/`, `~/.claude/commands/` |
 
@@ -85,10 +101,15 @@ claude plugin update omc@ultrapower
 ## 故障排除
 
 **插件未加载：**
-- 安装后重启 Claude Code
-- 检查 `claude plugin list` 显示状态为"enabled"
-- 验证 plugin.json 存在且为有效 JSON
+
+* 安装后重启 Claude Code
+
+* 检查 `claude plugin list` 显示状态为"enabled"
+
+* 验证 plugin.json 存在且为有效 JSON
 
 **显示旧版本：**
-- 缓存目录名称可能显示旧版本，但实际代码来自最新提交
-- 运行 `claude plugin marketplace update` 然后 `claude plugin update`
+
+* 缓存目录名称可能显示旧版本，但实际代码来自最新提交
+
+* 运行 `claude plugin marketplace update` 然后 `claude plugin update`

package/docs/LOCAL_TEST_INSTALL_REPORT.md

@@ -9,6 +9,7 @@
 ## ✅ 安装验证
 
 ### 命令执行
+
 ```bash
 npm install -g ./liangjie559567-ultrapower-5.5.14.tgz
 ```
@@ -66,12 +67,14 @@ which omc
 ## ✅ postinstall 效果
 
 ### HUD wrapper
+
 ```bash
 ls ~/.claude/hud/omc-hud.mjs
 ```
 ✓ 文件存在
 
 ### settings.json
+
 ```json
 {
   "statusLine": {
@@ -88,9 +91,12 @@ ls ~/.claude/hud/omc-hud.mjs
 
 **本地测试安装成功**
 
-- 全局安装正常
-- CLI 命令可用
-- postinstall 自动配置
-- 版本号正确
+* 全局安装正常
+
+* CLI 命令可用
+
+* postinstall 自动配置
+
+* 版本号正确
 
 **可以安全发布到 npm registry。**

package/docs/MAIN_DOCS_UPDATE_REPORT.md

@@ -8,31 +8,44 @@
 ## ✅ 已修复的数据不一致
 
 ### 实际数据（来自代码库）
-- Agents: **50** 个 (agents/*.md)
-- Skills: **71** 个 (skills/*/)
-- Hook 事件类型: **14** 个 (hooks/hooks.json)
-- 版本: **5.5.14** (package.json)
+
+* Agents: **50** 个 (agents/*.md)
+
+* Skills: **71** 个 (skills/*/)
+
+* Hook 事件类型: **14** 个 (hooks/hooks.json)
+
+* 版本: **5.5.14** (package.json)
 
 ### 更新前的文档数据
-- README.md: 49 agents ❌
-- AGENTS.md: 49 agents ❌
+
+* README.md: 49 agents ❌
+
+* AGENTS.md: 49 agents ❌
 
 ### 更新后的文档数据
-- README.md: 50 agents ✅
-- AGENTS.md: 50 agents ✅
+
+* README.md: 50 agents ✅
+
+* AGENTS.md: 50 agents ✅
 
 ---
 
 ## 📝 更新内容
 
 ### README.md
-- 第 3 行: `49 个专业 agents` → `50 个专业 agents`
-- 第 48 行: `## Agents（49 个）` → `## Agents（50 个）`
+
+* 第 3 行: `49 个专业 agents` → `50 个专业 agents`
+
+* 第 48 行: `## Agents（49 个）` → `## Agents（50 个）`
 
 ### AGENTS.md
-- 多处: `49 个智能体` → `50 个智能体`
-- 架构图: `(49 agents)` → `(50 agents)`
-- 标题: `## 智能体概览（共 49 个）` → `## 智能体概览（共 50 个）`
+
+* 多处: `49 个智能体` → `50 个智能体`
+
+* 架构图: `(49 agents)` → `(50 agents)`
+
+* 标题: `## 智能体概览（共 49 个）` → `## 智能体概览（共 50 个）`
 
 ---