feat: v0.8.1 记忆深化 · 观测闭环 · 体验收口 — 窗口/输出上限全局单一配置 · 2478 用例全量回归 + E2E 冒烟
CI / 类型检查 + Lint + 单元测试 (push) Failing after 9m8s
CI / 全量测试 (Electron ABI) (push) Failing after 6m0s
CI / 产物编译验证 (push) Successful in 10m58s

硬性契约:删除代码中一切写死的上下文窗口与最大输出上限(含六家模型元信息
钳制与全部兜底值)——唯一合法来源是设置面板「上下文长度」(llm.contextWindow)
与「最大输出上限」(llm.maxTokens),跨 Provider/模型原样透传。

P0 正确性收口:
- 迁移 11/12(SCHEMA_VERSION 5):记忆表 embedding 列 + 分 Provider 窗口键清理
- 记忆生命周期接线:会话终态清理 working memory / episodic 90 天 TTL / access_count 回写
- 回放缓冲模块化 + 会话终态清理(杜绝 4MB/会话内存滞留)
- i18n 收口:主进程 main-locale(zh/en,ui.locale 热切换)+ 渲染层 17 处出层

P1 能力演进:
- 本地向量混合检索:0.6×向量余弦 + 0.4×TF-IDF,Ollama embeddings 首次投产,
  存量记忆惰性回填,嵌入不可用自动回退 TF-IDF
- MEMORY.md 维护闭环:固化去重消除截断盲区;两阶段维护(AI 建议 → 用户确认 →
  原子改写 + 语义记忆双轨同步 + 审计);>50KB 告警
- 可观测闭环:cacheTokens 引擎→前端透传(Token 面板命中率/成本行)+ 输入框
  上下文占用指示条
- MCP Prompts/Resources 对话可用:/mcp:{server}:{prompt} 与 @mcp:{server}:{uri}

P2 体验补全:
- 工具自定义策略(正则白/黑名单 + 频率 + 强制确认,热生效)
- 连续 ≥3 同类工具确认聚合为单弹框
- 会话消息游标分页(首屏 200 条向上翻页)
- 开机自启;Playwright + Electron E2E 冒烟(本地 mock LLM 零外联)

Review 回归修复:MCP 大小写失配 / 分页状态复位 / 清空=未配置语义(Number(null)=0
隐患)/ MEMORY.md 告警位置 / working_memories FK(迁移 13)/ 全局配置层废键清理;
附带根治权限加固启动时序、代理回环放行、safeStorage 降级、悬空 symlink 逃逸。

验证:typecheck/lint 0 问题;test:electron 2478/2478(0 跳过);E2E 2/2;
docs/v0.8.1-迭代实施清单.md 全项留档。
This commit is contained in:
2026-09-08 09:35:58 +08:00
parent 839860083f
commit 9b45c445bf
85 changed files with 5286 additions and 1158 deletions
+32 -2
View File
@@ -9,6 +9,8 @@ import { ipcMain } from 'electron';
import { join, resolve as resolvePath, sep } from 'path';
import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
import type { IPCContext } from './context';
// v0.8.1 P0-3: 会话终态清除流式回放缓冲
import { clearReplayBuffer } from './replay-buffer';
/** M-34 修复: 统一 sessionId 校验辅助函数 */
const isValidSessionId = (id: unknown): id is string =>
@@ -54,6 +56,11 @@ export function registerSessionHandlers(ctx: IPCContext): void {
// (防 rememberedDecisions 随会话数累积泄漏)
if (result.success) {
confirmationHook.forgetSession(sessionId);
// v0.8.1 P0-2: 会话终态联动清理工作记忆(此前 clearWorkingMemory 零调用方,
// working_memories 随会话数永久残留)
ctx.memoryManager.clearWorkingMemory(sessionId);
// v0.8.1 P0-3: 清除该会话的流式回放缓冲(最多 4MB/会话)
clearReplayBuffer(sessionId);
// v0.7.4 P3-5: 显式销毁引擎与 adapter 实例(内存收口)
// —— 旧实现只靠 LRU 上限 30 淘汰,会话删除后引擎仍驻留
agentEngineManager.disposeEngine(sessionId);
@@ -78,14 +85,35 @@ export function registerSessionHandlers(ctx: IPCContext): void {
if (result.success) {
confirmationHook.forgetSession(sessionId);
agentEngineManager.disposeEngine(sessionId);
// v0.8.1 P0-2: 终态联动清理工作记忆
ctx.memoryManager.clearWorkingMemory(sessionId);
// v0.8.1 P0-3: 清除该会话的流式回放缓冲
clearReplayBuffer(sessionId);
}
return result;
});
ipcMain.handle('sessions:getMessages', async (_event, sessionId: unknown) => {
ipcMain.handle('sessions:getMessages', async (_event, sessionId: unknown, options?: unknown) => {
// M-34 修复: 校验 sessionId
if (!isValidSessionId(sessionId)) return [];
return sessionService.getMessages(sessionId);
// v0.8.1 P2-3: 游标分页选项(limit 1-1000 / beforeRowid 正整数),非法值忽略
let safeOptions: { limit?: number; beforeRowid?: number } | undefined;
if (options && typeof options === 'object') {
const o = options as Record<string, unknown>;
safeOptions = {};
if (typeof o.limit === 'number' && Number.isFinite(o.limit) && o.limit >= 1) {
safeOptions.limit = Math.min(1000, Math.floor(o.limit));
}
if (
typeof o.beforeRowid === 'number' &&
Number.isFinite(o.beforeRowid) &&
o.beforeRowid > 0
) {
safeOptions.beforeRowid = Math.floor(o.beforeRowid);
}
if (Object.keys(safeOptions).length === 0) safeOptions = undefined;
}
return sessionService.getMessages(sessionId, safeOptions);
});
// v0.7.4 P3-10: 更新单条用户消息内容(编辑"仅保存"落库)。
@@ -129,6 +157,8 @@ export function registerSessionHandlers(ctx: IPCContext): void {
if (!isValidSessionId(sessionId)) return { success: false, error: 'Invalid sessionId' };
try {
sessionService.clearMessages(sessionId);
// v0.8.1 P0-2: 清空会话 = 会话内容重置 —— 工作记忆一并清理
ctx.memoryManager.clearWorkingMemory(sessionId);
return { success: true };
} catch (error) {
return { success: false, error: (error as Error).message };