@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/tasks/memory-evolution-optimize/manifest.md

@@ -64,7 +64,7 @@ graph TD
 ## 2. 关键架构决策
 
 | 决策项 | 选择 | 理由 |
-|--------|------|------|
+| -------- | ------ | ------ |
 | 原子写入 | 复用 `src/lib/atomic-write.ts` | 项目已有成熟实现（temp+rename），无需新增依赖 |
 | 并发锁 | 新建 `src/lib/file-lock.ts` | 轻量文件锁（mkdir-based），30s 陈旧超时，T2/T1 共享 |
 | 解析器位置 | 新建 `src/hooks/learner/reflection-parser.ts` | 独立解析模块，与现有 `reflection.ts` 分离，便于测试 |
@@ -82,18 +82,23 @@ graph TD
 
 #### T-001: reflection_log 块解析器
 
-- **所属功能**: T2
-- **依赖**: 无
-- **预估工时**: 4 小时
-- **Impact Scope**:
+* **所属功能**: T2
+
+* **依赖**: 无
+
+* **预估工时**: 4 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/reflection-parser.ts`（新建）
-- **验收标准**:
+
+* **验收标准**:
   - 正确解析 `## 反思 - YYYY-MM-DD` 块边界（含末尾 `---` 分隔符归属当前块）
   - 空条目判断：三个核心小节（`### 做得好的` / `### 待改进` / `### 学到了什么`）均无有效内容时识别为空
   - 有效内容定义：排除空行、纯 `-` 占位、`(无)` 占位、HTML 注释后仍有文本
   - 返回结构化数组 `ReflectionBlock[]`，含 `isEmpty` 标记
   - 按 `## 反思 - 日期` 倒序排列
-- **实现要点**:
+
+* **实现要点**:
   - 新建 `src/hooks/learner/reflection-parser.ts`
   - 导出 `parseReflectionLog(text: string): ReflectionBlock[]`
   - 导出 `interface ReflectionBlock { header: string; rawContent: string; date: string; isEmpty: boolean }`
@@ -105,20 +110,25 @@ graph TD
 
 #### T-002: 一次性清理脚本（空条目移除 + 备份）
 
-- **所属功能**: T2
-- **依赖**: T-001
-- **预估工时**: 3 小时
-- **Impact Scope**:
+* **所属功能**: T2
+
+* **依赖**: T-001
+
+* **预估工时**: 3 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/reflection-cleanup.ts`（新建）
   - `.omc/axiom/reflection_log.md`（运行时修改）
   - `.omc/axiom/reflection_log_backup_YYYYMMDD.md`（运行时创建）
-- **验收标准**:
+
+* **验收标准**:
   - 备份原文件至 `reflection_log_backup_YYYYMMDD.md`
   - 清理所有 `isEmpty === true` 的条目
   - 输出清理摘要：`[清理] 已移除 X 条空条目，保留 Y 条有效反思`
   - 有效反思无误删
   - 人工触发（非自动）
-- **实现要点**:
+
+* **实现要点**:
   - 新建 `src/hooks/learner/reflection-cleanup.ts`
   - 导出 `cleanupReflectionLog(baseDir: string): Promise<{ removed: number; kept: number; backupPath: string }>`
   - 调用 T-001 的 `parseReflectionLog()` 获取块列表
@@ -131,21 +141,26 @@ graph TD
 
 #### T-003: 反思滚动窗口归档逻辑
 
-- **所属功能**: T2
-- **依赖**: T-001
-- **预估工时**: 5 小时
-- **Impact Scope**:
+* **所属功能**: T2
+
+* **依赖**: T-001
+
+* **预估工时**: 5 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/reflection-archiver.ts`（新建）
   - `src/lib/file-lock.ts`（新建）
   - `.omc/axiom/evolution/reflection_log_archive.md`（运行时创建/追加）
-- **验收标准**:
+
+* **验收标准**:
   - 保留最近 10 条完整反思（按日期倒序）
   - 超出 10 条的最旧条目追加至归档文件
   - 原子写入：主文件使用 write-to-tmp-then-rename
   - 并发锁：`.omc/axiom/evolution/.archive.lock`，30s 超时视为陈旧
   - 归档文件 > 5000 行输出 warning
   - 用户反馈：`[归档] reflection_log: 已移动 N 条反思至 reflection_log_archive.md`
-- **实现要点**:
+
+* **实现要点**:
   - 新建 `src/hooks/learner/reflection-archiver.ts`
   - 导出 `archiveReflections(baseDir: string): Promise<{ archived: number; kept: number; warning?: string }>`
   - 新建 `src/lib/file-lock.ts`（T2/T1 共享）
@@ -160,19 +175,24 @@ graph TD
 
 #### T-004: ax-reflect 触发集成
 
-- **所属功能**: T2
-- **依赖**: T-002, T-003
-- **预估工时**: 3 小时
-- **Impact Scope**:
+* **所属功能**: T2
+
+* **依赖**: T-002, T-003
+
+* **预估工时**: 3 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/reflection.ts`（修改）
   - `src/hooks/learner/orchestrator.ts`（修改）
   - `skills/ax-reflect/SKILL.md`（修改）
-- **验收标准**:
+
+* **验收标准**:
   - `ReflectionEngine.appendToLog()` 写入新条目后，自动检查条目数，`count > 10` 时调用归档
   - `ax-reflect` 调用语法不变（向后兼容）
   - 不改变 `reflect()` 方法签名
   - 归档结果包含在 reflect 返回信息中
-- **实现要点**:
+
+* **实现要点**:
   - 修改 `src/hooks/learner/reflection.ts`：
     - 在 `appendToLog()` 末尾调用 `archiveReflections()`（条件：解析后 count > 10）
     - import `archiveReflections` from `./reflection-archiver.js`
@@ -186,20 +206,25 @@ graph TD
 
 #### T-005: T2 单元测试
 
-- **所属功能**: T2
-- **依赖**: T-004
-- **预估工时**: 4 小时
-- **Impact Scope**:
+* **所属功能**: T2
+
+* **依赖**: T-004
+
+* **预估工时**: 4 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/__tests__/reflection-parser.test.ts`（新建）
   - `src/hooks/learner/__tests__/reflection-archiver.test.ts`（新建）
   - `src/lib/__tests__/file-lock.test.ts`（新建）
-- **验收标准**:
+
+* **验收标准**:
   - 解析器测试：正常块、空条目、混合块、边界 `---` 归属
   - 归档测试：10 条边界（11 条触发，10 条不触发）、归档文件追加、原子写入
   - 锁测试：正常加锁/解锁、陈旧锁超时、并发竞争
   - 清理测试：备份生成、空条目移除、有效条目保留
   - 所有测试通过 `npm test`
-- **实现要点**:
+
+* **实现要点**:
   - 使用 `tmp` 目录（`os.tmpdir()`）模拟文件系统
   - 测试数据：构造含空条目和有效条目的 reflection_log 内容
   - 边界测试：恰好 10 条（不触发）、11 条（触发归档 1 条）
@@ -213,24 +238,29 @@ graph TD
 
 #### T-006: 知识库过滤核心函数
 
-- **所属功能**: T3-v1
-- **依赖**: 无（与 T2 并行安全，但建议在 T005 后开始）
-- **预估工时**: 3 小时
-- **Impact Scope**:
+* **所属功能**: T3-v1
+
+* **依赖**: 无（与 T2 并行安全，但建议在 T005 后开始）
+
+* **预估工时**: 3 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/index-manager.ts`（修改）
-- **验收标准**:
+
+* **验收标准**:
   - `--filter <keyword>`：Title 或 Category 包含关键词（includes，大小写不敏感）
   - `--category <category>`：Category 字段精确匹配（大小写不敏感）
   - 无参数：全量返回（向后兼容）
   - 结果末尾包含统计：`显示 X/Y 条`
   - `--filter` 长度上限 256 字符，超出返回错误
   - 纯 TypeScript 实现，不依赖 LLM
-- **实现要点**:
+
+* **实现要点**:
   - 在 `KnowledgeIndexManager` 中新增方法：
     - `filterByKeyword(keyword: string): Promise<{ entries: IndexEntry[]; total: number }>`
     - `filterByCategory(category: string): Promise<{ entries: IndexEntry[]; total: number }>`
   - 内部调用 `loadIndex()` 获取全量数据后过滤
-  - keyword 过滤：`entry.title.toLowerCase().includes(kw) || entry.category.toLowerCase().includes(kw)`
+  - keyword 过滤：`entry.title.toLowerCase().includes(kw) | | entry.category.toLowerCase().includes(kw)`
   - category 过滤：`entry.category.toLowerCase() === cat.toLowerCase()`
   - 参数校验：keyword 长度 > 256 时 throw Error
 
@@ -238,18 +268,23 @@ graph TD
 
 #### T-007: ax-knowledge SKILL.md 参数声明 + 集成
 
-- **所属功能**: T3-v1
-- **依赖**: T-006
-- **预估工时**: 2 小时
-- **Impact Scope**:
+* **所属功能**: T3-v1
+
+* **依赖**: T-006
+
+* **预估工时**: 2 小时
+
+* **Impact Scope**:
   - `skills/ax-knowledge/SKILL.md`（修改）
   - `skills/ax-knowledge/AGENTS.md`（修改）
-- **验收标准**:
+
+* **验收标准**:
   - `ax-knowledge --filter typescript` 只返回匹配条目
   - `ax-knowledge --category architecture` 只返回 Category 精确匹配条目
   - 无参数时行为不变（全量查询）
   - 结果末尾显示 `显示 X/Y 条，使用无参数调用查看全部`
-- **实现要点**:
+
+* **实现要点**:
   - 修改 `skills/ax-knowledge/SKILL.md`：
     - 在"触发词"部分增加参数说明：`ax-knowledge [--filter <keyword>] [--category <category>]`
     - 在 Step 2 增加过滤逻辑说明
@@ -261,19 +296,24 @@ graph TD
 
 #### T-008: T3-v1 单元测试
 
-- **所属功能**: T3-v1
-- **依赖**: T-006
-- **预估工时**: 2 小时
-- **Impact Scope**:
+* **所属功能**: T3-v1
+
+* **依赖**: T-006
+
+* **预估工时**: 2 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/__tests__/index-manager-filter.test.ts`（新建）
-- **验收标准**:
+
+* **验收标准**:
   - `--filter typescript` 只返回 Title/Category 含 "typescript" 的条目
   - `--category architecture` 只返回 Category="architecture" 的条目
   - 无参数返回全量 62 条
   - 结果统计正确
   - 超 256 字符返回错误
   - 大小写不敏感验证
-- **实现要点**:
+
+* **实现要点**:
   - 构造 mock knowledge_base.md 内容（含多种 category 和 title）
   - 测试用例：关键词匹配、Category 精确匹配、空结果、全量返回、边界（256 字符）、大小写混合
 
@@ -285,18 +325,23 @@ graph TD
 
 #### T-009: 学习队列解析器重写（多行块格式）
 
-- **所属功能**: T1
-- **依赖**: T-005（需要 T2 完成后才开始）
-- **预估工时**: 5 小时
-- **Impact Scope**:
+* **所属功能**: T1
+
+* **依赖**: T-005（需要 T2 完成后才开始）
+
+* **预估工时**: 5 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/learning-queue.ts`（修改）
-- **验收标准**:
+
+* **验收标准**:
   - 正确解析多行块格式（`### LQ-XXX:` + 字段行）
   - 向后兼容：如遇旧表格格式仍能解析（降级路径）
   - `loadItems()` 返回与现有 `QueueItem` 接口一致的数据
   - `appendItem()` 以多行块格式写入
   - `updateStatus()` 在多行块格式中正确更新状态字段
-- **实现要点**:
+
+* **实现要点**:
   - 重写 `LearningQueue.loadItems()`：
     - 检测格式：如果包含 `### LQ-` 则使用块解析；否则回退表格解析
     - 块解析：以 `### LQ-XXX:` 为块起始，提取字段行（`- 优先级:`, `- 状态:` 等）
@@ -312,13 +357,17 @@ graph TD
 
 #### T-010: 学习队列归档逻辑
 
-- **所属功能**: T1
-- **依赖**: T-009
-- **预估工时**: 5 小时
-- **Impact Scope**:
+* **所属功能**: T1
+
+* **依赖**: T-009
+
+* **预估工时**: 5 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/queue-archiver.ts`（新建）
   - `.omc/axiom/evolution/learning_queue_archive.md`（运行时创建/追加）
-- **验收标准**:
+
+* **验收标准**:
   - 归档阈值：`done 条目数 > 10`（严格大于；done=11 触发，done=10 不触发）
   - 主文件保留：头部 + 所有 pending + 所有 in-progress + 按处理时间倒序最近 10 条 done
   - 归档目标：`.omc/axiom/evolution/learning_queue_archive.md`（追加写入）
@@ -328,7 +377,8 @@ graph TD
   - 归档文件 > 5000 行输出 warning
   - 归档文件 ID 无重复
   - 用户反馈：`[归档] learning_queue: 已移动 N 条 done 条目至 learning_queue_archive.md`
-- **实现要点**:
+
+* **实现要点**:
   - 新建 `src/hooks/learner/queue-archiver.ts`
   - 导出 `archiveQueueItems(baseDir: string): Promise<{ archived: number; kept: number; warning?: string }>`
   - 复用 T-003 的 `acquireLock()` / `releaseLock()` 锁机制
@@ -348,18 +398,23 @@ graph TD
 
 #### T-011: ax-evolve 触发集成 + 手动触发入口
 
-- **所属功能**: T1
-- **依赖**: T-010
-- **预估工时**: 3 小时
-- **Impact Scope**:
+* **所属功能**: T1
+
+* **依赖**: T-010
+
+* **预估工时**: 3 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/orchestrator.ts`（修改）
   - `skills/ax-evolve/SKILL.md`（修改）
-- **验收标准**:
+
+* **验收标准**:
   - `evolve()` 处理完一批条目后，自动检查 done 数量并触发归档
   - `--archive-queue` 参数可独立触发归档（不执行 evolve 其他步骤）
   - 归档结果包含在 evolve 返回信息中
   - 不改变 `evolve()` 基本流程
-- **实现要点**:
+
+* **实现要点**:
   - 修改 `src/hooks/learner/orchestrator.ts`：
     - 在 `evolve()` 方法的 step 9（清理队列）之后，调用 `archiveQueueItems()`
     - 新增 `archiveQueue()` 公开方法，用于手动触发
@@ -372,13 +427,17 @@ graph TD
 
 #### T-012: T1 单元测试
 
-- **所属功能**: T1
-- **依赖**: T-011
-- **预估工时**: 4 小时
-- **Impact Scope**:
+* **所属功能**: T1
+
+* **依赖**: T-011
+
+* **预估工时**: 4 小时
+
+* **Impact Scope**:
   - `src/hooks/learner/__tests__/learning-queue-parser.test.ts`（新建）
   - `src/hooks/learner/__tests__/queue-archiver.test.ts`（新建）
-- **验收标准**:
+
+* **验收标准**:
   - 解析器测试：多行块格式解析、旧表格格式兼容、字段映射正确
   - 归档测试：done=11 触发 / done=10 不触发、保留最近 10 条 done、pending/in-progress 不受影响
   - 归档文件 ID 无重复
@@ -386,7 +445,8 @@ graph TD
   - 并发锁复用验证
   - 归档 > 5000 行 warning
   - 所有测试通过 `npm test`
-- **实现要点**:
+
+* **实现要点**:
   - 构造多行块格式和旧表格格式的测试数据
   - 边界测试：done=10（不触发）、done=11（归档 1 条）、done=20（归档 10 条）
   - 保留顺序验证：按处理时间倒序最近 10 条
@@ -398,15 +458,19 @@ graph TD
 
 ### T4: knowledge_base.md MiniSearch 全文检索（v1.1）
 
-- **描述**: 引入 MiniSearch 库，为知识库提供全文检索能力
-- **原因**: 需引入新运行时依赖，延至 v1.1
-- **前置条件**: T3-v1 完成
+* **描述**: 引入 MiniSearch 库，为知识库提供全文检索能力
+
+* **原因**: 需引入新运行时依赖，延至 v1.1
+
+* **前置条件**: T3-v1 完成
 
 ### T3-v2: ax-knowledge LLM 语义搜索（v1.1）
 
-- **描述**: 利用 LLM 进行语义级知识查询
-- **原因**: 需 LLM 集成，复杂度高，延至 v1.1
-- **前置条件**: T3-v1 + T4 完成
+* **描述**: 利用 LLM 进行语义级知识查询
+
+* **原因**: 需 LLM 集成，复杂度高，延至 v1.1
+
+* **前置条件**: T3-v1 + T4 完成
 
 ---
 
@@ -415,7 +479,7 @@ graph TD
 ### 新建文件
 
 | 文件路径 | 所属任务 | 说明 |
-|---------|---------|------|
+| --------- | --------- | ------ |
 | `src/hooks/learner/reflection-parser.ts` | T-001 | reflection_log 块解析器 |
 | `src/hooks/learner/reflection-cleanup.ts` | T-002 | 一次性清理脚本 |
 | `src/hooks/learner/reflection-archiver.ts` | T-003 | 反思滚动窗口归档 |
@@ -431,7 +495,7 @@ graph TD
 ### 修改文件
 
 | 文件路径 | 所属任务 | 说明 |
-|---------|---------|------|
+| --------- | --------- | ------ |
 | `src/hooks/learner/reflection.ts` | T-004 | appendToLog 后触发归档 |
 | `src/hooks/learner/orchestrator.ts` | T-004, T-011 | reflect/evolve 返回值扩展 |
 | `src/hooks/learner/index-manager.ts` | T-006 | 新增 filterByKeyword/filterByCategory |
@@ -444,7 +508,7 @@ graph TD
 ### 参考文件（只读）
 
 | 文件路径 | 用途 |
-|---------|------|
+| --------- | ------ |
 | `src/lib/atomic-write.ts` | 复用原子写入函数 |
 | `src/config/axiom-config.ts` | 理解 EvolutionConfig 结构 |
 | `.omc/axiom/evolution/learning_queue.md` | 理解当前队列格式 |
@@ -466,7 +530,7 @@ tsc --noEmit && npm run build && npm test
 ## 7. 工时汇总
 
 | 阶段 | 任务 | 预估工时 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | T2 - 反思滚动窗口 | T-001 ~ T-005 | 19 小时 |
 | T3-v1 - 知识库过滤 | T-006 ~ T-008 | 7 小时 |
 | T1 - 学习队列归档 | T-009 ~ T-012 | 17 小时 |

package/docs/tasks/ultrapower-standards/AGENTS.md

@@ -4,24 +4,29 @@
 # docs/tasks/ultrapower-standards/
 
 ## Purpose
+
 Ultrapower 标准任务文档目录。包含 ultrapower 标准规范的任务追踪文档和 manifest 清单。
 
 ## Key Files
 
 | File | Description |
-|------|-------------|
+| ------ | ------------- |
 | `manifest.md` | 任务 manifest 清单，定义标准规范的实施任务 |
 
 ## For AI Agents
 
 ### 修改此目录时
-- 参见父级目录了解整体结构
-- 遵循项目编码规范
+
+* 参见父级目录了解整体结构
+
+* 遵循项目编码规范
 
 ## Dependencies
 
 ### Internal
-- `docs/tasks/` — 相关模块
-- `docs/standards/` — 相关模块
+
+* `docs/tasks/` — 相关模块
+
+* `docs/standards/` — 相关模块
 
 <!-- MANUAL: -->