feat: v0.7.4 时序语义修正 · 防线实效补漏 · 全量测试翻倍 — 2406 用例 + jsdom 组件测试全量回归
CI / 类型检查 + Lint + 单元测试 (push) Failing after 6m27s
CI / 产物编译验证 (push) Successful in 9m57s
CI / 全量测试 (Electron ABI) (push) Failing after 5m19s

P1 修复面收口:
- 超时三态区分(aborted→USER_INTERRUPT / ETIMEDOUT→TIMEOUT / 其余→ERROR),
  根治"真实网络超时被误报为用户中断"
- 流空闲超时统一(SSE/Ollama/Anthropic 读循环 60s 无数据抛 504 进重试通道)
- 同会话并发 sendMessage 防重入(isRunning 守卫)+ 会话存在性预检 +
  前置调用移入 try(ERROR+DONE 双事件保证,根治 isStreaming 假死)
- 清空审计后 resetChainCache(根治 verifyChain 误报 TAMPERED)
- DONE 不再提前清理 TRACE(TERMINATED 统一收尾,补全最终迭代录制)
- IME 合成回车不发送(普通 Enter + Cmd/Ctrl+Enter 双分支)+ handleSend 闭包修复

P2 安全纵深:
- preload 移除原始 electronAPI 暴露(渲染层零使用,关掉 XSS invoke 任意通道单点风险)
- CORS 同源回显根治(仅当前浏览页面 Origin,did-navigate 同步)
- MEMORY.md 命令保护正则扩展(括号/$/反引号/< 重定向边界 + 前导路径)
- write_file append TOCTOU 统一(open 后 realpath 校验,新文件分支补漏)
- 敏感键归一化(authKey 驼峰/连字符命中)+ MCP headers 鉴权值加密落库
- ReDoS 检测共享化(search_files/file_editor 统一拦截)
- run_tests/lint_code 升风险 + 需确认 + npx --no-install(执行边界对齐 run_command)
- MCP/SearXNG/llm.baseURL/updateFeedUrl 配置类 URL 高危目标校验(IPv6 去括号 +
  十六进制映射解析 + 尾点剥离)

P3 架构还债:
- temperature/maxTokens 热生效(引擎/编排器/SubAgent 三处接线)+ setBatch 单事务落盘
- SessionRecorder flush 竞态根治(flushPromise 等待 + 超限内联落盘 + stopRecording async)
- 内存收口(lastConsolidationBySession LRU / subTraces 清理 / 会话删除 disposeEngine)
- i18n 全量收口(28 组件 + 353 key 双字典,状态标签改渲染时函数)
- 死代码清理(updateTraceStep/HEADER_HEIGHT/void preA/失实注释)
- 斜杠菜单 MUI 化 + 删除逻辑收敛 resetSessionState + Blob URL 统一释放 +
  用户消息"仅保存"落库(saveMessage 透传前端 id 修复 id 错位)

P4 能力演进:
- 死循环检测拆分(驻留前置 + 乒乓后置带进度信号,合法交替不误报)
- run-lock 30s 超时强制 abort(旧 run 卡死不无限排队)
- RETRY 双通道 stream_reset(前端按 run 归属精确清空,根治重试文本重复)
- FTS5 trigram 中文子串搜索(迁移 9 版本化 SCHEMA_VERSION=2,≤2 字符 LIKE 回退)
- getContextWindow 兜底 1M→128K(未知模型防 413)

测试:
- 855 → 2406 用例(+1551,2.8 倍):服务层 +325(含 MemoryManager 51 新用例)、
  工具实体 +483、IPC/适配器 +390(含 OpenAI/Anthropic/Ollama 独立套件)、
  纯函数表格化 +330;引入 jsdom + @testing-library(14 组件测试文件 249 用例)
- 修复 R1(saveMessage id 透传)/ R2(stream_reset 精确归属)两个回归缺陷
- 遗留低危项清零:git-tools 顺序耦合 / web-fetch 真实时间退避 / slo 内存断言 /
  mcp-security 多余 skipIf / deepseek-balance 命名误导 / 组件 mock 注入脆弱性

版本: 0.7.4; README 同步(工具风险表/版本徽章); 依赖: 移除 @electron-toolkit/preload,
新增 jsdom/@testing-library(devDependencies 不打包)

回归: typecheck 双端 0 错误; ESLint 0/0; Electron ABI 全量 2406/2406 零跳过;
系统 Node 2110 通过 296 跳过(better-sqlite3 ABI)
This commit is contained in:
2026-08-30 19:19:07 +08:00
parent ebe45482b0
commit 99d0c54129
137 changed files with 25190 additions and 1792 deletions
@@ -140,3 +140,94 @@ export async function safeValidateSSRF(
return { ok: false, error: (err as Error).message };
}
}
/**
* v0.7.4 P2-9: 配置类 URLMCP server url / SearXNG url)的安全校验。
*
* 与工具执行路径(validateSSRF)的区别:MCP/SearXNG 实例由用户在设置页显式
* 配置且常部署在本机/内网(127.0.0.1、192.168.x 的本地 server 是合法用例),
* 不能一刀切拒绝私网。但渲染层可控的 URL 若允许指向云元数据/链路本地高危段,
* XSS 后可作内网探测跳板。
*
* 规则:
* - 协议仅 http/https
* - 阻止:169.254.169.254(云元数据)与 169.254/16 链路本地、0.0.0.0、
* [::](未指定)、fe80::/10(链路本地)、ff00::/8(组播)、
* ::ffff: 映射的 IPv4(递归复用 isPrivateIP 段位判定,云元数据映射也拦)、
* metadata.google.internal 等元数据主机名、224/4 组播与 240/4 保留段
* - 放行:127.0.0.1 / RFC1918 私网(本地/局域网 MCP、SearXNG 合法)
*
* v0.7.4 P2-9 修正:
* - IPv6 死代码:Node URL.hostname 对 IPv6 字面量**带方括号**返回(如 '[::1]'),
* 旧实现直接 isIP(hostname) 对带括号值恒 0 → 全部落入"域名放行"分支,
* [::ffff:169.254.169.254] 云元数据映射被放行。现先去括号再判定。
* - 域名尾点绕过:metadata.google.internal.(合法 FQDN 尾点)先剥离尾点再比对。
*
* @throws 如果 URL 指向高危目标或协议不被允许
*/
export function assertSafeConfigTarget(url: string): 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: protocol "${parsed.protocol}" not allowed (only http/https)`);
}
// 去方括号(IPv6 字面量) + 去尾点(FQDN 尾点)后统一判定
let hostname = parsed.hostname.toLowerCase();
if (hostname.startsWith('[') && hostname.endsWith(']')) {
hostname = hostname.slice(1, -1);
}
if (hostname.endsWith('.')) {
hostname = hostname.slice(0, -1);
}
// 云元数据/链路本地高危主机名(域名形式,含尾点剥离后)
const HIGH_RISK_HOSTS = ['metadata.google.internal', 'metadata.google', '169.254.169.254'];
if (HIGH_RISK_HOSTS.some((h) => hostname === h || hostname.endsWith('.' + h))) {
throw new Error(`Blocked: ${hostname} is a cloud metadata / link-local target`);
}
// IP 直连:仅阻止链路本地/组播/保留/0.0.0.0(本地回环与 RFC1918 私网放行)
const ipVersion = isIP(hostname);
if (ipVersion !== 0) {
if (ipVersion === 4) {
const parts = hostname.split('.').map(Number);
const blocked =
(parts[0] === 169 && parts[1] === 254) || // 链路本地(含云元数据)
parts[0] === 0 || // 0.0.0.0/8
parts[0] >= 224; // 组播 + 保留
if (blocked) {
throw new Error(`Blocked: ${hostname} is a link-local/multicast/reserved address`);
}
return;
}
// IPv6:阻止 ::(未指定)、fe80::/10(链路本地)、ff00::/8(组播)、
// 以及 ::ffff: 映射的 IPv4(复用 IPv4 段位判定,云元数据映射一并拦)。
// 注意:Node URL.hostname 对 IPv4-mapped 返回十六进制(::ffff:a9fe:a9fe),
// 需解析为 IPv4 再判定。
const lower = hostname;
const v4MappedMatch = lower.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);
if (v4MappedMatch) {
// 两段十六进制 → IPv4:段1<<8|段2
const a = parseInt(v4MappedMatch[1], 16);
const b = parseInt(v4MappedMatch[2], 16);
const v4 = `${a >> 8}.${a & 0xff}.${b >> 8}.${b & 0xff}`;
const parts = v4.split('.').map(Number);
const blocked = (parts[0] === 169 && parts[1] === 254) || parts[0] === 0 || parts[0] >= 224;
if (blocked) {
throw new Error(
`Blocked: ${hostname} (IPv4-mapped) is a link-local/multicast/reserved address`,
);
}
return;
}
if (lower === '::' || lower.startsWith('fe80:') || lower.startsWith('ff')) {
throw new Error(`Blocked: ${hostname} is an unspecified/link-local/multicast address`);
}
return;
}
// 域名(非 IP):允许(DNS 可能解析到内网,但用户显式配置的本地服务是合法场景)
}