@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/AXIOM.md

@@ -13,29 +13,36 @@ Axiom 是 ultrapower 的智能工作流引擎，将复杂的多 Agent 编排转
 ### 第一个工作流示例
 
 ```bash
+
 # 1. 提出新需求（触发专家评审）
+
 /ax-draft "添加用户认证模块"
 
 # 2. 专家评审（架构师 + 产品经理）
+
 /ax-review
 
 # 3. 拆解为可执行任务
+
 /ax-decompose
 
 # 4. 开始开发（自动路由 executors）
+
 /ax-implement
 
 # 5. 遇到错误？自动诊断
+
 /ax-analyze-error
 
 # 6. 完成后反思和学习
+
 /ax-reflect
 ```
 
 ### 基本命令
 
 | 命令 | 用途 | 触发 Agent |
-|------|------|-----------|
+| ------ | ------ | ----------- |
 | `/ax-draft` | 新需求 → PRD | analyst + product-manager |
 | `/ax-review` | 专家评审 | architect + critic |
 | `/ax-decompose` | 拆解任务 | planner + analyst |
@@ -50,7 +57,7 @@ Axiom 是 ultrapower 的智能工作流引擎，将复杂的多 Agent 编排转
 ## 14 个 Axiom Agents
 
 | Agent | 模型 | 职责 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `analyst` | opus | 需求澄清、验收标准、隐性约束 |
 | `architect` | opus | 系统设计、边界、接口、长期权衡 |
 | `planner` | opus | 任务排序、执行计划、风险标记 |
@@ -71,7 +78,7 @@ Axiom 是 ultrapower 的智能工作流引擎，将复杂的多 Agent 编排转
 ## 14 个 Axiom Skills
 
 | Skill | 触发词 | 工作流 |
-|-------|--------|--------|
+| ------- | -------- | -------- |
 | `ax-draft` | "draft", "新需求" | 需求 → PRD 生成 |
 | `ax-review` | "review", "评审" | 专家评审门禁 |
 | `ax-decompose` | "decompose", "拆解" | 任务分解 |
@@ -96,6 +103,7 @@ Axiom 维护三层记忆，确保工作流连贯性：
 ### 1. 活跃上下文（`.omc/axiom/active_context.md`）
 
 ```markdown
+
 # 当前工作流状态
 
 状态: EXECUTING
@@ -107,23 +115,31 @@ Axiom 维护三层记忆，确保工作流连贯性：
 ### 2. 项目决策（`.omc/axiom/project_decisions.md`）
 
 ```markdown
+
 # 架构约束
 
-- 认证: JWT + Redis session
-- 数据库: PostgreSQL
-- 框架: Express.js
-- 禁止: 直接 SQL 拼接
+* 认证: JWT + Redis session
+
+* 数据库: PostgreSQL
+
+* 框架: Express.js
+
+* 禁止: 直接 SQL 拼接
 ```
 
 ### 3. 用户偏好（`.omc/axiom/user_preferences.md`）
 
 ```markdown
+
 # 工作流偏好
 
-- 默认模型: sonnet
-- 并行度: 4
-- 自动审查: 启用
-- 学习队列: 启用
+* 默认模型: sonnet
+
+* 并行度: 4
+
+* 自动审查: 启用
+
+* 学习队列: 启用
 ```
 
 ---
@@ -131,24 +147,36 @@ Axiom 维护三层记忆，确保工作流连贯性：
 ## 门禁规则
 
 ### Expert Gate（专家评审）
-- **触发**：所有新功能需求
-- **流程**：`/ax-draft` → `/ax-review` → 确认
-- **通过条件**：架构师 + 产品经理同意
+
+* **触发**：所有新功能需求
+
+* **流程**：`/ax-draft` → `/ax-review` → 确认
+
+* **通过条件**：架构师 + 产品经理同意
 
 ### User Gate（PRD 确认）
-- **触发**：PRD 终稿生成
-- **动作**：显示 "PRD 已生成，是否确认执行？(Yes/No)"
-- **通过条件**：用户确认
+
+* **触发**：PRD 终稿生成
+
+* **动作**：显示 "PRD 已生成，是否确认执行？(Yes/No)"
+
+* **通过条件**：用户确认
 
 ### CI Gate（编译提交）
-- **触发**：代码修改完成
-- **命令**：`tsc --noEmit && npm run build && npm test`
-- **通过条件**：无错误
+
+* **触发**：代码修改完成
+
+* **命令**：`tsc --noEmit && npm run build && npm test`
+
+* **通过条件**：无错误
 
 ### Scope Gate（范围检查）
-- **触发**：修改文件时
-- **检查**：是否在 `manifest.md` 的 `Impact Scope` 内
-- **动作**：越界修改需用户确认
+
+* **触发**：修改文件时
+
+* **检查**：是否在 `manifest.md` 的 `Impact Scope` 内
+
+* **动作**：越界修改需用户确认
 
 ---
 
@@ -157,83 +185,131 @@ Axiom 维护三层记忆，确保工作流连贯性：
 ### 示例 1：完整功能开发流程
 
 ```bash
+
 # 第 1 步：提出需求
+
 /ax-draft "实现 OAuth2 登录"
 
 # 输出：
+
 # ✓ PRD 已生成
+
 # ✓ 验收标准：
+
 #   - 支持 Google/GitHub 登录
+
 #   - 自动创建用户账户
+
 #   - 返回 JWT token
 
 # 第 2 步：专家评审
+
 /ax-review
 
 # 输出：
+
 # ✓ 架构师审查：设计合理，建议添加 rate limiting
+
 # ✓ 产品经理审查：符合需求
+
 # ✓ 安全审查：需要 CSRF 防护
 
 # 第 3 步：拆解任务
+
 /ax-decompose
 
 # 输出：
+
 # ✓ 任务 1: 配置 OAuth2 提供商 (30 min)
+
 # ✓ 任务 2: 实现登录端点 (45 min)
+
 # ✓ 任务 3: 添加单元测试 (30 min)
+
 # ✓ 任务 4: 集成测试 (20 min)
 
 # 第 4 步：开始开发
+
 /ax-implement
 
 # 输出：
+
 # ✓ 任务 1 完成 (executor)
+
 # ✓ 任务 2 完成 (executor)
+
 # ✓ 任务 3 完成 (test-engineer)
+
 # ✓ 任务 4 完成 (qa-tester)
+
 # ✓ 代码审查通过 (code-reviewer)
+
 # ✓ 安全审查通过 (security-reviewer)
+
 ```
 
 ### 示例 2：错误诊断和修复
 
 ```bash
+
 # 构建失败
+
 npm run build
+
 # Error: Type 'User' is not assignable to type 'UserDTO'
 
 # 自动诊断
+
 /ax-analyze-error
 
 # 输出：
+
 # ✓ 根因：User model 缺少 email 字段
+
 # ✓ 影响范围：3 个文件
+
 # ✓ 修复方案：添加 email 字段到 User model
+
 # ✓ 修复中...
+
 # ✓ 修复完成，重新构建
+
 # ✓ 构建成功
+
 ```
 
 ### 示例 3：工作流反思
 
 ```bash
+
 # 完成后反思
+
 /ax-reflect
 
 # 输出：
+
 # ✓ 工作流总结：
+
 #   - 总耗时：2.5 小时
+
 #   - 任务数：4
+
 #   - 成功率：100%
+
 #   - 平均任务时间：37.5 min
 #
+
 # ✓ 学习收获：
+
 #   - 模式：OAuth2 集成最佳实践
+
 #   - 反模式：避免在 middleware 中做 DB 查询
+
 #   - 性能优化：使用 Redis 缓存 token 验证
 #
+
 # ✓ 知识库已更新
+
 ```
 
 ---
@@ -243,7 +319,9 @@ npm run build
 Axiom 自动检测中断的工作流：
 
 ```bash
+
 # 会话启动时自动检测
+
 # 如果存在 .omc/axiom/active_context.md
 
 状态: EXECUTING
@@ -254,10 +332,14 @@ Axiom 自动检测中断的工作流：
 ```
 
 **状态类型**：
-- `IDLE` - 系统就绪，等待指令
-- `EXECUTING` - 工作流进行中，可继续
-- `BLOCKED` - 遇到问题，需人工介入
-- `ARCHIVING` - 自动触发 `/ax-reflect`
+
+* `IDLE` - 系统就绪，等待指令
+
+* `EXECUTING` - 工作流进行中，可继续
+
+* `BLOCKED` - 遇到问题，需人工介入
+
+* `ARCHIVING` - 自动触发 `/ax-reflect`
 
 ---
 
@@ -266,7 +348,7 @@ Axiom 自动检测中断的工作流：
 Axiom 自动学习和改进：
 
 | 触发事件 | 自动行为 |
-|---------|---------|
+| --------- | --------- |
 | 任务完成 | 代码变更加入 `learning_queue.md` |
 | 错误修复成功 | 修复模式加入学习队列 (P1) |
 | 工作流完成 | 更新 `workflow_metrics.md` |
@@ -310,7 +392,10 @@ Axiom 自动学习和改进：
 
 ## 下一步
 
-- 📖 [完整 API 文档](./REFERENCE.md)
-- 🏗️ [架构设计指南](./ARCHITECTURE.md)
-- 🔒 [安全规范](./standards/runtime-protection.md)
-- 🧪 [测试策略](./standards/testing-strategy.md)
+* 📖 [完整 API 文档](./REFERENCE.md)
+
+* 🏗️ [架构设计指南](./ARCHITECTURE.md)
+
+* 🔒 [安全规范](./standards/runtime-protection.md)
+
+* 🧪 [测试策略](./standards/testing-strategy.md)

package/docs/CJK-IME-KNOWN-ISSUES.md

@@ -4,13 +4,19 @@
 
 ## 目录
 
-- [概述](#overview)
-- [受影响用户](#affected-users)
-- [已知问题](#known-issues)
-- [根本原因](#root-cause)
-- [解决方案](#workarounds)
-- [相关问题](#related-issues)
-- [状态](#status)
+* [概述](#overview)
+
+* [受影响用户](#affected-users)
+
+* [已知问题](#known-issues)
+
+* [根本原因](#root-cause)
+
+* [解决方案](#workarounds)
+
+* [相关问题](#related-issues)
+
+* [状态](#status)
 
 ## 概述
 
@@ -19,7 +25,7 @@ Claude Code CLI 使用 React Ink 进行终端 UI 渲染。由于终端 raw mode
 ## 受影响用户
 
 | 语言 | 输入法 | 是否受影响 |
-|----------|--------------|----------|
+| ---------- | -------------- | ---------- |
 | 韩语 (한국어) | macOS 韩语 IME | ✅ 是 |
 | 韩语 (한국어) | Windows 韩语 IME | ✅ 是 |
 | 韩语 (한국어) | Gureumkim (구름) | ✅ 是 |
@@ -38,10 +44,14 @@ Claude Code CLI 使用 React Ink 进行终端 UI 渲染。由于终端 raw mode
 **平台**：macOS、Linux
 
 **示例（韩语）**：
-- 输入 `ㅎ` → 无显示
-- 输入 `ㅎ` + `ㅏ` → 无显示
-- 输入 `ㅎ` + `ㅏ` + `ㄴ` → 无显示
-- 按 Enter → `한` 出现在输出中
+
+* 输入 `ㅎ` → 无显示
+
+* 输入 `ㅎ` + `ㅏ` → 无显示
+
+* 输入 `ㅎ` + `ㅏ` + `ㄴ` → 无显示
+
+* 按 Enter → `한` 出现在输出中
 
 ### 2. 组合字符位置错误
 
@@ -62,16 +72,22 @@ Claude Code CLI 使用 React Ink 进行终端 UI 渲染。由于终端 raw mode
 ### 1. 终端 Raw Mode 限制
 
 当 Node.js 在 raw mode（`process.stdin.setRawMode(true)`）下运行时，它仅提供字节级 STDIN 访问，不支持：
-- 组合事件回调（`compositionstart`、`compositionupdate`、`compositionend`）
-- IME 预编辑缓冲区信息
-- 组合过程中的光标位置反馈
+
+* 组合事件回调（`compositionstart`、`compositionupdate`、`compositionend`）
+
+* IME 预编辑缓冲区信息
+
+* 组合过程中的光标位置反馈
 
 ### 2. React Ink 的 TextInput 组件
 
 React Ink 的 TextInput 逐个处理按键，不理解多阶段字符组合：
-- 无 `isComposing` 状态追踪
-- 无独立的组合缓冲区
-- 逐字符处理破坏了 CJK 算法组合
+
+* 无 `isComposing` 状态追踪
+
+* 无独立的组合缓冲区
+
+* 逐字符处理破坏了 CJK 算法组合
 
 ### 3. CJK 字符的复杂性
 
@@ -112,11 +128,15 @@ k + a → か
 在可能的情况下，使用英文编写提示词，但在文件内容或引用中包含 CJK 文字。
 
 ```
+
 # 不直接输入韩语：
+
 # "한국어로 인사말 작성해줘"
 
 # 使用英文提示词：
+
 # "Write a greeting message in Korean language"
+
 ```
 
 ### 方案 3：基于剪贴板的输入脚本
@@ -124,10 +144,13 @@ k + a → か
 创建一个从剪贴板读取并发送到 Claude Code 的脚本：
 
 ```bash
+
 # macOS
+
 pbpaste | claude --stdin
 
 # Linux（需要 xclip）
+
 xclip -selection clipboard -o | claude --stdin
 ```
 
@@ -138,27 +161,37 @@ xclip -selection clipboard -o | claude --stdin
 ## 相关问题
 
 ### ultrapower
-- [#344](https://github.com/liangjie559567/ultrapower/issues/344) - 韩语 IME 输入在输入框中不可见
+
+* [#344](https://github.com/liangjie559567/ultrapower/issues/344) - 韩语 IME 输入在输入框中不可见
 
 ### anthropics/claude-code
-- [#22732](https://github.com/anthropics/claude-code/issues/22732) - 韩语 IME：组合过程中字符完全不可见
-- [#18291](https://github.com/anthropics/claude-code/issues/18291) - 韩语 IME 组合：音节完成前字母不显示
-- [#16322](https://github.com/anthropics/claude-code/issues/16322) - [严重] 韩语 IME：组合字符显示在错误位置
-- [#15705](https://github.com/anthropics/claude-code/issues/15705) - 韩语输入字符在 iOS 移动 SSH 上消失
-- [#1547](https://github.com/anthropics/claude-code/issues/1547) - IME 输入导致性能问题
-- [#3045](https://github.com/anthropics/claude-code/issues/3045) - 调查：通过修补 React Ink 修复 IME 问题
+
+* [#22732](https://github.com/anthropics/claude-code/issues/22732) - 韩语 IME：组合过程中字符完全不可见
+
+* [#18291](https://github.com/anthropics/claude-code/issues/18291) - 韩语 IME 组合：音节完成前字母不显示
+
+* [#16322](https://github.com/anthropics/claude-code/issues/16322) - [严重] 韩语 IME：组合字符显示在错误位置
+
+* [#15705](https://github.com/anthropics/claude-code/issues/15705) - 韩语输入字符在 iOS 移动 SSH 上消失
+
+* [#1547](https://github.com/anthropics/claude-code/issues/1547) - IME 输入导致性能问题
+
+* [#3045](https://github.com/anthropics/claude-code/issues/3045) - 调查：通过修补 React Ink 修复 IME 问题
 
 ### 上游（React Ink）
-- React Ink 的 TextInput 不支持 IME 组合状态
-- 最小复现：https://github.com/takeru/react-ink-ime-bug
+
+* React Ink 的 TextInput 不支持 IME 组合状态
+
+* 最小复现：<https://github.com/takeru/react-ink-ime-bug>
 
 ### 其他项目中的类似问题
-- [Google Gemini CLI #3014](https://github.com/google-gemini/gemini-cli/issues/3014) - 同样的问题影响 Gemini CLI
+
+* [Google Gemini CLI #3014](https://github.com/google-gemini/gemini-cli/issues/3014) - 同样的问题影响 Gemini CLI
 
 ## 状态
 
 | 修复领域 | 状态 | 备注 |
-|----------|--------|-------|
+| ---------- | -------- | ------- |
 | 光标定位 | ✅ 部分修复 | 2025 年 8 月版本改善了组合窗口位置 |
 | 字符可见性 | ❌ 未修复 | 组合过程中字符仍不可见 |
 | 性能 | ⚠️ 持续改进 | 内存问题正在调查中 |
@@ -174,6 +207,8 @@ xclip -selection clipboard -o | claude --stdin
 
 ## 参考资料
 
-- [Terminal-friendly application with Node.js - User Inputs](https://blog.soulserv.net/terminal-friendly-application-with-node-js-part-iii-user-inputs/)
-- [React IME Composition Events Issue #8683](https://github.com/facebook/react/issues/8683)
-- [Node.js Readline Documentation](https://nodejs.org/api/readline.html)
+* [Terminal-friendly application with Node.js - User Inputs](https://blog.soulserv.net/terminal-friendly-application-with-node-js-part-iii-user-inputs/)
+
+* [React IME Composition Events Issue #8683](https://github.com/facebook/react/issues/8683)
+
+* [Node.js Readline Documentation](https://nodejs.org/api/readline.html)