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
+89 -1
View File
@@ -17,6 +17,12 @@
import { lookup } from 'node:dns/promises';
import { isIP } from 'node:net';
/**
* v0.8.0 P1-5: DNS lookup 可替换点 —— 生产恒为 node:dns/promises 的 lookup
* 测试通过替换 current 注入受控解析结果(ESM namespace 只读,无法直接打桩)。
*/
export const __dnsLookup: { current: typeof lookup } = { current: lookup };
/**
* 检查 IP 是否为私有/内网/回环/元数据地址
*
@@ -98,7 +104,7 @@ export async function resolvePublicAddresses(url: string): Promise<string[]> {
// 域名 — DNS 解析后检测所有 IP
let addresses: Array<{ address: string }>;
try {
addresses = await lookup(hostname, { all: true });
addresses = await __dnsLookup.current(hostname, { all: true });
} catch (err) {
throw new Error(
`Blocked SSRF: DNS resolution failed for ${hostname}: ${(err as Error).message}`,
@@ -231,3 +237,85 @@ export function assertSafeConfigTarget(url: string): void {
}
// 域名(非 IP):允许(DNS 可能解析到内网,但用户显式配置的本地服务是合法场景)
}
/**
* v0.8.0 P1-5: 配置类 URL 的**深校验** —— 在 assertSafeConfigTarget 的静态规则
* 之上对域名做真实 DNS 解析,任一解析结果命中高危段(链路本地/云元数据、0/8、
* 组播保留、::ffff: 映射等价段)即拒绝。
*
* 与 assertSafeConfigTarget 的差异:后者对"域名放行"(不解析 DNS,本地实例
* 域名合法);本函数补上"域名解析到云元数据 IP"的绕过窗口
* (如 attacker.example 解析到 169.254.169.254)。
*
* 放行语义不变:127.0.0.1 / RFC1918 私网(本地 MCP/SearXNG 合法);DNS 解析
* 失败也放行(配置期校验为纵深手段 —— 离线配置合法,且运行时工具路径仍有
* 独立校验;失败仅 WARN 由调用方留痕)。
*
* @throws 如果 URL 解析结果指向高危目标或协议不被允许
*/
export async function assertSafeConfigTargetDeep(url: string): Promise<void> {
// 先执行静态规则(协议白名单/元数据主机名/IP 字面量段位)
assertSafeConfigTarget(url);
let parsed: URL;
try {
parsed = new URL(url);
} catch {
return; // assertSafeConfigTarget 已抛,此处不可达(防御)
}
const rawHostname = parsed.hostname.toLowerCase();
// IPv6 字面量去方括号(与 assertSafeConfigTarget 同口径)
const hostname =
rawHostname.startsWith('[') && rawHostname.endsWith(']')
? rawHostname.slice(1, -1)
: rawHostname;
if (isIP(hostname) !== 0) return; // IP 字面量已由静态规则判定,无需解析
let addresses: Array<{ address: string }>;
try {
addresses = await __dnsLookup.current(hostname, { all: true });
} catch (err) {
// DNS 解析失败:放行(配置期纵深校验不做可用性裁决),由调用方日志留痕
throw new DeepCheckSoftFailure(
`config target DNS resolution failed for ${hostname}: ${(err as Error).message}`,
);
}
for (const { address } of addresses) {
// 复用 isPrivateIP 的完整段位表做"高危段"判定?——不行:isPrivateIP 把
// 回环/RFC1918 也判为私有,而配置路径放行它们。此处仅拦"静态规则拦不到、
// 但解析后才暴露"的高危段:链路本地(含云元数据)、0/8、组播保留。
if (isHighRiskResolvedIP(address)) {
throw new Error(
`Blocked: ${hostname} resolves to high-risk address ${address} (link-local/metadata/multicast)`,
);
}
}
}
/** 高危段判定(仅配置深校验使用):链路本地/0/8/组播保留,放行回环与 RFC1918 */
function isHighRiskResolvedIP(ip: string): boolean {
if (isIP(ip) === 4) {
const parts = ip.split('.').map(Number);
return (parts[0] === 169 && parts[1] === 254) || parts[0] === 0 || parts[0] >= 224;
}
if (isIP(ip) === 6) {
const lower = ip.toLowerCase();
if (lower.startsWith('fe80:') || lower.startsWith('ff')) return true;
if (lower === '::') return true;
const v4MappedMatch = lower.match(/::ffff:(\d+\.\d+\.\d+\.\d+)$/);
if (v4MappedMatch) return isHighRiskResolvedIP(v4MappedMatch[1]);
return false;
}
return false;
}
/**
* v0.8.0 P1-5: 深校验的"软失败"信号 —— DNS 解析失败不算配置错误(放行),
* 但调用方需要区分"校验通过"与"跳过校验"以便日志留痕。
*/
export class DeepCheckSoftFailure extends Error {
constructor(message: string) {
super(message);
this.name = 'DeepCheckSoftFailure';
}
}