dsh-lite-memory 0.18.19 → 0.18.26

package/TRIGGERS.md

@@ -16,7 +16,7 @@
 - 写：用户明确要求；用户自己的话已经是长期规则（「以后都这样 / 别再 X」）时直接存，不先问；或用户对某条建议点了「保留」。
 - 建议：一条经验能跨会话复用、又只存在于用户嘴里（偏好、惯例、踩过的坑），且同一项目 48 小时内没建议过。只出按钮，不写「要不要记」这种问句——问句要用户打字，按钮不要。
 - 不写：`1+1=2` 这种常识、一次性任务参数、能从仓库直接读到的正文；凭据只记位置与调用方式。
-- 自动命中：用户这句话与某条记忆的标题、旧标题、标签、触发词或摘要真有重合、且分数过线时，这一步的运行时上下文里多一段「已有记忆可能相关」——最多三条标题加 id，普通卡片与实验规则共用 3 条 / 1200 字节预算，正文仍要 `memory_read`。只有当前任务条件判为 `ok` 的条目能进；条件没确认或明确不符的既不进自动注入，也不进检索结果，检索只在全都被挡时说明「有相关的项目记忆，但适用条件还没确认 / 当前任务明确不适用」。没重合为空字符串，整条索引不进上下文，也不改 hits / lastUsed，更不落盘。同一句话只算一次；换句话重新算。
+- 自动命中：用户这句话与某条记忆的标题、旧标题、标签、触发词或摘要真有重合、且分数过线时，这一步的运行时上下文里多一段「已有记忆可能相关」——最多三条标题加 id，普通卡片与实验规则共用 3 条 / 1200 字节预算，正文仍要 `memory_read`。只有当前任务条件判为 `ok` 的条目能进；条件没确认或明确不符的既不进自动注入，也不进检索结果，检索只在全都被挡时说明「有相关的项目记忆，但适用条件还没确认 / 当前任务明确不适用」。没重合为空字符串，整条索引不进上下文，也不改 hits / lastUsed，更不落盘。用户这句话没提到动作、一张卡都没命中时，再用上一轮助手的话和工具调用里的实词补一次有界查询（预算不变）；补不到就保留第一次的「为什么没提醒」。同一句话只算一次；换句话重新算。
 
 ## 触发后长什么样
 

package/client.js

@@ -94,7 +94,7 @@ window.__ModuleLoader__.load({
         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',
+        origin: meta.origin === 'project_evolution' || meta.origin === 'model_drafted' ? meta.origin : 'user_explicit',
         kind,
         exposure: kind === 'memory-save' || kind === 'memory-forget' ? 'update' : 'reference',
         /** 条目类型：读正文看 recordKind，检索看 ref 自己的 kind；工具名不是类型。 */
@@ -568,12 +568,32 @@ window.__ModuleLoader__.load({
     };
 
     const versionLine = (shown) => {
-      const scope = shown.scopeLabel || (shown.scope === 'global' ? '全局' : '项目');
+      /** 项目名只当分层后缀：光写目录名会被当成记忆标题。 */
+      const scope = shown.scope === 'global' ? '全局'
+        : shown.scopeLabel ? `项目 · ${shown.scopeLabel}` : '项目';
       const archived = shown.status === 'archived' ? ' · 已归档' : '';
       const processing = processingStatusOf(shown.processingStatus ? { processingStatus: shown.processingStatus } : shown);
       return `${scope}${archived}${processing ? ` · ${PROCESSING_LABEL[processing]}` : ''}`;
     };
 
+    /** 展开的正文紧跟被点的那条；顺序由列表决定，不挂在一段末尾。 */
+    const refSectionRowsOf = (items, shown, renderRow, renderDetail) => {
+      const rows = [];
+      for (const item of items) {
+        rows.push(renderRow(item));
+        if (shown && shown.ref && shown.key === item.key && shown.ref.revision === item.revision) rows.push(renderDetail(item));
+      }
+      return rows;
+    };
+
+    /** 正文抬头永远是记忆标题；项目/全局只做下面的来源行。 */
+    const refDetailTitleOf = (shown) => {
+      const title = shown && shown.ref && typeof shown.ref.title === 'string' ? shown.ref.title.trim() : '';
+      if (title) return title;
+      const fallback = shown && typeof shown.title === 'string' ? shown.title.trim() : '';
+      return fallback || '记忆';
+    };
+
     /**
      * 引用三层的色调：中性 / 强调 / 成功。
      * 三档色阶：中性 / 强调 / 成功；正文用主文本色。
@@ -599,7 +619,8 @@ window.__ModuleLoader__.load({
     };
     const refMetaOf = (item) => {
       /** 会话里只标层与来源：类型留给面板和工具，不占引用行的宽度。 */
-      const layer = `${item.scope === 'global' ? '[全局]' : '[项目]'}${item.origin === 'project_evolution' ? '[自进化]' : ''}`;
+      /** 来源只标注信任差别：自进化规则与模型整理稿都不会因此升级层级。 */
+      const layer = `${item.scope === 'global' ? '[全局]' : '[项目]'}${item.origin === 'project_evolution' ? '[自进化]' : item.origin === 'model_drafted' ? '[模型]' : ''}`;
       const parts = [];
       const ago = agoLabel(item.updated);
       if (ago) parts.push(ago);
@@ -624,8 +645,9 @@ window.__ModuleLoader__.load({
         onMouseEnter: () => setHover(true),
         onMouseLeave: () => setHover(false),
         onClick: props.onShow, // ui-copy-ignore
-        'aria-label': `查看记忆 ${item.title || '记忆'}${reason ? `，${reason}` : ''}`,
-        title: reason ? `${item.title || '记忆'}，${reason}` : (item.title || '记忆'),
+        'aria-expanded': Boolean(props.active),
+        'aria-label': `${props.active ? '收起' : '查看'}记忆 ${item.title || '记忆'}${reason ? `，${reason}` : ''}`,
+        title: props.active ? `收起 ${item.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',
@@ -674,8 +696,11 @@ window.__ModuleLoader__.load({
         setOpen(false);
       };
       const show = (item) => {
-        if (shown && shown.key === item.key) {
-          close();
+        /** 再点同一条只收起正文，列表留着，方便接着看别的。 */
+        if (shown && shown.key === item.key && shown.ref && shown.ref.revision === item.revision) {
+          generation.current += 1;
+          setShown(null);
+          setNote('');
           return;
         }
         const request = generation.current + 1;
@@ -710,20 +735,13 @@ window.__ModuleLoader__.load({
           });
         });
       };
-      const rows = open ? items.map((item) => h(RefRow, {
-        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.key === shown.key && item.revision === shown.ref.revision)
-        ? h('div', { style: { ...REF_BODY, borderLeft: `2px solid ${tone}` } },
+      const detail = shown && shown.ref
+        ? h('div', { style: { ...REF_BODY, margin: '2px 0 4px 7px', padding: '2px 2px 4px 10px', borderLeft: `2px solid ${tone}` } },
           shown.loading ? h('span', { style: REF_META }, '读取中…') : null,
-          shown.gone ? h('span', { style: REF_META }, '这条记忆已删除') : null,
+          shown.gone ? h('span', { style: REF_META }, '这条记忆已经不在这里了') : null,
           shown.invalid ? h('span', { style: REF_META }, '读不到正文，点名字重试') : null,
           !shown.loading && !shown.gone && !shown.invalid ? h(React.Fragment, null,
-            shown.title && shown.title !== shown.ref.title
-              ? h('div', { style: { fontSize: '12px', lineHeight: '1.55', fontWeight: 600 } }, shown.title)
-              : null,
+            h('div', { style: { fontSize: '13px', lineHeight: '1.5', fontWeight: 600, wordBreak: 'break-word' } }, refDetailTitleOf(shown)),
             h('div', { style: REF_META }, versionLine(shown)),
             shown.when ? h('div', { style: REF_META }, shown.when) : null,
             shown.body
@@ -734,6 +752,13 @@ window.__ModuleLoader__.load({
           note ? h('span', { style: REF_META }, note) : null,
         )
         : null;
+      const rows = open
+        ? refSectionRowsOf(items, shown, (item) => h(RefRow, {
+          key: `${item.key}|${item.revision}`, // ui-copy-ignore
+          item, tone, active: Boolean(shown && shown.ref && shown.key === item.key && shown.ref.revision === item.revision),
+          onShow: () => show(item),
+        }), () => detail)
+        : [];
       return h('div', { style: DOCK, 'data-memory-section': props.label },
         h('button', {
           type: 'button',
@@ -752,7 +777,6 @@ window.__ModuleLoader__.load({
         h(RefChevron, { open }),
         ),
         ...rows,
-        detail,
       );
     };
 
@@ -870,10 +894,22 @@ window.__ModuleLoader__.load({
       explainBus.add(listener);
       return () => explainBus.delete(listener);
     };
+    /** 召回回执只说“多久以前”，不跟列表的“更新”混用。 */
+    const shortAgo = (value) => {
+      const at = Date.parse(value);
+      if (!Number.isFinite(at)) return '';
+      const minutes = Math.floor((Date.now() - at) / 60_000);
+      if (minutes < 1) return '刚刚';
+      if (minutes < 60) return `${minutes} 分钟前`;
+      const hours = Math.floor(minutes / 60);
+      if (hours < 24) return `${hours} 小时前`;
+      const days = Math.floor(hours / 24);
+      return days < 30 ? `${days} 天前` : '';
+    };
     /**
      * 面板只说判断结果，不说内部原因码；条数来自上一次自动召回的回执。
      */
-    const recallLineOf = (receipt) => {
+    const recallTextOf = (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;
@@ -882,12 +918,20 @@ window.__ModuleLoader__.load({
         case 'hit': return cards > 0 ? `上次自动提醒 ${cards} 条` : '';
         case 'budget': return `上次没提醒，${related}本轮自动提醒已用满`;
         case 'needs_context': return `上次没提醒，${related}适用条件未确认`;
+        case 'conflict': return `上次没提醒，${related}存在冲突的结论`;
         case 'no_overlap': return '上次没提醒，没有匹配的记忆';
+        case 'expired': return '上次没提醒，相关内容已经过期';
         case 'memory_off': return '上次没提醒，记忆已关闭';
         case 'tools_only': return '上次没提醒，只在你问时检索';
         default: return '';
       }
     };
+    /** 回执可能是上一轮甚至更早的：带上时间，别让旧提醒看起来像刚发生。 */
+    const recallLineOf = (receipt) => {
+      const text = recallTextOf(receipt);
+      const when = receipt && typeof receipt === 'object' ? shortAgo(receipt.at) : '';
+      return text && when ? `${text} · ${when}` : text;
+    };
     /** 功能关闭时视图统一回列表，不保留一个画不出来的页签。 */
     const graphViewOf = (enabled, view) => (enabled === true && view === 'graph' ? 'graph' : 'list');
     const viewModeOf = (display, view) => {
@@ -2194,7 +2238,7 @@ window.__ModuleLoader__.load({
         post('/lite-memory/body', { sessionId, id: selectedMemory, scopeKey: data.selected.key }).then((result) => {
           if (!live) return;
           if (result.ok && result.body && result.body.ok) {
-            if (result.body.status === 'gone') setDetailNote('这条记忆已删除');
+            if (result.body.status === 'gone') setDetailNote('这条记忆已经不在这里了');
             else setDetail(result.body);
           } else setDetailNote(failure(result, '读不到正文'));
         });
@@ -2210,6 +2254,8 @@ window.__ModuleLoader__.load({
         ? selected.control
         : (current && selected && selected.key === current.key && current.control ? current.control : { enabled: true });
       const memoryOn = control.enabled !== false;
+      const memoryMode = !memoryOn ? 'off'
+        : (control.effectiveMode === 'tool_only' || control.mode === 'tool_only' ? 'tool_only' : 'adaptive');
       const evolution = selected && selected.evolution
         ? selected.evolution
         : (current && selected && selected.key === current.key ? current.evolution : null);
@@ -2374,6 +2420,7 @@ window.__ModuleLoader__.load({
                   || !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);
+                setEditNote('已载入最新内容，再保存会覆盖它');
                 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));
@@ -2385,14 +2432,45 @@ window.__ModuleLoader__.load({
         });
       };
 
-      const toggleControl = () => {
-        if (busy || !canToggle) return;
+      /** 适用范围待确认是模型留下的不确定；人点一次就把它变成明确结论，别再让模型猜。 */
+      const confirmMemoryScope = (record) => {
+        if (busy || !canManage || !record || !record.id) return;
+        const text = currentBodyOf(detail) || '';
+        if (!text) return;
         setBusy(true);
-        post('/lite-memory/control', { sessionId, enabled: !memoryOn, operationId: newOperationId() }).then((result) => {
+        post('/lite-memory/entry', {
+          sessionId, scopeKey: selectedKey, id: record.id,
+          title: record.title || detail.title || '', body: text,
+          expectedRevision: record.revision, applicability: 'all_in_scope', conditions: [],
+        }).then((result) => {
+          if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)) return;
+          setBusy(false);
+          if (!succeeded(result)) {
+            setNote(failure(result, '适用范围没有改动'));
+            return;
+          }
+          const revision = result.body && Number.isInteger(result.body.revision) ? result.body.revision : record.revision;
+          setDetail((prev) => (prev ? { ...prev, applicability: 'all_in_scope', conditions: [], revision } : 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, applicability: 'all_in_scope', conditions: [], revision } : row));
+            return { ...prev, selected: { ...prev.selected, records } };
+          });
+        });
+      };
+
+      const setControlMode = (mode) => {
+        if (busy || !canToggle || mode === memoryMode) return;
+        setBusy(true);
+        const body = mode === 'off'
+          ? { sessionId, enabled: false, operationId: newOperationId() }
+          : { sessionId, enabled: true, mode, operationId: newOperationId() };
+        post('/lite-memory/control', body).then((result) => {
           if (!alive.current || (selectedKey && scopeRef.current !== selectedKey)) return;
           setBusy(false);
           if (succeeded(result)) load(selectedKey);
-          else setNote(failure(result, '开关没有改动'));
+          else setNote(failure(result, '触发方式没有改动'));
         });
       };
 
@@ -2460,6 +2538,25 @@ window.__ModuleLoader__.load({
         } : undefined,
       );
 
+      const modeChoices = () => h('div', {
+        style: { display: 'flex', alignItems: 'center', gap: '8px', minWidth: 0 },
+      },
+      h('span', { style: { fontSize: '12px', lineHeight: '20px', fontWeight: 600, whiteSpace: 'nowrap' } }, '记忆'),
+      h('div', {
+        role: 'radiogroup', 'aria-label': '记忆触发方式',
+        style: { display: 'flex', gap: '2px', padding: '2px', borderRadius: '8px', background: 'var(--dsw-alias-bg-layer-2)', border: '1px solid var(--dsw-alias-border-l1)' },
+      },
+      [['adaptive', '自动提醒'], ['tool_only', '仅搜索'], ['off', '关闭']].map(([key, text]) => h('button', {
+        key, type: 'button', role: 'radio', 'aria-checked': memoryMode === key, disabled: busy || !canToggle,
+        onClick: canToggle && !busy ? () => setControlMode(key) : undefined,
+        style: {
+          padding: '2px 7px', minHeight: '22px', border: 'none', borderRadius: '6px',
+          background: memoryMode === key ? 'var(--dsw-alias-bg-layer-1)' : 'transparent',
+          color: 'inherit', fontSize: '11px', lineHeight: '18px', fontWeight: memoryMode === key ? 600 : 400,
+          cursor: canToggle && !busy ? 'pointer' : 'default', whiteSpace: 'nowrap',
+          opacity: memoryMode === key || canToggle ? 1 : 0.55,
+        },
+      }, text))));
       const switchItem = (label, hint, on, disabled, onClick) => h('div', {
         style: { display: 'flex', flexDirection: 'column', gap: '1px', minWidth: 0, opacity: disabled && !on ? 0.55 : 1 },
       },
@@ -2476,7 +2573,7 @@ window.__ModuleLoader__.load({
       globalView
         ? h('div', { style: { ...PANEL_MUTED, lineHeight: '20px' } }, '全局记忆只读')
         : h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(190px, 1fr))', gap: '4px 18px' } },
-          switchItem('启用记忆', memoryOn ? '读取项目和全局记忆' : '记忆已关闭，内容只读', memoryOn, busy || !canToggle, toggleControl),
+          modeChoices(),
           switchItem('自进化', evolutionOn ? '实验功能，会增加 token 消耗' : '从反馈里整理经验', evolutionOn, busy || !evolution || !canToggle || !memoryOn, toggleEvolution), // ui-copy-ignore 用户指定文案
           showSettings ? displayToggle('启用图谱', 'graph') : null,
           showSettings ? displayToggle('启用记忆宫殿', 'palace') : null,
@@ -2549,12 +2646,23 @@ window.__ModuleLoader__.load({
                 h('div', { style: { flex: 1, minWidth: 0, fontSize: '13px', lineHeight: '1.45', fontWeight: 600, wordBreak: 'break-word' } }, detail.title),
                 h(Action, { onClick: () => setSelectedMemory('') }, '关闭'),
               ),
-              h('div', { style: PANEL_MUTED }, `${KIND_LABEL[detailRecord && detailRecord.kind] || '记忆'} · ${detail.scopeLabel || ''}${detailProcessing ? ` · ${PROCESSING_LABEL[detailProcessing]}` : ''}`),
+              h('div', { style: PANEL_MUTED }, `${KIND_LABEL[detailRecord && detailRecord.kind] || '记忆'} · ${detail.scopeLabel || ''}${detailRecord && detailRecord.origin === 'model_drafted' ? ' · [模型]' : ''}${detailProcessing ? ` · ${PROCESSING_LABEL[detailProcessing]}` : ''}`),
               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,
               memoryEditor,
               editingMemory ? null : h('div', { style: { fontSize: '12px', lineHeight: '1.65', whiteSpace: 'pre-wrap', wordBreak: 'break-word' } }, currentBodyOf(detail) || '没有正文'),
+              !editingMemory && detailRecord && detailRecord.applicability === 'unresolved'
+                ? h('div', { style: { display: 'flex', alignItems: 'center', gap: '8px', flexWrap: 'wrap' } },
+                  h('span', { style: PANEL_MUTED }, '适用范围待确认'),
+                  canManage
+                    ? h(Action, {
+                      disabled: busy || !currentBodyOf(detail),
+                      'aria-label': '标为所有任务都适用',
+                      onClick: () => confirmMemoryScope(detailRecord),
+                    }, '都适用')
+                    : null)
+                : null,
               editingMemory ? null : h(DetailExtras, { payload: detail }),
               !editingMemory && detailRecord && canManage
                 ? h('div', { style: { display: 'flex', alignItems: 'center', gap: '12px', flexWrap: 'wrap', paddingTop: '2px' } },
@@ -2850,7 +2958,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, refMetaOf, explainKeyOf, explainModeOf, setExplainMode, recallLineOf, agoLabel, checkupOf, titleCountsOf, rowKeyOf, rowKeepFlags, Row });
+      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, refSectionRowsOf, refDetailTitleOf, versionLine, titleCountsOf, rowKeyOf, rowKeepFlags, Row });
     }
 
     return {

package/docs/CONVENTIONS.md

@@ -36,9 +36,12 @@
 - 归档条目、实验来源（普通自动召回不碰，实验规则单独走 `experimentFor`）、`legacy_unreviewed` 全部排除。
 - 同一 `topicKey` 槽位只让胜出的记录进；槽位内冲突或条件未知的整组不进自动召回，不猜哪条对。
 - 默认值 `__tasks.defaults` 会参与任务上下文，但只是「范围提示」，不是把某条记忆设成必用。
+- 「继续 / 然后呢」这类续说句没有检索词时，沿用同会话上一轮原话；别把新的短问题接到旧查询上。
 
 **预算**：普通卡片与实验规则**共用**一份账本：最多 3 张卡片、最终拼接文本最多 1200 字节。字节量的是 provider 最终看到的完整文本（含标题行、ID、换行、两段之间的空行），不是单张正文。超预算时跳过这张，不截半句、不把标题留在模型侧。
 
+**实际 Token**：自动提示最多 3 条、1200 字节，不随全库条数线性增长；总量仍取决于命中频率、模型调用步数、主动读取正文，以及实验性自进化的整理次数。别把「每轮有上限」说成「不增加消耗」。
+
 **失败**：
 
 - 准备超过 `RECALL_DEADLINE_MS`、被取消、投影期间开关/代次变了：整批回退，预算退还，下一轮重新来。绝不发布半旧卡片。
@@ -77,7 +80,13 @@
 - `topicKey` 是槽位；同一槽位只允许一条当前胜出记录，冲突时先让人选，不自动合并。
 - `kind` 只影响展示分组，不参与检索和可用性判断。
 
-**范围路由**：模型给的 `scope` 是提案，不是命令。设备事实必须带设备条件（`machine` / `targetOs` / `runtime` / `shell` 至少一个）；正文或依据里出现本机路径、回环地址、端口的「通用流程」，先留在项目层或问一次条件，不直接写全局。
+**范围路由**：模型给的 `scope` 是提案，不是命令。
+
+- 显式 `scope="global"` 表示「用户在这一次对话里要求存全局」，只有用户确实这么说才传；模型自己觉得通用不是理由。显式全局不再因为缺少 `evidenceRef` 被降级。
+- 仍然会拦住的两类：设备事实没有条件（`machine` / `targetOs` / `runtime` / `shell` 至少一个），以及正文或依据里出现本机路径、回环地址、端口的「通用流程」——后者换台机器/换个项目就不成立，留在项目层。
+- `memoryClass="project_fact"` 不因写了 `global` 就变全局：项目事实换个项目本来就不成立。
+- 按类别推导（没有显式 `scope`）保持更严：`portable_procedure` 没有 `evidenceRef` 就落项目层。
+- 每次降级都要能解释：只在降级时返回 `scopeNote` 一行，说明为什么没进全局、怎么改才进得去；正常落全局或落项目不带这行。
 
 **限额与腾位**：每层活跃条目软上限 200、硬上限 1000；单条正文 4096 字节；单层总字节 1 MiB。到硬上限时把最久没被读的活跃条目移进归档，并在结果里写明「已归档「标题」腾位」，不拒绝新记忆；单条正文超限只报错、不截断。
 

package/docs/RELEASE-0.18.16.md

@@ -0,0 +1,6 @@
+# 0.18.16：适用范围由人确认一次
+
+- 面板详情里，适用范围还是「待确认」的记忆多一个「都适用」动作：标题、正文、版本照旧带上，只补适用范围。
+- 确认后写入 `all_in_scope` 和空条件；这条记忆才进入自动提醒，不再要求模型再猜一次。
+- 服务端只接受三档取值，其余拒绝；确认按版本写，过期仍返回 409，不覆盖别处改动。
+- 适用范围不再只有模型能补；人看一眼就能定下来，别条不受影响。

package/docs/RELEASE-0.18.17.md

@@ -0,0 +1,6 @@
+# 0.18.17：沾一个词不再算命中
+
+- 查询里有两个以上中文实词时，只重合一个词就不再给标题 / 关键词分：「启动服务器」不会带出「启动失败」那条改包名的记忆。
+- 单实词查询（「发版」「样式」）不受影响，照常召回；没有抬高全局阈值，同义说法仍能进提示。
+- 中文切词补出来的二元组先去重；只有切词结果全是单字时才补，避免重复词把命中数虚增。
+- 中英混排查询（「排查 PostgreSQL 连接池报错」）按中文词边界补二元组，不会因为英文词整段丢掉中文。

package/docs/RELEASE-0.18.18.md

@@ -0,0 +1,7 @@
+# 0.18.18：触发方式按项目选
+
+- 面板把「启用记忆」换成一排选择：自动提醒 / 仅搜索 / 关闭。选「仅搜索」后不再主动弹卡片，工具检索照常；选「关闭」等同原来的总开关，写入与学习一起停。
+- 触发方式存在项目自己的状态里，不改插件配置，也不影响其他项目；没有选过的项目仍跟随插件默认。改方式会换代次，关闭前排队的召回不会补交。
+- 记忆开关和触发方式在同一把锁里落盘，不会只改一半；关闭时切换方式不会顺手把记忆打开。
+- 编辑碰到别人先改过时，面板载入最新正文并说明「已载入最新内容，再保存会覆盖它」，不再只报一句通用失败。
+- 引用点开时条目已归档或移走，改说「这条记忆已经不在这里了」，不再误称已删除。

package/docs/RELEASE-0.18.19.md

@@ -0,0 +1,7 @@
+# 0.18.19
+
+- 保存失败回执走统一形状：带 `error` 字段、过输出 schema，界面显示具体原因，不再出现 `saved "undefined"`。
+- `memory_read` 的关联清单带上标题，关联卡片不再显示 undefined。
+- 作用域推断收窄：「所有口播」「一律」不再被当成全项目授权；无可信任务条件时留待确认。
+- 实验规则参与本轮相关度排序，和普通记忆共用 3 张卡片 / 1200 字节预算；条件已满足的规则仍按绑定注入。
+- 契约测试按已注册 `output.schema` 校验成功与失败回执。

package/docs/RELEASE-0.18.20.md

@@ -0,0 +1,4 @@
+# 0.18.20
+
+- 读取与检索回执带上来源：模型整理稿显示 `[模型]`，只作信任标记，不改变项目/全局层级；自进化仍是 `[自进化]`。
+- 自动提醒的未命中原因细分：条件未确认与结论冲突分别给出，不再一律说「没有匹配」。

package/docs/RELEASE-0.18.21.md

@@ -0,0 +1,4 @@
+# 0.18.21
+
+- 自动提示的词面匹配按整词比对英文：查询里的英文词没出现时，不再因为二元组恰好重合把不相关的记忆带进来；中文重合仍照常计分。
+- 中英混排查询保留中文命中：英文专名没出现在条目里，不会把中文部分当成的命中一起清零。

package/docs/RELEASE-0.18.22.md

@@ -0,0 +1,5 @@
+# 0.18.22
+
+- 自动召回跟上「继续」：只有明确的续说句（继续 / 接着 / 然后 / go on / continue）沿用同会话上一轮原话，短问题不拼旧上下文。
+- 召回回执按真正发出的内容记：投影后过期、发出时被撤掉的卡片不再在面板上算作「已提醒」；全部过期时显示「相关内容已经过期」。
+- 面板原因文案补 `expired` 一档，不再把过期说成「没有匹配的记忆」。

package/docs/RELEASE-0.18.23.md

@@ -0,0 +1,5 @@
+# 0.18.23
+
+- 回执只在内容真正发出后保留：投影完成后被超时、取消、换代或回滚挡下的卡片，不再在面板上显示「已提醒」。
+- 取消请求时同步撤掉回执（`clearRecall`），模型没见过的提醒不留在面板上。
+- 过期/被取代的旧记录不参与同名合并、也不触发 `needsResolution` 的回归断言补齐（store 测试 73 条）。

package/docs/RELEASE-0.18.24.md

@@ -0,0 +1,3 @@
+# 0.18.24
+
+- 面板的召回回执带上「多久以前」：旧提醒不再看起来像刚发生，也不再借列表的「更新」字样。

package/docs/RELEASE-0.18.25.md

@@ -0,0 +1,5 @@
+# 0.18.25
+
+- 会话末尾的记忆列表：展开的正文直接放在被点的那条下面，标题用记忆自己的标题；再点一次只收起正文，不再把整个列表关掉。
+- 用户明确说「存全局」时，不再因为模型自己觉得不够通用而被悄悄降级；本机路径/端口和项目事实仍留在项目层，并给出降级说明。
+- 预防型记忆在用户只说「这个怎么弄」时不漏：用户原话没命中，就用上一轮助手的话和工具名补一次有界查询，仍受同一份召回预算。

package/docs/RELEASE-0.18.26.md

@@ -0,0 +1,5 @@
+# 0.18.26
+
+- 只在本机成立、但跨项目复用的命令/流程（例如本机 npm 包装命令）：声明 machine 或 runtime 条件后可以进全局层，换台机器条件不成立就不会拿出来用；仍然写死本机路径/端口又没声明环境的，继续留在项目层。
+- 显式存全局的降级说明补了一句怎么改：补机器条件后可以存全局，不用把规则改写成一个不存在的通用说法。
+- CI 稳定性：召回投影的耗时上限可以在测试里放宽（CI 冷启动偶尔超过 150ms，逻辑断言不该被「这轮先不注入」判失败）；旧库正文比对按行尾归一（Windows 检出把 LF 转成 CRLF）。Windows 与 Ubuntu 六格矩阵全绿。