@stardustlc/dsh-dream 0.8.0 → 0.9.0

package/lib/client.js

@@ -16,6 +16,14 @@ const h = React.createElement;
 // Interface language follows DSH; user content and stored records keep their original text.
 let localeService;
 const EN = Object.freeze({
+  '已到复核时间': 'Review deadline reached',
+  '最近取回：': 'Last retrieved: ',
+  '取回仅表示提供参考，不等于重新核验。': 'Retrieval means reference exposure, not renewed verification.',
+  '偏好': 'Preference', '流程': 'Procedure', '避坑': 'Pitfall', '事实': 'Fact',
+  '项目与主题': 'Project and topic', '全部待核实': 'All awaiting review',
+  '批量采纳': 'Accept selected', '批量驳回': 'Reject selected',
+  '选中候选：': 'Select candidate: ', '已完成所选候选的审阅。': 'Selected candidates reviewed.',
+  '先展开核对来源、条件与例外；只批量处理同范围、同主题且无冲突的候选。': 'Expand sources, conditions and exceptions first. Batch review requires candidates with the same scope and topic and no conflicts.',
   "自动整理的内容在「经验」页待审阅；日记可让助手复盘时单独生成。": "Automatically collected lessons await review in Lessons. Ask the assistant to reflect when you want a separate journal entry.",
   "查看待审阅经验": "Review candidate lessons",
   "请求失败（HTTP ": "Request failed (HTTP ",
@@ -631,12 +639,16 @@ function normalizeKnowledge(value, now, limit) {
     const title = trimmedText(raw.title);
     const action = trimmedText(raw.action);
     if (title === "" && action === "") continue;
-    const state = normalizeLessonState(raw.state);
+    const state = raw.reviewDue === true && raw.state === 'usable' ? 'stale' : normalizeLessonState(raw.state);
     byState[state] = (byState[state] || 0) + 1;
     if (rows.length >= cap) continue;
     const lastValidatedAt = trimmedText(raw.lastValidatedAt);
     rows.push({
       id: trimmedText(raw.id),
+      kind: trimmedText(raw.kind),
+      groupKey: JSON.stringify([raw.kind, raw.scope?.global === true, raw.scope?.projectId ?? null, raw.scope?.workspaceRoot ?? null]),
+      reviewDue: raw.reviewDue === true,
+      lastRetrievedAt: trimmedText(raw.lastRetrievedAt),
       title: title !== "" ? title : action,
       action: action,
       when: trimmedText(raw.when),
@@ -661,9 +673,9 @@ function normalizeKnowledge(value, now, limit) {
       workspaceRoot: typeof raw.scope === "object" && raw.scope !== null ? trimmedText(raw.scope.workspaceRoot) : "",
       conflictIds: Array.isArray(raw.conflictIds) ? raw.conflictIds.filter(function (id) { return typeof id === "string" && id.trim() !== ""; }) : [],
       conflicts: Array.isArray(raw.conflictIds) ? raw.conflictIds.filter(function (id) { return typeof id === "string" && id.trim() !== ""; }).map(function (id) { return { id: id, title: lessonTitles.get(id) || t("未加载的经验（") + id + "）" }; }) : [],
-      holdReason: trimmedText(raw.holdReason) !== "" ? trimmedText(raw.holdReason) : holdReasonOf(raw),
-      holdReasonLabel: trimmedText(raw.holdReasonLabel) !== "" ? t(trimmedText(raw.holdReasonLabel)) : skippedReasonLabel(holdReasonOf(raw)),
-      bridgeable: bridgeableOf(raw.state) && trimmedText(raw.id) !== "",
+      holdReason: raw.reviewDue === true ? 'review-due' : trimmedText(raw.holdReason) !== "" ? trimmedText(raw.holdReason) : holdReasonOf(raw),
+      holdReasonLabel: raw.reviewDue === true ? t('已到复核时间') : trimmedText(raw.holdReasonLabel) !== "" ? t(trimmedText(raw.holdReasonLabel)) : skippedReasonLabel(holdReasonOf(raw)),
+      bridgeable: raw.reviewDue !== true && bridgeableOf(raw.state) && trimmedText(raw.id) !== "",
       candidate: state === "candidate",
       disputed: state === "disputed",
     });
@@ -1367,6 +1379,7 @@ function KnowledgeRow(props) {
     ]),
     h("div", { className: "dshd-kmeta", key: "m" }, [
       h("span", { className: "dshd-klast", key: "l", title: row.lastTitle }, t("最近核验：") + row.lastText),
+      row.lastRetrievedAt ? h('span', { className:'dshd-klast', key:'retrieved', title:t('取回仅表示提供参考，不等于重新核验。') }, t('最近取回：') + formatDate(row.lastRetrievedAt) + ' ' + formatTime(row.lastRetrievedAt)) : null,
     ]),
     h("div", { className: "dshd-kbody", key: "body" }, [
       h("div", { key: "when" }, t("何时用：") + (row.when !== "" ? row.when : t("未标注适用条件"))),
@@ -1451,9 +1464,30 @@ function KnowledgeCard(props) {
 function ReviewQueueCard(props) {
   const vm = props.vm;
   const [pageSize, setPageSize] = useState(5);
-  const rows = vm !== null && vm !== undefined && Array.isArray(vm.rows)
+  const [group, setGroup] = useState('');
+  const [selected, setSelected] = useState([]);
+  const [pending, setPending] = useState(false);
+  const [failure, setFailure] = useState('');
+  const [retry, setRetry] = useState(null);
+  const all = vm !== null && vm !== undefined && Array.isArray(vm.rows)
     ? vm.rows.filter(function (row) { return HELD_STATES.indexOf(row.state) !== -1; })
     : [];
+  const rows = group === '' ? all : all.filter(row => row.groupKey === group);
+  const groups = [...new Map(all.map(row => [row.groupKey, row.scopeLabel + ' · ' + t(({preference:'偏好',procedure:'流程',pitfall:'避坑',fact:'事实'})[row.kind] || row.kind)]))];
+  const picked = rows.filter(row => selected.includes(row.id) && row.candidate && !row.conflictIds.length);
+  async function batch(action) {
+    if (pending || !picked.length) return;
+    const items = picked.map(row => ({ lessonId:row.id,expectedRevision:row.revision }));
+    const signature = JSON.stringify({action,items});
+    const id = retry?.signature === signature ? retry.id : crypto.randomUUID();
+    setRetry({signature,id}); setPending(true); setFailure('');
+    try {
+      await postAction({operation:'review-batch',action,items,requestId:id});
+      setSelected([]); setRetry(null);
+      props.onChanged?.(t('已完成所选候选的审阅。'));
+    } catch(error) { setFailure(displayError(error)); }
+    finally { setPending(false); }
+  }
   const head = function (extra) {
     return h("div", { className: "dshd-khead", key: "head" }, [
       h("h4", { key: "t" }, t("待核实")),
@@ -1474,13 +1508,20 @@ function ReviewQueueCard(props) {
   }
   return h("section", { className: "dshd-card dshd-kcard" }, [
     head(rows.length === 0 ? null : h("span", { className: "dshd-hint", key: "c" }, String(rows.length) + t(" 条待核实"))),
+    all.length ? h('label', {key:'groups',className:'dshd-note'}, [t('项目与主题'), ' ', h('select', {'aria-label':t('项目与主题'),value:group,disabled:pending,onChange:event=>{setGroup(event.target.value);setSelected([]);setPageSize(5);}}, [h('option',{key:'all',value:''},t('全部待核实')), ...groups.map(([key,label])=>h('option',{key,value:key},label))])]) : null,
+    picked.length ? h('div',{key:'batch',className:'dshd-kcmd'}, [h(Btn,{key:'accept',disabled:pending || new Set(picked.map(row=>row.groupKey)).size>1,onClick:()=>batch('accept')},t('批量采纳') + ' (' + picked.length + ')'),h(Btn,{key:'reject',disabled:pending || new Set(picked.map(row=>row.groupKey)).size>1,onClick:()=>batch('reject')},t('批量驳回') + ' (' + picked.length + ')')]) : null,
+    failure ? h('p',{key:'failure',role:'alert'},failure) : null,
+    all.length ? h('p',{key:'batch-note',className:'dshd-note'},t('先展开核对来源、条件与例外；只批量处理同范围、同主题且无冲突的候选。')) : null,
     rows.length === 0
       ? h("div", { className: "dshd-kempty", key: "empty" }, [
           h("div", { className: "dshd-kempty-title", key: "t" }, t("没有待核实的经验")),
           h("p", { className: "dshd-kempty-body", key: "b" }, reviewQueueEmptyState()),
         ])
       : h("div", { className: "dshd-krows", key: "rows" }, rows.slice(0, pageSize).map(function (row, index) {
-          return h(KnowledgeRow, { key: row.id !== "" ? row.id : "held-" + String(index), row: row, onChanged: props.onChanged, privacy: props.privacy === true, showHoldReason: true });
+          return h('div',{key:row.id || 'held-' + index},[
+            row.candidate && !row.conflictIds.length ? h('label',{key:'select',className:'dshd-note'}, [h('input',{type:'checkbox',checked:selected.includes(row.id),disabled:pending || (!selected.includes(row.id) && selected.length >= 20),onChange:event=>setSelected(event.target.checked?[...selected,row.id]:selected.filter(id=>id!==row.id))}), ' ' + t('选中候选：') + row.title]) : null,
+            h(KnowledgeRow, { key:'row', row: row, onChanged: props.onChanged, privacy: props.privacy === true, showHoldReason: true }),
+          ]);
         })),
     rows.length > pageSize ? h(Btn, { key: "more", onClick: function () { setPageSize(pageSize + 5); } }, t("显示更多待核实经验")) : null,
     h("div", { className: "dshd-note", key: "note" }, t("这些经验默认不会作为任务建议注入。先核对来源与适用范围，再决定采纳、驳回或继续复核。")),
@@ -1615,6 +1656,7 @@ function AutomaticMemoryCard(props) {
   const [value, setValue] = useState(null);
   const [failure, setFailure] = useState(null);
   const [pending, setPending] = useState(false);
+  const [chatId, setChatId] = useState('');
   const a = function (zh, en) { return languageOf() === 'en' ? en : zh; };
   useEffect(function () {
     let alive = true, timer;
@@ -1631,12 +1673,13 @@ function AutomaticMemoryCard(props) {
     refresh();
     return function () { alive = false; clearTimeout(timer); controller.abort(); };
   }, [props.reloadToken]);
-  async function toggle(key, next) {
+  async function change(body) {
     setPending(true); setFailure(null);
-    try { const result = await postAction({ operation: 'automatic', [key]: next }); setValue(result.automatic); }
+    try { const result = await postAction(body); setValue(result.automatic); }
     catch (error) { setFailure(error); }
     finally { setPending(false); }
   }
+  const toggle = (key,next) => change({operation:'automatic',[key]:next});
   const reasons = {
     saved: a('已保存新候选，等待审阅', 'New candidates saved; review required'),
     merged: a('已合并重复经验', 'Duplicate lessons merged'),
@@ -1644,18 +1687,22 @@ function AutomaticMemoryCard(props) {
     'ordinary-chat': a('普通闲聊，已跳过', 'Ordinary chat skipped'),
     'no-source': a('缺少可见来源，已跳过', 'No visible sources; skipped'),
     'daily-budget': a('今天的整理预算已用完', 'Daily consolidation budget reached'),
-    cooldown: a('处于冷却时间，已跳过', 'Cooling down; skipped'),
+    cooldown: a('冷却中，轮次保留等待整理', 'Cooling down; queued turns retained'),
+    queued: a('已加入队列，安静后合并整理', 'Queued; consolidate after quiet time'),
     disabled: a('自动整理已暂停', 'Automatic collection paused'),
     unfinished: a('任务未正常完成，已跳过', 'Turn did not complete normally; skipped'),
     'no-model': a('当前会话尚无可用模型', 'No model route for this session'),
     recording: a('正在整理候选经验', 'Collecting candidate lessons'),
     timeout: a('整理超时，本次已停止', 'Consolidation timed out and stopped'),
-    cancelled: a('新输入或关闭操作已停止整理', 'New input or a shutdown stopped consolidation'),
+    cancelled: a('已暂停辅助调用，未完成轮次保留', 'Auxiliary call stopped; unfinished turns retained'),
     superseded: a('已有新任务，旧轮次不再整理', 'New work superseded this turn; skipped'),
     'model-error': a('模型返回失败或无法核验，请检查 DSH 模型连接', 'Model output failed or could not be verified. Check the DSH model connection.'),
     'input-limit': a('内容超过预算，已跳过', 'Input exceeds the budget; skipped'),
   };
   const last = value && value.last;
+  const chats = value?.sessions || [];
+  const chosenId = chats.some(row=>row.sessionId===chatId) ? chatId : (chats[0]?.sessionId || '');
+  const chat = chats.find(row=>row.sessionId===chosenId);
   const minutes = Math.max(0, Number(value && value.cooldownMinutes) || 0);
   const seconds = Math.ceil(minutes * 60);
   const interval = minutes < 1 ? String(seconds) + a(' 秒', seconds === 1 ? ' second' : ' seconds') : new Intl.NumberFormat(languageOf() === 'en' ? 'en-US' : 'zh-CN', { maximumFractionDigits: 2 }).format(minutes) + a(' 分钟', minutes === 1 ? ' minute' : ' minutes');
@@ -1664,19 +1711,30 @@ function AutomaticMemoryCard(props) {
     h('p', { key: 'intro' }, a('任务结束后整理可复用经验，不用记住“做梦”口令。新经验先待审阅，不自动修改项目规则。', 'Collect reusable lessons after tasks, without a trigger phrase. New lessons await review; project rules are not changed automatically.')),
     failure ? h('p', { key: 'error', role: 'alert' }, displayError(failure)) : null,
     !value ? (failure ? null : h('p', { key: 'loading' }, a('正在读取状态…', 'Loading status…'))) : h('div', { key: 'controls' }, [
-      h('p', { key: 'status', role: 'status' }, value.problem ? a('状态异常，请检查 DSH 日志。', 'Status error. Check the DSH logs.') : value.available ? (value.enabled === false ? a('自动整理已暂停', 'Automatic collection paused') : value.running ? a('正在整理', 'Consolidating') : a('已就绪，等待符合条件的任务', 'Ready; waiting for a qualifying task')) : a('当前宿主服务尚未就绪；手动工具仍可使用。', 'Host services are not ready; manual tools remain available.')),
+      h('p', { key: 'status', role: 'status' }, value.problem ? a('状态异常，请检查 DSH 日志。', 'Status error. Check the DSH logs.') : value.available ? (value.running ? a('正在整理', 'Consolidating') : value.enabled === false ? a('全局默认已暂停；聊天独立设置仍生效', 'Global collection is paused; chat overrides still apply') : a('已就绪，等待符合条件的任务', 'Ready; waiting for a qualifying task')) : a('当前宿主服务尚未就绪；手动工具仍可使用。', 'Host services are not ready; manual tools remain available.')),
       h('label', { key: 'collect', style: { display: 'block', marginBottom: '8px' } }, [
         h('input', { key: 'input', type: 'checkbox', checked: value.enabled === true, disabled: pending, onChange: event => toggle('enabled', event.target.checked) }),
-        ' ' + a('自动整理候选经验', 'Collect candidate lessons automatically'),
+        ' ' + a('默认自动整理候选经验', 'Collect candidate lessons by default'),
       ]),
       h('label', { key: 'retrieve', style: { display: 'block' } }, [
         h('input', { key: 'input', type: 'checkbox', checked: value.retrievalEnabled === true, disabled: pending, onChange: event => toggle('retrievalEnabled', event.target.checked) }),
-        ' ' + a('自动取回已采纳经验', 'Retrieve accepted lessons automatically'),
+        ' ' + a('默认自动取回已采纳经验', 'Retrieve accepted lessons by default'),
       ]),
       h('p', { key: 'budget' }, a('今天已调用模型 ', 'Model calls today: ') + String(value.callsToday ?? 0) + ' / ' + String(value.maxCallsPerDay ?? 0) + a(' 次；每次间隔至少 ', '; at least ') + interval + a('。', ' between calls.')),
+      h('p',{key:'queue'},a('待整理 ', 'Queued turns: ') + (value.pendingTurns ?? 0) + a(' 轮；安静 ', '; quiet time: ') + (value.idleSeconds ?? 60) + a(' 秒后，同项目最多合并 ', ' seconds; up to ') + (value.maxBatchTurns ?? 4) + a(' 轮。', ' turns per project in a batch.')),
+      h(Btn, { key: 'review', onClick: props.onReview }, a('待审阅 ', 'Awaiting review: ') + String(value.candidates ?? 0)),
+      h('details',{key:'advanced',className:'dshd-note'},[
+      h('summary',{key:'summary',style:{cursor:'pointer',marginTop:'10px'}},a('聊天设置与整理预算','Chat controls and consolidation limits')),
+      h(Btn,{key:'flush',disabled:pending || !value.available || value.mainTaskRunning || !value.pendingTurns,onClick:()=>change({operation:'automatic-flush'})},a('现在整理待处理轮次', 'Consolidate queued turns now')),
+      h('p',{key:'retention',className:'dshd-note'},a('手动整理仍遵守冷却和每日预算。待处理片段最多保留 24 小时、32 轮；过期 ', 'Manual consolidation respects cooldown and daily budget. Pending excerpts keep for up to 24 hours / 32 turns; expired: ') + (value.expiredTurns ?? 0) + a(' 轮，超出容量 ', '; overflow: ') + (value.overflowTurns ?? 0) + a(' 轮。', ' turns.')),
+      chat ? h('div',{key:'chat',className:'dshd-reviewform'},[
+        h('label',{key:'select'},[a('聊天记忆设置','Chat memory settings'),h('select',{'aria-label':a('聊天记忆设置','Chat memory settings'),value:chosenId,disabled:pending,onChange:event=>setChatId(event.target.value)},chats.map(row=>h('option',{key:row.sessionId,value:row.sessionId},(row.cwd || '') + ' · ' + row.sessionId.slice(0,8))))]),
+        ...[['use',a('使用记忆','Use memory')],['contribute',a('贡献记忆','Contribute memory')]].map(([key,label])=>h('label',{key},[label,h('select',{'aria-label':label,disabled:pending,value:chat[key]===null?'inherit':String(chat[key]),onChange:event=>change({operation:'automatic-chat',sessionId:chosenId,[key]:event.target.value==='inherit'?null:event.target.value==='true'})},[h('option',{key:'inherit',value:'inherit'},a('跟随全局','Follow global default')),h('option',{key:'true',value:'true'},a('仅此聊天开启','Enable for this chat')),h('option',{key:'false',value:'false'},a('仅此聊天关闭','Disable for this chat'))])])),
+        h('p',{key:'note',className:'dshd-note'},a('两个选项独立保存；关闭贡献会移除该聊天尚未整理的片段，已有经验仍保留。','Both controls persist independently. Disabling contribution removes pending excerpts for this chat; existing lessons remain.')),
+      ]) : null,
       h('p', { key: 'cost', className: 'dshd-note' }, a('沿用当前会话模型，会消耗模型额度；普通闲聊跳过。每次最多 ', 'Uses the current session model and its quota; ordinary chat is skipped. Up to ') + String(value.maxOutputTokens ?? 0) + a(' 个输出 token。', ' output tokens per call.')),
+      ]),
       last ? h('p', { key: 'last' }, a('最近检查：', 'Last check: ') + formatDate(new Date(last.at).toISOString()) + ' ' + formatTime(new Date(last.at).toISOString()) + ' · ' + (reasons[last.reason] || a('已检查', 'Checked'))) : null,
-      h(Btn, { key: 'review', onClick: props.onReview }, a('待审阅 ', 'Awaiting review: ') + String(value.candidates ?? 0)),
     ]),
   ]);
 }
@@ -1970,11 +2028,11 @@ function DreamPanel() {
   return h("div", { className: "dshd-root" + (privacy === true ? " dshd-privacy" : ""), key: "root" }, [
     h("div", { className: "dshd-shell", key: "shell" }, [
       errorBox,
-      h(AutomaticMemoryCard, { key: 'automatic', reloadToken: reloadToken, onReview: function () { setActiveTab('knowledge'); reload(); } }),
       h("nav", { className: "dshd-tabs", key: "tabs", "aria-label": t("梦境面板视图") }, [["journal", t("日记")], ["knowledge", t("经验")], ["bridge", t("写入记录")]].map(function (item) {
         return h("button", { key: item[0], type: "button", className: "dshd-chipbtn" + (activeTab === item[0] ? " on" : ""), "aria-pressed": activeTab === item[0], onClick: function () { setFilterOpen(false); setActiveTab(item[0]); } }, item[1]);
       })),
       toolbar,
+      activeTab === 'journal' ? h(AutomaticMemoryCard, { key: 'automatic', reloadToken: reloadToken, onReview: function () { setActiveTab('knowledge'); reload(); } }) : null,
       privacy === true ? h("div", { className: "dshd-note", key: "privacynote", role: "status" }, t("隐私模式：显示层模糊；DOM 仍为明文，不改文件、不加密。点击卡片可临时查看。")) : null,
       body(),
       activeTab !== "journal" ? null : h("div", { className: "dshd-footer", key: "footer" }, [

package/lib/config.d.ts

@@ -21,6 +21,7 @@ export interface ResolvedDreamConfig {
     autoMaxInputChars: number;
     autoMaxOutputTokens: number;
     autoTimeoutMs: number;
+    autoIdleMs: number;
 }
 /** 解析并校验插件配置。 */
 export declare function resolveConfig(raw?: Record<string, unknown> | null, env?: NodeJS.ProcessEnv): ResolvedDreamConfig;

package/lib/config.js

@@ -32,5 +32,6 @@ export function resolveConfig(raw, env = process.env) {
         autoMaxInputChars: clamp(cfg.autoMaxInputChars, 12000, 1000, 20000),
         autoMaxOutputTokens: clamp(cfg.autoMaxOutputTokens, 1200, 200, 2000),
         autoTimeoutMs: clamp(cfg.autoTimeoutMs, 30000, 1000, 60000),
+        autoIdleMs: clamp(cfg.autoIdleMs, 60000, 0, 3600000),
     };
 }

package/lib/knowledge-store.d.ts

@@ -1,4 +1,11 @@
 import { type Evidence, type EvidenceInput, type Lesson, type LessonInput, type LessonReviewResolution, type LessonState, type ReviewDecision } from './knowledge.js';
+type MemorySnapshot = {
+    sourceKey: string;
+    lessons: Lesson[];
+    evidence: Evidence[];
+    badLines: number;
+    complete: boolean;
+};
 /** events.jsonl 默认最多回放的行数（有界读取）。 */
 export declare const MAX_REPLAY_EVENTS = 200000;
 /** KnowledgeStore 构造选项（都可省略，保持 FREEZE 的 constructor(knowledgeDir) 可用）。 */
@@ -37,6 +44,9 @@ export declare class KnowledgeStore {
     listLessons(): Lesson[];
     /** 全部证据，按 observedAt 升序（同刻按 id 稳定排序）。 */
     listEvidence(): Evidence[];
+    /** Content-addressed, immutable snapshot. Hashes also detect same-size, same-mtime writes. */
+    readSnapshot(): MemorySnapshot;
+    private sourceFingerprint;
     /** 按 id 取经验；不存在返回 undefined。 */
     getLesson(id: string): Lesson | undefined;
     /** 追加证据；同 sessionId+recordSeq 或同 sourceHash 视为重复，返回已有记录且不写。 */
@@ -71,7 +81,7 @@ export declare class KnowledgeStore {
         id: string;
         patch: Partial<Lesson>;
         expectedRevision: number;
-    }>, idempotencyKey: string): Lesson[];
+    }>, idempotencyKey: string, candidateReview?: 'accepted' | 'rejected'): Lesson[];
     /** 状态迁移；不允许的迁移抛 KnowledgeError('invalid') 且不写。 */
     applyTransition(id: string, to: LessonState, expectedRevision: number, idempotencyKey: string): Lesson;
     /** 从事件完整重建派生索引与 checkpoint；不删除、不改写 events.jsonl / evidence.jsonl。 */
@@ -188,3 +198,4 @@ export declare class KnowledgeStore {
     private writeIndex;
     private writeIndexStrict;
 }
+export {};

package/lib/knowledge-store.js

@@ -22,6 +22,16 @@ import { join } from 'node:path';
 import { StringDecoder } from 'node:string_decoder';
 import { KnowledgeError, canTransition, evidenceNaturalKey, evidenceSessionKey, lessonFingerprint, mergeEvidenceSupport, validateEvidence, validateLesson, } from './knowledge.js';
 import { maskSecrets } from './mask.js';
+import { memoryDirectory } from './memory.js';
+const snapshots = new Map();
+function freezeTree(value) {
+    if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+        for (const child of Object.values(value))
+            freezeTree(child);
+        Object.freeze(value);
+    }
+    return value;
+}
 /** events.jsonl 默认最多回放的行数（有界读取）。 */
 export const MAX_REPLAY_EVENTS = 200000;
 const PREFIX_HASH_BYTES = 64 * 1024;
@@ -336,6 +346,53 @@ export class KnowledgeStore {
             .map((item) => clone(item))
             .sort((a, b) => (a.observedAt === b.observedAt ? a.id.localeCompare(b.id) : a.observedAt.localeCompare(b.observedAt)));
     }
+    /** Content-addressed, immutable snapshot. Hashes also detect same-size, same-mtime writes. */
+    readSnapshot() {
+        const key = this.sourceFingerprint();
+        const cacheKey = this.dir + ':' + this.maxReplayEvents;
+        const cached = snapshots.get(cacheKey);
+        if (cached?.sourceKey === key)
+            return cached;
+        snapshots.delete(cacheKey);
+        // Cold reads verify the authority, including edits in the middle of a
+        // legacy checkpoint's prefix/tail guards. Warm reads only hash the files.
+        const state = this.mergeEvidenceFile(this.loadEventsBounded(0));
+        if (this.sourceFingerprint() !== key)
+            throw new KnowledgeError('io', '记忆正在更新，请稍后重试');
+        const snapshot = freezeTree({ sourceKey: key, lessons: [...state.lessons.values()], evidence: [...state.evidence.values()], badLines: state.badLines,
+            complete: state.idempotencyComplete && state.orphanEvents === 0 && state.unsupportedVersions === 0 && state.skippedEvents === 0 });
+        if (snapshots.size >= 16)
+            snapshots.delete(snapshots.keys().next().value);
+        snapshots.set(cacheKey, snapshot);
+        return snapshot;
+    }
+    sourceFingerprint() {
+        const digest = createHash('sha256'), buffer = Buffer.allocUnsafe(64 * 1024);
+        for (const file of [this.eventsPath, this.evidencePath, this.indexPath]) {
+            digest.update(file);
+            let fd;
+            try {
+                fd = openSync(file, 'r');
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    digest.update(':missing');
+                    continue;
+                }
+                throw error;
+            }
+            try {
+                let count;
+                while ((count = readSync(fd, buffer, 0, buffer.length, null)) > 0)
+                    digest.update(buffer.subarray(0, count));
+                digest.update(':end');
+            }
+            finally {
+                closeSync(fd);
+            }
+        }
+        return digest.digest('hex');
+    }
     /** 按 id 取经验；不存在返回 undefined。 */
     getLesson(id) {
         const state = this.loadEvents();
@@ -693,7 +750,7 @@ export class KnowledgeStore {
      * 批量原子更新（M2-②）：一个事件承载全部变更；先统一校验，
      * 任一条不通过 → 零写入并抛 KnowledgeError（details.failedId）。
      */
-    updateLessonsBatch(updates, idempotencyKey) {
+    updateLessonsBatch(updates, idempotencyKey, candidateReview) {
         assertIdempotencyKey(idempotencyKey);
         if (!Array.isArray(updates) || updates.length === 0)
             throw new KnowledgeError('invalid', 'updates 必须是非空数组');
@@ -707,6 +764,7 @@ export class KnowledgeStore {
         }
         const requestHash = this.hashRequest({
             operation: 'lesson.batch',
+            ...(candidateReview === undefined ? {} : { candidateReview }),
             updates: updates.map((update) => ({ id: update.id, expectedRevision: update.expectedRevision, patch: this.hashablePatch(update.patch) })),
         });
         return this.withLock((touch) => {
@@ -721,6 +779,7 @@ export class KnowledgeStore {
             }
             const now = new Date().toISOString();
             const planned = [];
+            let reviewGroup;
             for (const update of updates) {
                 const previous = state.lessons.get(update.id);
                 if (previous === undefined)
@@ -733,6 +792,18 @@ export class KnowledgeStore {
                     });
                 }
                 const clean = this.cleanPatch(update.patch);
+                if (candidateReview !== undefined) {
+                    if (previous.state !== 'candidate' || previous.conflictIds.length)
+                        throw new KnowledgeError('invalid', '批量审阅只接受没有冲突的候选，请逐条核对其他记录');
+                    const group = JSON.stringify([previous.kind, previous.scope.global === true, previous.scope.projectId, previous.scope.workspaceRoot]);
+                    reviewGroup ??= group;
+                    if (group !== reviewGroup)
+                        throw new KnowledgeError('invalid', '批量审阅需要相同项目、范围和主题');
+                    if (candidateReview === 'accepted' && !previous.evidenceIds.some(id => state.evidence.get(id)?.verification === 'read'))
+                        throw new KnowledgeError('invalid', '请先核对候选的实际来源');
+                    clean.state = candidateReview === 'accepted' ? 'usable' : 'rejected';
+                    clean.review = { decision: candidateReview, actor: 'human', at: now };
+                }
                 if (clean.state !== undefined && clean.state !== previous.state && !canTransition(previous.state, clean.state)) {
                     throw new KnowledgeError('invalid', '不允许的状态迁移：' + previous.state + ' → ' + clean.state, { failedId: update.id });
                 }
@@ -1678,6 +1749,7 @@ export class KnowledgeStore {
             lessons,
             stateCounts,
             byState: stateCounts,
+            memory: memoryDirectory([...state.lessons.values()], [...state.evidence.values()]),
         };
         const checkpoint = this.buildCheckpoint(state);
         if (checkpoint !== undefined)

package/lib/memory.d.ts

@@ -0,0 +1,36 @@
+import type { Evidence, Lesson } from './knowledge.js';
+/** A retrieval deadline is not a verification result; feedback never renews it. */
+export declare function reviewDeadline(lesson: Lesson): number | undefined;
+export declare function needsMemoryReview(lesson: Lesson, now?: number): boolean;
+/** Derived layers contain pointers; authoritative lessons and evidence remain untouched. */
+export declare function memoryDirectory(lessons: Lesson[], evidence: Evidence[], now?: number): {
+    summary: {
+        lessonId: string;
+        title: string;
+        scope: {
+            projectId?: string;
+            workspaceRoot?: string;
+            global: boolean;
+        };
+    }[];
+    entries: {
+        lessonId: string;
+        revision: number;
+        title: string;
+        topic: import("./knowledge.js").LessonKind;
+        scope: {
+            projectId?: string;
+            workspaceRoot?: string;
+            global: boolean;
+        };
+        state: import("./knowledge.js").LessonState;
+        reviewDue: boolean;
+        reviewAfter: string | null;
+        sources: {
+            evidenceId: string;
+            sessionId: string | undefined;
+            recordSeq: string | number | undefined;
+            verification: "read" | "claimed";
+        }[];
+    }[];
+};

package/lib/memory.js

@@ -0,0 +1,35 @@
+/** A retrieval deadline is not a verification result; feedback never renews it. */
+export function reviewDeadline(lesson) {
+    const explicit = lesson.reviewAfter ? Date.parse(lesson.reviewAfter) : NaN;
+    const reviewed = Date.parse(lesson.review.at ?? lesson.lastValidatedAt ?? lesson.createdAt);
+    const renewed = lesson.review.at ? Date.parse(lesson.review.at) : NaN;
+    if (Number.isFinite(explicit) && (!Number.isFinite(renewed) || renewed <= explicit))
+        return explicit;
+    if (lesson.kind !== 'fact')
+        return undefined;
+    return Number.isFinite(reviewed) ? reviewed + 30 * 86400000 : undefined;
+}
+export function needsMemoryReview(lesson, now = Date.now()) {
+    const deadline = reviewDeadline(lesson);
+    return lesson.state === 'usable' && deadline !== undefined && deadline <= now;
+}
+/** Derived layers contain pointers; authoritative lessons and evidence remain untouched. */
+export function memoryDirectory(lessons, evidence, now = Date.now()) {
+    const byId = new Map(evidence.map(item => [item.id, item]));
+    const accepted = new Set(lessons.filter(item => item.review.decision === 'accepted').map(item => item.id));
+    const entries = lessons.filter(item => item.state !== 'rejected').map(item => ({
+        lessonId: item.id, revision: item.revision, title: item.title, topic: item.kind, scope: item.scope,
+        state: item.state, reviewDue: needsMemoryReview(item, now),
+        reviewAfter: reviewDeadline(item) === undefined ? null : new Date(reviewDeadline(item)).toISOString(),
+        sources: item.evidenceIds.slice(0, 3).flatMap(id => {
+            const source = byId.get(id);
+            return source ? [{ evidenceId: id, sessionId: source.sessionId, recordSeq: source.recordSeq, verification: source.verification }] : [];
+        }),
+    }));
+    let chars = 0;
+    const summary = entries.filter(item => item.state === 'usable' && !item.reviewDue
+        && accepted.has(item.lessonId))
+        .slice(0, 12).filter(item => { chars += item.title.length; return chars <= 2400; })
+        .map(({ lessonId, title, scope }) => ({ lessonId, title, scope }));
+    return { summary, entries };
+}

package/lib/retrieval.d.ts

@@ -28,6 +28,7 @@ export interface RetrievalQuery {
     includeCandidates?: boolean;
     /** 是否保留 independentSupportCount===0 且非 usable 的条目；默认 true。dream_context 传 false（R1）。 */
     includeNoEvidence?: boolean;
+    now?: number;
 }
 /** 检索结果中的单条经验（when/exceptions 永不截断）。 */
 export interface RetrievedLesson {

package/lib/retrieval.js

@@ -1,4 +1,5 @@
 import { normalizeLessonText } from './knowledge.js';
+import { needsMemoryReview } from './memory.js';
 /** 默认条数。 */
 export const DEFAULT_RETRIEVAL_LIMIT = 5;
 /** 条数硬上限。 */
@@ -150,6 +151,7 @@ const SKIPPED_REASON_LABELS = {
     'no-evidence': '无独立证据',
     'version-mismatch': '版本条件不匹配',
     'platform-mismatch': '平台条件不匹配',
+    'review-due': '已到复核时间',
     limit: '超出条数上限',
     'budget-stop': '预算放不下',
     budget: '预算放不下（旧值）',
@@ -478,6 +480,10 @@ export function retrieveLessons(lessons, evidence, q) {
     for (const lesson of lessons) {
         if (!scopeMatches(lesson, q))
             continue;
+        if (needsMemoryReview(lesson, q.now ?? Date.now())) {
+            skipped.push({ lessonId: lesson.id, reason: 'review-due' });
+            continue;
+        }
         const excludedReason = EXCLUDED_STATE_REASONS[lesson.state];
         if (excludedReason !== undefined) {
             skipped.push({ lessonId: lesson.id, reason: excludedReason });

package/lib/web-actions.js

@@ -104,6 +104,36 @@ export function createDreamActionHandler(options = {}) {
             if (request.signal.aborted)
                 return fail(409, 'cancelled', '操作已取消');
             const operation = text(body, 'operation');
+            if (operation === 'automatic-chat' || operation === 'automatic-flush') {
+                const runtime = automaticRuntime(cfg);
+                if (!runtime)
+                    return fail(503, 'unavailable', '自动功能尚未就绪');
+                if (operation === 'automatic-flush')
+                    runtime.flush();
+                else {
+                    if (['use', 'contribute'].some(key => body[key] !== undefined && body[key] !== null && typeof body[key] !== 'boolean')
+                        || (body.use === undefined && body.contribute === undefined))
+                        throw new KnowledgeError('invalid', '聊天记忆开关需要布尔值或跟随全局');
+                    runtime.controlSession(text(body, 'sessionId'), { use: body.use, contribute: body.contribute });
+                }
+                return json(200, { ok: true, automatic: runtime.status() });
+            }
+            if (operation === 'review-batch') {
+                if (!['accept', 'reject'].includes(String(body.action)) || !Array.isArray(body.items) || body.items.length < 1 || body.items.length > 20)
+                    throw new KnowledgeError('invalid', '批量审阅每次选择 1 到 20 条候选');
+                const key = text(body, 'requestId');
+                if (!/^[a-zA-Z0-9_-]{8,100}$/.test(key))
+                    throw new KnowledgeError('invalid', '审阅请求标识无效');
+                const seen = new Set();
+                const updates = body.items.map(item => {
+                    if (!item || typeof item.lessonId !== 'string' || seen.has(item.lessonId) || !Number.isSafeInteger(item.expectedRevision) || item.expectedRevision < 1)
+                        throw new KnowledgeError('invalid', '候选及版本无效或重复');
+                    seen.add(item.lessonId);
+                    return { id: item.lessonId, expectedRevision: item.expectedRevision, patch: {} };
+                });
+                const lessons = store.updateLessonsBatch(updates, 'web-review-batch:' + key, body.action === 'accept' ? 'accepted' : 'rejected');
+                return json(200, maskDeep({ ok: true, lessons, message: '已完成所选候选的审阅' }));
+            }
             if (operation === 'automatic') {
                 if ((body.enabled !== undefined && typeof body.enabled !== 'boolean') || (body.retrievalEnabled !== undefined && typeof body.retrievalEnabled !== 'boolean') || (body.enabled === undefined && body.retrievalEnabled === undefined))
                     throw new KnowledgeError('invalid', '自动功能开关必须是布尔值');
@@ -169,6 +199,8 @@ export function createDreamActionHandler(options = {}) {
             throw new KnowledgeError('invalid', '不支持此操作');
         }
         catch (error) {
+            if (error instanceof Error && error.message.startsWith('automatic-'))
+                return fail(409, 'invalid', error.message === 'automatic-main-task-active' ? '主任务进行中，请等待完成后整理' : '聊天状态已变化或正在写入，请刷新后重试');
             if (error instanceof KnowledgeError)
                 return fail(error.code === 'revision' || error.code === 'duplicate' ? 409 : error.code === 'io' ? 500 : 400, error.code, error.message);
             return fail(500, 'io', '操作失败：' + (error instanceof Error ? error.message : String(error)));

package/lib/web.d.ts

@@ -1,6 +1,7 @@
 import { type ResolvedDreamConfig } from './config.js';
 import { type DreamEntry, type DreamStats } from './journal.js';
 import type { Evidence, Lesson } from './knowledge.js';
+import { memoryDirectory } from './memory.js';
 /** 面板与浏览器说话的同源路由。 */
 export declare const DREAM_ROUTE = "/_dsh/dsh-dream/journal";
 /** M1 经验面板的只读路由。 */
@@ -43,7 +44,11 @@ export interface KnowledgeWebPayload {
     lessons: Array<Lesson & {
         scopeLabel: string;
         evidenceSummary: string;
+        reviewDue?: boolean;
+        nextReviewAt?: string;
+        lastRetrievedAt?: string;
     }>;
+    memory?: ReturnType<typeof memoryDirectory>;
     /** 脱敏后的证据记录。 */
     evidence: Evidence[];
     /** 全量统计（不受条数影响）。 */

package/lib/web.js

@@ -22,6 +22,8 @@ import { dreamStats, readDreams, searchDreams } from './journal.js';
 import { KnowledgeStore } from './knowledge-store.js';
 import { isDreamReference, maskSecrets } from './mask.js';
 import { buildEvidenceSummary, lessonScopeLabel } from './retrieval.js';
+import { memoryDirectory, needsMemoryReview, reviewDeadline } from './memory.js';
+import { readAutomaticState } from './automatic-state.js';
 /** 面板与浏览器说话的同源路由。 */
 export const DREAM_ROUTE = '/_dsh/dsh-dream/journal';
 /** M1 经验面板的只读路由。 */
@@ -343,14 +345,23 @@ export function createKnowledgeWebHandler(options = {}) {
             const lessons = reader.listLessons();
             const evidence = reader.listEvidence();
             const stats = normalizeKnowledgeStats(reader.stats());
+            let retrieved = {};
+            try {
+                retrieved = readAutomaticState({ ...resolveConfig(options.config), journalDir: journalDirOf(options) }).retrieved ?? {};
+            }
+            catch { /* read-only panel still reports knowledge */ }
             const payload = {
                 lessons: lessons.map((lesson) => maskDeep({
                     ...lesson,
                     scopeLabel: lessonScopeLabel(lesson.scope),
                     evidenceSummary: buildEvidenceSummary(lesson, evidence),
+                    reviewDue: needsMemoryReview(lesson),
+                    ...(reviewDeadline(lesson) === undefined ? {} : { nextReviewAt: new Date(reviewDeadline(lesson)).toISOString() }),
+                    ...(retrieved[lesson.id] ? { lastRetrievedAt: new Date(retrieved[lesson.id].at).toISOString() } : {}),
                 })),
                 evidence: evidence.map((item) => maskDeep(item)),
                 stats,
+                memory: maskDeep(memoryDirectory(lessons, evidence)),
             };
             responseJson(res, 200, payload);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardustlc/dsh-dream",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "回顾会话、保存反思，并把经过核验和审阅的经验用于后续任务。",
   "type": "module",
   "main": "lib/index.js",