Update bloat_min_bytes configuration and enhance MaintenanceSection

- Increased the default value of `bloat_min_bytes` from 2048 to 2400 to improve memory management.
- Updated the diagnostic view and related logic to reflect the new threshold.
- Enhanced the MaintenanceSection in the frontend to include preset options for bloat thresholds and improved user interface elements.
- Modified localization files to update labels and descriptions related to memory audit and bloat thresholds.
- Added tests to validate the new functionality and ensure proper behavior of the MaintenanceSection.

Author: Dataojitori

backend/config.py

@@ -56,7 +56,7 @@ def _default_database_url() -> str:
     "cors_origins": None,
     "public_readonly_mcp": False,
     "locale": None,
-    "bloat_min_bytes": 2048,
+    "bloat_min_bytes": 2400,
 }
 
 _ENV_MAP: dict[str, str] = {

backend/system_views.py

@@ -401,7 +401,7 @@ async def generate_diagnostic_view(
     import config
 
     if bloat_min_bytes is None:
-        bloat_min_bytes = config.get("bloat_min_bytes") or 2048
+        bloat_min_bytes = config.get("bloat_min_bytes") or 2400
 
     graph = get_graph_service()
 

backend/tests/api/test_api_routes.py

@@ -326,10 +326,10 @@ def test_config_backfills_bloat_min_bytes(tmp_path, monkeypatch):
     monkeypatch.setattr(config, "CONFIG_PATH", test_config_path)
     config._invalidate()
 
-    # 内存补齐生效：config.get() 和 config.get_all() 均可获取默认值 2048
+    # 内存补齐生效：config.get() 和 config.get_all() 均可获取默认值 2400
     val = config.get("bloat_min_bytes")
-    assert val == 2048
-    assert config.get_all().get("bloat_min_bytes") == 2048
+    assert val == 2400
+    assert config.get_all().get("bloat_min_bytes") == 2400
 
     # 旧的配置文件在磁盘上保持原样，未进行物理写入，避免只读文件系统等问题
     saved_data = json.loads(test_config_path.read_text())
@@ -346,7 +346,7 @@ async def test_settings_api_bloat_min_bytes(api_client, monkeypatch, tmp_path):
 
     get_res = await api_client.get("/settings")
     assert get_res.status_code == 200
-    assert get_res.json()["settings"]["bloat_min_bytes"] == 2048
+    assert get_res.json()["settings"]["bloat_min_bytes"] == 2400
 
     invalid_res = await api_client.put("/settings", json={"bloat_min_bytes": 0})
     assert invalid_res.status_code == 422

frontend/src/features/settings/MaintenanceSection.jsx

@@ -1,17 +1,20 @@
 import React, { useState, useEffect } from 'react';
-import { Save, AlertTriangle } from 'lucide-react';
+import { Save, AlertTriangle, Sparkles, Check, FileText } from 'lucide-react';
 import { useTranslation } from 'react-i18next';
 import { toast } from '../../components/Toast';
 
 export default function MaintenanceSection({ settings, onSave }) {
   const { t } = useTranslation();
-  const [bloatMinBytes, setBloatMinBytes] = useState('2048');
+  const [bloatMinBytes, setBloatMinBytes] = useState(
+    settings?.bloat_min_bytes != null ? String(settings.bloat_min_bytes) : ''
+  );
   const [dirty, setDirty] = useState(false);
   const [saving, setSaving] = useState(false);
 
   useEffect(() => {
     if (settings?.bloat_min_bytes != null) {
       setBloatMinBytes(String(settings.bloat_min_bytes));
+      setDirty(false);
     }
   }, [settings?.bloat_min_bytes]);
 
@@ -29,6 +32,13 @@ export default function MaintenanceSection({ settings, onSave }) {
     return `${bytes} ${t('settings.maintenance.bytes_unit')}`;
   };
 
+  const getCharEstimate = (bytes) => {
+    if (isNaN(bytes) || bytes < 1) return null;
+    const zhCount = Math.round(bytes / 3);
+    const enCount = bytes;
+    return t('settings.maintenance.char_estimate', { zhCount, enCount });
+  };
+
   const handleSave = async () => {
     if (!isValid) {
       toast(t('settings.maintenance.invalid_bloat_min_bytes'), 'error');
@@ -50,50 +60,124 @@ export default function MaintenanceSection({ settings, onSave }) {
     }
   };
 
+  const PRESETS = [
+    { bytes: 1200, labelKey: 'preset_strict', descKey: 'preset_strict_desc' },
+    { bytes: 2400, labelKey: 'preset_standard', descKey: 'preset_standard_desc' },
+    { bytes: 4800, labelKey: 'preset_relaxed', descKey: 'preset_relaxed_desc' },
+  ];
+
+  const handleApplyPreset = (bytes) => {
+    setBloatMinBytes(String(bytes));
+    const savedVal = settings?.bloat_min_bytes != null ? String(settings.bloat_min_bytes) : '';
+    setDirty(String(bytes) !== savedVal);
+  };
+
   return (
-    <div className="space-y-4 pt-4">
-      <div className="space-y-2">
-        <label className="block text-xs font-medium text-slate-400 uppercase tracking-wider flex items-center justify-between">
-          <span>{t('settings.maintenance.bloat_min_bytes_label')}</span>
-          {isValid && (
-            <span className="text-[11px] font-mono text-indigo-400 font-normal">
-              {formatByteHint(parsedVal)}
-            </span>
-          )}
-        </label>
-        <div className="flex items-center gap-2">
-          <input
-            type="number"
-            min="1"
-            value={bloatMinBytes}
-            onChange={(e) => {
-              setBloatMinBytes(e.target.value);
-              setDirty(true);
-            }}
-            placeholder="2048"
-            className="bg-slate-950 border border-slate-700 text-slate-200 rounded-lg px-3 py-2 text-sm w-44 font-mono focus:outline-none focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 shadow-inner"
-          />
-          <span className="text-xs text-slate-500 font-mono">
-            {t('settings.maintenance.bytes_unit')}
-          </span>
+    <div className="space-y-5 pt-2">
+      {/* Explanation Banner */}
+      <div className="p-4 rounded-xl bg-indigo-950/40 border border-indigo-800/40 text-slate-300 text-xs leading-relaxed space-y-2 shadow-inner">
+        <div className="flex items-center gap-2 text-indigo-300 font-semibold text-sm">
+          <Sparkles size={16} className="text-indigo-400 flex-shrink-0" />
+          <span>{t('settings.maintenance.explanation_title')}</span>
         </div>
-        <p className="text-xs text-slate-500 leading-relaxed pt-1">
-          {t('settings.maintenance.bloat_min_bytes_desc')}
+        <p className="text-slate-300/90 leading-normal">
+          {t('settings.maintenance.explanation_text')}
         </p>
+        <div className="pt-1 flex items-center gap-1.5 text-[11px] text-indigo-300/80 font-mono">
+          <FileText size={13} className="text-indigo-400 flex-shrink-0" />
+          <span>docs/skills/memory-audit/SKILL.md &rarr; system://diagnostic</span>
+        </div>
+      </div>
+
+      {/* Main Setting Input & Presets */}
+      <div className="space-y-3 pt-1">
+        <div className="space-y-1">
+          <label className="block text-xs font-medium text-slate-300 flex items-center justify-between">
+            <span className="font-semibold text-slate-200">{t('settings.maintenance.bloat_min_bytes_label')}</span>
+            {isValid && (
+              <span className="text-[11px] font-mono text-indigo-400 font-normal">
+                {formatByteHint(parsedVal)} {getCharEstimate(parsedVal)}
+              </span>
+            )}
+          </label>
+          <p className="text-xs text-slate-400 leading-relaxed">
+            {t('settings.maintenance.bloat_min_bytes_desc')}
+          </p>
+        </div>
+
+        {/* Preset Chips */}
+        <div className="space-y-1.5 pt-1">
+          <div className="text-[11px] font-medium text-slate-400">
+            {t('settings.maintenance.presets_label')}
+          </div>
+          <div className="grid grid-cols-3 gap-2">
+            {PRESETS.map((p) => {
+              const isSelected = isValid && parsedVal === p.bytes;
+              return (
+                <button
+                  key={p.bytes}
+                  type="button"
+                  onClick={() => handleApplyPreset(p.bytes)}
+                  className={`p-2 rounded-lg border text-left transition-all flex flex-col justify-between ${
+                    isSelected
+                      ? 'bg-indigo-600/20 border-indigo-500/80 text-indigo-200 ring-1 ring-indigo-500/30'
+                      : 'bg-slate-900/60 border-slate-800 text-slate-300 hover:bg-slate-800/60 hover:border-slate-700'
+                  }`}
+                >
+                  <div className="flex items-center justify-between w-full font-medium text-xs">
+                    <span>{t(`settings.maintenance.${p.labelKey}`)}</span>
+                    {isSelected && <Check size={12} className="text-indigo-400 flex-shrink-0" />}
+                  </div>
+                  <div className="text-[10px] text-slate-400 mt-1">
+                    {t(`settings.maintenance.${p.descKey}`)}
+                  </div>
+                </button>
+              );
+            })}
+          </div>
+        </div>
+
+        {/* Manual Input */}
+        <div className="pt-2">
+          <div className="flex items-center gap-2">
+            <input
+              type="number"
+              min="1"
+              value={bloatMinBytes}
+              onChange={(e) => {
+                const val = e.target.value;
+                setBloatMinBytes(val);
+                const savedVal = settings?.bloat_min_bytes != null ? String(settings.bloat_min_bytes) : '';
+                setDirty(val !== savedVal);
+              }}
+              placeholder={settings?.bloat_min_bytes != null ? String(settings.bloat_min_bytes) : ''}
+              className="bg-slate-950 border border-slate-700 text-slate-200 rounded-lg px-3 py-2 text-sm w-44 font-mono focus:outline-none focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 shadow-inner"
+            />
+            <span className="text-xs text-slate-500 font-mono">
+              {t('settings.maintenance.bytes_unit')}
+            </span>
+          </div>
+        </div>
+
         {!isValid && dirty && (
           <p className="text-xs text-rose-400 flex items-center gap-1 pt-1">
             <AlertTriangle size={12} />
             {t('settings.maintenance.invalid_bloat_min_bytes')}
           </p>
         )}
+
+        {/* Tip */}
+        <p className="text-[11px] text-slate-400/80 bg-slate-900/40 p-2.5 rounded-lg border border-slate-800/50 leading-relaxed">
+          {t('settings.maintenance.impact_hint')}
+        </p>
       </div>
 
       {dirty && (
-        <div className="flex items-center justify-end pt-1">
+        <div className="flex items-center justify-end pt-2">
           <button
             onClick={handleSave}
             disabled={saving || !isValid}
-            className="px-4 py-2 bg-indigo-600 hover:bg-indigo-500 disabled:opacity-50 text-white rounded-lg text-sm font-medium flex items-center gap-2 transition-colors"
+            className="px-4 py-2 bg-indigo-600 hover:bg-indigo-500 disabled:opacity-50 text-white rounded-lg text-sm font-medium flex items-center gap-2 transition-colors shadow-lg shadow-indigo-900/20"
           >
             <Save size={14} />
             {saving ? t('settings.maintenance.saving') : t('settings.maintenance.save')}

frontend/src/features/settings/MaintenanceSection.test.jsx

@@ -8,40 +8,83 @@ vi.mock('../../components/Toast', () => ({
 }));
 
 describe('MaintenanceSection', () => {
-  it('renders initial bloat_min_bytes and byte conversion hint', () => {
-    render(<MaintenanceSection settings={{ bloat_min_bytes: 2048 }} onSave={vi.fn()} />);
+  it('renders initial bloat_min_bytes, byte conversion hint, and explanation callout', () => {
+    render(<MaintenanceSection settings={{ bloat_min_bytes: 2400 }} onSave={vi.fn()} />);
 
-    const input = screen.getByPlaceholderText('2048');
-    expect(input.value).toBe('2048');
-    expect(screen.getByText('≈ 2.0 KB')).toBeInTheDocument();
+    const input = screen.getByPlaceholderText('2400');
+    expect(input.value).toBe('2400');
+    expect(screen.getByText(/2.3 KB/)).toBeInTheDocument();
+    expect(screen.getByText('What is Memory Audit & Bloat Threshold?')).toBeInTheDocument();
   });
 
   it('shows validation error for values less than 1', async () => {
-    render(<MaintenanceSection settings={{ bloat_min_bytes: 2048 }} onSave={vi.fn()} />);
+    render(<MaintenanceSection settings={{ bloat_min_bytes: 2400 }} onSave={vi.fn()} />);
 
-    const input = screen.getByPlaceholderText('2048');
+    const input = screen.getByPlaceholderText('2400');
     fireEvent.change(input, { target: { value: '0' } });
 
     expect(screen.getByText('Threshold must be a positive integer of at least 1')).toBeInTheDocument();
     expect(screen.queryByRole('button', { name: /save/i })).toBeDisabled();
   });
 
-  it('calls onSave with parsed integer when valid value is saved', async () => {
+  it('allows selecting presets (e.g. Compact 1200 B) to update threshold', async () => {
     const onSaveMock = vi.fn().mockResolvedValue({ success: true });
-    render(<MaintenanceSection settings={{ bloat_min_bytes: 2048 }} onSave={onSaveMock} />);
+    render(<MaintenanceSection settings={{ bloat_min_bytes: 2400 }} onSave={onSaveMock} />);
 
-    const input = screen.getByPlaceholderText('2048');
-    fireEvent.change(input, { target: { value: '4096' } });
+    const compactPreset = screen.getByText('Compact (1200 B)');
+    fireEvent.click(compactPreset);
 
-    expect(screen.getByText('≈ 4.0 KB')).toBeInTheDocument();
+    const input = screen.getByPlaceholderText('2400');
+    expect(input.value).toBe('1200');
 
     const saveButton = screen.getByRole('button', { name: /save/i });
     expect(saveButton).not.toBeDisabled();
 
     fireEvent.click(saveButton);
 
     await waitFor(() => {
-      expect(onSaveMock).toHaveBeenCalledWith({ bloat_min_bytes: 4096 });
+      expect(onSaveMock).toHaveBeenCalledWith({ bloat_min_bytes: 1200 });
     });
   });
+
+  it('calls onSave with parsed integer when valid value is saved manually', async () => {
+    const onSaveMock = vi.fn().mockResolvedValue({ success: true });
+    render(<MaintenanceSection settings={{ bloat_min_bytes: 2400 }} onSave={onSaveMock} />);
+
+    const input = screen.getByPlaceholderText('2400');
+    fireEvent.change(input, { target: { value: '4800' } });
+
+    expect(screen.getByText(/4.7 KB/)).toBeInTheDocument();
+
+    const saveButton = screen.getByRole('button', { name: /save/i });
+    expect(saveButton).not.toBeDisabled();
+
+    fireEvent.click(saveButton);
+
+    await waitFor(() => {
+      expect(onSaveMock).toHaveBeenCalledWith({ bloat_min_bytes: 4800 });
+    });
+  });
+
+  it('does not show save button when selecting preset that matches saved value', async () => {
+    render(<MaintenanceSection settings={{ bloat_min_bytes: 2400 }} onSave={vi.fn()} />);
+
+    // Click the 2400 preset
+    const standardPreset = screen.getByText(/Standard \(2400 B/i);
+    fireEvent.click(standardPreset);
+
+    // Should not show save button
+    expect(screen.queryByRole('button', { name: /save/i })).not.toBeInTheDocument();
+  });
+
+  it('does not show save button when manually entering saved value', async () => {
+    render(<MaintenanceSection settings={{ bloat_min_bytes: 2400 }} onSave={vi.fn()} />);
+
+    const input = screen.getByPlaceholderText('2400');
+    fireEvent.change(input, { target: { value: '1200' } });
+    expect(screen.queryByRole('button', { name: /save/i })).toBeInTheDocument();
+
+    fireEvent.change(input, { target: { value: '2400' } });
+    expect(screen.queryByRole('button', { name: /save/i })).not.toBeInTheDocument();
+  });
 });

frontend/src/i18n/en.json

@@ -22,7 +22,7 @@
       "section_database": "Database Connection",
       "section_boot_uris": "Boot URIs",
       "section_presets": "Boot Presets",
-      "section_maintenance": "Memory Maintenance Thresholds",
+      "section_maintenance": "Memory Audit Bloat Threshold",
       "section_domains": "Memory Domains"
     },
     "error": {
@@ -185,15 +185,26 @@
       "save_failed": "Save failed"
     },
     "maintenance": {
-      "bloat_min_bytes_label": "Node Bloat Threshold (bloat_min_bytes)",
-      "bloat_min_bytes_desc": "When a single memory's UTF-8 content size exceeds this threshold, memory diagnostic and cleanup views flag it as bloated for summarization or splitting.",
+      "bloat_min_bytes_label": "Memory Audit Bloat Threshold (bloat_min_bytes)",
+      "bloat_min_bytes_desc": "When a single memory's UTF-8 content size exceeds this threshold, the AI memory-audit workflow flags it as a Bloated Memory via system://diagnostic, prompting the AI to split or summarize it.",
       "bytes_unit": "Bytes",
       "equiv_kb": "≈ {{kb}} KB",
       "equiv_mb": "≈ {{mb}} MB",
+      "char_estimate": "(≈ {{zhCount}} Chinese chars / {{enCount}} English chars)",
       "invalid_bloat_min_bytes": "Threshold must be a positive integer of at least 1",
       "save_failed": "Failed to save maintenance threshold",
       "saving": "Saving...",
-      "save": "Save"
+      "save": "Save",
+      "explanation_title": "What is Memory Audit & Bloat Threshold?",
+      "explanation_text": "When the AI performs self-reflection and memory quality auditing (memory-audit skill), it queries system://diagnostic to identify memory graph issues. Oversized memories consume excessive context bandwidth and dilute key takeaways. This threshold defines when a memory node is diagnosed as 'bloated'.",
+      "presets_label": "Recommended Presets",
+      "preset_strict": "Compact (1200 B)",
+      "preset_strict_desc": "≈ 400 chars · Aggressive split",
+      "preset_standard": "Standard (2400 B · Default)",
+      "preset_standard_desc": "≈ 800 chars · Recommended default",
+      "preset_relaxed": "Relaxed (4800 B)",
+      "preset_relaxed_desc": "≈ 1600 chars · Allows long nodes",
+      "impact_hint": "💡 Tip: Lowering the threshold prompts the AI to aggressively decompose bloated memories during audits; raising it allows longer single nodes."
     }
   },