@liangjie559567/ultrapower 5.5.2 → 5.5.3

package/docs/RELEASE_NOTES_v5.5.14.md

@@ -0,0 +1,97 @@
+# ultrapower v5.5.14 Release Notes
+
+**发布日期**: 2026-03-05
+**类型**: Bug Fix + Verification
+
+---
+
+## 🎯 核心改进
+
+### 插件安装和升级流程修复
+
+修复了 6 个影响用户升级体验的关键问题：
+
+1. **npm-cache 版本锁定** - 用户点击 "Update now" 后停留在旧版本
+2. **plugin.json 缺失** - npm 剥离隐藏目录导致插件无法加载
+3. **Windows 嵌套目录** - 无限嵌套导致 Claude Code 无法启动
+4. **templates/hooks/ 缺失** - Hook 执行时报错找不到模块
+5. **marketplace 名称迁移** - 从 `ultrapower` 到 `omc` 的自动迁移
+6. **npm-cache plugin.json 损坏** - 旧版本遗留的无效字段
+
+所有修复通过 `scripts/plugin-setup.mjs` 的 postinstall 自动执行。
+
+---
+
+## 🔒 安全加固
+
+- **路径遍历防护增强**: `assertValidMode()` 添加字符串截断保护
+- 所有状态文件操作强制通过安全校验
+
+---
+
+## ✅ 完整验证
+
+本次发布经过全面验证：
+
+### 构建验证
+- 3524 个文件成功打包
+- TypeScript 编译无错误
+- 所有 bridge 服务器已打包
+
+### 组件完整性
+- 50 个 agents
+- 71 个 skills
+- 14 个 hook 事件类型
+- 17 个 hook 实现文件
+
+### 安装测试
+- ✅ npm 全局安装
+- ✅ 插件市场安装
+- ✅ 本地 tarball 安装
+- ✅ postinstall 自动修复
+- ✅ HUD 配置
+- ✅ CLI 命令可用
+
+---
+
+## 📦 升级方式
+
+### 推荐：插件市场
+```
+/plugin update ultrapower
+```
+
+### 备选：npm 全局
+```bash
+npm install -g @liangjie559567/ultrapower@latest
+```
+
+---
+
+## 🐛 已知问题修复
+
+| 问题 | 影响 | 修复 |
+|------|------|------|
+| npm-cache 版本锁定 | 升级跳过下载 | `fixNpmCacheVersion()` |
+| plugin.json 缺失 | 插件无法加载 | `fixMissingPluginJson()` |
+| Windows 嵌套目录 | 启动失败 | `fixNestedCacheDir()` |
+| templates/hooks/ 缺失 | Hook 执行失败 | `copyTemplatesToCache()` |
+
+---
+
+## 📄 验证文档
+
+完整验证报告：
+- `docs/UPGRADE_VERIFICATION.md` - 升级指南
+- `docs/PLUGIN_MARKETPLACE_VERIFICATION.md` - 插件市场验证
+- `docs/LOCAL_INSTALL_VERIFICATION.md` - 本地安装验证
+- `docs/VERIFICATION_SUMMARY.md` - 总结报告
+- `scripts/verify-all.sh` - 自动化验证脚本
+
+---
+
+## 🔗 相关链接
+
+- [完整 CHANGELOG](../CHANGELOG.md)
+- [升级指南](./UPGRADE_VERIFICATION.md)
+- [GitHub Issues](https://github.com/liangjie559567/ultrapower/issues)

package/docs/RELEASE_SUMMARY_v5.5.18.md

@@ -0,0 +1,60 @@
+# v5.5.18 Release Summary
+
+**发布日期**: 2026-03-06
+**版本**: 5.5.18
+**状态**: 稳定版本
+
+## 核心成果
+
+### 安全性加固
+- ✅ permission-request hook 阻塞模式实现
+- ✅ 环境变量验证机制
+- ✅ 安全 JSON 解析函数
+- ✅ Windows 命令注入防护
+
+### 性能优化
+- ✅ 构建时间: 5.8s → 2.4s (-59.6%)
+- ✅ Worker 健康检查: 50ms → 10ms (-80%)
+- ✅ Worker 状态查询: 20ms → 5ms (-75%)
+- ✅ 内存占用: -30%
+
+### 质量提升
+- ✅ 测试覆盖率: 54.55% → 56-58%
+- ✅ 新增测试: 472 个（100% 通过）
+- ✅ 所有 6249 个测试通过，无回归
+
+### 架构改进
+- ✅ Worker 后端统一
+- ✅ 消除 400-500 行重复代码
+- ✅ 缓存层性能提升 4-5 倍
+
+## 关键指标
+
+| 指标 | 改进前 | 改进后 | 变化 |
+|------|--------|--------|------|
+| 整体测试覆盖率 | 54.55% | 56-58% | +2-4% |
+| 构建时间 | 5.8s | 2.4s | -59.6% |
+| Worker 健康检查 | ~50ms | <10ms | -80% |
+| 内存占用 | 31MB | -30% | -30% |
+
+## 交付物
+
+- **代码文件**: 15 个新增，12 个修改
+- **测试文件**: 20 个新增
+- **文档**: CHANGELOG、已知问题、迁移指南
+
+## 无破坏性变更
+
+v5.5.18 完全向后兼容，所有 API 保持稳定。
+
+## 下一步
+
+- **v5.5.19**: 性能优化（缓存、异步 I/O、数据库索引）
+- **v5.5.20**: 代码质量改进（重构、API 文档）
+- **v5.5.21+**: 中期优化（Git、字符串、流式处理）
+
+## 文档
+
+- [CHANGELOG.md](../CHANGELOG.md) - 详细变更日志
+- [KNOWN_ISSUES.md](./KNOWN_ISSUES.md) - 已知问题和修复计划
+- [MIGRATION_GUIDE_v5.5.18.md](./MIGRATION_GUIDE_v5.5.18.md) - 升级指南

package/docs/TUTORIAL.md

@@ -0,0 +1,223 @@
+# ultrapower 交互式教程
+
+**版本**: v5.5.18
+**预计完成时间**: 30 分钟
+
+---
+
+## 教程概览
+
+本教程包含 5 个场景，帮助你掌握 ultrapower 的核心功能：
+
+1. ✅ 环境验证与配置
+2. ✅ 使用第一个 agent（executor）
+3. ✅ 创建自定义 skill
+4. ✅ 配置 hook 自动化
+5. ✅ 团队协作模式（team）
+
+---
+
+## 场景 1: 环境验证与配置
+
+### 目标
+验证 ultrapower 安装正确，配置基本环境。
+
+### 步骤
+
+**1.1 验证安装**
+```bash
+/ultrapower:omc-doctor
+```
+
+**预期输出**:
+```
+✅ ultrapower v5.5.18
+✅ Node.js v18.x.x
+✅ Claude Code v1.x.x
+✅ All systems ready
+```
+
+**1.2 查看可用 agents**
+```bash
+/ultrapower:omc-help agents
+```
+
+**1.3 查看可用 skills**
+```bash
+/ultrapower:omc-help skills
+```
+
+### 验证
+- [ ] omc-doctor 显示全部 ✅
+- [ ] 能看到 50+ agents 列表
+- [ ] 能看到 70+ skills 列表
+
+---
+
+## 场景 2: 使用第一个 agent（executor）
+
+### 目标
+学习如何调用 agent 执行代码任务。
+
+### 步骤
+
+**2.1 创建简单函数**
+```
+Task(subagent_type="ultrapower:executor", prompt="创建一个计算两数之和的函数 add.ts")
+```
+
+**预期输出**:
+```typescript
+export function add(a: number, b: number): number {
+  return a + b;
+}
+```
+
+**2.2 添加测试**
+```
+Task(subagent_type="ultrapower:test-engineer", prompt="为 add 函数添加单元测试")
+```
+
+**预期输出**:
+```typescript
+import { add } from './add';
+
+describe('add', () => {
+  it('should add two numbers', () => {
+    expect(add(1, 2)).toBe(3);
+  });
+});
+```
+
+### 验证
+- [ ] 函数代码已生成
+- [ ] 测试代码已生成
+- [ ] 测试通过
+
+---
+
+## 场景 3: 创建自定义 skill
+
+### 目标
+学习如何创建自定义 skill。
+
+### 步骤
+
+**3.1 创建 skill 目录**
+```bash
+mkdir -p skills/my-skill
+```
+
+**3.2 创建 SKILL.md**
+```markdown
+# My Custom Skill
+
+触发词: "my-skill"
+
+## 描述
+这是我的第一个自定义 skill。
+
+## 执行逻辑
+1. 读取用户输入
+2. 调用 executor agent
+3. 返回结果
+```
+
+**3.3 测试 skill**
+```
+/ultrapower:my-skill "测试任务"
+```
+
+### 验证
+- [ ] skill 文件已创建
+- [ ] skill 可以被触发
+- [ ] skill 执行成功
+
+---
+
+## 场景 4: 配置 hook 自动化
+
+### 目标
+学习如何配置 hook 实现自动化。
+
+### 步骤
+
+**4.1 创建 hook 配置**
+```json
+// .claude/hooks/auto-format.json
+{
+  "name": "auto-format",
+  "event": "PostToolUse",
+  "condition": "tool_name === 'Edit'",
+  "action": "prettier --write {{file_path}}"
+}
+```
+
+**4.2 测试 hook**
+```
+# 编辑任意文件
+Edit(file_path="test.ts", old_string="...", new_string="...")
+
+# hook 会自动运行 prettier
+```
+
+**4.3 验证 hook 执行**
+```bash
+cat .omc/logs/hook-execution.log
+```
+
+### 验证
+- [ ] hook 配置已创建
+- [ ] 编辑文件后 hook 自动触发
+- [ ] 文件已格式化
+
+---
+
+## 场景 5: 团队协作模式（team）
+
+### 目标
+学习如何使用 team 模式进行多 agent 协作。
+
+### 步骤
+
+**5.1 启动 team 模式**
+```
+team "重构用户认证模块"
+```
+
+**5.2 观察流水线执行**
+```
+team-plan → team-prd → team-exec → team-verify → team-fix
+```
+
+**5.3 查看任务状态**
+```
+TaskList()
+```
+
+**5.4 查看执行结果**
+```
+# team 会自动完成所有阶段
+# 最终输出验证报告
+```
+
+### 验证
+- [ ] team 模式启动成功
+- [ ] 所有阶段顺序执行
+- [ ] 最终状态为 complete
+
+---
+
+## 下一步
+
+恭喜完成教程！你现在可以：
+
+- 查看 [USER_GUIDE.md](USER_GUIDE.md) 了解更多功能
+- 查看 [REFERENCE.md](REFERENCE.md) 获取完整参考
+- 加入社区讨论：[GitHub Discussions](https://github.com/liangjie559567/ultrapower/discussions)
+
+---
+
+## 故障排查
+
+遇到问题？查看 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)