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
+110 -12
View File
@@ -5,11 +5,72 @@
import { ipcMain } from 'electron';
import type { IPCContext } from './context';
import type { MemoryType } from '../harness/memory/manager';
import type { MemoryMaintenanceAction } from '../harness/memory/maintainer';
import log from 'electron-log';
const VALID_MEMORY_TYPES: readonly MemoryType[] = ['episodic', 'semantic', 'working'];
export function registerMemoryHandlers(ctx: IPCContext): void {
const { memoryManager, sessionService } = ctx;
const { memoryManager, sessionService, memoryMaintainer, auditService } = ctx;
// ===== v0.8.1 P1-2: MEMORY.md 维护闭环(分析/应用两阶段) =====
// 阶段一:LLM 分析当前 MEMORY.md → 结构化维护建议(不改任何文件/DB)
ipcMain.handle('memory:analyzeMaintenance', async () => {
try {
const proposal = await memoryMaintainer.analyze();
return { success: true, data: proposal };
} catch (error) {
log.warn('[IPC] memory:analyzeMaintenance failed:', (error as Error).message);
return { success: false, error: (error as Error).message };
}
});
// 阶段二:应用用户确认(勾选)后的动作 —— 精确匹配校验 + 重写 MEMORY.md +
// 同步 semantic_memories + 审计留痕
ipcMain.handle('memory:applyMaintenance', async (_event, actions: unknown) => {
if (!Array.isArray(actions)) {
return { success: false, error: 'Invalid actions: must be an array' };
}
// 结构校验:只透传合法字段,其余拒绝
const valid: MemoryMaintenanceAction[] = [];
for (const item of actions.slice(0, 30)) {
if (!item || typeof item !== 'object') continue;
const a = item as Record<string, unknown>;
if (a.action !== 'delete' && a.action !== 'update') continue;
if (typeof a.section !== 'string' || typeof a.entry !== 'string') continue;
if (a.action === 'update' && typeof a.newEntry !== 'string') continue;
valid.push({
action: a.action,
section: a.section,
entry: a.entry,
newEntry: typeof a.newEntry === 'string' ? a.newEntry : undefined,
reason: typeof a.reason === 'string' ? a.reason : undefined,
});
}
try {
const result = memoryMaintainer.apply(valid);
auditService.log({
sessionId: '',
eventType: 'tool_call',
actor: 'user',
target: 'memory_maintenance',
details: { requested: valid.length, applied: result.applied, skipped: result.skipped },
outcome: 'success',
});
return { success: true, data: result };
} catch (error) {
auditService.log({
sessionId: '',
eventType: 'error',
actor: 'user',
target: 'memory_maintenance',
details: { error: (error as Error).message },
outcome: 'error',
});
return { success: false, error: (error as Error).message };
}
});
ipcMain.handle('db:searchMemories', async (_event, query: unknown, options: unknown) => {
// M-37 修复: query 和 options 校验
@@ -17,7 +78,12 @@ export function registerMemoryHandlers(ctx: IPCContext): void {
return [];
}
// 构造合法的搜索选项(仅保留已知字段,强制类型安全)
const searchOptions: { topK?: number; sessionId?: string; type?: MemoryType; minImportance?: number } = {};
const searchOptions: {
topK?: number;
sessionId?: string;
type?: MemoryType;
minImportance?: number;
} = {};
if (options && typeof options === 'object') {
const opts = options as Record<string, unknown>;
// topK 限制范围 1-100(防止过大查询)
@@ -26,12 +92,15 @@ export function registerMemoryHandlers(ctx: IPCContext): void {
if (Number.isFinite(topK) && topK >= 1 && topK <= 100) {
searchOptions.topK = topK;
} else {
searchOptions.topK = 10; // 默认值
searchOptions.topK = 10; // 默认值
}
}
if (typeof opts.sessionId === 'string') searchOptions.sessionId = opts.sessionId;
// type 必须是合法的 MemoryType 枚举值
if (typeof opts.type === 'string' && (VALID_MEMORY_TYPES as readonly string[]).includes(opts.type)) {
if (
typeof opts.type === 'string' &&
(VALID_MEMORY_TYPES as readonly string[]).includes(opts.type)
) {
searchOptions.type = opts.type as MemoryType;
}
if (typeof opts.minImportance === 'number' && Number.isFinite(opts.minImportance)) {
@@ -52,7 +121,10 @@ export function registerMemoryHandlers(ctx: IPCContext): void {
const opts = options as Record<string, unknown>;
if (opts.type !== undefined) {
if (typeof opts.type !== 'string' || !VALID_MEMORY_TYPES_LIST.includes(opts.type)) {
return { success: false, error: `Invalid type (must be one of: ${VALID_MEMORY_TYPES_LIST.join(', ')})` };
return {
success: false,
error: `Invalid type (must be one of: ${VALID_MEMORY_TYPES_LIST.join(', ')})`,
};
}
type = opts.type;
}
@@ -69,16 +141,34 @@ export function registerMemoryHandlers(ctx: IPCContext): void {
const results: Record<string, unknown[]> = {};
try {
if (!type || type === 'episodic') {
const rows = db.prepare('SELECT * FROM episodic_memories ORDER BY created_at DESC LIMIT ?').all(limit) as Array<Record<string, unknown>>;
const rows = db
.prepare('SELECT * FROM episodic_memories ORDER BY created_at DESC LIMIT ?')
.all(limit) as Array<Record<string, unknown>>;
results.episodic = rows.map((r) => ({ ...r, type: 'episodic', content: r.content ?? '' }));
}
if (!type || type === 'semantic') {
const rows = db.prepare('SELECT * FROM semantic_memories ORDER BY updated_at DESC LIMIT ?').all(limit) as Array<Record<string, unknown>>;
results.semantic = rows.map((r) => ({ ...r, type: 'semantic', content: r.value ?? r.key ?? '', importance: r.confidence ?? 0, created_at: r.created_at ?? r.updated_at }));
const rows = db
.prepare('SELECT * FROM semantic_memories ORDER BY updated_at DESC LIMIT ?')
.all(limit) as Array<Record<string, unknown>>;
results.semantic = rows.map((r) => ({
...r,
type: 'semantic',
content: r.value ?? r.key ?? '',
importance: r.confidence ?? 0,
created_at: r.created_at ?? r.updated_at,
}));
}
if (!type || type === 'working') {
const rows = db.prepare('SELECT * FROM working_memories ORDER BY updated_at DESC LIMIT ?').all(limit) as Array<Record<string, unknown>>;
results.working = rows.map((r) => ({ ...r, type: 'working', content: r.value ?? r.key ?? '', importance: 0.5, created_at: r.updated_at ?? Date.now() }));
const rows = db
.prepare('SELECT * FROM working_memories ORDER BY updated_at DESC LIMIT ?')
.all(limit) as Array<Record<string, unknown>>;
results.working = rows.map((r) => ({
...r,
type: 'working',
content: r.value ?? r.key ?? '',
importance: 0.5,
created_at: r.updated_at ?? Date.now(),
}));
}
return { success: true, data: results };
} catch (error) {
@@ -89,14 +179,22 @@ export function registerMemoryHandlers(ctx: IPCContext): void {
ipcMain.handle('memory:delete', async (_event, type: unknown, id: unknown) => {
// M-50 修复: 校验 type 枚举(防止三元表达式默认映射到 working_memories)和 id 类型
if (typeof type !== 'string' || !VALID_MEMORY_TYPES_LIST.includes(type)) {
return { success: false, error: `Invalid type (must be one of: ${VALID_MEMORY_TYPES_LIST.join(', ')})` };
return {
success: false,
error: `Invalid type (must be one of: ${VALID_MEMORY_TYPES_LIST.join(', ')})`,
};
}
if (typeof id !== 'string' || !id) {
return { success: false, error: 'Invalid memory id' };
}
const db = sessionService.getDB();
try {
const table = type === 'episodic' ? 'episodic_memories' : type === 'semantic' ? 'semantic_memories' : 'working_memories';
const table =
type === 'episodic'
? 'episodic_memories'
: type === 'semantic'
? 'semantic_memories'
: 'working_memories';
db.prepare(`DELETE FROM ${table} WHERE id = ?`).run(id);
return { success: true };
} catch (error) {