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
@@ -1,10 +1,10 @@
/**
* Provider maxTokens 上限钳制契约测试(v0.5.3
* maxTokens 透传契约测试(v0.8.1 硬性契约重写
*
* 背景:引擎默认 maxTokens=63488engine.ts DEFAULT_CONFIG),超过部分模型
* 上限时 API 直接 400 —— OpenAI gpt-4o(16384)/gpt-4.1(32768)、Anthropic
* opus/haiku(32000)、MiMo standard(32768) 曾不可用。v0.5.3 各 adapter 按
* MODEL_INFO.maxOutputTokens 钳制
* 背景:v0.5.3 曾引入"按 MODEL_INFO.maxOutputTokens 钳制"逻辑。v0.8.1 按硬性
* 契约废除 —— 设置面板「最大输出上限」(llm.maxTokens)是唯一合法的输出上限
* 配置,adapter 对一切 Provider/模型**原样透传** `params.maxTokens`,代码中
* 不存在任何写死的输出上限或按模型元信息的钳制行为
*
* 测试策略(v0.5.2 教训):mock fetch 记录真实请求体并断言契约 ——
* 不 mock adapter 内部方法,验证"发出的 HTTP 请求体"这个最终事实。
@@ -33,7 +33,7 @@ afterEach(() => {
mockFetch.mockReset();
});
/** 引擎默认形态的请求(maxTokens=63488,与 engine DEFAULT_CONFIG 一致 */
/** 设置面板「最大输出上限」配置生效时的请求形态(llm.maxTokens → params.maxTokens */
function makeRequest(overrides: Partial<MetonaRequest> = {}): MetonaRequest {
return {
meta: {
@@ -79,8 +79,8 @@ function requestBody(): Record<string, unknown> {
return JSON.parse(init.body as string) as Record<string, unknown>;
}
describe('maxTokens 模型上限钳制(引擎默认 63488 场景', () => {
it('DeepSeek v4 pro(上限 384K):63488 未超限,原样传递', async () => {
describe('maxTokens 原样透传(v0.8.1:设置面板是唯一合法上限配置', () => {
it('DeepSeekmax_tokens 原样透传(不按模型钳制)', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new DeepSeekAdapter({
provider: 'deepseek',
@@ -92,7 +92,19 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
expect(requestBody().max_tokens).toBe(63_488);
});
it('Agnes flash(上限 65536):63488 未超限,原样传递', async () => {
it('DeepSeek:超出旧模型元信息上限的值同样原样透传(钳制已废除)', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new DeepSeekAdapter({
provider: 'deepseek',
baseURL: 'https://api.deepseek.com',
apiKey: 'sk',
defaultModel: 'deepseek-v4-flash-vision-exp',
});
await adapter.send(makeRequest());
expect(requestBody().max_tokens).toBe(63_488);
});
it('Agnesmax_tokens 原样透传', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new AgnesAdapter({
provider: 'agnes',
@@ -104,7 +116,7 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
expect(requestBody().max_tokens).toBe(63_488);
});
it('MiMo standard(上限 32768):钳制到 32768(原为 400 错误场景', async () => {
it('MiMo standardmax_completion_tokens 原样透传(旧 32768 钳制已废除', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new MimoAdapter({
provider: 'mimo',
@@ -113,10 +125,10 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
defaultModel: 'mimo-v2.5',
});
await adapter.send(makeRequest());
expect(requestBody().max_completion_tokens).toBe(32_768);
expect(requestBody().max_completion_tokens).toBe(63_488);
});
it('MiMo pro(上限 131072):63488 未超限,原样传递', async () => {
it('MiMo promax_completion_tokens 原样透传', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new MimoAdapter({
provider: 'mimo',
@@ -128,7 +140,7 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
expect(requestBody().max_completion_tokens).toBe(63_488);
});
it('OpenAI gpt-4o上限 16384):钳制到 16384(原为 400 错误场景', async () => {
it('OpenAI gpt-4o非推理模型):max_tokens 原样透传(旧 16384 钳制已废除', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new OpenAIAdapter({
provider: 'openai',
@@ -137,10 +149,10 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
defaultModel: 'gpt-4o',
});
await adapter.send(makeRequest());
expect(requestBody().max_tokens).toBe(16_384);
expect(requestBody().max_tokens).toBe(63_488);
});
it('OpenAI o3-mini上限 100K):63488 未超限,推理模型字段名正确', async () => {
it('OpenAI o3-mini(推理模型):max_completion_tokens 原样透传,字段名路由正确', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const adapter = new OpenAIAdapter({
provider: 'openai',
@@ -153,7 +165,7 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
expect(requestBody().max_tokens).toBeUndefined();
});
it('Anthropic opus(上限 32000):钳制到 32000(原为 400 错误场景', async () => {
it('Anthropic opusmax_tokens 原样透传(旧 32000 钳制已废除', async () => {
mockFetch.mockResolvedValue(anthropicResponse());
const adapter = new AnthropicAdapter({
provider: 'anthropic',
@@ -162,10 +174,10 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
defaultModel: 'claude-opus-4-1',
});
await adapter.send(makeRequest());
expect(requestBody().max_tokens).toBe(32_000);
expect(requestBody().max_tokens).toBe(63_488);
});
it('Anthropic sonnet(上限 64000):63488 未超限', async () => {
it('Anthropic sonnetmax_tokens 原样透传', async () => {
mockFetch.mockResolvedValue(anthropicResponse());
const adapter = new AnthropicAdapter({
provider: 'anthropic',
@@ -177,13 +189,12 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
expect(requestBody().max_tokens).toBe(63_488);
});
it('未配置 maxTokens 时各 adapter 使用安全默认值(不超过模型上限', async () => {
it('未配置 maxTokens:不下发任何输出上限字段(由 Provider 服务端默认值决定', async () => {
mockFetch.mockResolvedValue(openAIResponse());
const request = makeRequest({
params: { temperature: 0, stream: false } as MetonaRequest['params'],
});
// MiMo standard + thinking 默认 → 兜底 32768= 上限,安全)
const mimo = new MimoAdapter({
provider: 'mimo',
baseURL: 'https://api.mimo.com/v1',
@@ -191,6 +202,33 @@ describe('maxTokens 模型上限钳制(引擎默认 63488 场景)', () => {
defaultModel: 'mimo-v2.5',
});
await mimo.send(request);
expect(requestBody().max_completion_tokens).toBe(32_768);
expect(requestBody().max_completion_tokens).toBeUndefined();
const deepseek = new DeepSeekAdapter({
provider: 'deepseek',
baseURL: 'https://api.deepseek.com',
apiKey: 'sk',
defaultModel: 'deepseek-v4-pro',
});
mockFetch.mockReset();
mockFetch.mockResolvedValue(openAIResponse());
await deepseek.send(request);
expect(requestBody().max_tokens).toBeUndefined();
});
it('Anthropic 未配置 maxTokens + thinking 开启:仅满足协议下限 2048(协议不变量,非上限)', async () => {
mockFetch.mockResolvedValue(anthropicResponse());
const adapter = new AnthropicAdapter({
provider: 'anthropic',
baseURL: 'https://api.anthropic.com',
apiKey: 'k',
defaultModel: 'claude-opus-4-1',
});
await adapter.send(
makeRequest({
params: { temperature: 0, stream: false, thinkingEnabled: true } as MetonaRequest['params'],
}),
);
expect(requestBody().max_tokens).toBe(2048);
});
});