@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/plans/2026-02-26-phase2-active-learning-design.md

@@ -5,13 +5,20 @@
 ## 背景
 
 Phase 1（被动学习 MVP）已完成并合并到 main。它建立了：
-- Skill 文件发现、解析、匹配、注入基础设施
-- 基于触发词的被动注入（用户消息 → 匹配 → 注入上下文）
-- 模式检测（`auto-learner.ts`）：问题-解决方案对，置信度评分
-- 自动调用决策（`auto-invoke.ts`）：置信度阈值、冷却时间
-- 使用指标追踪（`usage-tracker.ts`）
-- 会话结束自动反思（`session-reflector.ts`）
-- 进化引擎编排（`orchestrator.ts`）
+
+* Skill 文件发现、解析、匹配、注入基础设施
+
+* 基于触发词的被动注入（用户消息 → 匹配 → 注入上下文）
+
+* 模式检测（`auto-learner.ts`）：问题-解决方案对，置信度评分
+
+* 自动调用决策（`auto-invoke.ts`）：置信度阈值、冷却时间
+
+* 使用指标追踪（`usage-tracker.ts`）
+
+* 会话结束自动反思（`session-reflector.ts`）
+
+* 进化引擎编排（`orchestrator.ts`）
 
 **Phase 1 的核心局限：**
 1. 没有用户反馈回路——skill 注入后不知道是否有用
@@ -115,14 +122,20 @@ function parseFeedbackFromMessage(message: string): FeedbackResponse | null;
 ```
 
 **`storage.ts`**
-- 存储路径：`.omc/axiom/evolution/skill_feedback.json`
-- 结构：`{ skillId: { ratings: [], averageScore: number, lastUpdated: string } }`
-- 使用 `atomicWriteJson` 防止并发写入
+
+* 存储路径：`.omc/axiom/evolution/skill_feedback.json`
+
+* 结构：`{ skillId: { ratings: [], averageScore: number, lastUpdated: string } }`
+
+* 使用 `atomicWriteJson` 防止并发写入
 
 **触发时机：**
-- 注入 skill 后的第 2-3 条消息（给用户时间使用 skill）
-- 每个 skill 每会话最多请求一次反馈
-- 置信度 > 80% 的 skill 才请求反馈（避免噪音）
+
+* 注入 skill 后的第 2-3 条消息（给用户时间使用 skill）
+
+* 每个 skill 每会话最多请求一次反馈
+
+* 置信度 > 80% 的 skill 才请求反馈（避免噪音）
 
 ---
 
@@ -133,9 +146,12 @@ function parseFeedbackFromMessage(message: string): FeedbackResponse | null;
 **`adoption-detector.ts`**
 
 检测信号：
-- **代码模式匹配**：助手响应中是否出现 skill 建议的代码模式
-- **行为关键词**：响应中是否包含 skill 中的关键术语
-- **问题解决**：用户后续消息是否表明问题已解决（"谢谢"、"成功了"、"works"）
+
+* **代码模式匹配**：助手响应中是否出现 skill 建议的代码模式
+
+* **行为关键词**：响应中是否包含 skill 中的关键术语
+
+* **问题解决**：用户后续消息是否表明问题已解决（"谢谢"、"成功了"、"works"）
 
 ```typescript
 interface AdoptionSignal {
@@ -159,9 +175,12 @@ function detectAdoption(
 ```
 
 **`tracker.ts`**
-- 维护会话内的 skill 注入记录
-- 在每条助手响应后检测采纳信号
-- 将采纳结果写入 `usage_metrics.json`（扩展 Phase 1 的 `UsageMetrics`）
+
+* 维护会话内的 skill 注入记录
+
+* 在每条助手响应后检测采纳信号
+
+* 将采纳结果写入 `usage_metrics.json`（扩展 Phase 1 的 `UsageMetrics`）
 
 ---
 
@@ -235,9 +254,12 @@ function parseRecommendationResponse(message: string): {
 **`improver.ts`** — Skill 内容改进
 
 改进策略：
-- **触发词优化**：基于实际触发场景，添加/删除触发词
-- **内容精炼**：基于采纳模式，突出最有效的部分
-- **示例更新**：用实际使用案例替换通用示例
+
+* **触发词优化**：基于实际触发场景，添加/删除触发词
+
+* **内容精炼**：基于采纳模式，突出最有效的部分
+
+* **示例更新**：用实际使用案例替换通用示例
 
 ```typescript
 interface ImprovementSuggestion {
@@ -288,17 +310,24 @@ function insightsToImprovements(insights: AggregatedInsight[]): ImprovementSugge
 ### Hook 集成
 
 **`UserPromptSubmit` hook（`skill-injector.mjs`）**
-- 现有：触发词匹配 → 被动注入
-- 新增：检查是否有待推荐的 skill → 附加推荐消息
+
+* 现有：触发词匹配 → 被动注入
+
+* 新增：检查是否有待推荐的 skill → 附加推荐消息
 
 **`PostToolUse` hook（新增 `skill-feedback.mjs`）**
-- 在助手响应后触发
-- 运行采纳检测
-- 判断是否需要请求反馈
+
+* 在助手响应后触发
+
+* 运行采纳检测
+
+* 判断是否需要请求反馈
 
 **`SessionEnd` hook（`session-reflector.ts`）**
-- 现有：触发 Axiom 反思
-- 新增：运行跨会话聚合，生成改进建议
+
+* 现有：触发 Axiom 反思
+
+* 新增：运行跨会话聚合，生成改进建议
 
 ### 配置扩展（`.omc-config.json`）
 
@@ -337,26 +366,29 @@ function insightsToImprovements(insights: AggregatedInsight[]): ImprovementSugge
 ## 实现优先级
 
 ### P0（核心功能，必须实现）
+
 1. **反馈收集**（`feedback/collector.ts` + `storage.ts`）
 2. **主动推荐引擎**（`recommender/engine.ts` + `timing.ts`）
 3. **Hook 集成**（扩展 `skill-injector.mjs`，新增 `skill-feedback.mjs`）
 
 ### P1（重要功能）
-4. **采纳检测**（`effectiveness/adoption-detector.ts`）
-5. **触发词优化**（`quality/improver.ts` 的触发词部分）
-6. **配置扩展**（`config.ts` 扩展）
+
+1. **采纳检测**（`effectiveness/adoption-detector.ts`）
+2. **触发词优化**（`quality/improver.ts` 的触发词部分）
+3. **配置扩展**（`config.ts` 扩展）
 
 ### P2（增强功能）
-7. **跨会话聚合**（`quality/aggregator.ts`）
-8. **内容精炼**（`quality/improver.ts` 的内容部分）
-9. **效果仪表盘**（`/ultrapower:learner` skill 扩展）
+
+1. **跨会话聚合**（`quality/aggregator.ts`）
+2. **内容精炼**（`quality/improver.ts` 的内容部分）
+3. **效果仪表盘**（`/ultrapower:learner` skill 扩展）
 
 ---
 
 ## 风险与约束
 
 | 风险 | 影响 | 缓解策略 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | 反馈请求打扰用户 | 高 | 严格冷却时间 + 每会话上限 |
 | 采纳检测误报 | 中 | 多信号 AND 逻辑，高置信度阈值 |
 | 自动改进破坏 skill | 高 | 默认关闭自动改进，需用户确认 |
@@ -367,11 +399,18 @@ function insightsToImprovements(insights: AggregatedInsight[]): ImprovementSugge
 
 ## 验收标准
 
-- [ ] 用户注入 skill 后，系统能在适当时机请求反馈
-- [ ] 反馈数据正确持久化到 `skill_feedback.json`
-- [ ] 系统能检测到 skill 被采纳的信号（≥ 70% 准确率）
-- [ ] 当模式置信度 ≥ 70 且出现 ≥ 2 次时，系统主动推荐保存 skill
-- [ ] 用户确认后，推荐的 skill 正确保存到 `.omc/skills/`
-- [ ] 所有新功能可通过配置独立开关
-- [ ] 新增代码通过 `npm test` 和 `tsc --noEmit`
-- [ ] 不破坏 Phase 1 的任何现有功能
+* [ ] 用户注入 skill 后，系统能在适当时机请求反馈
+
+* [ ] 反馈数据正确持久化到 `skill_feedback.json`
+
+* [ ] 系统能检测到 skill 被采纳的信号（≥ 70% 准确率）
+
+* [ ] 当模式置信度 ≥ 70 且出现 ≥ 2 次时，系统主动推荐保存 skill
+
+* [ ] 用户确认后，推荐的 skill 正确保存到 `.omc/skills/`
+
+* [ ] 所有新功能可通过配置独立开关
+
+* [ ] 新增代码通过 `npm test` 和 `tsc --noEmit`
+
+* [ ] 不破坏 Phase 1 的任何现有功能

package/docs/plans/2026-02-27-release-cicd-pipeline-design.md

@@ -11,15 +11,22 @@
 ### 问题陈述
 
 当前 ultrapower 发布流程依赖手动执行 `skills/release/SKILL.md` 中的步骤：
-- 手动更新版本号（多个文件）
-- 手动运行 `npm publish`
-- 手动创建 GitHub Release
-- 手动更新 `marketplace.json`
+
+* 手动更新版本号（多个文件）
+
+* 手动运行 `npm publish`
+
+* 手动创建 GitHub Release
+
+* 手动更新 `marketplace.json`
 
 这导致：
-- 发布步骤容易遗漏（如 REFERENCE.md 双重数量声明 — k-047）
-- 发布者机器环境依赖（NPM_TOKEN 本地配置）
-- 无法并行执行独立步骤
+
+* 发布步骤容易遗漏（如 REFERENCE.md 双重数量声明 — k-047）
+
+* 发布者机器环境依赖（NPM_TOKEN 本地配置）
+
+* 无法并行执行独立步骤
 
 ### 目标
 
@@ -52,7 +59,7 @@
 ### 文件变更清单
 
 | 操作 | 文件 | 说明 |
-|------|------|------|
+| ------ | ------ | ------ |
 | 新增 | `.github/workflows/release.yml` | GitHub Actions 主流程 |
 | 新增 | `scripts/release-steps.mjs` | 共享核心逻辑 |
 | 新增 | `scripts/release-local.mjs` | 本地执行入口 |
@@ -112,9 +119,11 @@ export async function runReleasePipeline(opts = {})
 
 ### 错误处理原则
 
-- 每步失败输出明确错误信息（步骤名 + 错误内容 + 建议操作）
-- 支持 `--start-from` 从失败步骤重试（跳过已完成步骤）
-- dry-run 模式：打印将执行的命令，不实际执行
+* 每步失败输出明确错误信息（步骤名 + 错误内容 + 建议操作）
+
+* 支持 `--start-from` 从失败步骤重试（跳过已完成步骤）
+
+* dry-run 模式：打印将执行的命令，不实际执行
 
 ---
 
@@ -140,14 +149,16 @@ build-test
           └── marketplace-sync
 ```
 
-- `build-test` → `publish`：串行（确保验证通过才发布）
-- `publish` → `github-release`：串行（确保 npm 包存在才创建 Release）
-- `publish` → `marketplace-sync`：并行（与 github-release 独立）
+* `build-test` → `publish`：串行（确保验证通过才发布）
+
+* `publish` → `github-release`：串行（确保 npm 包存在才创建 Release）
+
+* `publish` → `marketplace-sync`：并行（与 github-release 独立）
 
 ### Secrets 需求
 
 | Secret | 用途 | 配置位置 |
-|--------|------|---------|
+| -------- | ------ | --------- |
 | `NPM_TOKEN` | npm publish 权限 | GitHub repo Settings → Secrets |
 | `GITHUB_TOKEN` | GitHub Release 创建 | Actions 内置，无需手动配置 |
 
@@ -174,7 +185,7 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
+          registry-url: '<https://registry.npmjs.org'>
       - run: npm ci
       - run: node scripts/release-steps.mjs publish
         env:
@@ -232,7 +243,7 @@ jobs:
 ## 6. 与现有 Release Skill 的分工
 
 | 步骤 | 负责方 | 工具 |
-|------|--------|------|
+| ------ | -------- | ------ |
 | 版本号更新（package.json、CHANGELOG、文档） | release skill（手动） | 编辑文件 |
 | git commit + tag + push | release skill（手动） | git |
 | npm publish | **GitHub Actions（自动）** | release-steps.mjs |
@@ -247,7 +258,7 @@ jobs:
 ## 7. 测试策略
 
 | 测试类型 | 覆盖内容 |
-|---------|---------|
+| --------- | --------- |
 | 单元测试 | `release-steps.mjs` 各函数（mock exec） |
 | dry-run 测试 | 验证 dry-run 模式不执行实际命令 |
 | 集成测试 | GitHub Actions workflow 语法验证（`actionlint`） |
@@ -258,7 +269,7 @@ jobs:
 ## 8. 风险与缓解
 
 | 风险 | 缓解措施 |
-|------|---------|
+| ------ | --------- |
 | NPM_TOKEN 过期 | CI 失败时发邮件通知，本地脚本作为备用 |
 | marketplace-sync 提交冲突 | 使用 `git pull --rebase` 后再 push |
 | 版本号不一致 | validateBuild 步骤检查 package.json vs git tag 一致性 |

package/docs/plans/2026-02-27-release-cicd-pipeline-impl.md

@@ -13,7 +13,8 @@
 ### Task 1: 创建共享核心 `scripts/release-steps.mjs`
 
 **Files:**
-- Create: `scripts/release-steps.mjs`
+
+* Create: `scripts/release-steps.mjs`
 
 **Step 1: 写失败测试**
 
@@ -115,11 +116,11 @@ export async function publishNpm(opts = {}) {
 
 export async function createGithubRelease(opts = {}) {
   const { version, notes = '', dryRun = false } = opts;
-  const v = version || getVersion();
+  const v = version | | getVersion();
   try {
     const notesFlag = notes ? `--notes "${notes}"` : '--generate-notes';
     run(`gh release create v${v} ${notesFlag}`, dryRun);
-    return { success: true, url: `https://github.com/liangjie559567/ultrapower/releases/tag/v${v}` };
+    return { success: true, url: `<https://github.com/liangjie559567/ultrapower/releases/tag/v${v}`> };
   } catch (err) {
     return { success: false, url: '', output: err.message };
   }
@@ -127,7 +128,7 @@ export async function createGithubRelease(opts = {}) {
 
 export async function syncMarketplace(opts = {}) {
   const { version, dryRun = false } = opts;
-  const v = version || getVersion();
+  const v = version | | getVersion();
   try {
     // marketplace.json version 字段由 release skill 手动更新，此步骤负责 git commit + push
     run(`git add .claude-plugin/marketplace.json`, dryRun);
@@ -149,7 +150,7 @@ export async function runReleasePipeline(opts = {}) {
     process.exit(1);
   }
 
-  const v = version || getVersion();
+  const v = version | | getVersion();
 
   if (startIdx <= 0) {
     console.log('Step 1/4: validateBuild...');
@@ -199,8 +200,10 @@ git commit -m "feat(release): add shared release-steps.mjs core with dry-run sup
 ### Task 2: 创建本地入口 `scripts/release-local.mjs`
 
 **Files:**
-- Create: `scripts/release-local.mjs`
-- Modify: `package.json` (scripts 字段)
+
+* Create: `scripts/release-local.mjs`
+
+* Modify: `package.json` (scripts 字段)
 
 **Step 1: 写失败测试**
 
@@ -303,7 +306,8 @@ git commit -m "feat(release): add release-local.mjs entry point and package.json
 ### Task 3: 创建 GitHub Actions Workflow
 
 **Files:**
-- Create: `.github/workflows/release.yml`
+
+* Create: `.github/workflows/release.yml`
 
 **Step 1: 写 workflow 语法验证测试**
 
@@ -343,7 +347,7 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
+          registry-url: '<https://registry.npmjs.org'>
           cache: 'npm'
       - run: npm ci
       - run: node scripts/release-steps.mjs publish
@@ -384,7 +388,7 @@ jobs:
 const cliStep = process.argv[2];
 if (cliStep && ['validate', 'publish', 'release', 'sync'].includes(cliStep)) {
   const dryRun = process.argv.includes('--dry-run');
-  const version = process.env.GITHUB_REF_NAME?.replace(/^v/, '') || undefined;
+  const version = process.env.GITHUB_REF_NAME?.replace(/^v/, '') | | undefined;
   const stepMap = { validate: validateBuild, publish: publishNpm, release: createGithubRelease, sync: syncMarketplace };
   stepMap[cliStep]({ dryRun, version }).then(r => {
     if (!r.success) { console.error(`Step ${cliStep} failed`); process.exit(1); }
@@ -423,21 +427,26 @@ git commit -m "feat(ci): add GitHub Actions release workflow with 4-job dependen
 ### Task 4: 更新 `skills/release/SKILL.md`
 
 **Files:**
-- Modify: `skills/release/SKILL.md`
+
+* Modify: `skills/release/SKILL.md`
 
 **Step 1: 在"发布步骤"末尾添加 CI 说明**
 
 在 `### 4. 创建并推送 Tag` 步骤之后，`### 5. 刷新本地 marketplace 缓存` 之前，插入：
 
 ```markdown
+
 ### 4b. GitHub Actions 自动接管（推荐）
 
 执行 `git push --tags` 后，GitHub Actions 自动接管后续步骤：
-- **npm 发布**（`publish` job）
-- **GitHub Release 创建**（`github-release` job）
-- **marketplace.json 版本同步**（`marketplace-sync` job）
 
-在 GitHub Actions 页面查看进度：https://github.com/liangjie559567/ultrapower/actions
+* **npm 发布**（`publish` job）
+
+* **GitHub Release 创建**（`github-release` job）
+
+* **marketplace.json 版本同步**（`marketplace-sync` job）
+
+在 GitHub Actions 页面查看进度：<https://github.com/liangjie559567/ultrapower/actions>
 
 如需手动执行（紧急发布或 CI 不可用）：
 ```bash
@@ -501,7 +510,9 @@ ls .github/workflows/release.yml
 
 ```bash
 git status
+
 # 确认无未提交变更
+
 ```
 
 ---
@@ -509,7 +520,7 @@ git status
 ## 任务队列
 
 | ID | 名称 | 依赖 | 并行组 | 预估 |
-|----|------|------|--------|------|
+| ---- | ------ | ------ | -------- | ------ |
 | T1 | 创建 release-steps.mjs | 无 | G1 | 30min |
 | T2 | 创建 release-local.mjs + package.json | T1 | G2 | 20min |
 | T3 | 创建 GitHub Actions workflow | T1 | G2 | 20min |

package/docs/plans/2026-02-28-nexus-self-evolution.md

@@ -9,8 +9,10 @@
 **Tech Stack:** Python 3.11+, pytest, aiohttp, collections.Counter, dataclasses, math, json, pathlib
 
 **Review History:**
-- v1: 初始计划 (T1-T12)
-- v2: 经 Architect + Critic 两轮评审，融合 6 项强制修正
+
+* v1: 初始计划 (T1-T12)
+
+* v2: 经 Architect + Critic 两轮评审，融合 6 项强制修正
 
 ---
 
@@ -32,7 +34,7 @@
 ### P0 — 数据基础层（纯 Python，无 LLM 依赖）
 
 | ID | Name | Dependencies | Parallel Group | Estimated |
-|----|------|-------------|----------------|-----------|
+| ---- | ------ | ------------- | ---------------- | ----------- |
 | T1 | Multi-dim pattern detection (evolution_engine.py) | none | G1 | 2-3h |
 | T2 | 6-dim health evaluation (self_evaluator.py) | none | G1 | 3h |
 | T4 | Anomaly detection — Strategy pattern (anomaly_detector.py) | T2 | G2 | 2h |
@@ -42,7 +44,7 @@
 ### P1 — LLM + 语义能力
 
 | ID | Name | Dependencies | Parallel Group | Estimated |
-|----|------|-------------|----------------|-----------|
+| ---- | ------ | ------------- | ---------------- | ----------- |
 | T7 | LLM self-reflection Reflexion framework (consciousness_loop.py) | T6 | G5 | 3-4h |
 | T8 | Knowledge graph — chromadb + networkx (knowledge_graph.py) | T6 | G5 | 4-5h |
 | T17 | Cross-agent experience propagation (experience_sharing.py) | T8 | G5 | 2-3h |
@@ -50,7 +52,7 @@
 ### P2 — 安全沙箱 + 强化学习
 
 | ID | Name | Dependencies | Parallel Group | Estimated |
-|----|------|-------------|----------------|-----------|
+| ---- | ------ | ------------- | ---------------- | ----------- |
 | T9 | Sandbox + canary release (self_modifier.py) | T6 | G6 | 3-4h |
 | T15 | Code health scorer — radon MI + complexity (code_health_scorer.py) | T2 | G6 | 2h |
 | T14 | Bottleneck analyzer (bottleneck_analyzer.py) | T6 | G6 | 2h |
@@ -58,7 +60,7 @@
 ### P3 — 集成 + 可视化
 
 | ID | Name | Dependencies | Parallel Group | Estimated |
-|----|------|-------------|----------------|-----------|
+| ---- | ------ | ------------- | ---------------- | ----------- |
 | T10 | RL feedback loop (prompt_optimizer.py) | T7, T9 | G7 | 3-4h |
 | T11 | 4-layer memory model (memory_model.py) | T8 | G7 | 3-4h |
 | T12 | Final integration + CI Gate | T1-T11 | G8 | 1h |
@@ -71,8 +73,10 @@
 ### Task 1: Multi-dimensional Pattern Detection (evolution_engine.py)
 
 **Files:**
-- Modify: `nexus-daemon/evolution_engine.py`
-- Test: `nexus-daemon/tests/test_evolution_engine.py`
+
+* Modify: `nexus-daemon/evolution_engine.py`
+
+* Test: `nexus-daemon/tests/test_evolution_engine.py`
 
 **Context:** 当前 `detect_patterns()` 只检测 `mode_usage` 一个维度。扩展为 5 个维度：mode_usage、tool_sequence、agent_cooccurrence、error_pattern、skill_chain。
 
@@ -83,8 +87,10 @@
 ### Task 2: Six-Dimension Health Evaluation (self_evaluator.py)
 
 **Files:**
-- Modify: `nexus-daemon/self_evaluator.py`
-- Test: `nexus-daemon/tests/test_self_evaluator.py`
+
+* Modify: `nexus-daemon/self_evaluator.py`
+
+* Test: `nexus-daemon/tests/test_self_evaluator.py`
 
 **Context:** 当前 `SelfEvaluator` 只做 skill 触发计数和僵尸检测。扩展为 6 维健康评估。
 
@@ -106,8 +112,10 @@ class SelfEvaluator:
 ### Task 4: Anomaly Detection — Strategy Pattern (anomaly_detector.py)
 
 **Files:**
-- Create: `nexus-daemon/anomaly_detector.py`
-- Test: `nexus-daemon/tests/test_anomaly_detector.py`
+
+* Create: `nexus-daemon/anomaly_detector.py`
+
+* Test: `nexus-daemon/tests/test_anomaly_detector.py`
 
 **强制约束 — Strategy 模式接口:**
 ```python
@@ -127,8 +135,10 @@ P0 仅实现 ZScoreDetector。IQR 和 EWMA 留给后续迭代。
 ### Task 5: Recommendation Engine + Thompson Sampling (recommendation_engine.py)
 
 **Files:**
-- Create: `nexus-daemon/recommendation_engine.py`
-- Test: `nexus-daemon/tests/test_recommendation_engine.py`
+
+* Create: `nexus-daemon/recommendation_engine.py`
+
+* Test: `nexus-daemon/tests/test_recommendation_engine.py`
 
 **Context:** 基于使用模式推荐最优 agent/skill 组合。合并原 T5 和 T16，使用 Thompson Sampling (`θ ~ Beta(α_success, β_failure)`) 实现探索-利用平衡。
 
@@ -137,9 +147,12 @@ P0 仅实现 ZScoreDetector。IQR 和 EWMA 留给后续迭代。
 ### Task 6: Daemon Integration + God Class Refactor + Status Output
 
 **Files:**
-- Modify: `nexus-daemon/daemon.py`
-- Create: `nexus-daemon/module_registry.py`
-- Test: `nexus-daemon/tests/test_daemon.py`
+
+* Modify: `nexus-daemon/daemon.py`
+
+* Create: `nexus-daemon/module_registry.py`
+
+* Test: `nexus-daemon/tests/test_daemon.py`
 
 **强制约束:**
 1. **God Class 拆分**: NexusDaemon 拆为 GitSync、EventProcessor、ImprovementManager、HealthReporter + ModuleRegistry 协调