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
+58 -17
View File
@@ -57,6 +57,12 @@ interface SessionRecordState {
buffer: string[];
flushTimer: NodeJS.Timeout | null;
flushing: boolean;
/**
* v0.7.4 P3-4: 当前 in-flight 异步 flush 的 Promise(供 flushSync 等待)。
* 根治"异步 flush 失败把数据 unshift 回 buffer 后,stopRecording 删除状态
* 导致重试数据丢失"的竞态。
*/
flushPromise: Promise<void> | null;
}
// ===== 服务类 =====
@@ -104,6 +110,7 @@ export class SessionRecorder {
buffer: [],
flushTimer: null,
flushing: false,
flushPromise: null,
});
// 写入 session_start 事件
@@ -118,8 +125,10 @@ export class SessionRecorder {
/**
* 停止录制(P1-6: 按会话停止,不影响其他并发录制)
* v0.7.4 P3-4: 改为 async —— 先等待 in-flight 异步 flush 完成(防止其失败回滚的
* 数据在状态删除后丢失),再同步 flush 剩余 buffer,最后删除状态。
*/
stopRecording(
async stopRecording(
sessionId: string,
params: {
totalIterations: number;
@@ -127,7 +136,7 @@ export class SessionRecorder {
durationMs: number;
terminationReason: string;
},
): void {
): Promise<void> {
const state = this.state(sessionId);
if (!state) return;
@@ -141,7 +150,8 @@ export class SessionRecorder {
});
// #35 修复: 同步 flush 确保最后的 session_end 事件写入文件
this.flushSync(sessionId);
// v0.7.4 P3-4: flushSync 先等待 in-flight flush(避免交叉写入/丢数据)再同步落盘
await this.flushSync(sessionId);
log.info(`Session recording stopped: ${state.filePath}`);
this.sessions.delete(sessionId);
@@ -375,8 +385,17 @@ export class SessionRecorder {
// 审查修复: buffer 上限防止 OOM — 高频事件持续 flush 失败时避免内存无限增长
const MAX_BUFFER_SIZE = 1000;
if (state.buffer.length >= MAX_BUFFER_SIZE) {
// 超限时强制同步写入,避免内存无限增长
this.flushSync(sessionId);
// v0.7.4 P3-4 修正: 超限路径原调用 async flushSync 但未 await(同步方法内无法 await),
// flushSync 改为 async 后产生 in-flight 窗口(await 期间新事件与另一 flush 交叉)。
// 现改为内联同步落盘:直接 appendFileSync 当前 buffer(不含本行),保证确定性。
const flushData = state.buffer.join('\n') + '\n';
state.buffer = [];
try {
appendFileSync(state.filePath, flushData, 'utf-8');
} catch (error) {
log.error('Trace event buffer overflow flush failed:', error);
state.buffer.unshift(flushData.trimEnd());
}
}
state.buffer.push(line);
if (!state.flushTimer) {
@@ -394,6 +413,8 @@ export class SessionRecorder {
* #35 修复: 异步 flush 缓冲区到文件
* 审查修复: 用局部变量保存 filePath,防止 stopRecording 将状态删除后 appendFile 抛错;
* 失败时将数据 unshift 回 buffer 避免丢整批数据
* v0.7.4 P3-4: flush 的 Promise 存入 state.flushPromise,供 flushSync 等待 ——
* 根治"异步 flush 失败回滚数据后 stopRecording 删除状态导致数据丢失"的竞态。
*/
private async flush(sessionId: string): Promise<void> {
const state = this.state(sessionId);
@@ -402,31 +423,51 @@ export class SessionRecorder {
const filePath = state.filePath; // 局部变量,防止中途状态被删除
const data = state.buffer.join('\n') + '\n';
state.buffer = [];
try {
await promises.appendFile(filePath, data, 'utf-8');
} catch (error) {
log.error('Trace event flush failed:', error);
// 审查修复: 失败时将数据放回 buffer 头部,下次 flush/flushSync 重试
const st = this.state(sessionId);
if (st) st.buffer.unshift(data.trimEnd());
} finally {
const st = this.state(sessionId);
if (st) st.flushing = false;
}
const run = (async (): Promise<void> => {
try {
await promises.appendFile(filePath, data, 'utf-8');
} catch (error) {
log.error('Trace event flush failed:', error);
// 审查修复: 失败时将数据放回 buffer 头部,下次 flush/flushSync 重试
const st = this.state(sessionId);
if (st) st.buffer.unshift(data.trimEnd());
} finally {
const st = this.state(sessionId);
if (st) st.flushing = false;
}
})();
state.flushPromise = run;
await run;
// 清空引用(若期间又发起了新 flush,由新调用覆盖)
const st = this.state(sessionId);
if (st && st.flushPromise === run) st.flushPromise = null;
}
/**
* #35 修复: 同步 flush 缓冲区到文件
* 用于 stopRecording 确保最后的数据(如 session_end 事件)写入文件
* 审查修复: 如果异步 flush 正在进行(flushing=true),等待其完成后再写入,避免数据交叉/丢失
* v0.7.4 P3-4: 改为 async 且真正等待 in-flight flush —— 旧实现只检查 flushing 标志后
* buffer 为空即返回,若异步 flush 失败把数据 unshift 回 bufferstopRecording 随即将
* 状态删除,重试数据整体丢失。现在先 await flushPromise(失败回滚的数据会回到 buffer),
* 再同步 appendFileSync 剩余数据,确保零丢失。
*/
private flushSync(sessionId: string): void {
private async flushSync(sessionId: string): Promise<void> {
const state = this.state(sessionId);
if (!state) return;
if (state.flushTimer) {
clearTimeout(state.flushTimer);
state.flushTimer = null;
}
// 等待 in-flight 异步 flush 完成(其失败回滚的数据会回到 buffer)
if (state.flushPromise) {
try {
await state.flushPromise;
} catch {
/* flush 内部已吞错,此处防御 */
}
}
if (state.buffer.length === 0) return;
const data = state.buffer.join('\n') + '\n';
state.buffer = [];