@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/PERFORMANCE-MONITORING.md

@@ -6,16 +6,22 @@
 
 ## 目录
 
-- [概述](#overview)
-- [内置监控](#built-in-monitoring)
+* [概述](#overview)
+
+* [内置监控](#built-in-monitoring)
   - [Agent Observatory](#agent-observatory)
   - [Token 与费用分析](#token--cost-analytics)
   - [会话回放](#session-replay)
-- [HUD 集成](#hud-integration)
-- [调试技术](#debugging-techniques)
-- [外部资源](#external-resources)
-- [最佳实践](#best-practices)
-- [故障排除](#troubleshooting)
+
+* [HUD 集成](#hud-integration)
+
+* [调试技术](#debugging-techniques)
+
+* [外部资源](#external-resources)
+
+* [最佳实践](#best-practices)
+
+* [故障排除](#troubleshooting)
 
 ---
 
@@ -26,7 +32,7 @@ ultrapower 提供全面的监控功能，用于追踪 agent 性能、token 使
 ### 可监控的内容
 
 | 指标 | 工具 | 粒度 |
-|--------|------|-------------|
+| -------- | ------ | ------------- |
 | Agent 生命周期 | Agent Observatory | 每个 agent |
 | 工具计时 | 会话回放 | 每次工具调用 |
 | Token 使用量 | 分析系统 | 每个会话/agent |
@@ -68,7 +74,7 @@ Agent Observatory (3 active, 85% efficiency)
 #### 状态指示器
 
 | 图标 | 含义 |
-|------|---------|
+| ------ | --------- |
 | 🟢 | 健康——agent 正常运行 |
 | 🟡 | 警告——建议干预 |
 | 🔴 | 严重——agent 已停滞（>5 分钟） |
@@ -76,7 +82,7 @@ Agent Observatory (3 active, 85% efficiency)
 #### 关键指标
 
 | 指标 | 描述 |
-|--------|-------------|
+| -------- | ------------- |
 | `tools:N` | 已进行的工具调用次数 |
 | `tokens:Nk` | 近似 token 使用量（千） |
 | `$X.XX` | 估算费用（美元） |
@@ -90,21 +96,27 @@ OMC 自动追踪所有会话的 token 使用情况和费用。
 #### CLI 命令
 
 ```bash
+
 # 查看当前会话统计
+
 omc stats
 
 # 查看每日/每周/每月费用报告
+
 omc cost daily
 omc cost weekly
 omc cost monthly
 
 # 查看会话历史
+
 omc sessions
 
 # 查看 agent 明细
+
 omc agents
 
 # 导出数据
+
 omc export cost csv ./costs.csv
 ```
 
@@ -121,26 +133,35 @@ omc export cost csv ./costs.csv
 ```
 
 显示内容：
-- 会话费用和 token 数
-- 每小时费用
-- 缓存效率（来自缓存的 token 百分比）
-- 预算警告（>$2 警告，>$5 严重警告）
+
+* 会话费用和 token 数
+
+* 每小时费用
+
+* 缓存效率（来自缓存的 token 百分比）
+
+* 预算警告（>$2 警告，>$5 严重警告）
 
 #### 回填历史数据
 
 分析历史 Claude Code 转录：
 
 ```bash
+
 # 预览可用转录
+
 omc backfill --dry-run
 
 # 回填所有转录
+
 omc backfill
 
 # 回填特定项目
+
 omc backfill --project "*my-project*"
 
 # 仅回填最近的
+
 omc backfill --from "2026-01-01"
 ```
 
@@ -151,7 +172,7 @@ omc backfill --from "2026-01-01"
 #### 事件类型
 
 | 事件 | 描述 |
-|-------|-------------|
+| ------- | ------------- |
 | `agent_start` | Agent 已生成，包含任务信息 |
 | `agent_stop` | Agent 已完成/失败，包含持续时间 |
 | `tool_start` | 工具调用开始 |
@@ -186,9 +207,12 @@ console.log(`Files touched:`, summary.files_touched);
 #### 瓶颈检测
 
 回放系统自动识别瓶颈：
-- 平均耗时 >1s 且调用次数 ≥2 的工具
-- 每个 agent 的工具计时分析
-- 按影响排序（平均时间最长的优先）
+
+* 平均耗时 >1s 且调用次数 ≥2 的工具
+
+* 每个 agent 的工具计时分析
+
+* 按影响排序（平均时间最长的优先）
 
 ---
 
@@ -197,7 +221,7 @@ console.log(`Files touched:`, summary.files_touched);
 ### 预设
 
 | 预设 | 关注点 | 元素 |
-|--------|-------|----------|
+| -------- | ------- | ---------- |
 | `minimal` | 简洁状态 | 仅上下文栏 |
 | `focused` | 任务进度 | Todos、agents、模式 |
 | `full` | 全部内容 | 所有元素启用 |
@@ -225,7 +249,7 @@ console.log(`Files touched:`, summary.files_touched);
 ### 自定义元素
 
 | 元素 | 描述 |
-|---------|-------------|
+| --------- | ------------- |
 | `agents` | 活跃 agent 数量和状态 |
 | `todos` | Todo 进度（已完成/总计） |
 | `ralph` | Ralph 循环迭代次数 |
@@ -269,7 +293,7 @@ conflicts.forEach(c => {
 OMC 自动检测有问题的 agent：
 
 | 干预 | 触发条件 | 操作 |
-|--------------|---------|--------|
+| -------------- | --------- | -------- |
 | `timeout` | Agent 运行 >5 分钟 | 建议终止 |
 | `excessive_cost` | 费用 >$1.00 | 警告 |
 | `file_conflict` | 多个 agent 操作同一文件 | 警告 |
@@ -295,9 +319,11 @@ console.log(`Efficiency: ${eff.score}%`);
 console.log(`Active: ${eff.active}, Stale: ${eff.stale}, Total: ${eff.total}`);
 ```
 
-- **100%**：所有 agent 都在积极工作
-- **<80%**：部分 agent 停滞或等待
-- **<50%**：并行化存在重大问题
+* **100%**：所有 agent 都在积极工作
+
+* **<80%**：部分 agent 停滞或等待
+
+* **<50%**：并行化存在重大问题
 
 ### 清理停滞 Agent
 
@@ -320,10 +346,13 @@ console.log(`Cleaned ${cleaned} stale agents`);
 
 [MarginLab.ai](https://marginlab.ai) 提供 Claude 模型的外部性能追踪：
 
-- **SWE-Bench-Pro 每日追踪**：监控 Claude 在软件工程基准测试上的表现
-- **统计显著性测试**：通过置信区间检测性能下降
-- **历史趋势**：追踪 Claude 随时间的能力变化
-- **模型对比**：比较不同 Claude 模型版本的性能
+* **SWE-Bench-Pro 每日追踪**：监控 Claude 在软件工程基准测试上的表现
+
+* **统计显著性测试**：通过置信区间检测性能下降
+
+* **历史趋势**：追踪 Claude 随时间的能力变化
+
+* **模型对比**：比较不同 Claude 模型版本的性能
 
 #### 用法
 
@@ -336,7 +365,7 @@ console.log(`Cleaned ${cleaned} stale agents`);
 ### 社区资源
 
 | 资源 | 描述 | 链接 |
-|----------|-------------|------|
+| ---------- | ------------- | ------ |
 | Claude Code Discord | 社区支持和技巧 | [discord.gg/anthropic](https://discord.gg/anthropic) |
 | OMC GitHub Issues | 错误报告和功能请求 | [GitHub Issues](https://github.com/liangjie559567/ultrapower/issues) |
 | Anthropic Documentation | 官方 Claude 文档 | [docs.anthropic.com](https://docs.anthropic.com) |
@@ -346,7 +375,7 @@ console.log(`Cleaned ${cleaned} stale agents`);
 追踪 Claude 在标准基准测试中的表现：
 
 | 基准测试 | 测量内容 | 追踪位置 |
-|-----------|-----------------|----------------|
+| ----------- | ----------------- | ---------------- |
 | SWE-Bench | 软件工程任务 | MarginLab.ai |
 | HumanEval | 代码生成准确性 | 公开排行榜 |
 | MMLU | 通用知识 | Anthropic 博客 |
@@ -358,15 +387,19 @@ console.log(`Cleaned ${cleaned} stale agents`);
 ### 1. 主动监控 Token 使用情况
 
 ```bash
+
 # 在 HUD 中设置预算警告
+
 /ultrapower:hud
+
 # 选择 "analytics" 预设
+
 ```
 
 ### 2. 使用合适的模型层级
 
 | 任务类型 | 推荐模型 | 费用影响 |
-|-----------|------------------|-------------|
+| ----------- | ------------------ | ------------- |
 | 文件查找 | Haiku | 最低 |
 | 功能实现 | Sonnet | 中等 |
 | 架构决策 | Opus | 最高 |
@@ -376,10 +409,13 @@ console.log(`Cleaned ${cleaned} stale agents`);
 会话回放自动启用。复杂工作流完成后查看回放：
 
 ```bash
+
 # 查找回放文件
+
 ls .omc/state/agent-replay-*.jsonl
 
 # 查看最近事件
+
 tail -20 .omc/state/agent-replay-*.jsonl
 ```
 
@@ -466,7 +502,7 @@ cleanupReplayFiles(process.cwd()); // 保留最近 10 个会话
 ## 状态文件参考
 
 | 文件 | 用途 | 格式 |
-|------|---------|--------|
+| ------ | --------- | -------- |
 | `.omc/state/subagent-tracking.json` | 当前 agent 状态 | JSON |
 | `.omc/state/agent-replay-{id}.jsonl` | 会话事件时间线 | JSONL |
 | `.omc/state/token-tracking.jsonl` | Token 使用日志 | JSONL |
@@ -525,6 +561,8 @@ cleanupReplayFiles(directory: string): number
 
 ## 另请参阅
 
-- [Analytics System](./ANALYTICS-SYSTEM.md) - 详细的 token 追踪文档
-- [Reference](./REFERENCE.md) - 完整功能参考
-- [Architecture](./ARCHITECTURE.md) - 系统架构概述
+* [Analytics System](./ANALYTICS-SYSTEM.md) - 详细的 token 追踪文档
+
+* [Reference](./REFERENCE.md) - 完整功能参考
+
+* [Architecture](./ARCHITECTURE.md) - 系统架构概述

package/docs/PLUGIN_MARKETPLACE_VERIFICATION.md

@@ -9,6 +9,7 @@
 ## ✅ 插件结构验证
 
 ### marketplace.json
+
 ```json
 {
   "name": "omc",
@@ -28,6 +29,7 @@
 ✓ npm 包源配置正确
 
 ### plugin.json
+
 ```json
 {
   "name": "ultrapower",
@@ -42,18 +44,21 @@
 ## ✅ 组件清单
 
 ### Agents: 50 个
+
 ```
 accessibility-auditor.md, analyst.md, api-designer.md, api-reviewer.md,
 architect.md, axiom-* (14个), build-fixer.md, code-reviewer.md, ...
 ```
 
 ### Skills: 72 个
+
 ```
 analyze, autopilot, ax-* (14个), brainstorming, build-fix, cancel,
 ccg, code-review, configure-*, deepinit, deepsearch, ...
 ```
 
 ### Hooks: 14 个事件类型
+
 ```json
 {
   "SessionStart": [...],
@@ -80,6 +85,7 @@ ccg, code-review, configure-*, deepinit, deepsearch, ...
 ## ✅ 构建产物
 
 ### dist/ 目录
+
 ```
 agents/, analytics/, audit/, cli/, commands/, compatibility/,
 config/, constants/, core/, features/, hud/, hooks/, lib/,
@@ -91,6 +97,7 @@ mcp/, state/, tools/, types/, utils/, index.js
 ✓ HUD 模块已构建
 
 ### bridge/ 目录
+
 ```
 mcp-server.cjs, codex-server.cjs, gemini-server.cjs, team-bridge.cjs
 ```
@@ -106,7 +113,7 @@ mcp-server.cjs, codex-server.cjs, gemini-server.cjs, team-bridge.cjs
 
 **步骤 1: 添加 marketplace**
 ```
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 ```
 
 **步骤 2: 安装插件**
@@ -160,14 +167,19 @@ Claude Code 插件系统会自动发现：
 ### 从 5.2.x → 5.5.14
 
 **自动迁移项**:
-- Marketplace 名称: `ultrapower` → `omc`
-- 状态文件路径: `~/.claude/.omc/` → `{worktree}/.omc/`
-- plugin.json 格式: 移除 hooks/agents 字段
+
+* Marketplace 名称: `ultrapower` → `omc`
+
+* 状态文件路径: `~/.claude/.omc/` → `{worktree}/.omc/`
+
+* plugin.json 格式: 移除 hooks/agents 字段
 
 **用户操作**:
 ```
 /plugin update ultrapower
+
 # 重启 Claude Code
+
 ```
 
 ---
@@ -176,10 +188,13 @@ Claude Code 插件系统会自动发现：
 
 **插件市场升级流程完整可靠**
 
-- 所有组件完整（50 agents, 72 skills, 14 hook types）
-- 自动发现机制正常工作
-- postinstall 修复所有已知问题
-- marketplace.json 配置正确
+* 所有组件完整（50 agents, 72 skills, 14 hook types）
+
+* 自动发现机制正常工作
+
+* postinstall 修复所有已知问题
+
+* marketplace.json 配置正确
 
 **推荐升级方式**: 插件市场更新（最简单）
 ```

package/docs/QUICKSTART.md

@@ -7,7 +7,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
 ```
@@ -29,7 +29,7 @@ autopilot "创建一个 hello world 函数"
 ## 最常用的 5 个 Skills
 
 | Skill | 用途 | 示例 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | **autopilot** | 全自动从想法到代码 | `autopilot "添加用户认证"` |
 | **ultrawork** | 并行执行多个任务 | `ultrawork "任务1" "任务2"` |
 | **team** | 多 agent 协作编排 | `team "设计并实现登录流程"` |
@@ -77,7 +77,7 @@ team "重构认证模块"
 ### Q1: 如何选择执行模式？
 
 | 场景 | 推荐模式 |
-|------|---------|
+| ------ | --------- |
 | 简单功能，快速交付 | `autopilot` |
 | 复杂任务，需要自动修复 | `ralph` |
 | 大型功能，需要多 agent 协作 | `team` |
@@ -107,7 +107,10 @@ team "重构认证模块"
 
 ## 下一步
 
-- 详细文档：[docs/REFERENCE.md](./REFERENCE.md)
-- 架构设计：[docs/ARCHITECTURE.md](./ARCHITECTURE.md)
-- 故障排查：[docs/guides/troubleshooting-guide.md](./guides/troubleshooting-guide.md)
-- 工作流指南：[docs/guides/workflow-recommendation-guide.md](./guides/workflow-recommendation-guide.md)
+* 详细文档：[docs/REFERENCE.md](./REFERENCE.md)
+
+* 架构设计：[docs/ARCHITECTURE.md](./ARCHITECTURE.md)
+
+* 故障排查：[docs/guides/troubleshooting-guide.md](./guides/troubleshooting-guide.md)
+
+* 工作流指南：[docs/guides/workflow-recommendation-guide.md](./guides/workflow-recommendation-guide.md)

package/docs/README.codex.md

@@ -7,32 +7,33 @@
 告诉 Codex：
 
 ```
-Fetch and follow instructions from https://raw.githubusercontent.com/liangjie559567/ultrapower/refs/heads/main/.codex/INSTALL.md
+Fetch and follow instructions from <https://raw.githubusercontent.com/liangjie559567/ultrapower/refs/heads/main/.codex/INSTALL.md>
 ```
 
 ## 手动安装
 
 ### 前提条件
 
-- OpenAI Codex CLI
-- Git
+* OpenAI Codex CLI
+
+* Git
 
 ### 步骤
 
 1. 克隆仓库：
    ```bash
-   git clone https://github.com/liangjie559567/ultrapower.git ~/.codex/ultrapower
+   git clone <https://github.com/liangjie559567/ultrapower.git> ~/.codex/ultrapower
    ```
 
-2. 创建 skills 符号链接：
+1. 创建 skills 符号链接：
    ```bash
    mkdir -p ~/.agents/skills
    ln -s ~/.codex/ultrapower/skills ~/.agents/skills/ultrapower
    ```
 
-3. 重启 Codex。
+1. 重启 Codex。
 
-4. **For subagent skills** (optional): Skills like `dispatching-parallel-agents` and `subagent-driven-development` require Codex's collab feature. Add to your Codex config:
+1. **For subagent skills** (optional): Skills like `dispatching-parallel-agents` and `subagent-driven-development` require Codex's collab feature. Add to your Codex config:
    ```toml
    [features]
    collab = true
@@ -60,9 +61,12 @@ Codex 具有原生 skill 发现功能——它在启动时扫描 `~/.agents/skil
 ## 使用方法
 
 Skills 会被自动发现。Codex 在以下情况激活它们：
-- 你按名称提及某个 skill（例如，"use brainstorming"）
-- 任务与某个 skill 的描述匹配
-- `using-superpowers` skill 指示 Codex 使用某个 skill
+
+* 你按名称提及某个 skill（例如，"use brainstorming"）
+
+* 任务与某个 skill 的描述匹配
+
+* `using-superpowers` skill 指示 Codex 使用某个 skill
 
 ### 个人 Skills
 
@@ -122,5 +126,6 @@ Junction 通常无需特殊权限即可工作。如果创建失败，请尝试
 
 ## 获取帮助
 
-- 报告问题：https://github.com/liangjie559567/ultrapower/issues
-- 主要文档：https://github.com/liangjie559567/ultrapower
+* 报告问题：<https://github.com/liangjie559567/ultrapower/issues>
+
+* 主要文档：<https://github.com/liangjie559567/ultrapower>

package/docs/README.md

@@ -9,72 +9,102 @@
 
 ## 🚀 快速导航
 
-- [5 分钟安装](./getting-started/installation.md)
-- [15 分钟快速开始](./getting-started/quickstart.md)
-- [核心概念](./getting-started/concepts.md)
+* [5 分钟安装](./getting-started/installation.md)
+
+* [15 分钟快速开始](./getting-started/quickstart.md)
+
+* [核心概念](./getting-started/concepts.md)
 
 ---
 
 ## 👥 按角色查找
 
 ### 新用户
+
 刚开始使用 ultrapower？从这里开始：
-- [快速开始](./getting-started/quickstart.md) - 20 分钟内跑通第一个示例
-- [核心概念](./getting-started/concepts.md) - 理解 agents、skills、hooks、tools
+
+* [快速开始](./getting-started/quickstart.md) - 20 分钟内跑通第一个示例
+
+* [核心概念](./getting-started/concepts.md) - 理解 agents、skills、hooks、tools
 
 ### 日常用户
+
 查找特定功能的使用方法：
-- [Agents 列表](./features/agents.md) - 50 个专业 agents
-- [Skills 列表](./features/skills.md) - 71 个工作流 skills
-- [Hooks 系统](./features/hooks.md) - 47 个事件 hooks
-- [工具参考](./features/tools.md) - 35 个自定义工具
+
+* [Agents 列表](./features/agents.md) - 50 个专业 agents
+
+* [Skills 列表](./features/skills.md) - 71 个工作流 skills
+
+* [Hooks 系统](./features/hooks.md) - 47 个事件 hooks
+
+* [工具参考](./features/tools.md) - 35 个自定义工具
 
 ### 高级用户
+
 深入理解系统架构：
-- [状态机设计](./architecture/state-machine.md)
-- [Hook 执行顺序](./architecture/hook-execution-order.md)
-- [Agent 生命周期](./architecture/agent-lifecycle.md)
+
+* [状态机设计](./architecture/state-machine.md)
+
+* [Hook 执行顺序](./architecture/hook-execution-order.md)
+
+* [Agent 生命周期](./architecture/agent-lifecycle.md)
 
 ### 贡献者
+
 参与项目开发：
-- [贡献指南](./standards/contribution-guide.md)
-- [代码规范](./standards/runtime-protection.md)
-- [反模式](./standards/anti-patterns.md)
+
+* [贡献指南](./standards/contribution-guide.md)
+
+* [代码规范](./standards/runtime-protection.md)
+
+* [反模式](./standards/anti-patterns.md)
 
 ---
 
 ## 🎯 按场景查找
 
-- [功能开发](./guides/scenario-feature-dev.md) - 从需求到交付的完整流程
-- [Bug 调查](./guides/scenario-bug-investigation.md) - 系统化调试方法
-- [代码审查](./guides/scenario-code-review.md) - 多维度审查流程
+* [功能开发](./guides/scenario-feature-dev.md) - 从需求到交付的完整流程
+
+* [Bug 调查](./guides/scenario-bug-investigation.md) - 系统化调试方法
+
+* [代码审查](./guides/scenario-code-review.md) - 多维度审查流程
 
 ---
 
 ## 📚 核心功能
 
 ### Agents（智能体）
+
 50 个专业 agents，覆盖构建、审查、领域、产品等多个通道。
 
 **常用 agents**:
-- `executor` - 代码实现
-- `debugger` - 根因分析
-- `architect` - 系统设计
-- `code-reviewer` - 代码审查
+
+* `executor` - 代码实现
+
+* `debugger` - 根因分析
+
+* `architect` - 系统设计
+
+* `code-reviewer` - 代码审查
 
 [查看完整列表 →](./features/agents.md)
 
 ### Skills（技能）
+
 71 个工作流 skills，自动化复杂任务。
 
 **高频 skills**:
-- `/ultrapower:autopilot` - 全自主执行
-- `/ultrapower:team` - 多 agent 协作
-- `/ultrapower:ralph` - 持续执行直到完成
+
+* `/ultrapower:autopilot` - 全自主执行
+
+* `/ultrapower:team` - 多 agent 协作
+
+* `/ultrapower:ralph` - 持续执行直到完成
 
 [查看完整列表 →](./features/skills.md)
 
 ### Axiom 进化系统
+
 自我改进的智能体系统，包含知识收割、模式检测、工作流优化。
 
 [了解更多 →](./features/axiom.md)
@@ -84,12 +114,16 @@
 ## 💬 反馈与帮助
 
 ### 这篇文档有帮助吗？
-- [👍 有帮助](https://github.com/liangjie559567/ultrapower/issues/new?labels=docs-feedback&template=docs-helpful.md)
-- [👎 需改进](https://github.com/liangjie559567/ultrapower/issues/new?labels=docs-feedback&template=docs-improvement.md)
+
+* [👍 有帮助](https://github.com/liangjie559567/ultrapower/issues/new?labels=docs-feedback&template=docs-helpful.md)
+
+* [👎 需改进](https://github.com/liangjie559567/ultrapower/issues/new?labels=docs-feedback&template=docs-improvement.md)
 
 ### 遇到问题？
-- [故障排查指南](./guides/troubleshooting.md)
-- [提交 Issue](https://github.com/liangjie559567/ultrapower/issues/new)
+
+* [故障排查指南](./guides/troubleshooting.md)
+
+* [提交 Issue](https://github.com/liangjie559567/ultrapower/issues/new)
 
 ---