@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/MIGRATION_GUIDE_v5.5.18.md

@@ -12,7 +12,9 @@ v5.5.18 是一个稳定性和性能改进版本，**无破坏性变更**。所
 
 ```bash
 npm install ultrapower@5.5.18
+
 # 或
+
 yarn upgrade ultrapower@5.5.18
 ```
 
@@ -30,6 +32,7 @@ npm test
 ### Security 改进
 
 #### permission-request Hook 阻塞模式
+
 **变更**: 权限检查失败时现在返回 `continue: false`
 
 **之前**:
@@ -47,6 +50,7 @@ npm test
 **影响**: 需要权限的 hook 现在会被正确阻塞。如果你的代码依赖旧的无声降级行为，需要更新权限配置。
 
 #### 环境变量验证
+
 **变更**: Hook 执行中现在验证敏感环境变量
 
 **影响**: 如果 hook 使用敏感环境变量，需确保它们在白名单中。
@@ -54,11 +58,13 @@ npm test
 ### Performance 改进
 
 #### Worker 健康检查
+
 **变更**: 健康检查延迟从 ~50ms 降低到 <10ms
 
 **影响**: 无需代码变更，自动获得性能提升。
 
 #### 构建时间
+
 **变更**: 增量构建从 5.8s 优化到 2.4s
 
 **影响**: 开发体验改进，无需代码变更。
@@ -66,6 +72,7 @@ npm test
 ## API 兼容性
 
 ### 工具返回类型扩展
+
 **变更**: `GenericToolDefinition.handler` 返回类型现在支持 `isError` 字段
 
 **之前**:
@@ -88,22 +95,29 @@ interface ToolResponse {
 **影响**: 完全向后兼容。现有工具无需修改。
 
 ### HookInput 接口完整化
+
 **变更**: HookInput 现在包含完整的 snake_case 字段
 
 **新增字段**:
-- `tool_name`: 工具名称
-- `tool_input`: 工具输入
-- `tool_response`: 工具响应
-- `session_id`: 会话 ID
-- `cwd`: 当前工作目录
-- `hook_event_name`: Hook 事件名称
+
+* `tool_name`: 工具名称
+
+* `tool_input`: 工具输入
+
+* `tool_response`: 工具响应
+
+* `session_id`: 会话 ID
+
+* `cwd`: 当前工作目录
+
+* `hook_event_name`: Hook 事件名称
 
 **影响**: Hook 处理器现在可以访问更多上下文信息。
 
 ## 测试覆盖率改进
 
 | 模块 | 改进 | 新覆盖率 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | hooks guards | +64.70% | 97.05% |
 | MCP Client | +100% | 100% |
 | bridge-entry | +64% | 81.52% |
@@ -168,9 +182,11 @@ npm test
 
 ## 支持
 
-- **文档**: https://github.com/ultrapower/docs
-- **Issue**: https://github.com/ultrapower/issues
-- **讨论**: https://github.com/ultrapower/discussions
+* **文档**: <https://github.com/ultrapower/docs>
+
+* **Issue**: <https://github.com/ultrapower/issues>
+
+* **讨论**: <https://github.com/ultrapower/discussions>
 
 ## 更新日志
 

package/docs/NEXUS.md

@@ -6,17 +6,27 @@ ultrapower v5.2.2 的双层自我提升架构——让 AI 工作流真正越用
 
 ## 目录
 
-- [概述](#概述)
-- [系统架构](#系统架构)
-- [Phase 1：被动学习（已完成）](#phase-1被动学习已完成)
-- [Phase 2：主动学习](#phase-2主动学习)
-- [Nexus 双层架构](#nexus-双层架构)
-- [核心模块详解](#核心模块详解)
-- [数据存储结构](#数据存储结构)
-- [配置参考](#配置参考)
-- [Skills 使用指南](#skills-使用指南)
-- [部署指南](#部署指南)
-- [风险与约束](#风险与约束)
+* [概述](#概述)
+
+* [系统架构](#系统架构)
+
+* [Phase 1：被动学习（已完成）](#phase-1被动学习已完成)
+
+* [Phase 2：主动学习](#phase-2主动学习)
+
+* [Nexus 双层架构](#nexus-双层架构)
+
+* [核心模块详解](#核心模块详解)
+
+* [数据存储结构](#数据存储结构)
+
+* [配置参考](#配置参考)
+
+* [Skills 使用指南](#skills-使用指南)
+
+* [部署指南](#部署指南)
+
+* [风险与约束](#风险与约束)
 
 ---
 
@@ -25,7 +35,7 @@ ultrapower v5.2.2 的双层自我提升架构——让 AI 工作流真正越用
 ultrapower 的进化系统分为三个层次：
 
 | 层次 | 名称 | 状态 | 核心能力 |
-|------|------|------|---------|
+| ------ | ------ | ------ | --------- |
 | Phase 1 | 被动学习 | ✅ 已完成 | 触发词匹配、模式检测、会话反思 |
 | Phase 2 | 主动学习 | 🚧 开发中 | 反馈收集、效果追踪、主动推荐、质量迭代 |
 | Nexus | 双层自我提升 | 📋 设计完成 | VPS 后台意识循环、代码自动修改、跨会话进化 |
@@ -76,9 +86,11 @@ ultrapower 的进化系统分为三个层次：
 
 ### 与 ultrapower 的关系
 
-- **升级，不替换**：保留现有 71 skills + 49 agents + 39 hooks 的全部价值
-- Nexus 作为顶层能力层叠加在 ultrapower 之上
-- 现有用户无感知升级，所有现有功能继续正常工作
+* **升级，不替换**：保留现有 71 skills + 49 agents + 39 hooks 的全部价值
+
+* Nexus 作为顶层能力层叠加在 ultrapower 之上
+
+* 现有用户无感知升级，所有现有功能继续正常工作
 
 ---
 
@@ -89,7 +101,7 @@ Phase 1 建立了主动学习的基础设施，已合并到 main 分支。
 ### 已实现能力
 
 | 模块 | 文件 | 功能 |
-|------|------|------|
+| ------ | ------ | ------ |
 | Skill 发现 | `skill-loader.ts` | 扫描并解析 skill 文件 |
 | 触发词匹配 | `skill-injector.mjs` | 用户消息 → 匹配 → 注入上下文 |
 | 模式检测 | `auto-learner.ts` | 问题-解决方案对，置信度评分 |
@@ -177,9 +189,12 @@ VPS 生成改进 → 写入 improvements/{id}.json
 ```
 
 **优点：**
-- 无需网络端口，无需 API 服务器
-- 天然版本控制，可回溯所有数据
-- 离线时数据不丢失，重连后自动同步
+
+* 无需网络端口，无需 API 服务器
+
+* 天然版本控制，可回溯所有数据
+
+* 离线时数据不丢失，重连后自动同步
 
 ---
 
@@ -190,9 +205,12 @@ VPS 生成改进 → 写入 improvements/{id}.json
 收集用户对注入 skill 的有用性评分。
 
 **触发时机：**
-- 注入 skill 后的第 2-3 条消息（给用户时间使用 skill）
-- 每个 skill 每会话最多请求一次反馈
-- 置信度 > 80% 的 skill 才请求反馈（避免噪音）
+
+* 注入 skill 后的第 2-3 条消息（给用户时间使用 skill）
+
+* 每个 skill 每会话最多请求一次反馈
+
+* 置信度 > 80% 的 skill 才请求反馈（避免噪音）
 
 **反馈类型：**
 ```typescript
@@ -215,7 +233,7 @@ interface FeedbackResponse {
 **检测信号（多信号 AND 逻辑）：**
 
 | 信号类型 | 检测方式 |
-|---------|---------|
+| --------- | --------- |
 | `code_pattern` | 助手响应中是否出现 skill 建议的代码模式 |
 | `keyword_match` | 响应中是否包含 skill 中的关键术语 |
 | `problem_solved` | 用户后续消息是否表明问题已解决 |
@@ -236,9 +254,12 @@ interface FeedbackResponse {
 4. 本会话推荐次数 < 3（避免打扰）
 
 **用户响应解析：**
-- `save` / `yes` → 保存推荐的 skill
-- `skip` / `no` → 跳过，记录反馈
-- `edit` → 用户编辑后保存
+
+* `save` / `yes` → 保存推荐的 skill
+
+* `skip` / `no` → 跳过，记录反馈
+
+* `edit` → 用户编辑后保存
 
 **存储：** `.omc/axiom/evolution/recommendations.json`
 
@@ -251,7 +272,7 @@ interface FeedbackResponse {
 **改进策略：**
 
 | 类型 | 触发条件 | 操作 |
-|------|---------|------|
+| ------ | --------- | ------ |
 | `trigger_update` | 触发词命中率低 | 添加/删除触发词 |
 | `content_refinement` | 采纳率低 | 突出最有效的部分 |
 | `example_update` | 示例过时 | 用实际使用案例替换 |
@@ -264,9 +285,11 @@ interface FeedbackResponse {
 
 VPS 上持续运行的后台思考进程。
 
-- **频率：** 每 5 分钟一轮
-- **预算上限：** 总预算的 10%
-- **行为：**
+* **频率：** 每 5 分钟一轮
+
+* **预算上限：** 总预算的 10%
+
+* **行为：**
   - 读取最近会话数据 + knowledge_base
   - 生成"当前状态感知"和"改进想法"
   - 写入 `consciousness/scratchpad.md`
@@ -281,7 +304,7 @@ VPS 上持续运行的后台思考进程。
 **操作范围（分级）：**
 
 | 目标文件 | 置信度要求 | 操作方式 |
-|---------|---------|---------|
+| --------- | --------- | --------- |
 | `skills/*.md`、`agents/*.md` | ≥ 70 | 自动 PR |
 | `src/hooks/*.ts` | ≥ 85 | 自动 PR |
 | `src/hooks/*.ts` | < 85 | Telegram 确认后执行 |
@@ -307,9 +330,12 @@ VPS 上持续运行的后台思考进程。
 分析 skill 使用数据，生成健康报告。
 
 **分析内容：**
-- Skill 使用频率和触发成功率
-- 检测"僵尸 skill"（从未被触发）
-- Agent 调用模式分析
+
+* Skill 使用频率和触发成功率
+
+* 检测"僵尸 skill"（从未被触发）
+
+* Agent 调用模式分析
 
 **输出：** 健康报告 → 推送 Telegram（每日一次）
 
@@ -467,29 +493,36 @@ Phase 2 模块随 ultrapower 插件自动安装，无需额外配置。
 ### VPS 云端层（Nexus Daemon）
 
 ```bash
+
 # 1. 克隆 nexus-daemon 仓库
+
 git clone git@github.com:user/nexus-daemon.git
 cd nexus-daemon
 
 # 2. 安装依赖
+
 pip install -r requirements.txt
 
 # 3. 配置环境变量
+
 cp .env.example .env
+
 # 编辑 .env 填入 OpenRouter API key 和 Telegram token
 
 # 4. 启动守护进程
+
 systemctl enable nexus-daemon
 systemctl start nexus-daemon
 
 # 5. 验证运行状态
+
 systemctl status nexus-daemon
 ```
 
 **技术栈：**
 
 | 层 | 技术 | 理由 |
-|---|---|---|
+| --- | --- | --- |
 | 插件层 | TypeScript | 与现有 ultrapower 一致 |
 | VPS 守护进程 | Python 3.11 | asyncio 支持后台循环 |
 | LLM 调用 | OpenRouter API | 多模型支持，成本优化 |
@@ -504,7 +537,7 @@ systemctl status nexus-daemon
 ### Phase 2 主动学习
 
 | 风险 | 影响 | 缓解策略 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | 反馈请求打扰用户 | 高 | 严格冷却时间 + 每会话上限 3 次 |
 | 采纳检测误报 | 中 | 多信号 AND 逻辑，高置信度阈值 |
 | 自动改进破坏 skill | 高 | 默认关闭自动改进，需用户确认 |
@@ -514,7 +547,7 @@ systemctl status nexus-daemon
 ### Nexus 双层架构
 
 | 风险 | 影响 | 缓解策略 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | 代码自动修改破坏插件 | 高 | 强制 tsc + npm test 门禁；置信度分级 |
 | 意识循环成本失控 | 中 | 10% 预算硬上限；每轮成本追踪 |
 | Git 同步冲突 | 低 | events/ 和 improvements/ 目录分离；文件名含时间戳 |
@@ -528,7 +561,7 @@ systemctl status nexus-daemon
 ### Phase 2 优先级
 
 | 优先级 | 任务 | 状态 |
-|--------|------|------|
+| -------- | ------ | ------ |
 | P0 | 反馈收集（`feedback/collector.ts` + `storage.ts`） | 📋 待实现 |
 | P0 | 主动推荐引擎（`recommender/engine.ts` + `timing.ts`） | 📋 待实现 |
 | P0 | Hook 集成（扩展 `skill-injector.mjs`，新增 `skill-feedback.mjs`） | 📋 待实现 |
@@ -540,7 +573,7 @@ systemctl status nexus-daemon
 ### Nexus 优先级
 
 | 优先级 | 任务 | 状态 |
-|--------|------|------|
+| -------- | ------ | ------ |
 | P0 | data-collector hook | 📋 待实现 |
 | P0 | consciousness-sync hook | 📋 待实现 |
 | P0 | nexus-daemon 基础框架 | 📋 待实现 |
@@ -556,7 +589,10 @@ systemctl status nexus-daemon
 
 ## 相关文档
 
-- [EVOLUTION.md](./EVOLUTION.md) — Axiom 自我进化系统（Phase 1 基础）
-- [REFERENCE.md](./REFERENCE.md) — 完整 API 参考
-- [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
-- [INSTALL.md](./INSTALL.md) — 安装部署指南
+* [EVOLUTION.md](./EVOLUTION.md) — Axiom 自我进化系统（Phase 1 基础）
+
+* [REFERENCE.md](./REFERENCE.md) — 完整 API 参考
+
+* [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
+
+* [INSTALL.md](./INSTALL.md) — 安装部署指南