dsh-lite-memory 0.17.0 → 0.18.19

package/client.js

@@ -82,22 +82,26 @@ window.__ModuleLoader__.load({
       return meta;
     };
 
-    const isMemoryId = (value) => typeof value === 'string' && /^mem_[a-z0-9]{6,}$/.test(value);
     const isCandidateId = (value) => typeof value === 'string' && /^sug_[a-z0-9]{6,}$/.test(value);
 
-    /** 一条引用的规范形态：只有定位与版次。 */
+    /** 一条引用的规范形态：只有标题、范围与版次；id 不进界面。 */
     const citationOf = (meta, kind) => {
-      if (!meta || !isMemoryId(meta.id)) return null;
+      if (!meta || typeof meta.title !== 'string' || !meta.title.trim()) return null;
       if (kind === 'memory-save' && meta.changed !== true) return null;
       return {
-        id: meta.id,
-        title: typeof meta.title === 'string' ? meta.title : '',
+        title: meta.title,
+        key: `${meta.scope === 'global' ? 'global' : 'project'}\u0000${meta.title}`, // ui-copy-ignore
         scope: meta.scope === 'global' ? 'global' : 'project',
         revision: Number.isInteger(meta.revision) ? meta.revision : 1,
         status: typeof meta.status === 'string' ? meta.status : 'ok',
         origin: meta.origin === 'project_evolution' ? 'project_evolution' : 'user_explicit',
         kind,
         exposure: kind === 'memory-save' || kind === 'memory-forget' ? 'update' : 'reference',
+        /** 条目类型：读正文看 recordKind，检索看 ref 自己的 kind；工具名不是类型。 */
+        entryKind: typeof meta.kind === 'string' && Object.prototype.hasOwnProperty.call(KIND_LABEL, meta.kind)
+          ? meta.kind
+          : (typeof meta.recordKind === 'string' ? meta.recordKind : ''),
+        updated: typeof meta.updated === 'string' ? meta.updated : '',
         reason: typeof meta.reason === 'string' ? meta.reason : '',
         reasonCode: typeof meta.reasonCode === 'string' ? meta.reasonCode : '',
         noTriggerReason: typeof meta.noTriggerReason === 'string' ? meta.noTriggerReason : '',
@@ -153,7 +157,7 @@ window.__ModuleLoader__.load({
       const seen = new Map();
       const out = [];
       for (const item of items) {
-        const key = `${item.scope}:${item.id}:${item.exposure}`;
+        const key = `${item.scope}:${item.key}:${item.exposure}`;
         const at = seen.get(key);
         if (at === undefined) {
           seen.set(key, out.length);
@@ -253,9 +257,51 @@ window.__ModuleLoader__.load({
       };
     };
 
+    /** 一行展示的身份：曝光类型 + 文案 + 正文；拦截结果没有 id，只能按内容认。 */
+    const rowKeyOf = (toolName, block) => {
+      const text = settledText(block);
+      return text ? `${toolName}|${text}` : '';
+    };
+
+    /** 同一组行每次出现的去留：同键只留第一次。 */
+    const rowKeepFlags = (keys) => {
+      const seen = new Set();
+      return keys.map((key) => {
+        if (!key) return true;
+        if (seen.has(key)) return false;
+        seen.add(key);
+        return true;
+      });
+    };
+
     const Row = (props) => {
       const line = props.phase === 'preparing' ? null : firstLine(settledText(props.block));
-      return h('div', { 'data-tool': props.toolName, style: ROW }, h('span', { style: DOT }, '·'), h('span', { style: LABEL }, line ?? RUNNING[props.toolName] ?? 'memory'));
+      const key = props.phase === 'preparing' ? '' : rowKeyOf(props.toolName, props.block);
+      const nodeRef = React.useRef(null);
+      const [dup, setDup] = React.useState(false);
+      const useLayout = React.useLayoutEffect || React.useEffect;
+      useLayout(() => {
+        const node = nodeRef.current;
+        if (!key || !node || typeof node.closest !== 'function') return;
+        const turnBox = node.closest('[data-chat-turn]');
+        const turn = turnBox ? turnBox.getAttribute('data-chat-turn') : null;
+        const rootScope = node.ownerDocument || node.parentElement;
+        if (!rootScope || typeof rootScope.querySelectorAll !== 'function') return;
+        const peers = Array.prototype.filter.call(rootScope.querySelectorAll('[data-memory-row]'), (peer) => {
+          if (!turn) return peer.parentElement === node.parentElement;
+          const box = peer.closest('[data-chat-turn]');
+          return box !== null && box.getAttribute('data-chat-turn') === turn;
+        });
+        const at = peers.indexOf(node);
+        if (at < 0) return;
+        setDup(!rowKeepFlags(peers.map((peer) => peer.getAttribute('data-memory-row') || ''))[at]);
+      }, [key]);
+      return h('div', {
+        ref: nodeRef,
+        'data-tool': props.toolName,
+        'data-memory-row': key || undefined,
+        style: dup ? { ...ROW, display: 'none' } : ROW,
+      }, h('span', { style: DOT }, '·'), h('span', { style: LABEL }, line ?? RUNNING[props.toolName] ?? 'memory'));
     };
 
     /** 建议行：候选 id 来自持久元数据，不读文案。 */
@@ -293,7 +339,7 @@ window.__ModuleLoader__.load({
     const undoRefOf = (meta, cwd) => (meta
       && meta.kind === 'memory-save'
       && meta.changed === true
-      && isMemoryId(meta.id)
+      && typeof meta.title === 'string' && meta.title.trim().length > 0
       && Number.isInteger(meta.revision)
       && typeof cwd === 'string'
       && cwd.length > 0
@@ -312,7 +358,7 @@ window.__ModuleLoader__.load({
       const drop = () => {
         if (!canDrop) return;
         setState('saving');
-        post('/lite-memory/undo', { op: 'undo', id: changed.id, revision: changed.revision, cwd }).then((result) => {
+        post('/lite-memory/undo', { op: 'undo', title: changed.title, revision: changed.revision, cwd }).then((result) => {
           if (succeeded(result)) {
             setState('dropped');
             setNote(result.body && result.body.mode === 'restored' ? 'memory · restored' : 'memory · archived');
@@ -464,7 +510,7 @@ window.__ModuleLoader__.load({
       if (ref.messageId !== undefined) return `消息 ${ref.messageId}`;
       if (ref.turn !== undefined) return `第 ${ref.turn} 轮`;
       if (ref.turnIndex !== undefined) return `第 ${ref.turnIndex} 轮`;
-      return ref.id !== undefined ? String(ref.id) : `引用 ${index + 1}`;
+      return `引用 ${index + 1}`;
     };
     const refHrefOf = (ref) => (ref && typeof ref === 'object'
       ? [ref.href, ref.url, ref.link].find((value) => typeof value === 'string' && value)
@@ -540,13 +586,27 @@ window.__ModuleLoader__.load({
     const REF_META = { display: 'flex', alignItems: 'center', gap: '6px', margin: '0 0 2px 2px', fontSize: '11px', lineHeight: '18px', color: 'var(--dsw-alias-label-secondary)' };
     const REF_BODY = { margin: '2px 0 3px', padding: '3px 0 3px 9px', display: 'flex', flexDirection: 'column', gap: '3px', fontSize: '12px', lineHeight: '1.65', maxHeight: '180px', overflowY: 'auto' };
 
-    /** 出处一句话：项目/全局、来源、状态。 */
+    /** 出处一句话：类型、项目/全局、来源、状态。 */
+    /** 只管最近一个月：更早或没时间就不占位。 */
+    const agoLabel = (value) => {
+      const at = Date.parse(value);
+      if (!Number.isFinite(at)) return '';
+      const days = Math.floor((Date.now() - at) / 86_400_000);
+      if (days <= 0) return '今天更新';
+      if (days === 1) return '昨天更新';
+      if (days < 30) return `${days} 天前更新`;
+      return '';
+    };
     const refMetaOf = (item) => {
-      const parts = [item.scope === 'global' ? '全局' : '项目', item.origin === 'project_evolution' ? '自进化' : '你记的'];
+      /** 会话里只标层与来源：类型留给面板和工具，不占引用行的宽度。 */
+      const layer = `${item.scope === 'global' ? '[全局]' : '[项目]'}${item.origin === 'project_evolution' ? '[自进化]' : ''}`;
+      const parts = [];
+      const ago = agoLabel(item.updated);
+      if (ago) parts.push(ago);
       if (item.status === 'archived') parts.push('已归档');
       const processing = PROCESSING_LABEL[item.processingStatus] || '';
       if (processing) parts.push(processing);
-      return parts.join(' · ');
+      return [layer, ...parts].join(' · ');
     };
 
     const RefChevron = (props) => h('svg', {
@@ -564,8 +624,8 @@ window.__ModuleLoader__.load({
         onMouseEnter: () => setHover(true),
         onMouseLeave: () => setHover(false),
         onClick: props.onShow, // ui-copy-ignore
-        'aria-label': `查看记忆 ${item.title || item.id}${reason ? `，${reason}` : ''}`,
-        title: reason ? `${item.title || item.id}，${reason}` : (item.title || item.id),
+        'aria-label': `查看记忆 ${item.title || '记忆'}${reason ? `，${reason}` : ''}`,
+        title: reason ? `${item.title || '记忆'}，${reason}` : (item.title || '记忆'),
         style: { // ui-copy-ignore
           display: 'flex', alignItems: 'flex-start', gap: '7px', width: '100%', minWidth: 0, textAlign: 'left',
           border: 'none', borderRadius: '8px', padding: '3px 7px', cursor: 'pointer', color: 'inherit',
@@ -575,7 +635,7 @@ window.__ModuleLoader__.load({
       },
       h('span', { 'aria-hidden': 'true', style: { flex: '0 0 auto', alignSelf: 'stretch', width: '2px', minHeight: '10px', borderRadius: '999px', background: props.tone, opacity: 0.85 } }),
       h('span', { style: { display: 'flex', flexDirection: 'column', gap: '1px', flex: '1 1 auto', minWidth: 0 } },
-        h('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, item.title || item.id),
+        h('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, item.title || '记忆'),
         h('span', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0, fontSize: '11px', lineHeight: '16px', color: 'var(--dsw-alias-label-secondary)' } },
           reason ? h('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, reason) : null,
           h('span', { style: { marginLeft: 'auto', flex: '0 0 auto', fontVariantNumeric: 'tabular-nums' } }, refMetaOf(item)),
@@ -614,28 +674,28 @@ window.__ModuleLoader__.load({
         setOpen(false);
       };
       const show = (item) => {
-        if (shown && shown.id === item.id) {
+        if (shown && shown.key === item.key) {
           close();
           return;
         }
         const request = generation.current + 1;
         generation.current = request;
         setOpen(true);
-        setShown({ id: item.id, ref: item, loading: true });
+        setShown({ key: item.key, ref: item, loading: true });
         setNote('');
-        post('/lite-memory/body', { id: item.id, revision: item.revision, sessionId }).then((result) => {
+        post('/lite-memory/body', { title: item.title, scope: item.scope, revision: item.revision, sessionId }).then((result) => {
           if (!alive.current || generation.current !== request) return;
           const payload = result.ok && result.body ? result.body : null;
           if (!payload || payload.ok !== true) {
-            setShown({ id: item.id, ref: item, invalid: true });
+            setShown({ key: item.key, ref: item, invalid: true });
             return;
           }
           if (payload.status === 'gone') {
-            setShown({ id: item.id, ref: item, gone: true });
+            setShown({ key: item.key, ref: item, gone: true });
             return;
           }
           setShown({
-            id: item.id,
+            key: item.key,
             ref: item,
             title: typeof payload.title === 'string' ? payload.title : '',
             when: typeof payload.when === 'string' ? payload.when : '',
@@ -651,11 +711,11 @@ window.__ModuleLoader__.load({
         });
       };
       const rows = open ? items.map((item) => h(RefRow, {
-        key: `${item.scope}|${item.id}|${item.revision}`, // ui-copy-ignore
-        item, tone, active: Boolean(shown && shown.id === item.id),
+        key: `${item.key}|${item.revision}`, // ui-copy-ignore
+        item, tone, active: Boolean(shown && shown.key === item.key),
         onShow: () => show(item),
       })) : [];
-      const detail = shown && shown.ref && items.some((item) => item.id === shown.id && item.revision === shown.ref.revision)
+      const detail = shown && shown.ref && items.some((item) => item.key === shown.key && item.revision === shown.ref.revision)
         ? h('div', { style: { ...REF_BODY, borderLeft: `2px solid ${tone}` } },
           shown.loading ? h('span', { style: REF_META }, '读取中…') : null,
           shown.gone ? h('span', { style: REF_META }, '这条记忆已删除') : null,
@@ -770,6 +830,64 @@ window.__ModuleLoader__.load({
         return false;
       }
     };
+    /**
+     * 解释模式只在本机、按会话记；默认关，零命中原因不打扰。
+     * 面板开关与对话末尾共用同一条广播。
+     */
+    const explainBus = (() => {
+      const key = '__liteMemoryExplainBus'; // ui-copy-ignore
+      if (!(globalThis[key] instanceof Set)) globalThis[key] = new Set();
+      return globalThis[key];
+    })();
+    const explainKeyOf = (sessionId) => `lite-memory:explain:${sessionId || 'default'}`;
+    const explainModeOf = (sessionId) => {
+      const store = displayStoreOf();
+      if (!store) return false;
+      try {
+        return store.getItem(explainKeyOf(sessionId)) === '1';
+      } catch {
+        return false;
+      }
+    };
+    const setExplainMode = (sessionId, on) => {
+      const store = displayStoreOf();
+      if (!store) return false;
+      try {
+        store.setItem(explainKeyOf(sessionId), on === true ? '1' : '0');
+      } catch {
+        return false;
+      }
+      for (const listener of [...explainBus]) {
+        try {
+          listener();
+        } catch {
+          // 单个订阅坏掉不影响其它面板。
+        }
+      }
+      return true;
+    };
+    const watchExplain = (listener) => {
+      explainBus.add(listener);
+      return () => explainBus.delete(listener);
+    };
+    /**
+     * 面板只说判断结果，不说内部原因码；条数来自上一次自动召回的回执。
+     */
+    const recallLineOf = (receipt) => {
+      if (!receipt || typeof receipt !== 'object') return '';
+      const cards = Number.isInteger(receipt.cards) ? receipt.cards : 0;
+      const matched = Number.isInteger(receipt.matched) ? receipt.matched : 0;
+      const related = matched > 0 ? `${matched} 条相关记忆，` : '';
+      switch (receipt.reason) {
+        case 'hit': return cards > 0 ? `上次自动提醒 ${cards} 条` : '';
+        case 'budget': return `上次没提醒，${related}本轮自动提醒已用满`;
+        case 'needs_context': return `上次没提醒，${related}适用条件未确认`;
+        case 'no_overlap': return '上次没提醒，没有匹配的记忆';
+        case 'memory_off': return '上次没提醒，记忆已关闭';
+        case 'tools_only': return '上次没提醒，只在你问时检索';
+        default: return '';
+      }
+    };
     /** 功能关闭时视图统一回列表，不保留一个画不出来的页签。 */
     const graphViewOf = (enabled, view) => (enabled === true && view === 'graph' ? 'graph' : 'list');
     const viewModeOf = (display, view) => {
@@ -803,6 +921,15 @@ window.__ModuleLoader__.load({
       return reduced;
     };
 
+    /** 同标题（去空白后）出现几次；体检与重复标题筛选共用。 */
+    const titleCountsOf = (records) => {
+      const counts = new Map();
+      (Array.isArray(records) ? records : EMPTY).forEach((record) => {
+        const title = typeof record.title === 'string' ? record.title.trim() : '';
+        if (title) counts.set(title, (counts.get(title) || 0) + 1);
+      });
+      return counts;
+    };
     /** 标签/话题按精确值筛选；只有自由搜索才用包含匹配。 */
     const filterRecords = (records, query, hub) => {
       const rows = Array.isArray(records) ? records : EMPTY;
@@ -814,6 +941,15 @@ window.__ModuleLoader__.load({
       if (kind === 'topic' && value) {
         return rows.filter((record) => record.topicKey === value);
       }
+      if (kind === 'duplicate' || kind === 'unread' || kind === 'noWhen') {
+        const counts = titleCountsOf(rows);
+        return rows.filter((record) => {
+          if (kind === 'unread') return !record.lastUsed;
+          if (kind === 'noWhen') return !record.when;
+          const title = typeof record.title === 'string' ? record.title.trim() : '';
+          return Boolean(title) && counts.get(title) > 1;
+        });
+      }
       const needle = typeof query === 'string' ? query.trim().toLowerCase() : '';
       if (!needle) return rows;
       return rows.filter((record) => {
@@ -822,6 +958,21 @@ window.__ModuleLoader__.load({
       });
     };
 
+    /** 结构体检：只看现行记录，缺的数据给 null，不猜。 */
+    const checkupOf = (records, scopes, globalSelected) => {
+      const rows = Array.isArray(records) ? records : EMPTY;
+      const counts = titleCountsOf(rows);
+      let duplicate = 0;
+      counts.forEach((count) => { if (count > 1) duplicate += 1; });
+      const globalRow = (Array.isArray(scopes) ? scopes : EMPTY).find((scope) => scope && scope.kind === 'global');
+      return {
+        duplicate,
+        unread: rows.filter((record) => !record.lastUsed).length,
+        globalEntries: globalRow && Number.isInteger(globalRow.entries) ? globalRow.entries : null,
+        globalMissingWhen: globalSelected ? rows.filter((record) => !record.when).length : null,
+      };
+    };
+
     /** 记忆宫殿：房间固定，槽位固定，换项目只换陈列内容。 */
     const PALACE_PAGE_SIZE = 24;
     const PALACE_PREVIEW = 4;
@@ -1091,7 +1242,7 @@ window.__ModuleLoader__.load({
         edges.push({ from, to, type });
       };
       for (const record of rows) {
-        nodes.push({ id: record.id, kind: 'memory', label: record.title || record.id, experimental: record.experimental === true });
+        nodes.push({ id: record.id, kind: 'memory', label: record.title || '记忆', experimental: record.experimental === true });
       }
       for (const [tag, count] of tags) {
         nodes.push({ id: `tag:${tag}`, kind: 'tag', label: `#${tag}`, count });
@@ -1490,13 +1641,15 @@ window.__ModuleLoader__.load({
       },
     }));
 
-    const STAGE = { pending: '候选', trial: '试用', active: '生效', paused: '暂停' };
+    const STAGE = { pending: '候选', trial: '试用', active: '生效', paused: '暂停', legacy: '待复核' };
     const STAGE_TONE = {
       pending: 'var(--dsw-alias-state-warn-primary)',
       trial: 'var(--dsw-alias-brand-primary)',
       active: 'var(--dsw-alias-state-success-primary)',
       paused: 'var(--dsw-alias-label-secondary)',
+      legacy: 'var(--dsw-alias-state-warn-primary)',
     };
+    const stageOf = (rule) => (rule.reviewState === 'legacy_unreviewed' ? 'legacy' : rule.state);
     const StagePill = (props) => h('span', {
       style: {
         flex: '0 0 auto', padding: '0 6px', border: '1px solid var(--dsw-alias-border-l1)',
@@ -1533,6 +1686,7 @@ window.__ModuleLoader__.load({
     const usabilityOf = (rule, evolution, memoryOn) => {
       if (!memoryOn) return '记忆已关闭，暂不参与回答。';
       if (!evolution || evolution.enabled !== true || evolution.effectiveEnabled === false) return '自进化已关闭，暂不参与回答。';
+      if (rule.reviewState === 'legacy_unreviewed') return '所属项目还没确认，暂不参与回答。';
       if (rule.state === 'paused') return '已暂停，不参与回答。';
       const unresolved = rule.applicability === 'unresolved'
         || (rule.applicability === 'conditional' && (!Array.isArray(rule.conditions) || rule.conditions.length === 0));
@@ -1589,7 +1743,7 @@ window.__ModuleLoader__.load({
           color: 'inherit', padding: '4px 8px', cursor: 'pointer', minWidth: 0,
         },
       },
-      h('span', { style: { fontSize: '12px', lineHeight: '16px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, record.title || record.id),
+      h('span', { style: { fontSize: '12px', lineHeight: '16px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, record.title || '记忆'),
       h('span', { style: { ...PANEL_MUTED, display: 'flex', alignItems: 'center', gap: '5px', minWidth: 0, lineHeight: '14px' } },
         h('span', null, KIND_LABEL[record.kind] || record.kind),
         record.experimental ? h('span', { style: { color: 'var(--dsw-alias-state-warn-primary)' } }, '实验') : null,
@@ -1616,7 +1770,7 @@ window.__ModuleLoader__.load({
       },
       h('span', { style: { fontSize: '12px', lineHeight: '18px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, rule.title),
       h('span', { style: { ...PANEL_MUTED, display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0, lineHeight: '16px' } },
-        h(StagePill, { state: rule.state }),
+        h(StagePill, { state: stageOf(rule) }),
         h('span', { style: { marginLeft: 'auto', flex: '0 0 auto', fontVariantNumeric: 'tabular-nums' } }, EVO_DATE(rule.updated)),
       ));
     };
@@ -1655,7 +1809,7 @@ window.__ModuleLoader__.load({
         ? h('div', { style: { display: 'flex', alignItems: 'center', gap: '12px', flexWrap: 'wrap', paddingTop: '3px' } },
           rule.state === 'pending' || rule.state === 'trial'
             ? h(Action, { disabled: !canManage, onClick: () => act('adopt') }, '采纳') : null,
-          rule.state === 'paused'
+          rule.state === 'paused' && rule.reviewState !== 'legacy_unreviewed'
             ? h(Action, { disabled: !canManage, onClick: () => act('resume') }, '恢复')
             : (rule.state === 'trial' || rule.state === 'active'
               ? h(Action, { disabled: !canManage, onClick: () => act('pause') }, '暂停')
@@ -1742,7 +1896,7 @@ window.__ModuleLoader__.load({
         h('div', { style: { display: 'flex', flexDirection: 'column', gap: '4px' } },
           h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
             h('span', { style: PANEL_LABEL }, '当前状态'),
-            h(StagePill, { state: rule.state }),
+            h(StagePill, { state: stageOf(rule) }),
           ),
           h('div', { style: { fontSize: '12px', lineHeight: '1.55', opacity: 0.82 } }, usabilityOf(rule, props.evolution, props.memoryOn)),
           failureState
@@ -1770,7 +1924,7 @@ window.__ModuleLoader__.load({
           style: { height: '46px', border: '1px dashed var(--dsw-alias-border-l1)', borderRadius: '8px', opacity: 0.28 },
         });
       }
-      const title = String(record.title || record.id || '记忆');
+      const title = String(record.title || '记忆');
       return h('button', {
         type: 'button', title, 'aria-label': title,
         onClick: () => props.onPick(record.id),
@@ -1948,11 +2102,17 @@ window.__ModuleLoader__.load({
       const [selectedRule, setSelectedRule] = React.useState('');
       const [detail, setDetail] = React.useState(null);
       const [detailNote, setDetailNote] = React.useState('');
+      const [editingMemory, setEditingMemory] = React.useState(false);
+      const [editTitle, setEditTitle] = React.useState('');
+      const [editBody, setEditBody] = React.useState('');
+      const [editNote, setEditNote] = React.useState('');
       const [busy, setBusy] = React.useState(false);
       const [showReason, setShowReason] = React.useState(false);
       const [showSettings, setShowSettings] = React.useState(false);
+      const [explainOn, setExplainOn] = React.useState(explainModeOf(sessionId));
       const [display, setDisplay] = React.useState({ ...DISPLAY_DEFAULTS });
       const [hubFilter, setHubFilter] = React.useState(null);
+      const [checkup, setCheckup] = React.useState(false);
       const alive = React.useRef(true);
       const generation = React.useRef(0);
       const scopeRef = React.useRef('');
@@ -1966,6 +2126,8 @@ window.__ModuleLoader__.load({
       const load = (scopeKey = '', focusRule = '') => {
         const request = generation.current + 1;
         generation.current = request;
+        /** 用户选的项目立刻算数：晚到的保存/开关回执不能再把界面拉回旧范围。 */
+        if (scopeKey) scopeRef.current = scopeKey;
         setLoading(true);
         setFailed(false);
         setNote('');
@@ -2023,6 +2185,8 @@ window.__ModuleLoader__.load({
       }, []);
 
       React.useEffect(() => {
+        setEditingMemory(false);
+        setEditNote('');
         if (!selectedMemory || !data) { setDetail(null); setDetailNote(''); return undefined; }
         let live = true;
         setDetail(null);
@@ -2088,7 +2252,7 @@ window.__ModuleLoader__.load({
       } else if (activityCode === 'scope_unconfirmed' || activityCode === 'unknown_scope') {
         activityText = '暂未整理：适用范围待确认';
       } else if (activityCode === 'quota' || activityCode === 'exhausted') {
-        activityText = '本轮整理额度已用完';
+        activityText = '这轮先整理这些，下一条消息接着整理';
       } else if (activityCode === 'failed' || activityCode === 'error') {
         activityText = staleLearning ? '这轮整理没采用' : '最近整理失败，可查看原因';
       } else if (activityCode === 'waiting' || activityCode === 'idle' || activityCode === 'empty') {
@@ -2109,6 +2273,25 @@ window.__ModuleLoader__.load({
         return rules.filter((rule) => rule.state === stage);
       }, [rules, stage]);
       const selectedRuleRow = selectedRule ? rules.find((rule) => rule.id === selectedRule) : null;
+      const checkupData = checkupOf(records, data && data.scopes, globalView);
+      const globalScopeRow = (data && Array.isArray(data.scopes) ? data.scopes : EMPTY).find((scope) => scope && scope.kind === 'global');
+      const checkupJump = (hub) => { setCheckup(false); setTab('memory'); setQuery(''); setHubFilter(hub); };
+      const checkupJumpGlobal = (hub) => {
+        setCheckup(false); setQuery(''); setHubFilter(hub || null);
+        if (globalScopeRow) load(globalScopeRow.key);
+        else setTab('memory');
+      };
+      const checkupRowOf = (key, label, value, unit, onClick) => h('button', {
+        key, type: 'button', onClick,
+        style: {
+          display: 'flex', alignItems: 'center', gap: '8px', width: '100%', minWidth: 0,
+          padding: '7px 9px', border: 'none', background: 'transparent', color: 'inherit',
+          font: 'inherit', textAlign: 'left', cursor: 'pointer',
+          borderBottom: '1px solid var(--dsw-alias-border-l1)',
+        },
+      },
+      h('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, label),
+      h('span', { style: { marginLeft: 'auto', flex: '0 0 auto', fontVariantNumeric: 'tabular-nums', opacity: 0.72 } }, value === null || value === undefined ? '—' : `${value} ${unit}`));
       const detailRecord = selectedMemory ? records.find((record) => record.id === selectedMemory) : null;
 
       const onPickNode = (node) => {
@@ -2149,18 +2332,64 @@ window.__ModuleLoader__.load({
         };
         if (learningAction === 'pause') payload.ids = [selectedRuleRow.id];
         post('/lite-memory/evolution', payload).then((result) => {
-          if (!alive.current) return;
+          if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)) return;
           setBusy(false);
           if (succeeded(result)) load(selectedKey, selectedRuleRow.id);
           else setNote(failure(result, '这次没有改动'));
         });
       };
 
+      /** 普通记忆的正文由人直接改：带读到的版本写，冲突就提示刷新，不覆盖别处的修改。 */
+      const saveMemoryEdit = (record) => {
+        if (busy || !canManage || !record || !record.id) return;
+        const title = editTitle.trim();
+        const text = editBody.trim();
+        if (!title || !text) return;
+        setBusy(true);
+        setEditNote('');
+        const payload = { sessionId, scopeKey: selectedKey, id: record.id, title, body: text, expectedRevision: record.revision };
+        post('/lite-memory/entry', payload).then((result) => {
+          if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)) return;
+          setBusy(false);
+          if (succeeded(result)) {
+            const nextTitle = result.body && typeof result.body.title === 'string' ? result.body.title : title;
+            const nextRevision = result.body && Number.isInteger(result.body.revision) ? result.body.revision : record.revision;
+            setEditingMemory(false);
+            setDetail((prev) => (prev ? { ...prev, title: nextTitle, body: text, currentBody: text, revision: nextRevision } : prev));
+            setData((prev) => {
+              if (!prev || !prev.selected || !Array.isArray(prev.selected.records)) return prev;
+              const records = prev.selected.records.map((row) => (row.id === record.id ? { ...row, title: nextTitle, revision: nextRevision } : row));
+              return { ...prev, selected: { ...prev.selected, records } };
+            });
+            setEditNote('');
+          } else {
+            setEditNote(failure(result, '这次没有改动'));
+            /**
+             * 版本过期不是失败终点：把最新正文和版本取回来，草稿留着，
+             * 人确认后再按一次保存就写在最新版本上。
+             */
+            if (result.status === 409 && result.body && result.body.retry) {
+              post('/lite-memory/body', { sessionId, id: record.id, scopeKey: selectedKey }).then((fresh) => {
+                if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)
+                  || !fresh.ok || !fresh.body || !fresh.body.ok || fresh.body.status === 'gone') return;
+                const revision = Number.isInteger(fresh.body.revision) ? fresh.body.revision : 0;
+                setDetail(fresh.body);
+                setData((prev) => {
+                  if (!prev || !prev.selected || !Array.isArray(prev.selected.records)) return prev;
+                  const records = prev.selected.records.map((row) => (row.id === record.id ? { ...row, revision: revision || row.revision } : row));
+                  return { ...prev, selected: { ...prev.selected, records } };
+                });
+              });
+            }
+          }
+        });
+      };
+
       const toggleControl = () => {
         if (busy || !canToggle) return;
         setBusy(true);
         post('/lite-memory/control', { sessionId, enabled: !memoryOn, operationId: newOperationId() }).then((result) => {
-          if (!alive.current) return;
+          if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)) return;
           setBusy(false);
           if (succeeded(result)) load(selectedKey);
           else setNote(failure(result, '开关没有改动'));
@@ -2171,7 +2400,7 @@ window.__ModuleLoader__.load({
         if (busy || !evolution || !canToggle || !memoryOn) return;
         setBusy(true);
         post('/lite-memory/evolution', { sessionId, enabled: evolution.enabled !== true, operationId: newOperationId() }).then((result) => {
-          if (!alive.current) return;
+          if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)) return;
           setBusy(false);
           if (succeeded(result)) load(selectedKey);
           else setNote(failure(result, '开关没有改动'));
@@ -2219,6 +2448,18 @@ window.__ModuleLoader__.load({
         selectedKey ? () => setDisplayFlag(key, display[key] !== true) : undefined,
       );
 
+      const explainToggle = () => switchItem(
+        '解释模式',
+        explainOn ? '零命中时说明原因' : '零命中时不出提示',
+        explainOn,
+        !sessionId,
+        sessionId ? () => {
+          const next = explainOn !== true;
+          setExplainOn(next);
+          setExplainMode(sessionId, next);
+        } : undefined,
+      );
+
       const switchItem = (label, hint, on, disabled, onClick) => h('div', {
         style: { display: 'flex', flexDirection: 'column', gap: '1px', minWidth: 0, opacity: disabled && !on ? 0.55 : 1 },
       },
@@ -2228,6 +2469,7 @@ window.__ModuleLoader__.load({
       ),
       hint ? h('span', { style: { ...PANEL_MUTED, lineHeight: '16px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, hint) : null);
       const evolutionOn = Boolean(memoryOn && evolution && evolution.enabled === true);
+      const recallLine = recallLineOf(current && current.recall);
       const switchBar = h('div', {
         style: { display: 'flex', flexDirection: 'column', gap: '3px', padding: '7px 18px 8px', borderBottom: '1px solid var(--dsw-alias-border-l1)', flex: '0 0 auto' },
       },
@@ -2238,9 +2480,11 @@ window.__ModuleLoader__.load({
           switchItem('自进化', evolutionOn ? '实验功能，会增加 token 消耗' : '从反馈里整理经验', evolutionOn, busy || !evolution || !canToggle || !memoryOn, toggleEvolution), // ui-copy-ignore 用户指定文案
           showSettings ? displayToggle('启用图谱', 'graph') : null,
           showSettings ? displayToggle('启用记忆宫殿', 'palace') : null,
+          showSettings ? explainToggle() : null,
         ),
       !globalView && !canToggle ? h('div', { style: { ...PANEL_MUTED, lineHeight: '18px' } }, '只读，切换回当前项目后可修改') : null,
       note ? h('div', { style: { ...PANEL_MUTED, lineHeight: '18px', color: 'var(--dsw-alias-state-error-primary)' } }, note) : null,
+      !globalView && recallLine ? h('div', { style: { ...PANEL_MUTED, lineHeight: '18px' } }, recallLine) : null,
       );
 
       const switchTab = (key) => {
@@ -2278,6 +2522,25 @@ window.__ModuleLoader__.load({
           }));
 
       const detailProcessing = detail ? processingStatusOf(detail) : '';
+      const memoryEditor = editingMemory && detailRecord
+        ? h('div', { style: { display: 'flex', flexDirection: 'column', gap: '8px' } },
+          h(Field, { label: '标题', value: editTitle, onChange: setEditTitle }),
+          h('label', { style: { display: 'flex', flexDirection: 'column', gap: '4px' } },
+            h('span', { style: PANEL_LABEL }, '经验'),
+            h('textarea', {
+              value: editBody, onChange: (event) => setEditBody(event.target.value), 'aria-label': '经验',
+              rows: 8,
+              style: { ...PANEL_INPUT, height: 'auto', minHeight: '150px', padding: '7px 9px', resize: 'vertical', lineHeight: '1.6' },
+            }),
+          ),
+          editNote ? h('div', { style: { ...PANEL_MUTED, color: 'var(--dsw-alias-label-error)' } }, editNote) : null,
+          h('div', { style: { display: 'flex', alignItems: 'center', gap: '12px', flexWrap: 'wrap' } },
+            h(Action, { disabled: busy || !editTitle.trim() || !editBody.trim(), onClick: () => saveMemoryEdit(detailRecord) }, '保存'),
+            h(Action, { disabled: busy, onClick: () => { setEditingMemory(false); setEditNote(''); } }, '取消'),
+          ),
+        )
+        : null;
+
       const memoryDetail = selectedMemory
         ? h('div', { style: { ...PANEL_CARD, minHeight: 0, overflowY: 'auto', display: 'flex', flexDirection: 'column', gap: '6px' } },
           detail
@@ -2290,8 +2553,22 @@ window.__ModuleLoader__.load({
               Array.isArray(detailRecord && detailRecord.tags) && detailRecord.tags.length
                 ? h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: '4px' } },
                   detailRecord.tags.slice(0, 6).map((tag) => h('span', { key: tag, style: { ...PANEL_MUTED, padding: '0 6px', border: '1px solid var(--dsw-alias-border-l1)', borderRadius: '999px' } }, `#${tag}`))) : null,
-              h('div', { style: { fontSize: '12px', lineHeight: '1.65', whiteSpace: 'pre-wrap', wordBreak: 'break-word' } }, currentBodyOf(detail) || '没有正文'),
-              h(DetailExtras, { payload: detail }),
+              memoryEditor,
+              editingMemory ? null : h('div', { style: { fontSize: '12px', lineHeight: '1.65', whiteSpace: 'pre-wrap', wordBreak: 'break-word' } }, currentBodyOf(detail) || '没有正文'),
+              editingMemory ? null : h(DetailExtras, { payload: detail }),
+              !editingMemory && detailRecord && canManage
+                ? h('div', { style: { display: 'flex', alignItems: 'center', gap: '12px', flexWrap: 'wrap', paddingTop: '2px' } },
+                  h(Action, {
+                    disabled: busy,
+                    onClick: () => {
+                      setEditTitle(detailRecord.title || detail.title || '');
+                      setEditBody(currentBodyOf(detail) || '');
+                      setEditNote('');
+                      setEditingMemory(true);
+                    },
+                  }, '修改'),
+                )
+                : null,
             )
             : h('div', { style: PANEL_MUTED }, detailNote || '读取中…'),
         )
@@ -2388,7 +2665,15 @@ window.__ModuleLoader__.load({
             fontVariantNumeric: 'tabular-nums',
           },
         }, `${label} ${countText(key)}`)),
-        h('span', { style: { marginLeft: 'auto' } }, display.graph ? viewToggleOf(evolutionView, setEvolutionView, '自进化视图') : null),
+        h('span', { style: { marginLeft: 'auto', display: 'flex', alignItems: 'center', gap: '8px' } },
+          h('button', {
+            type: 'button', 'aria-pressed': checkup, onClick: () => setCheckup((value) => !value),
+            style: {
+              ...PANEL_LINK, height: '30px', opacity: checkup ? 0.92 : 0.68,
+              borderBottom: checkup ? '1px solid currentColor' : '1px solid transparent',
+            },
+          }, '结构体检'),
+          display.graph ? viewToggleOf(evolutionView, setEvolutionView, '自进化视图') : null),
       );
 
       const stageLabel = (stageFilters.find(([key]) => key === stage) || ['all', '全部'])[1];
@@ -2439,6 +2724,18 @@ window.__ModuleLoader__.load({
         emptyText: evolutionEmptyText, ariaLabel: '经验关系图',
         legend: '实心 经验 · 空心 条件 · 虚线 共用条件 · 点经验查看',
       }));
+      const evolutionCheckupPane = h('div', {
+        style: {
+          ...PANEL_CARD, padding: '4px', flex: '0 0 auto', minHeight: 0, overflowY: 'auto',
+          display: 'flex', flexDirection: 'column', gap: 0,
+        },
+      },
+      checkupRowOf('duplicate', '重复标题', checkupData.duplicate, '组', () => checkupJump({ kind: 'duplicate', display: '重复标题' })),
+      checkupRowOf('global', '全局条目超 200', checkupData.globalEntries, '条', () => checkupJumpGlobal()),
+      checkupRowOf('globalWhen', '全局缺适用条件', checkupData.globalMissingWhen, '条',
+        () => checkupJumpGlobal({ kind: 'noWhen', display: '全局缺适用条件' })),
+      checkupRowOf('unread', '从未读过', checkupData.unread, '条', () => checkupJump({ kind: 'unread', display: '从未读过' })));
+
       const evolutionTab = evolutionFailed ? evolutionFailed : h('div', { role: 'tabpanel', 'aria-label': '自进化', style: { flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column', gap: '9px' } },
         h('div', { style: { ...PANEL_CARD, padding: '9px 11px', display: 'flex', alignItems: 'flex-start', gap: '8px', flex: '0 0 auto' } },
           h('span', { style: { flex: '0 0 auto', width: '6px', height: '6px', marginTop: '5px', borderRadius: '999px', background: effectiveEnabled ? 'var(--dsw-alias-brand-primary)' : 'var(--dsw-alias-label-secondary)', opacity: 0.8 } }),
@@ -2456,11 +2753,11 @@ window.__ModuleLoader__.load({
         h('div', {
           style: {
             flex: 1, minHeight: 0, display: 'grid', gap: '10px',
-            gridTemplateColumns: selectedRuleRow ? 'minmax(0, 1fr) minmax(280px, 340px)' : 'minmax(0, 1fr)',
+            gridTemplateColumns: !checkup && selectedRuleRow ? 'minmax(0, 1fr) minmax(280px, 340px)' : 'minmax(0, 1fr)',
           },
         },
-        evolutionViewActive === 'graph' ? evolutionGraphPane : evolutionListPane,
-        evolutionDetailPane),
+        checkup ? evolutionCheckupPane : (evolutionViewActive === 'graph' ? evolutionGraphPane : evolutionListPane),
+        checkup ? null : evolutionDetailPane),
       );
 
       const palaceLoose = activeTab === 'memory' && viewModeOf(display, memoryView) === 'palace' && !selectedMemory;
@@ -2528,12 +2825,14 @@ window.__ModuleLoader__.load({
           update: list.filter((item) => item.exposure === 'update'),
         };
       }, [refs]);
+      const [explainOn, setExplainOn] = React.useState(explainModeOf(sessionId));
+      React.useEffect(() => watchExplain(() => setExplainOn(explainModeOf(sessionId))), [sessionId]);
       const noTriggerReason = typeof props.noTriggerReason === 'string' && props.noTriggerReason
         ? props.noTriggerReason
         : (typeof refs.noTriggerReason === 'string' ? refs.noTriggerReason : '');
       if (!sessionId && refs.length === 0) return null;
       if (groups.found.length === 0 && groups.provided.length === 0 && groups.update.length === 0) {
-        return noTriggerReason
+        return explainOn && noTriggerReason
           ? h('div', { style: TAIL }, h(RefSection, { label: '搜索命中', tone: 'found', items: EMPTY, sessionId, turnKey: turn, noTriggerReason }))
           : null;
       }
@@ -2551,7 +2850,7 @@ window.__ModuleLoader__.load({
 
     // 测试缝：Node 里验引用投影，浏览器里没有任何副作用。
     if (typeof globalThis.__LITE_MEMORY_TEST__ === 'function') {
-      globalThis.__LITE_MEMORY_TEST__({ metaOf, citationOf, citationsOfMeta, citationsOfTurn, dedupe, undoRefOf, graphOf, ruleGraphOf, processingStatusOf, currentBodyOf, historyDiffsOf, MemoryPanel, MemoryGraph, MemoryPalace, TurnMemory, RefSection, displayKeyOf, readDisplaySettings, writeDisplaySettings, graphViewOf, viewModeOf, filterRecords, projectionOf, failureStateOf, evidenceTextOf, evidenceMetaOf, palaceRoomsOf, palaceRoomPageOf, palacePageWindow, palaceToggleOf, palaceMotionOf, palaceRoomIdOf });
+      globalThis.__LITE_MEMORY_TEST__({ metaOf, citationOf, citationsOfMeta, citationsOfTurn, dedupe, undoRefOf, graphOf, ruleGraphOf, processingStatusOf, currentBodyOf, historyDiffsOf, MemoryPanel, MemoryGraph, MemoryPalace, TurnMemory, RefSection, displayKeyOf, readDisplaySettings, writeDisplaySettings, graphViewOf, viewModeOf, filterRecords, projectionOf, failureStateOf, evidenceTextOf, evidenceMetaOf, palaceRoomsOf, palaceRoomPageOf, palacePageWindow, palaceToggleOf, palaceMotionOf, palaceRoomIdOf, refMetaOf, explainKeyOf, explainModeOf, setExplainMode, recallLineOf, agoLabel, checkupOf, titleCountsOf, rowKeyOf, rowKeepFlags, Row });
     }
 
     return {