@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/api/media/EVOLUTION.md

@@ -6,18 +6,29 @@ ultrapower v5.2.2 深度集成的自我进化引擎，让 AI 工作流随使用
 
 ## 目录
 
-- [概述](#概述)
-- [安装与初始化](#安装与初始化)
-- [核心组件](#核心组件)
-- [记忆系统](#记忆系统)
-- [进化工作流](#进化工作流)
-- [Skills 使用指南](#skills-使用指南)
-- [自动触发机制](#自动触发机制)
-- [知识库管理](#知识库管理)
-- [状态机](#状态机)
-- [门禁系统](#门禁系统)
-- [HUD 集成](#hud-集成)
-- [故障排除](#故障排除)
+* [概述](#概述)
+
+* [安装与初始化](#安装与初始化)
+
+* [核心组件](#核心组件)
+
+* [记忆系统](#记忆系统)
+
+* [进化工作流](#进化工作流)
+
+* [Skills 使用指南](#skills-使用指南)
+
+* [自动触发机制](#自动触发机制)
+
+* [知识库管理](#知识库管理)
+
+* [状态机](#状态机)
+
+* [门禁系统](#门禁系统)
+
+* [HUD 集成](#hud-集成)
+
+* [故障排除](#故障排除)
 
 ---
 
@@ -53,10 +64,13 @@ ax-evolve（进化）→ 知识库 + 模式库
 ultrapower 插件已安装：
 
 ```bash
+
 # 添加插件市场
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 
 # 安装插件
+
 /plugin install omc@ultrapower
 ```
 
@@ -109,7 +123,7 @@ Axiom 系统状态
 负责处理学习队列、更新知识库、检测代码模式。
 
 | 属性 | 值 |
-|------|-----|
+| ------ | ----- |
 | 模型 | sonnet |
 | 触发方式 | `/ax-evolve` 或自动（IDLE 状态） |
 | 输入 | `learning_queue.md` |
@@ -120,13 +134,17 @@ Axiom 系统状态
 管理 7 种记忆操作：读取、写入、状态更新、检查点创建/恢复、合并、清理。
 
 ```bash
+
 # 读取当前上下文
+
 /ultrapower:ax-context read
 
 # 创建检查点
+
 /ultrapower:ax-context checkpoint
 
 # 恢复到检查点
+
 /ultrapower:ax-context restore
 ```
 
@@ -135,9 +153,12 @@ Axiom 系统状态
 每次会话启动时自动注入记忆上下文，无需手动加载。
 
 **注入内容：**
-- `active_context.md` 中的当前状态
-- `project_decisions.md` 中的架构约束
-- `user_preferences.md` 中的用户偏好
+
+* `active_context.md` 中的当前状态
+
+* `project_decisions.md` 中的架构约束
+
+* `user_preferences.md` 中的用户偏好
 
 ### 4. axiom-guards hook（门禁钩子）
 
@@ -152,19 +173,28 @@ Axiom 系统状态
 存储当前会话的任务状态：
 
 ```markdown
+
 ## 当前状态
+
 状态: EXECUTING
 目标: 实现用户认证模块
 进度: 3/7 任务完成
 
 ## 任务队列
-- [x] 设计数据库 schema
-- [x] 实现 JWT 工具函数
-- [x] 创建登录 API
-- [ ] 实现注册 API
-- [ ] 添加中间件
-- [ ] 编写测试
-- [ ] 更新文档
+
+* [x] 设计数据库 schema
+
+* [x] 实现 JWT 工具函数
+
+* [x] 创建登录 API
+
+* [ ] 实现注册 API
+
+* [ ] 添加中间件
+
+* [ ] 编写测试
+
+* [ ] 更新文档
 ```
 
 ### project_decisions.md（长期记忆）
@@ -172,21 +202,29 @@ Axiom 系统状态
 存储架构决策，跨会话持久化：
 
 ```markdown
+
 ## 架构决策记录
 
 ### ADR-001: 使用 JWT 认证
-- 决策日期: 2026-02-15
-- 原因: 无状态、易于水平扩展
-- 影响: 所有 API 端点需要验证 token
+
+* 决策日期: 2026-02-15
+
+* 原因: 无状态、易于水平扩展
+
+* 影响: 所有 API 端点需要验证 token
 ```
 
 ### knowledge_base.md（知识图谱）
 
 中央知识索引，每条知识包含：
-- **ID**：唯一标识符（k-001 格式）
-- **置信度**：0.0-1.0，基于验证次数动态更新
-- **分类**：architecture / debugging / workflow / pattern / security / tooling
-- **状态**：active / deprecated
+
+* **ID**：唯一标识符（k-001 格式）
+
+* **置信度**：0.0-1.0，基于验证次数动态更新
+
+* **分类**：architecture / debugging / workflow / pattern / security / tooling
+
+* **状态**：active / deprecated
 
 ### pattern_library.md（模式库）
 
@@ -194,7 +232,7 @@ Axiom 系统状态
 
 ```markdown
 | ID | Name | Occurrences | Confidence | Status |
-|----|------|-------------|------------|--------|
+| ---- | ------ | ------------- | ------------ | -------- |
 | P-001 | Markdown Workflow Pattern | 5 | 0.9 | active |
 | P-002 | assertValidMode() Guard | 1 | 0.95 | pending |
 ```
@@ -206,7 +244,7 @@ Axiom 系统状态
 待处理的学习素材，按优先级排序：
 
 | 优先级 | 触发条件 | 示例 |
-|--------|---------|------|
+| -------- | --------- | ------ |
 | P0 | 安全漏洞修复 | 路径遍历防护 |
 | P1 | 错误修复成功 | 修复 bug 的模式 |
 | P2 | 代码变更 | 新功能实现 |
@@ -397,7 +435,7 @@ Axiom 系统状态
 进化系统的大部分操作是自动触发的，无需手动干预：
 
 | 触发事件 | 自动行为 |
-|---------|---------|
+| --------- | --------- |
 | 任务完成 | 将代码变更加入 `learning_queue.md`（P2） |
 | 错误修复成功 | 将修复模式加入学习队列（P1） |
 | 安全漏洞修复 | 加入学习队列（P0，最高优先级） |
@@ -415,6 +453,7 @@ Axiom 系统状态
 每条知识包含：
 
 ```markdown
+
 ## k-001: Global Configuration Pattern
 
 **分类**: architecture
@@ -423,21 +462,26 @@ Axiom 系统状态
 **状态**: active
 
 ### 核心洞见
+
 全局配置应集中在 `~/.claude/.omc-config.json`，避免分散配置。
 
 ### 适用场景
-- 需要跨项目共享配置时
-- 配置项影响多个模块时
+
+* 需要跨项目共享配置时
+
+* 配置项影响多个模块时
 
 ### 验证记录
-- 2026-02-08: 首次提取（置信度 0.8）
-- 2026-02-15: 第二次验证（置信度 0.9）
+
+* 2026-02-08: 首次提取（置信度 0.8）
+
+* 2026-02-15: 第二次验证（置信度 0.9）
 ```
 
 ### 置信度系统
 
 | 置信度范围 | 含义 | 操作 |
-|-----------|------|------|
+| ----------- | ------ | ------ |
 | 0.0 - 0.5 | 低置信，待验证 | 仅记录，不推荐 |
 | 0.5 - 0.7 | 中置信，有参考价值 | 推荐参考 |
 | 0.7 - 0.9 | 高置信，可信赖 | 主动推荐 |
@@ -446,10 +490,13 @@ Axiom 系统状态
 ### 手动添加知识
 
 ```bash
+
 # 通过 learner skill 从当前会话提取
+
 /ultrapower:learner
 
 # 通过 ax-knowledge 查询现有知识
+
 /ax-knowledge [关键词]
 ```
 
@@ -464,7 +511,7 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 ```
 
 | 状态 | 描述 | 允许操作 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | IDLE | 系统就绪，等待指令 | ax-draft, ax-knowledge, ax-evolve |
 | PLANNING | 正在规划任务 | ax-status, ax-suspend |
 | CONFIRMING | 等待用户确认 PRD | 确认/拒绝 |
@@ -477,9 +524,11 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 
 会话启动时，axiom-boot hook 自动检测状态：
 
-- **IDLE**: 系统就绪，等待指令
-- **EXECUTING**: 检测到中断任务，询问是否继续
-- **BLOCKED**: 上次任务遇到问题，需要人工介入
+* **IDLE**: 系统就绪，等待指令
+
+* **EXECUTING**: 检测到中断任务，询问是否继续
+
+* **BLOCKED**: 上次任务遇到问题，需要人工介入
 
 ---
 
@@ -487,28 +536,37 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 
 ### Expert Gate（专家评审门禁）
 
-- **触发**：所有新功能需求
-- **流程**：必须经过 `/ax-draft` → `/ax-review`
-- **绕过**：不允许
+* **触发**：所有新功能需求
+
+* **流程**：必须经过 `/ax-draft` → `/ax-review`
+
+* **绕过**：不允许
 
 ### User Gate（PRD 确认门禁）
 
-- **触发**：PRD 终稿生成完成
-- **流程**：显示确认提示，用户输入 Yes 后才能进入开发
-- **绕过**：不允许
+* **触发**：PRD 终稿生成完成
+
+* **流程**：显示确认提示，用户输入 Yes 后才能进入开发
+
+* **绕过**：不允许
 
 ### CI Gate（编译提交门禁）
 
-- **触发**：代码修改完成
-- **命令**：`tsc --noEmit && npm run build && npm test`
-- **通过条件**：零错误
-- **失败处理**：最多自动修复 3 次，3 次后输出 BLOCKED
+* **触发**：代码修改完成
+
+* **命令**：`tsc --noEmit && npm run build && npm test`
+
+* **通过条件**：零错误
+
+* **失败处理**：最多自动修复 3 次，3 次后输出 BLOCKED
 
 ### Scope Gate（范围门禁）
 
-- **触发**：修改文件时
-- **检查**：是否在 `manifest.md` 定义的 Impact Scope 内
-- **越界处理**：触发警告，需用户确认后才能继续
+* **触发**：修改文件时
+
+* **检查**：是否在 `manifest.md` 定义的 Impact Scope 内
+
+* **越界处理**：触发警告，需用户确认后才能继续
 
 ---
 
@@ -523,14 +581,14 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 HUD 显示内容：
 
 | 元素 | 内容 |
-|------|------|
+| ------ | ------ |
 | axiom | 当前状态 / 目标 / 任务进度 / 学习队列 / 知识库条数 / 成功率 |
 | suggestions | 基于 Axiom 状态的智能下一步建议 |
 
 **智能建议示例：**
 
 | 条件 | 建议 |
-|------|------|
+| ------ | ------ |
 | 状态 BLOCKED | `/ax-analyze-error` |
 | IDLE + 学习队列不为空 | `/ax-evolve` |
 | EXECUTING + 无 Agent | `/ax-status` |
@@ -558,10 +616,13 @@ HUD 显示内容：
 
 **解决**：
 ```bash
+
 # 手动触发进化
+
 /ax-evolve
 
 # 或检查系统状态
+
 /ax-status
 ```
 
@@ -573,10 +634,13 @@ HUD 显示内容：
 
 **解决**：
 ```bash
+
 # 查看知识条目详情
+
 /ax-knowledge [条目关键词]
 
 # 手动触发进化以重新计算
+
 /ax-evolve
 ```
 
@@ -588,10 +652,13 @@ HUD 显示内容：
 
 **解决**：
 ```bash
+
 # 重新初始化
+
 /ultrapower:ax-context init
 
 # 重新安装 hooks
+
 /ultrapower:omc-setup
 ```
 
@@ -599,7 +666,10 @@ HUD 显示内容：
 
 ## 相关文档
 
-- [REFERENCE.md](./REFERENCE.md) — 完整 API 参考
-- [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
-- [CLAUDE.md](./CLAUDE.md) — 编排规则和工作流路由表
-- [standards/agent-lifecycle.md](./standards/agent-lifecycle.md) — Agent 生命周期规范
+* [REFERENCE.md](./REFERENCE.md) — 完整 API 参考
+
+* [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
+
+* [CLAUDE.md](./CLAUDE.md) — 编排规则和工作流路由表
+
+* [standards/agent-lifecycle.md](./standards/agent-lifecycle.md) — Agent 生命周期规范