feat: v0.8.0 流语义补全 · 会话可靠 · 恢复力 — finish_reason 全链路贯通根治"思考中停止" · 2445 用例全量回归
CI / 类型检查 + Lint + 单元测试 (push) Failing after 9m16s
CI / 全量测试 (Electron ABI) (push) Failing after 6m4s
CI / 产物编译验证 (push) Successful in 11m1s

P0 会话可靠性收口(根治"模型思考着会话就停止"):
- P0-1 finish_reason 全链路贯通:DONE 事件与 IterationStep 新增 finishReason,OpenAI 共享 SSE / Anthropic message_delta.stop_reason / Ollama done_reason 三路采集,TRACE 层弃用硬编码 'stop' 记录真值
- P0-2 空响应守卫 + 降级重试:零产出流→可重试错误走退避;思考耗尽输出预算(reasoning-only + length)→自动关闭思考降级重试一次;仍失败→OUTPUT_LENGTH_EXCEEDED 结构化错误 + 故障转移;附带根治 abort 恰逢零工具调用轮被 COMPLETED 抢占的真实缺陷
- P0-3 思考×能力×预算三对齐:DeepSeek/MiMo/Agnes/Ollama 四家 supportsThinking=false 强制不发思考参数;小输出预算告警;设置页联动提示
- P0-4 渲染层可见性:截断/空完成/友好错误三类提示,i18n 全部出层
- P0-5 回归四件套:reasoning-only 终止判定、集成级空闲超时、504 引擎重试归类、思考中 abort→USER_INTERRUPT、P4-2 强制收尾路径

FEAT-1:LLM 设置新增「最大输出上限」——Provider 支持矩阵显隐 + 模型上限钳制提示 + 超限保存警告 + llm.maxTokens 热生效

P1 修复面收口:
- 渲染层三缺陷根治:后台会话回放缓冲(2000 条/4MB 有界 + agent:getReplayState + 事件总线)+ abort 双层自愈 + sendMessage 收尾兜底 + 中断卡片清扫
- 工具 abort 信号全覆盖:web_search/web_fetch/http_request/code_search/git 系列/delegate_task 全部接入引擎中断;web_search 时间预算收敛(720s→≤240s);移除伪造 ToolExecutionContext 与死代码
- 安全:本地 Pinned CONNECT 代理根治浏览器通道 DNS rebinding(校验期 IP pinning,可注入 resolver 表测);配置 URL 域名解析深校验(DeepCheckSoftFailure 软失败);SSE 空 error 帧防御修复;Ollama generate/embed AbortSignal.any 合并
- 缺陷清单:UTF-16 BOM 读取、tmp 同毫秒碰撞(nanoid 后缀)、code_search JS 回退参数对称(case_sensitive/前后文独立)、list_directory include_node_modules、崩溃自愈退避(60s 窗 ≥3 次停 reload)、MemoryViewer/Sidebar i18n 收口

P2 能力演进:
- 会话回收站:SCHEMA_VERSION 3 + 迁移 10(deleted_at,存在性守卫),软删除/恢复/彻底删除/30 天自动清理(启动+24h),searchMessages 聚合剔除,Sidebar 回收站面板
- 会话回放播放器:sessions:listRecordings/readRecording(白名单+目录边界+20MB 上限),SessionReplayPlayer 时间轴/步进/变速,Trace 面板入口
- electron-updater 自动更新:双轨(手动 feed 比对保留),生产环境启动静默检查 + update:status 广播 + app:updateInstall + LogsSettings UpdatePanel + builder publish 配置
- @ 文件提及:workspace.listFiles/readFileClip(边界/512KB/NUL 拒绝/MEMORY.md 保护),ChatInput Fuse 联想+键盘导航+附件管线注入
- MCP Resources/Prompts 发现:可选能力 try/catch 降级,mcp:listServerContents,MCPSettings 展开视图
- 文档对齐:内部 API 标准 HTML(Adapter 清单补 MiMo/已实现注记/STREAM_RESET/DONE.finishReason/ repetition_truncation 映射);README v0.8.0 亮点表

P3 测试基建:
- 新增 4 个测试文件:engine-stream-contract(6)、engine-stream-reliability(4:集成空闲超时/504 重试/思考中 abort/P4-2 强制收尾)、thinking-capability-gate(7)、pinned-proxy(9,含深校验 5)、session-trash(5,DB 域)、use-agent-stream hook 级(5)、agent.test 回放缓冲(2)
- 契约更新:orchestrator 被中断 SubAgent success=false(abort 优先级修复语义)、SSE 空 error 帧、UTF-16 正常读取、DeepSeek 未配置思考显式 disabled、迁移矩阵 v2→3
- 弱断言根治:registry WEBP 单向断言、hooks-contracts 自比恒真、memory 空 token 补强

全量验证:typecheck 0 错误 / lint 0 问题 / 系统 Node 2144 通过(301 DB 用例按 ABI 跳过)/ Electron ABI 2445/2445 全量通过 0 跳过
This commit is contained in:
2026-09-05 20:06:26 +08:00
parent 99d0c54129
commit 5b9d4d19b3
78 changed files with 5128 additions and 411 deletions
@@ -0,0 +1,157 @@
/**
* v0.8.0 P2-1: 会话回收站(软删除 30 天保留)回归测试。
*
* 钉住契约:
* - delete → 软删除(deleted_at 时间戳),list/getSession 不再返回,listDeleted 返回;
* - restore → 恢复到主列表;
* - purge → 硬删除(不可恢复);
* - purgeExpiredTrash(30d) → 仅清理超期条目;
* - searchMessages 聚合剔除回收站会话。
*
* 运行要求:better-sqlite3 为 Electron ABI 构建(test:electron),系统 Node 下自动跳过。
*/
import { describe, it, expect, beforeAll, afterAll, vi } from 'vitest';
vi.mock('electron-log', () => ({
default: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() },
}));
let dbAvailable = true;
let Database: typeof import('better-sqlite3');
try {
// eslint-disable-next-line @typescript-eslint/no-require-imports
Database = require('better-sqlite3');
const probe = new Database(':memory:');
probe.close();
} catch {
dbAvailable = false;
}
describe.skipIf(!dbAvailable)('会话回收站(v0.8.0 P2-1', () => {
let sessionService: any;
let db: InstanceType<typeof Database>;
beforeAll(async () => {
const { SessionService } = await import('../session.service');
db = new Database(':memory:');
db.pragma('foreign_keys = ON');
// 最小 schema(与 DatabaseService.createTables 对齐的关键列:deleted_at + 级联删除)
db.exec(`
CREATE TABLE sessions (
id TEXT PRIMARY KEY,
title TEXT DEFAULT '新会话',
created_at INTEGER NOT NULL,
updated_at INTEGER NOT NULL,
message_count INTEGER DEFAULT 0,
total_tokens INTEGER DEFAULT 0,
pinned INTEGER DEFAULT 0,
archived INTEGER DEFAULT 0,
deleted_at INTEGER,
metadata TEXT DEFAULT '{}'
);
CREATE TABLE messages (
id TEXT PRIMARY KEY,
session_id TEXT NOT NULL,
role TEXT NOT NULL,
content TEXT,
reasoning_content TEXT,
tool_calls TEXT,
tool_result TEXT,
attachments TEXT,
iteration INTEGER,
created_at INTEGER NOT NULL,
FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
);
CREATE TABLE session_summaries (
session_id TEXT PRIMARY KEY,
summary TEXT NOT NULL,
summarized_until_rowid INTEGER NOT NULL,
updated_at INTEGER NOT NULL,
FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
);
`);
sessionService = new SessionService(() => db);
});
afterAll(() => {
try {
db.close();
} catch {
/* ignore */
}
});
it('delete → 软删除:list 不返回、listDeleted 返回、getSession 排除', () => {
const a = sessionService.create('A');
const b = sessionService.create('B');
expect(sessionService.delete(a.id)).toBe(true);
const list = sessionService.list().map((s: { id: string }) => s.id);
expect(list).toContain(b.id);
expect(list).not.toContain(a.id);
const trash = sessionService.listDeleted().map((s: { id: string }) => s.id);
expect(trash).toEqual([a.id]);
expect(sessionService.getSession(a.id)).toBeNull();
expect(sessionService.getSession(b.id)).not.toBeNull();
});
it('restore → 恢复到主列表', () => {
const a = sessionService.listDeleted()[0];
expect(sessionService.restore(a.id)).toBe(true);
expect(sessionService.list().map((s: { id: string }) => s.id)).toContain(a.id);
expect(sessionService.listDeleted()).toHaveLength(0);
});
it('purge → 硬删除(仅对回收站条目生效)', () => {
const s = sessionService.create('temp');
sessionService.delete(s.id);
sessionService.saveMessage({ sessionId: s.id, role: 'user', content: 'x' });
expect(sessionService.purge(s.id)).toBe(true);
const count = db
.prepare('SELECT COUNT(*) AS c FROM messages WHERE session_id = ?')
.get(s.id) as {
c: number;
};
expect(count.c).toBe(0);
// 未删除的会话不可 purge(幂等保护)
const live = sessionService.create('live');
expect(sessionService.purge(live.id)).toBe(false);
});
it('purgeExpiredTrash(30d) → 仅清理超期条目', () => {
const old = sessionService.create('old');
sessionService.delete(old.id);
db.prepare('UPDATE sessions SET deleted_at = ? WHERE id = ?').run(
Date.now() - 31 * 24 * 60 * 60 * 1000,
old.id,
);
const fresh = sessionService.create('fresh');
sessionService.delete(fresh.id); // deleted_at = now
const purged = sessionService.purgeExpiredTrash(30);
expect(purged).toBe(1);
const remaining = db.prepare('SELECT COUNT(*) AS c FROM sessions WHERE id = ?').get(old.id) as {
c: number;
};
expect(remaining.c).toBe(0);
expect(sessionService.listDeleted().map((s: { id: string }) => s.id)).toContain(fresh.id);
});
it('searchMessages 聚合剔除回收站会话(≤2 字符 LIKE 回退路径)', () => {
const s1 = sessionService.create('搜索目标会话');
sessionService.saveMessage({ sessionId: s1.id, role: 'user', content: '量子计算机的独特内容' });
// '量子' ≤2 字符走 LIKE 回退(最小 schema 无 FTS 表,与生产 trigram 路径
// 共用同一个 aggregateSearchResults 聚合出口,剔除逻辑同源)
const r1 = sessionService.searchMessages('量子');
expect(r1.length).toBe(1);
sessionService.delete(s1.id);
const r2 = sessionService.searchMessages('量子');
expect(r2.length).toBe(0);
});
});