feat: v0.7.3 成本收口 · 状态一致 · 死账清理 — Prompt Cache 根治 + SSRF DNS Pinning + 87 用例扩充全量回归

P1 修复面收口: Prompt Cache 根治(日期/记忆/附件三类易变内容出 system 入用户消息前置块 user-context.ts, system 跨 run 字节级稳定; Anthropic system 块数组化 + cache_control ephemeral 断言, DeepSeek 自动缓存前缀命中 — 多轮对话输入 token 成本降数量级); 编辑重发/重新生成幽灵 Trace 双侧根治(DB truncateMessagesAfter 同步过滤 metadata.traceSteps + 前端 trimTraceStepsByAnchor 镜像, 严格小于锚点时间戳, 同毫秒等值判废); sessions:deleteMessage 死通道全链路删除(渲染层零调用 + message_count 漂移面); Ollama vision 能力门控全链路(MetonaModelInfo .supportsVision 贯穿 adapter/IPC/store/UI, model-capabilities.ts 三道判定纯函数, 未知保守放行); 记忆固化节流(consolidation-policy 纯函数: 总开关 + 内容门控 [回答>=200字符或存在成功工具调用] + 会话级 10 分钟频率窗口, 三 memory.* 配置键) P2 安全纵深: SSRF DNS Pinning 关闭 rebinding 窗口(ssrf-guard 重构 resolvePublicAddresses 单源; ssrf-dispatcher 以 undici Agent.connect.lookup 钉死校验 IP, TLS SNI 保持原域名, 一次性 dispatcher 用后即毁; 代理激活显式退化为仅入口校验); web_fetch 重写手动逐跳重定向循环(每跳先校验后连接, 替代 redirect:follow 内核跟跳的中间跳裸奔, 上限 5 跳); http_request 换用 pinned fetch; web_search 可达性预检加固(私有 URL 零请求 + 不跟跳, 3xx 视为可达); Agent 浏览器 CORS 通配收紧为 Origin 回显 + Vary: Origin; ConfirmationHook.forgetSession 会话终态清理(会话删除/abort 联动/SubAgent 终结三处接线, 根治 rememberedDecisions 泄漏) P3 架构还债: agent.enableReflection 死配置全链路接线(main→shared→引擎→ Orchestrator→设置开关, REFLECTING 状态真实可达); AgentLoopConfig.timeoutMs 死字段删除; MemoryManager.cleanupExpired 挂入健康检查周期(expires_at 回收管道真实化); buildSafeEnv 收敛 utils/safe-env.ts 单源(run_command 与 MCP stdio 共用, 终结双实现漂移); Trace 生命周期治理(metadata 只保留最近 20 个 run — keepRecentRuns 纯函数; JSONL 录制启动自动清理保留 200 个 + 设置页手动清理); SLO/健康快照可视化(app:healthSnapshot IPC + 设置页只读卡片 + 审计链一键校验) P4 能力演进: 会话标题 LLM 自动生成(TitleGenerator — 每会话幂等/并发重入复用同一 Promise/自定义标题不覆盖/失败静默回退, Sidebar 经 config:changed 实时刷新); MCP 自动重连(5s/15s/60s 退避最多 3 次, reconnecting 状态机, teardownConnection 内部拆除保留簿记 — 用户断开/开关关闭即时取消, 设置页显示第 N/3 次); 死循环检测 ABAB 乒乓模式(最近4轮 A→B→A→B 交替判定, 补齐 docs 第五章"两状态反复切换"检测契约); i18n 第三阶段(ChatInput/LLMSettings/ OnboardingWizard/MemoryViewer 主链路文案出层, zh-CN + en-US 双字典补齐) 测试: 737 → 824 用例(+87, 新增 8 个测试文件 + 扩展 3 个)。新覆盖: user-context 分组/空值收缩/拼接契约、context-builder 字节级稳定性、Anthropic cache_control 四态、consolidation-policy 九路判定矩阵、ssrf-dispatcher(pinned lookup/重定向解析/IP 校验)、forget-session 会话隔离、trace-lifecycle run 淘汰、 trace-trim 严格小于边界、safe-env 净化矩阵、mcp-reconnect 退避状态机 (fake timers)、title-generator 并发重入、SQLite 侧 truncate×TRACE 联动 (Electron ABI)。测试驱动修复: GIT_*/ 注释终止块注释、重连计数被自身重试前置断开重置(拆 teardownConnection 保留簿记)、TitleGenerator 幂等占位与并发去重的检查顺序竞态(去重先于幂等) 版本: 0.7.3; README 同步(配置表新增 agent.enableReflection/memory.*/mcp.autoReconnect) 回归: typecheck 双端 0 错误; ESLint 0/0; 系统 Node 771 通过 53 跳过 (better-sqlite3 ABI); Electron ABI 全量 824/824 零跳过
2026-08-30 09:44:43 +08:00
parent 26169b7be4
commit ebe45482b0
68 changed files with 4568 additions and 664 deletions
@@ -7,13 +7,25 @@

 import { useState, useEffect, useRef, useCallback } from 'react';
 import {
-  Box, Typography, Stack, Accordion, AccordionSummary, AccordionDetails,
-  IconButton, TextField, Chip, Alert, InputAdornment,
+  Box,
+  Typography,
+  Stack,
+  Accordion,
+  AccordionSummary,
+  AccordionDetails,
+  IconButton,
+  TextField,
+  Chip,
+  Alert,
+  InputAdornment,
 } from '@mui/material';
 import { Brain, Search, Trash2, ChevronDown } from 'lucide-react';
 import { useAgentStore } from '@renderer/stores/agent-store';
 import { useUIStore } from '@renderer/stores/ui-store';
 import { formatTime, truncate } from '@renderer/lib/formatters';
+// v0.7.3 P4-3: 文案出层（字典含注册副作用，须在 t() 使用前 import）
+import { t } from '@renderer/lib/i18n';
+import '@renderer/lib/i18n-strings';

 // ===== 类型 =====

@@ -43,11 +55,13 @@ interface SearchResult {

 const MEMORY_TYPES: MemoryType[] = ['episodic', 'semantic', 'working'];

-const MEMORY_TYPE_LABELS: Record<MemoryType, string> = {
-  episodic: '情景记忆',
-  semantic: '语义记忆',
-  working: '工作记忆',
+// v0.7.3 P4-3: 类型标签渲染时求值（i18next 字典注册是异步的，模块顶层固化会拿到 key 本体）
+const MEMORY_TYPE_LABEL_KEYS: Record<MemoryType, string> = {
+  episodic: 'memory.type.episodic',
+  semantic: 'memory.type.semantic',
+  working: 'memory.type.working',
 };
+const memoryTypeLabel = (type: MemoryType): string => t(MEMORY_TYPE_LABEL_KEYS[type]);

 const MEMORY_TYPE_COLORS: Record<MemoryType, string> = {
  episodic: '#22d3ee',
@@ -73,7 +87,9 @@ function getId(item: MemoryItem): string {

 export function MemoryViewer(): React.JSX.Element {
  const [memories, setMemories] = useState<Record<MemoryType, MemoryItem[]>>({
-    episodic: [], semantic: [], working: [],
+    episodic: [],
+    semantic: [],
+    working: [],
  });
  const [searchQuery, setSearchQuery] = useState('');
  const [searchResults, setSearchResults] = useState<SearchResult[] | null>(null);
@@ -108,7 +124,7 @@ export function MemoryViewer(): React.JSX.Element {
      // 竞态保护：若已被新请求取代或组件已卸载，放弃本次结果
      if (loadReqIdRef.current !== reqId) return;
      if (!res.success) {
-        setError(res.error ?? '加载记忆失败');
+        setError(res.error ?? t('memory.loadFailed'));
        return;
      }
      const data = res.data ?? {};
@@ -119,7 +135,7 @@ export function MemoryViewer(): React.JSX.Element {
      });
    } catch (err) {
      if (loadReqIdRef.current !== reqId) return;
-      setError((err as Error).message ?? '加载记忆失败');
+      setError((err as Error).message ?? t('memory.loadFailed'));
    }
  }, []);

@@ -127,7 +143,9 @@ export function MemoryViewer(): React.JSX.Element {
  useEffect(() => {
    loadMemories();
    // cleanup: 使当前请求失效（防止卸载后 setState）
-    return () => { loadReqIdRef.current++; };
+    return () => {
+      loadReqIdRef.current++;
+    };
  }, [loadMemories]);

  // Agent 完成自动刷新
@@ -161,7 +179,7 @@ export function MemoryViewer(): React.JSX.Element {
      setSearchResults(results);
    } catch (err) {
      if (searchReqIdRef.current !== reqId) return;
-      setError((err as Error).message ?? '搜索失败');
+      setError((err as Error).message ?? t('memory.loadFailed'));
      setSearchResults([]);
    } finally {
      // 审计补充修复: 无条件清理 searching 状态，避免被 loadMemories 取代时卡死
@@ -181,29 +199,42 @@ export function MemoryViewer(): React.JSX.Element {
      const res = await window.metona.memory.delete(type, id);
      if (!res.success) {
        // 用户主动操作失败应用 toast（与项目惯例一致），不污染加载/搜索的 Alert
-        import('@metona-team/metona-toast').then((mod) => mod.default.error(res.error ?? '删除失败')).catch(() => {});
+        import('@metona-team/metona-toast')
+          .then((mod) => mod.default.error(res.error ?? t('memory.deleteFailed')))
+          .catch(() => {});
        return;
      }
      await loadMemories();
    } catch (err) {
-      import('@metona-team/metona-toast').then((mod) => mod.default.error((err as Error).message ?? '删除失败')).catch(() => {});
+      import('@metona-team/metona-toast')
+        .then((mod) => mod.default.error((err as Error).message ?? t('memory.deleteFailed')))
+        .catch(() => {});
    }
  };

-  const totalCount =
-    memories.episodic.length + memories.semantic.length + memories.working.length;
+  const totalCount = memories.episodic.length + memories.semantic.length + memories.working.length;

  // 搜索结果视图
  if (searchResults !== null) {
    return (
-      <Box sx={{ flex: 1, display: 'flex', flexDirection: 'column', overflow: 'hidden', minHeight: 0 }}>
+      <Box
+        sx={{ flex: 1, display: 'flex', flexDirection: 'column', overflow: 'hidden', minHeight: 0 }}
+      >
        <Stack direction="row" spacing={1} sx={{ mb: 1.5, flexShrink: 0, alignItems: 'center' }}>
          <Brain size={14} style={{ color: '#a855f7' }} />
-          <Typography variant="caption" sx={{ fontWeight: 600, textTransform: 'uppercase', letterSpacing: 1, color: 'text.secondary' }}>
-            记忆搜索
+          <Typography
+            variant="caption"
+            sx={{
+              fontWeight: 600,
+              textTransform: 'uppercase',
+              letterSpacing: 1,
+              color: 'text.secondary',
+            }}
+          >
+            {t('memory.search.title')}
          </Typography>
          <Typography variant="caption" sx={{ ml: 'auto', color: 'text.disabled', fontSize: 10 }}>
-            {searchResults.length} 条结果
+            {t('memory.results', { count: searchResults.length })}
          </Typography>
        </Stack>

@@ -212,9 +243,15 @@ export function MemoryViewer(): React.JSX.Element {
          fullWidth
          value={searchQuery}
          onChange={(e) => setSearchQuery(e.target.value)}
-          onKeyDown={(e) => { if (e.key === 'Enter') handleSearch(); }}
-          placeholder="搜索记忆..."
-          sx={{ mb: 1.5, flexShrink: 0, '& .MuiOutlinedInput-root': { fontSize: 11, height: 30, borderRadius: 1.5 } }}
+          onKeyDown={(e) => {
+            if (e.key === 'Enter') handleSearch();
+          }}
+          placeholder={t('memory.search.placeholder')}
+          sx={{
+            mb: 1.5,
+            flexShrink: 0,
+            '& .MuiOutlinedInput-root': { fontSize: 11, height: 30, borderRadius: 1.5 },
+          }}
          slotProps={{
            input: {
              startAdornment: (
@@ -223,24 +260,49 @@ export function MemoryViewer(): React.JSX.Element {
                </InputAdornment>
              ),
              endAdornment: searchQuery ? (
-                <InputAdornment position="end" sx={{ cursor: 'pointer' }} onClick={handleClearSearch}>
-                  <Typography variant="caption" sx={{ fontSize: 10, color: 'text.secondary' }}>清除</Typography>
+                <InputAdornment
+                  position="end"
+                  sx={{ cursor: 'pointer' }}
+                  onClick={handleClearSearch}
+                >
+                  <Typography variant="caption" sx={{ fontSize: 10, color: 'text.secondary' }}>
+                    {t('memory.search.clear')}
+                  </Typography>
                </InputAdornment>
              ) : null,
            },
          }}
        />

-        {error && <Alert severity="error" sx={{ mb: 1, py: 0.5, fontSize: 11, flexShrink: 0 }}>{error}</Alert>}
+        {error && (
+          <Alert severity="error" sx={{ mb: 1, py: 0.5, fontSize: 11, flexShrink: 0 }}>
+            {error}
+          </Alert>
+        )}

-        <Box sx={{ flex: 1, overflowY: 'auto', display: 'flex', flexDirection: 'column', gap: 0.5, minHeight: 0 }}>
+        <Box
+          sx={{
+            flex: 1,
+            overflowY: 'auto',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 0.5,
+            minHeight: 0,
+          }}
+        >
          {searching ? (
-            <Typography variant="caption" sx={{ textAlign: 'center', py: 2, color: 'text.disabled' }}>
-              搜索中...
+            <Typography
+              variant="caption"
+              sx={{ textAlign: 'center', py: 2, color: 'text.disabled' }}
+            >
+              {t('memory.searching')}
            </Typography>
          ) : searchResults.length === 0 ? (
-            <Typography variant="caption" sx={{ textAlign: 'center', py: 2, color: 'text.disabled' }}>
-              无匹配结果
+            <Typography
+              variant="caption"
+              sx={{ textAlign: 'center', py: 2, color: 'text.disabled' }}
+            >
+              {t('memory.search.empty')}
            </Typography>
          ) : (
            searchResults.map((r) => (
@@ -254,14 +316,24 @@ export function MemoryViewer(): React.JSX.Element {

  // 全量列表视图
  return (
-    <Box sx={{ flex: 1, display: 'flex', flexDirection: 'column', overflow: 'hidden', minHeight: 0 }}>
+    <Box
+      sx={{ flex: 1, display: 'flex', flexDirection: 'column', overflow: 'hidden', minHeight: 0 }}
+    >
      <Stack direction="row" spacing={1} sx={{ mb: 1.5, flexShrink: 0, alignItems: 'center' }}>
        <Brain size={14} style={{ color: '#a855f7' }} />
-        <Typography variant="caption" sx={{ fontWeight: 600, textTransform: 'uppercase', letterSpacing: 1, color: 'text.secondary' }}>
-          记忆库
+        <Typography
+          variant="caption"
+          sx={{
+            fontWeight: 600,
+            textTransform: 'uppercase',
+            letterSpacing: 1,
+            color: 'text.secondary',
+          }}
+        >
+          {t('memory.list.title')}
        </Typography>
        <Typography variant="caption" sx={{ ml: 'auto', color: 'text.disabled', fontSize: 10 }}>
-          {totalCount} 条
+          {t('memory.total', { count: totalCount })}
        </Typography>
      </Stack>

@@ -270,9 +342,15 @@ export function MemoryViewer(): React.JSX.Element {
        fullWidth
        value={searchQuery}
        onChange={(e) => setSearchQuery(e.target.value)}
-        onKeyDown={(e) => { if (e.key === 'Enter') handleSearch(); }}
-        placeholder="搜索记忆..."
-        sx={{ mb: 1.5, flexShrink: 0, '& .MuiOutlinedInput-root': { fontSize: 11, height: 30, borderRadius: 1.5 } }}
+        onKeyDown={(e) => {
+          if (e.key === 'Enter') handleSearch();
+        }}
+        placeholder={t('memory.search.placeholder')}
+        sx={{
+          mb: 1.5,
+          flexShrink: 0,
+          '& .MuiOutlinedInput-root': { fontSize: 11, height: 30, borderRadius: 1.5 },
+        }}
        slotProps={{
          input: {
            startAdornment: (
@@ -284,11 +362,18 @@ export function MemoryViewer(): React.JSX.Element {
        }}
      />

-      {error && <Alert severity="error" sx={{ mb: 1, py: 0.5, fontSize: 11, flexShrink: 0 }}>{error}</Alert>}
+      {error && (
+        <Alert severity="error" sx={{ mb: 1, py: 0.5, fontSize: 11, flexShrink: 0 }}>
+          {error}
+        </Alert>
+      )}

      <Box sx={{ flex: 1, overflowY: 'auto', minHeight: 0 }}>
        {totalCount === 0 ? (
-          <Typography variant="caption" sx={{ textAlign: 'center', py: 4, display: 'block', color: 'text.disabled' }}>
+          <Typography
+            variant="caption"
+            sx={{ textAlign: 'center', py: 4, display: 'block', color: 'text.disabled' }}
+          >
            暂无记忆数据
          </Typography>
        ) : (
@@ -320,16 +405,31 @@ export function MemoryViewer(): React.JSX.Element {
              >
                <AccordionSummary expandIcon={<ChevronDown size={14} />}>
                  <Stack direction="row" spacing={1} sx={{ alignItems: 'center', width: '100%' }}>
-                    <Box sx={{ width: 6, height: 6, borderRadius: '50%', bgcolor: MEMORY_TYPE_COLORS[type], flexShrink: 0 }} />
-                    <Typography variant="caption" sx={{ fontWeight: 600, fontSize: 11, color: 'text.primary' }}>
-                      {MEMORY_TYPE_LABELS[type]}
+                    <Box
+                      sx={{
+                        width: 6,
+                        height: 6,
+                        borderRadius: '50%',
+                        bgcolor: MEMORY_TYPE_COLORS[type],
+                        flexShrink: 0,
+                      }}
+                    />
+                    <Typography
+                      variant="caption"
+                      sx={{ fontWeight: 600, fontSize: 11, color: 'text.primary' }}
+                    >
+                      {memoryTypeLabel(type)}
                    </Typography>
                    <Chip
                      label={items.length}
                      size="small"
                      sx={{
-                        ml: 'auto', mr: 0.5, height: 16, fontSize: 10,
-                        bgcolor: 'action.hover', color: 'text.secondary',
+                        ml: 'auto',
+                        mr: 0.5,
+                        height: 16,
+                        fontSize: 10,
+                        bgcolor: 'action.hover',
+                        color: 'text.secondary',
                        '& .MuiChip-label': { px: 0.5 },
                      }}
                    />
@@ -366,17 +466,22 @@ function MemoryItemRow({
  return (
    <Box
      sx={{
-        px: 1, py: 0.75, borderRadius: 1,
-        bgcolor: 'background.default', border: '1px solid', borderColor: 'divider',
+        px: 1,
+        py: 0.75,
+        borderRadius: 1,
+        bgcolor: 'background.default',
+        border: '1px solid',
+        borderColor: 'divider',
        '&:hover .delete-btn': { opacity: 1 },
      }}
    >
      <Stack direction="row" spacing={0.5} sx={{ mb: 0.25, alignItems: 'center' }}>
        <Chip
-          label={MEMORY_TYPE_LABELS[type]}
+          label={memoryTypeLabel(type)}
          size="small"
          sx={{
-            height: 14, fontSize: 9,
+            height: 14,
+            fontSize: 9,
            bgcolor: MEMORY_TYPE_COLORS[type] + '22',
            color: MEMORY_TYPE_COLORS[type],
            '& .MuiChip-label': { px: 0.5 },
@@ -387,7 +492,8 @@ function MemoryItemRow({
            label={`I ${(item.importance ?? 0).toFixed(2)}`}
            size="small"
            sx={{
-              height: 14, fontSize: 9,
+              height: 14,
+              fontSize: 9,
              bgcolor: importanceColor(item.importance) + '22',
              color: importanceColor(item.importance),
              '& .MuiChip-label': { px: 0.5, fontFamily: 'monospace' },
@@ -406,12 +512,26 @@ function MemoryItemRow({
          className="delete-btn"
          size="small"
          onClick={() => onDelete(type, getId(item))}
-          sx={{ opacity: 0, transition: 'opacity 150ms', p: 0.25, '&:hover': { color: 'error.main' } }}
+          sx={{
+            opacity: 0,
+            transition: 'opacity 150ms',
+            p: 0.25,
+            '&:hover': { color: 'error.main' },
+          }}
        >
          <Trash2 size={11} />
        </IconButton>
      </Stack>
-      <Typography variant="caption" sx={{ fontSize: 11, color: 'text.primary', display: 'block', lineHeight: 1.4, wordBreak: 'break-word' }}>
+      <Typography
+        variant="caption"
+        sx={{
+          fontSize: 11,
+          color: 'text.primary',
+          display: 'block',
+          lineHeight: 1.4,
+          wordBreak: 'break-word',
+        }}
+      >
        {truncate(item.content, 100)}
      </Typography>
    </Box>
@@ -428,17 +548,22 @@ function MemorySearchItem({
  return (
    <Box
      sx={{
-        px: 1, py: 0.75, borderRadius: 1,
-        bgcolor: 'background.default', border: '1px solid', borderColor: 'divider',
+        px: 1,
+        py: 0.75,
+        borderRadius: 1,
+        bgcolor: 'background.default',
+        border: '1px solid',
+        borderColor: 'divider',
        '&:hover .delete-btn': { opacity: 1 },
      }}
    >
      <Stack direction="row" spacing={0.5} sx={{ mb: 0.25, alignItems: 'center' }}>
        <Chip
-          label={MEMORY_TYPE_LABELS[item.type]}
+          label={memoryTypeLabel(item.type)}
          size="small"
          sx={{
-            height: 14, fontSize: 9,
+            height: 14,
+            fontSize: 9,
            bgcolor: MEMORY_TYPE_COLORS[item.type] + '22',
            color: MEMORY_TYPE_COLORS[item.type],
            '& .MuiChip-label': { px: 0.5 },
@@ -448,8 +573,10 @@ function MemorySearchItem({
          label={`R ${(item.relevanceScore ?? 0).toFixed(2)}`}
          size="small"
          sx={{
-            height: 14, fontSize: 9,
-            bgcolor: '#22d3ee22', color: '#22d3ee',
+            height: 14,
+            fontSize: 9,
+            bgcolor: '#22d3ee22',
+            color: '#22d3ee',
            '& .MuiChip-label': { px: 0.5, fontFamily: 'monospace' },
          }}
        />
@@ -457,14 +584,18 @@ function MemorySearchItem({
          label={`I ${(item.importance ?? 0).toFixed(2)}`}
          size="small"
          sx={{
-            height: 14, fontSize: 9,
+            height: 14,
+            fontSize: 9,
            bgcolor: importanceColor(item.importance) + '22',
            color: importanceColor(item.importance),
            '& .MuiChip-label': { px: 0.5, fontFamily: 'monospace' },
          }}
        />
        {item.createdAt > 0 && (
-          <Typography variant="caption" sx={{ ml: 'auto', fontSize: 9, color: 'text.disabled', fontFamily: 'monospace' }}>
+          <Typography
+            variant="caption"
+            sx={{ ml: 'auto', fontSize: 9, color: 'text.disabled', fontFamily: 'monospace' }}
+          >
            {formatTime(item.createdAt)}
          </Typography>
        )}
@@ -473,12 +604,26 @@ function MemorySearchItem({
          size="small"
          aria-label="删除该记忆"
          onClick={() => onDelete(item.type, item.id)}
-          sx={{ opacity: 0, transition: 'opacity 150ms', p: 0.25, '&:hover': { color: 'error.main' } }}
+          sx={{
+            opacity: 0,
+            transition: 'opacity 150ms',
+            p: 0.25,
+            '&:hover': { color: 'error.main' },
+          }}
        >
          <Trash2 size={11} />
        </IconButton>
      </Stack>
-      <Typography variant="caption" sx={{ fontSize: 11, color: 'text.primary', display: 'block', lineHeight: 1.4, wordBreak: 'break-word' }}>
+      <Typography
+        variant="caption"
+        sx={{
+          fontSize: 11,
+          color: 'text.primary',
+          display: 'block',
+          lineHeight: 1.4,
+          wordBreak: 'break-word',
+        }}
+      >
        {truncate(item.content, 100)}
      </Typography>
    </Box>