feat: v0.7.0 四阶段全量迭代 — 修复面收口 · 安全纵深 · 架构还债 · 能力演进

P1 修复面收口: v0.6.3 截断自愈推全量(Anthropic/Ollama/非流式/引擎兜底); SSE 上游错误帧检测进重试通道;
clearMessages 摘要游标根治; truncateResult 内联图片白名单统一; 前端四 bug(确认弹窗锁死/MemoryViewer/
Virtuoso Footer/abort 尾部过滤) + reasoning 缓冲跨迭代污染; 托盘通知过滤与新建会话死链接线

P2 安全纵深: MCP 审批闭环(ConfirmationHook×PolicyEngine 联动+重名拒注册); SSRF 收敛 ssrf-guard 共享模块
(web_fetch 双通道校验+重定向终态复检); Electron 加固(preload CJS 化→sandbox:true/CSP/权限白名单/will-navigate);
run_command cmd.exe 白名单通道元字符守门; diff_viewer 10MB 预检; Anthropic thinking 预算下限; Agnes 思考显式关闭

P3 架构还债: OpenAICompatibleAdapter 中间基类收敛四家样板; 错误分类单轨化(删 mapError/getFetchSignal,
超时显式 ETIMEDOUT); PRAGMA user_version 迁移版本化; 死代码清理专项(cn.ts/SHORTCUTS/ContextMenu 分支/
getWindowState/modifiedArgs/sandbox 空壳); i18next 引入; a11y 第一轮; SearXNG 页批量草稿模型统一

P4 能力演进: Ollama pull 可取消/capabilities 探测/num_ctx 实测缓存; UpdateService feed 比对式自动更新
(app:updateCheck IPC + StatusBar 入口); MiMo providerOptions(web_search 服务端工具/strict JSON);
web_fetch extract_mode=markdown(turndown); network.proxyUrl 全局代理(Chromium sessions+undici dispatcher)

测试: 264 → 507 用例(Electron ABI 全绿零跳过), 覆盖引擎压缩管线/重试竞速/MEMORY.md 闸门/file_editor 五操作/
filesystem 七工具实体夹具/git 真实仓库/SSE 错误帧/全线截断自愈/Provider 请求形态矩阵/SSRF 表测/钩子分级矩阵/
OutputValidator 全量/SLO 指标/MCP 安全纯函数/task_manager 链路/渲染层纯域/i18n 桥契约

electron/harness/tools/built-in/http-request.ts

@@ -9,11 +9,12 @@
  * #10 修复: SSRF 防护 — 解析 URL 域名并校验 IP，拒绝内网/回环/元数据地址。
  */
 
-import { lookup } from 'node:dns/promises';
-import { isIP } from 'node:net';
 import type { IMetonaTool, ToolExecutionContext } from '../../types/metona-tool';
 import type { MetonaToolDef } from '../../../harness/types';
 import { MetonaToolCategory, MetonaRiskLevel } from '../../../harness/types';
+// v0.6.4 P2-2: SSRF 校验收敛到共享模块 ssrf-guard.ts —— 原实现是本文件私有逻辑，
+// web_fetch 无校验造成工具层最大的安全不对称。单源后所有网络工具行为一致。
+import { validateSSRF } from './ssrf-guard';
 
 const ALLOWED_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD'] as const;
 const MAX_BODY_BYTES = 50 * 1024; // 50KB
@@ -21,50 +22,13 @@ const MAX_BODY_BYTES = 50 * 1024; // 50KB
 /**
  * #10 修复: 检查 IP 是否为私有/内网/回环/元数据地址
  *
- * 覆盖：
- * - IPv4: 127.0.0.0/8 (回环)、10.0.0.0/8、192.168.0.0/16、172.16.0.0/12、
- *         169.254.0.0/16 (链路本地，含云元数据 169.254.169.254)、0.0.0.0/8、
- *         224.0.0.0/4 (组播)、240.0.0.0/4 (保留)
- * - IPv6: ::1 (回环)、fe80::/10 (链路本地)、fc00::/7 (唯一本地)、::ffff: 映射的 IPv4
+ * v0.6.4: 实现迁移到共享模块 ssrf-guard.ts（isPrivateIP / validateSSRF），
+ * 本文件仅保留使用方。实现细节与覆盖范围见 ssrf-guard.ts 注释：
+ * - IPv4: 127/8、10/8、192.168/16、172.16-31、169.254/16（云元数据）、0/8、224+/4
+ * - IPv6: ::1、fe80::/10、fc00::/7、::ffff: 映射 v4（递归检测）
  */
-function isPrivateIP(ip: string): boolean {
-  // IPv4 直接检测
-  if (isIP(ip) === 4) {
-    const parts = ip.split('.').map(Number);
-    if (parts[0] === 127) return true;          // 回环
-    if (parts[0] === 10) return true;           // 内网
-    if (parts[0] === 192 && parts[1] === 168) return true; // 内网
-    if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) return true; // 内网
-    if (parts[0] === 169 && parts[1] === 254) return true;  // 链路本地（含云元数据）
-    if (parts[0] === 0) return true;            // 0.0.0.0/8
-    if (parts[0] >= 224) return true;           // 组播 + 保留
-    return false;
-  }
-
-  // IPv6 检测
-  if (isIP(ip) === 6) {
-    const lower = ip.toLowerCase();
-    if (lower === '::1') return true;                        // 回环
-    if (lower.startsWith('fe80:')) return true;              // 链路本地
-    if (lower.startsWith('fc') || lower.startsWith('fd')) return true; // 唯一本地
-    // ::ffff: 映射的 IPv4 — 提取 IPv4 部分递归检测
-    const v4MappedMatch = lower.match(/::ffff:(\d+\.\d+\.\d+\.\d+)$/);
-    if (v4MappedMatch) return isPrivateIP(v4MappedMatch[1]);
-    return false;
-  }
-
-  // 非 IP 格式（域名等），由调用方 DNS 解析后再检测
-  return false;
-}
 
 /**
- * #10 修复: SSRF 校验 — 解析 URL 域名并校验 IP
- *
- * 1. 协议白名单：仅允许 http/https
- * 2. DNS 解析域名，获取所有 IP 地址
- * 3. 逐个检测 IP 是否为私有/内网/回环/元数据地址
- * 4. 任意一个 IP 为私有即拒绝（防止 DNS rebinding 中只校验第一个 IP）
- *
  * 审查修复 (M7) — 已知限制：DNS rebinding 窗口
  * ---------------------------------------------------------------
  * validateSSRF 在校验阶段 DNS 解析得到 IP，fetch 内部会再次 DNS 解析，
@@ -82,55 +46,8 @@ function isPrivateIP(ip: string): boolean {
  * 当前实现的缓解措施：
  *   - 校验所有 DNS 返回的 IP（防只校验第一个 IP 的绕过）
  *   - redirect: 'manual' 禁用自动重定向（防重定向到内网）
- *   - 窗口虽存在，但需要攻击者控制权威 DNS 并在毫秒级切换记录，
- *     实际利用难度较高。
- *
- * 彻底防护建议：在 Electron 主进程层使用自定义 lookup 钩子实现
- * DNS pinning（例如 undici 的 dispatcher.agent.connect lookup）。
- *
- * @throws 如果 URL 指向私有/内网/回环地址
+ *   - web_fetch 场景下对重定向终态 URL 复检（v0.6.4）
  */
-async function validateSSRF(url: string): Promise<void> {
-  let parsed: URL;
-  try {
-    parsed = new URL(url);
-  } catch {
-    throw new Error(`Invalid URL: ${url}`);
-  }
-
-  // 协议白名单
-  if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
-    throw new Error(`Blocked SSRF: protocol "${parsed.protocol}" not allowed (only http/https)`);
-  }
-
-  const hostname = parsed.hostname;
-
-  // 如果 hostname 本身就是 IP，直接检测
-  if (isIP(hostname)) {
-    if (isPrivateIP(hostname)) {
-      throw new Error(`Blocked SSRF: ${hostname} is a private/loopback address`);
-    }
-    return;
-  }
-
-  // 域名 — DNS 解析后检测所有 IP
-  let addresses: Array<{ address: string }>;
-  try {
-    addresses = await lookup(hostname, { all: true });
-  } catch (err) {
-    throw new Error(`Blocked SSRF: DNS resolution failed for ${hostname}: ${(err as Error).message}`);
-  }
-
-  if (addresses.length === 0) {
-    throw new Error(`Blocked SSRF: no DNS records for ${hostname}`);
-  }
-
-  for (const { address } of addresses) {
-    if (isPrivateIP(address)) {
-      throw new Error(`Blocked SSRF: ${hostname} resolves to private IP ${address}`);
-    }
-  }
-}
 
 export class HttpRequestTool implements IMetonaTool {
   readonly definition: MetonaToolDef = {