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
+62 -12
View File
@@ -27,6 +27,7 @@ import type { MetonaToolDef } from '../harness/types';
import { MetonaToolCategory, MetonaRiskLevel } from '../harness/types';
// v0.7.3 P3-2: 子进程环境净化收敛到 utils/safe-env.ts 单源(与 run_command 共用)
import { buildSafeChildEnv } from '../utils/safe-env';
import { encryptConfigValue, decryptConfigValue, isEncryptedValue } from '../utils/secure-config';
// v0.3.0 修复: 安全解析 JSON args,防止数据库中存储了非法 JSON 导致初始化崩溃
/** @visibleForTesting 纯函数,供安全表测直接断言 */
@@ -110,16 +111,45 @@ export function buildSafeEnv(): Record<string, string> {
}
/**
* v0.7.2 P2-8: 安全解析 MCP headers 列(JSON 对象,键值均为字符串)
* v0.7.4 P2-5 根治: MCP headers 中敏感键(鉴权类)的值加密落库
*
* 数据库中存储为 JSON 字符串(mcp_servers.headers 列自建表起即存在
* 此前从未被读写)。解析规则:
* - 空/null → undefined(匿名连接)
* - 非对象 / 数组 / 含非字符串键值 → 丢弃该条目并 WARN(保持可用性优先,
* 不因单列损坏阻断整个 server 连接)
* 背景:旧实现直接把 config.headers JSON.stringify 写入 mcp_servers.headers 列,
* 绕过 secure-config —— Authorization: Bearer xxx 等远程 MCP 鉴权头明文存于本地
* DB 文件,任何人拿到 DB 即可读取所有远程 MCP 凭据。
*
* 规则:仅对敏感键(authorization / proxy-authorization / x-api-key / api-key /
* 含 token/secret/password 的键)的值走 encryptConfigValuesafeStorage 加密 +
* metona-enc:v1: 前缀);普通键(如 Accept / Content-Type)明文存储,保持
* 可读性。读取侧(parseStoredHeaders)对加密值解密。
*/
/** @visibleForTesting 纯函数,供安全表测直接断言 */
export function safeParseHeaders(
const SENSITIVE_HEADER_KEY_RE =
/^(authorization|proxy-authorization|x-api-key|api-key)$|(token|secret|password|credential)/i;
/** @visibleForTesting 纯函数:判断 header 键是否敏感(需加密值) */
export function isSensitiveHeaderKey(key: string): boolean {
return SENSITIVE_HEADER_KEY_RE.test(key);
}
/**
* v0.7.4 P2-5: 落库前序列化 headers —— 敏感键值加密。
* @param headers 运行时 headers(明文)
* @returns 可写入 DB 的 JSON 字符串(敏感值带 metona-enc:v1: 前缀)
*/
export function serializeHeadersForStorage(headers: Record<string, string>): string {
const out: Record<string, string> = {};
for (const [k, v] of Object.entries(headers)) {
out[k] = isSensitiveHeaderKey(k) ? (encryptConfigValue(v) as string) : v;
}
return JSON.stringify(out);
}
/**
* v0.7.4 P2-5: 读取 DB 后反序列化 headers —— 加密值解密为明文。
* 兼容历史明文(无前缀值原样返回)与加密格式(metona-enc:v1:)。
* @param raw DB headers 列的原始 JSON 字符串
* @returns 明文 headers(供 requestInit 注入)
*/
export function parseStoredHeaders(
raw: string | null | undefined,
): Record<string, string> | undefined {
if (!raw) return undefined;
@@ -128,11 +158,11 @@ export function safeParseHeaders(
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return undefined;
const out: Record<string, string> = {};
for (const [k, v] of Object.entries(parsed as Record<string, unknown>)) {
if (typeof v === 'string') {
out[k] = v;
} else {
if (typeof v !== 'string') {
log.warn(`MCP headers entry "${k}" dropped: value is not a string`);
continue;
}
out[k] = isEncryptedValue(v) ? (decryptConfigValue(v) as string) : v;
}
return Object.keys(out).length > 0 ? out : undefined;
} catch {
@@ -141,6 +171,25 @@ export function safeParseHeaders(
}
}
/**
* v0.7.2 P2-8: 安全解析 MCP headers 列(JSON 对象,键值均为字符串)。
*
* 数据库中存储为 JSON 字符串(mcp_servers.headers 列自建表起即存在,
* 此前从未被读写)。解析规则:
* - 空/null → undefined(匿名连接)
* - 非对象 / 数组 / 含非字符串键值 → 丢弃该条目并 WARN(保持可用性优先,
* 不因单列损坏阻断整个 server 连接)
*
* v0.7.4 P2-5: 本函数保留为"解析不含加密值的 headers"(历史明文路径/测试兼容);
* 运行时读取统一走 parseStoredHeaders(含解密)。
*/
/** @visibleForTesting 纯函数,供安全表测直接断言 */
export function safeParseHeaders(
raw: string | null | undefined,
): Record<string, string> | undefined {
return parseStoredHeaders(raw);
}
// ===== 类型定义 =====
export type MCPServerStatus =
@@ -687,8 +736,9 @@ export class MCPManager {
config.command ?? null,
config.args ? JSON.stringify(config.args) : null,
config.url ?? null,
// v0.7.4 P2-5: 敏感键值加密后落库(Authorization/x-api-key 等不再明文存 DB
config.headers && Object.keys(config.headers).length > 0
? JSON.stringify(config.headers)
? serializeHeadersForStorage(config.headers)
: null,
);