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
+14 -35
View File
@@ -56,7 +56,7 @@ export function OnboardingWizard(): React.JSX.Element | null {
const [apiKey, setApiKey] = useState('');
const [showKey, setShowKey] = useState(false);
const [workspacePath, setWorkspacePath] = useState('');
// 上下文窗口(联动 Provider:ollama 可空=由模型决定;其他 provider 默认值见 DEFAULT_CTX
// 上下文长度(v0.8.1: 全局单一配置 llm.contextWindow,跨 Provider 生效,不预填默认值
const [contextWindow, setContextWindow] = useState<number | null>(null);
// #48 修复: 启动时从 localStorage 恢复未完成的引导进度,避免中途退出后需重新填写
@@ -112,18 +112,10 @@ export function OnboardingWizard(): React.JSX.Element | null {
if (onboardingCompleted) return null;
// 各 Provider 上下文窗口默认值(与 SettingsModal 保持一致)
// ollama 返回 null(由模型决定),其他 provider 返回正整数
const DEFAULT_CTX: Record<string, number | null> = {
deepseek: 1_000_000,
agnes: 1_000_000,
mimo: 1_000_000,
ollama: null,
openai: 128_000,
anthropic: 200_000,
};
// 上下文窗口校验:ollama 允许空,最小 512;其他 provider 最小 4096
const ctxMin = provider === 'ollama' ? 512 : 4096;
// v0.8.1 硬性契约: 上下文长度是全局单一配置(llm.contextWindow),不再存在
// 分 Provider 默认值 —— 删除了旧的 DEFAULT_CTX 写死表(1M/128K/200K/4096)。
// 引导页不再预填任何窗口数值,留空时由设置面板种子默认值(131072)兜底。
const ctxMin = 512;
const ctxError =
contextWindow != null && (!Number.isFinite(contextWindow) || contextWindow < ctxMin);
@@ -149,13 +141,10 @@ export function OnboardingWizard(): React.JSX.Element | null {
entries.push({ key: 'llm.multimodalEnabled', value: multimodalEnabled });
if (workspacePath.trim())
entries.push({ key: 'workspace.path', value: workspacePath.trim() });
// 上下文窗口:根据 Provider 落库到对应 key
// - ollama: ollama.numCtx(允许 null=由模型决定)
// - deepseek/agnes/mimo: {provider}.contextWindow(必须有值且 >= 4096
if (provider === 'ollama') {
entries.push({ key: 'ollama.numCtx', value: contextWindow });
} else if (provider && contextWindow != null && contextWindow >= 4096) {
entries.push({ key: `${provider}.contextWindow`, value: contextWindow });
// v0.8.1: 上下文长度全局单一配置(llm.contextWindow,跨 Provider 生效;
// Ollama 场景由主进程同步为 num_ctx)—— 分 Provider 键已废除
if (contextWindow != null && contextWindow >= ctxMin) {
entries.push({ key: 'llm.contextWindow', value: contextWindow });
}
entries.push({ key: 'onboarding.completed', value: true });
@@ -259,8 +248,8 @@ export function OnboardingWizard(): React.JSX.Element | null {
onChange={(e) => {
const v = e.target.value;
setProvider(v);
// 联动默认上下文窗口(与 SettingsModal 默认值一致)
setContextWindow(DEFAULT_CTX[v] ?? null);
// v0.8.1: 上下文长度为全局单一配置,切换 Provider 不再预填
// 任何分 Provider 默认值(DEFAULT_CTX 写死表已删除)
// D-3 修复: 自动填充默认 URL(与 LLMSettings 行为一致 —
// 仅在 URL 为空或仍是某 Provider 的默认值时覆盖,用户自定义 URL 不动)
const currentUrl = baseURL.trim();
@@ -313,30 +302,20 @@ export function OnboardingWizard(): React.JSX.Element | null {
/>
<TextField
size="small"
label={
provider === 'ollama'
? t('onboarding.llm.ctx.ollama')
: t('onboarding.llm.ctx.window')
}
label={t('onboarding.llm.ctx.window')}
type="number"
value={contextWindow ?? ''}
onChange={(e) => {
const v = e.target.value;
setContextWindow(v === '' ? null : Number(v));
}}
placeholder={
provider === 'ollama'
? t('onboarding.llm.ctx.ollamaPlaceholder')
: t('onboarding.llm.ctx.placeholder')
}
placeholder={t('onboarding.llm.ctx.placeholder')}
slotProps={{ htmlInput: { min: ctxMin, step: ctxMin } }}
error={ctxError}
helperText={
ctxError
? t('onboarding.llm.ctx.minError', { min: ctxMin })
: provider === 'ollama'
? ' '
: t('onboarding.llm.ctx.helper')
: t('onboarding.llm.ctx.helper')
}
/>
{/* v0.5.4: 多模态总开关 — 未开启时即使模型支持也不能上传图片 */}