feat: v0.8.1 记忆深化 · 观测闭环 · 体验收口 — 窗口/输出上限全局单一配置 · 2478 用例全量回归 + E2E 冒烟
硬性契约:删除代码中一切写死的上下文窗口与最大输出上限(含六家模型元信息
钳制与全部兜底值)——唯一合法来源是设置面板「上下文长度」(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:
@@ -21,6 +21,19 @@ function toErrorMessage(error: unknown): string {
|
||||
return error instanceof Error ? error.message : String(error);
|
||||
}
|
||||
|
||||
/**
|
||||
* v0.8.1: 已废除的配置键(单一来源 —— 迁移 12 与全局配置层清理共用)。
|
||||
* 分 Provider contextWindow 与 ollama.numCtx 由全局 llm.contextWindow 取代。
|
||||
*/
|
||||
export const DEPRECATED_CONFIG_KEYS = [
|
||||
'ollama.numCtx',
|
||||
'deepseek.contextWindow',
|
||||
'agnes.contextWindow',
|
||||
'mimo.contextWindow',
|
||||
'openai.contextWindow',
|
||||
'anthropic.contextWindow',
|
||||
] as const;
|
||||
|
||||
/** 配置默认值条目(P1-13: 单一来源,global-config.service.ts 的 SEED_DEFAULTS 由此派生) */
|
||||
export interface ConfigDefaultEntry {
|
||||
key: string;
|
||||
@@ -42,7 +55,13 @@ export const CONFIG_DEFAULTS: ConfigDefaultEntry[] = [
|
||||
{ key: 'llm.baseURL', value: '', category: 'llm' },
|
||||
// F-8 接通: temperature/maxTokens 此前为死配置(引擎硬编码),现由 main.ts 注入引擎
|
||||
{ key: 'llm.temperature', value: 0, category: 'llm' },
|
||||
// v0.8.0 FEAT-1 / v0.8.1: 最大输出上限 —— 唯一合法的输出上限配置(全局,跨 Provider)
|
||||
{ key: 'llm.maxTokens', value: 63488, category: 'llm' },
|
||||
// v0.8.1: 上下文长度 —— 唯一合法的上下文窗口配置(全局,跨 Provider/模型;
|
||||
// 驱动引擎压缩预算、前端占用指示,Ollama 场景同时作为 num_ctx 下发)。
|
||||
// 分 Provider 的 deepseek/agnes/mimo/openai/anthropic.contextWindow 与 ollama.numCtx
|
||||
// 已废除(迁移 12 清理遗留键)。
|
||||
{ key: 'llm.contextWindow', value: 131072, category: 'llm' },
|
||||
// v0.5.4: 多模态总开关 — 即使模型支持多模态,未开启也不能上传图片(默认关闭,
|
||||
// 用户在设置/引导向导显式开启;上传入口 = 开关 × 模型能力双重判断)
|
||||
{ key: 'llm.multimodalEnabled', value: false, category: 'llm' },
|
||||
@@ -74,6 +93,9 @@ export const CONFIG_DEFAULTS: ConfigDefaultEntry[] = [
|
||||
{ key: 'memory.consolidationEnabled', value: true, category: 'memory' },
|
||||
{ key: 'memory.consolidationMinChars', value: 200, category: 'memory' },
|
||||
{ key: 'memory.consolidationIntervalMs', value: 600000, category: 'memory' },
|
||||
// v0.8.1 P1-1: 本地向量记忆嵌入模型(Ollama embedding 模型名,空 = 向量检索关闭,
|
||||
// 仅 TF-IDF)。唯一合法来源是设置面板 —— 代码中不存在默认模型名。
|
||||
{ key: 'memory.embeddingModel', value: '', category: 'memory' },
|
||||
|
||||
// v0.7.3 P4-2: MCP 自动重连开关(mcp-manager.service 消费;断连后指数退避重试)
|
||||
{ key: 'mcp.autoReconnect', value: true, category: 'mcp' },
|
||||
@@ -88,16 +110,8 @@ export const CONFIG_DEFAULTS: ConfigDefaultEntry[] = [
|
||||
{ key: 'logging.auditEnabled', value: true, category: 'logging' },
|
||||
{ key: 'logging.traceEnabled', value: true, category: 'logging' },
|
||||
|
||||
// Ollama 配置
|
||||
{ key: 'ollama.numCtx', value: null, category: 'ollama' },
|
||||
|
||||
// Provider 上下文窗口配置(用于 Engine 压缩判断和 UI 显示)
|
||||
{ key: 'deepseek.contextWindow', value: 1000000, category: 'deepseek' },
|
||||
{ key: 'agnes.contextWindow', value: 1000000, category: 'agnes' },
|
||||
{ key: 'mimo.contextWindow', value: 1000000, category: 'mimo' },
|
||||
// P3: OpenAI / Anthropic Provider
|
||||
{ key: 'openai.contextWindow', value: 128000, category: 'openai' },
|
||||
{ key: 'anthropic.contextWindow', value: 200000, category: 'anthropic' },
|
||||
// v0.8.1: Ollama numCtx 独立配置已废除(与「上下文长度」合并为 llm.contextWindow);
|
||||
// Provider 上下文窗口分键配置已废除 —— 遗留键由迁移 12 从存量库清理。
|
||||
|
||||
// Onboarding
|
||||
{ key: 'onboarding.completed', value: false, category: 'general' },
|
||||
@@ -114,8 +128,12 @@ export class DatabaseService {
|
||||
* v0.7.4 P4-4: 1 → 2 —— 迁移 9(messages_fts trigram)纳入版本化,
|
||||
* 失败中断批次不盖章 → 下次启动重试(根治"失败被吞 + 永久跳过")。
|
||||
* v0.8.0 P2-1: 2 → 3 —— 迁移 10(sessions.deleted_at 回收站软删除列)。
|
||||
* v0.8.1: 3 → 4 —— 迁移 11(记忆表 embedding 列,本地向量混合检索)+
|
||||
* 迁移 12(清理已废除的 llm.contextWindow 分 Provider 键与 ollama.numCtx)。
|
||||
* v0.8.1 review: 4 → 5 —— 迁移 13(working_memories 补 sessions 外键 CASCADE,
|
||||
* 孤儿行清理;根治历史 schema 缺失级联导致的孤儿数据)。
|
||||
*/
|
||||
static readonly SCHEMA_VERSION = 3;
|
||||
static readonly SCHEMA_VERSION = 5;
|
||||
|
||||
constructor(workspacePath?: string) {
|
||||
const baseDir = workspacePath ?? join(app.getPath('userData'), 'MetonaWorkspaces', 'default');
|
||||
@@ -280,6 +298,7 @@ export class DatabaseService {
|
||||
);
|
||||
|
||||
-- ===== 工作记忆表 =====
|
||||
-- v0.8.1 review: 补 sessions 外键(CASCADE)—— 历史建表缺失级联
|
||||
CREATE TABLE IF NOT EXISTS working_memories (
|
||||
id TEXT PRIMARY KEY,
|
||||
session_id TEXT NOT NULL,
|
||||
@@ -287,7 +306,9 @@ export class DatabaseService {
|
||||
key TEXT NOT NULL,
|
||||
value TEXT NOT NULL,
|
||||
updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
|
||||
UNIQUE(session_id, task_id, key)
|
||||
tf_cache TEXT,
|
||||
UNIQUE(session_id, task_id, key),
|
||||
FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
|
||||
);
|
||||
|
||||
-- ===== v0.2.0: 任务表 =====
|
||||
@@ -657,6 +678,79 @@ export class DatabaseService {
|
||||
}
|
||||
}
|
||||
|
||||
// v0.8.1 P1-1 迁移 11: 记忆表 embedding 列(本地向量混合检索)。
|
||||
// 存量记忆行为 NULL = 未向量化(检索时回退 TF-IDF 路径),新写入由
|
||||
// MemoryEmbedder 异步回填;向量维度由用户配置的 embedding 模型决定,
|
||||
// 故用 BLOB 存 Float32Array 而非固定宽度 F32Blob 列。
|
||||
tryAddColumn('episodic_memories', 'embedding', 'BLOB');
|
||||
tryAddColumn('semantic_memories', 'embedding', 'BLOB');
|
||||
|
||||
// v0.8.1 迁移 12: 清理已废除的上下文窗口配置键(全局 llm.contextWindow 取代)。
|
||||
// 旧键残留会使设置面板与引擎出现双源语义,启动迁移一次性移除(幂等)。
|
||||
{
|
||||
const placeholders = DEPRECATED_CONFIG_KEYS.map(() => '?').join(', ');
|
||||
const result = db
|
||||
.prepare(`DELETE FROM app_config WHERE key IN (${placeholders})`)
|
||||
.run(...DEPRECATED_CONFIG_KEYS);
|
||||
if (result.changes > 0) {
|
||||
log.info(
|
||||
`[DB] Migration: removed ${result.changes} deprecated context-window config key(s) (replaced by llm.contextWindow)`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// v0.8.1 review 迁移 13: working_memories 补 sessions 外键(ON DELETE CASCADE)
|
||||
// 历史缺陷:该表自 v0.2.0 建表起就没有 sessions 外键 —— 会话删除/清空后
|
||||
// working 行成为孤儿(行为面已由 0.8.1 终态清理接线覆盖,此处根治 schema)。
|
||||
// 先清理孤儿行(早于 0.8.1 的历史删除遗留),再以 FK 重建。
|
||||
{
|
||||
const hasWorking = db
|
||||
.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='working_memories'")
|
||||
.get();
|
||||
// hasSessions 由迁移 10 块内查询(块作用域),此处独立复查
|
||||
const hasSessions = !!db
|
||||
.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='sessions'")
|
||||
.get();
|
||||
const fkRows = hasWorking
|
||||
? (db.prepare('PRAGMA foreign_key_list(working_memories)').all() as Array<{
|
||||
table: string;
|
||||
}>)
|
||||
: [];
|
||||
const hasSessionsFk = fkRows.some((fk) => fk.table === 'sessions');
|
||||
if (hasWorking && hasSessions && !hasSessionsFk) {
|
||||
log.info('[DB] Migration: rebuilding working_memories with sessions FK (CASCADE)');
|
||||
const rebuildWorking = db.transaction(() => {
|
||||
db.exec(`
|
||||
DELETE FROM working_memories
|
||||
WHERE session_id NOT IN (SELECT id FROM sessions);
|
||||
|
||||
CREATE TABLE working_memories_new (
|
||||
id TEXT PRIMARY KEY,
|
||||
session_id TEXT NOT NULL,
|
||||
task_id TEXT NOT NULL,
|
||||
key TEXT NOT NULL,
|
||||
value TEXT NOT NULL,
|
||||
updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
|
||||
tf_cache TEXT,
|
||||
UNIQUE(session_id, task_id, key),
|
||||
FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
|
||||
);
|
||||
|
||||
INSERT INTO working_memories_new (id, session_id, task_id, key, value, updated_at, tf_cache)
|
||||
SELECT id, session_id, task_id, key, value, updated_at, tf_cache
|
||||
FROM working_memories;
|
||||
|
||||
DROP TABLE working_memories;
|
||||
ALTER TABLE working_memories_new RENAME TO working_memories;
|
||||
|
||||
CREATE INDEX IF NOT EXISTS idx_working_session_task ON working_memories(session_id, task_id);
|
||||
`);
|
||||
});
|
||||
rebuildWorking();
|
||||
log.info('[DB] Migration: working_memories rebuilt with sessions FK');
|
||||
}
|
||||
}
|
||||
|
||||
// v0.7.4 P4-4 迁移 9: messages_fts 升级 trigram tokenizer
|
||||
// 存量库的 messages_fts 建表语句不含 trigram —— 直接 DROP + 重建 + rebuild,
|
||||
// 使中文非连续子串搜索(trigram ≥3 字符)可用。检测方式:读 sqlite_master 的
|
||||
|
||||
Reference in New Issue
Block a user