dsh-memory-fish 0.0.0-stage → 0.7.0

package/lib/dream.mjs

@@ -0,0 +1,162 @@
+import { promises as fs } from 'node:fs';
+import { localDay, jaccard, bigrams, similar, CANDIDATE_CUES, strengthOf, nowIso } from './util.mjs';
+
+/**
+ * 做梦：三阶段睡眠（P0）
+ *   Phase 1 SWS：重放 journal + 压缩近重复记忆（合并、原文进 archive）
+ *   Phase 2 SHY：按显著性加权衰减，长期低分条目降级归档
+ *   Phase 3 REM：建立"相关记忆"链接（只加链接，不改内容）
+ * 并输出到期复习清单（P1）。
+ */
+export async function buildDream(store, cfg, days = cfg.dreamDays) {
+  const records = await store.readJournal(days);
+  const sessions = new Set(records.map(r => r.session).filter(Boolean));
+  const userRecords = records.filter(r => r.role === 'user');
+  const cues = [];
+  const seen = [];
+  for (const r of userRecords) {
+    const text = String(r.text ?? '').trim();
+    if (!text || text.length < 4) continue;
+    if (!CANDIDATE_CUES.test(text)) continue;
+    const sig = bigrams(text);
+    if (seen.some(s => jaccard(s, sig) >= 0.6)) continue;
+    seen.push(sig);
+    cues.push({
+      session: r.session || '',
+      at: r.ts || '',
+      text: text.length > 240 ? text.slice(0, 240) + '…' : text,
+      explicit: /(记住|记一下|记下)/.test(text),
+    });
+    if (cues.length >= 20) break;
+  }
+
+  if (!store.entries.length) await store.load();
+  const now = Date.now();
+
+  // ---- Phase 1 · SWS：重放 + 压缩 ----
+  const active = store.entries.filter(e => e.status === 'active').sort((a, b) => String(b.updated).localeCompare(String(a.updated)));
+  const merged = [];
+  const removed = new Set();
+  for (let i = 0; i < active.length; i++) {
+    const a = active[i];
+    if (removed.has(a.id)) continue;
+    for (let j = i + 1; j < active.length; j++) {
+      const b = active[j];
+      if (removed.has(b.id)) continue;
+      const sim = similar(`${a.title}\n${a.content ?? ''}`, `${b.title}\n${b.content ?? ''}`);
+      if (sim < cfg.dedupeThreshold) continue;
+      const keep = String(a.updated).localeCompare(String(b.updated)) >= 0 ? a : b;
+      const drop = keep === a ? b : a;
+      merged.push({ kept: keep.id, dropped: drop.id, similarity: Number(sim.toFixed(2)) });
+      keep.supersedes = [...new Set([...(keep.supersedes || []), drop.id])];
+      keep.salience = Math.max(keep.salience ?? 5, drop.salience ?? 5);
+      try {
+        const text = await fs.readFile(drop.file, 'utf8');
+        await store.archiveContent(drop, text);
+      } catch { /* 忽略 */ }
+      drop.status = 'archived';
+      drop.validTo = drop.validTo || nowIso();
+      drop.pinned = false;
+      removed.add(drop.id);
+    }
+  }
+
+  // ---- Phase 2 · SHY：显著性加权衰减 ----
+  const demoted = [];
+  for (const e of store.entries) {
+    if (e.status !== 'active' || e.pinned) continue;
+    const ageDays = (now - new Date(e.updated || e.created).getTime()) / 86400000;
+    const strength = strengthOf(e, now);
+    const keepDays = (e.importance ?? 3) >= 4 ? cfg.archiveAfterDays * 3 : cfg.archiveAfterDays;
+    if (ageDays > keepDays && strength < 0.12) {
+      try {
+        const text = await fs.readFile(e.file, 'utf8');
+        await store.archiveContent(e, text);
+      } catch { /* 忽略 */ }
+      e.status = 'archived';
+      e.validTo = e.validTo || nowIso();
+      e.pinned = false;
+      demoted.push({ id: e.id, title: e.title, ageDays: Math.round(ageDays), strength: Number(strength.toFixed(3)) });
+    }
+  }
+
+  // ---- Phase 3 · REM：关联（tags 共现 + 相似度） ----
+  const links = [];
+  const live = store.entries.filter(e => e.status === 'active');
+  for (let i = 0; i < live.length; i++) {
+    const a = live[i];
+    if (a.salience !== undefined && a.salience < 4) continue; // 低显著性的不建图，省空间
+    const aTags = new Set((a.tags || []).map(t => t.toLowerCase()));
+    for (let j = i + 1; j < live.length; j++) {
+      const b = live[j];
+      const bTags = new Set((b.tags || []).map(t => t.toLowerCase()));
+      let shared = 0;
+      for (const t of aTags) if (bTags.has(t)) shared++;
+      const sim = similar(`${a.title}\n${a.content ?? ''}`, `${b.title}\n${b.content ?? ''}`);
+      if (shared >= 1 || sim >= 0.5) {
+        const rel = shared >= 1 ? `tag:${[...aTags].filter(t => bTags.has(t))[0]}` : `sim:${sim.toFixed(2)}`;
+        a.links = [...new Set([...(a.links || []), b.id])].slice(-12);
+        b.links = [...new Set([...(b.links || []), a.id])].slice(-12);
+        links.push({ a: a.id, b: b.id, relation: rel });
+      }
+    }
+  }
+
+  // ---- 复习清单（P1） ----
+  const due = store.due(now).map(e => ({
+    id: e.id, title: e.title, dueAt: e.nextReview,
+    stability: e.stability, hits: e.hits || 0, salience: e.salience ?? 5,
+  }));
+
+  const day = localDay();
+  const lines = [
+    `# 睡梦报告 ${day}`,
+    '',
+    `- 回顾范围：最近 ${days} 天`,
+    `- 会话数：${sessions.size}，对话条数：${records.length}（用户 ${userRecords.length} 条）`,
+    '',
+    '## 🌊 Phase 1 · SWS 慢波：重放 + 压缩',
+    `- 合并近似记忆：${merged.length} 组`,
+    ...(merged.length ? merged.map(m => `  - 保留 ${m.kept} ← 归档 ${m.dropped}（相似度 ${m.similarity}）`) : ['  - （无需合并）']),
+    '',
+    '## 🌙 Phase 2 · SHY 稳态：显著性加权衰减',
+    `- 降级归档：${demoted.length} 条`,
+    ...(demoted.length ? demoted.map(d => `  - ${d.title}（${d.ageDays} 天未动，强度 ${d.strength}）`) : ['  - （没有需要遗忘的）']),
+    '',
+    '## 💭 Phase 3 · REM：联想链接',
+    `- 新建关联：${links.length} 条`,
+    ...(links.length ? links.slice(0, 10).map(l => `  - ${l.a} ↔ ${l.b}（${l.relation}）`) : ['  - （暂无可关联）']),
+    '',
+    '## ⏰ 待复习（间隔重复）',
+    ...(due.length ? due.map(d => `- [ ] ${d.title}（稳定 ${d.stability ?? '?'} 天，命中 ${d.hits} 次）`) : ['- （暂无到期）']),
+    '',
+    '## 候选（值得考虑写入长期记忆）',
+    ...(cues.length ? cues.map((c, i) => `${i + 1}. [${c.at ? c.at.slice(0, 16).replace('T', ' ') : '—'}] ${c.text}${c.explicit ? ' （明确要求记住）' : ''}`) : ['（没有发现候选）']),
+    '',
+    '## 处理建议',
+    '- 候选逐条判断："一个月后仍成立"才写，明确"记住"的直接写。',
+    '- 待复习条目：主动以一句话回顾，能加固记忆（提取练习效应）。',
+    '- 然后执行 memory_consolidate 收尾。',
+    '',
+  ].join('\n');
+
+  await store.saveIndex();
+  const file = await store.saveDreamReport(day, lines);
+  store.stats.dreams = (store.stats.dreams || 0) + 1;
+  store.stats.lastDream = nowIso();
+  store.stats.capturedSinceDream = 0;
+  await store.saveStats();
+
+  return {
+    day, days,
+    sessions: sessions.size, messages: records.length, userMessages: userRecords.length,
+    cues,
+    phases: {
+      sws: { mergedCount: merged.length, merged },
+      shy: { demotedCount: demoted.length, demoted },
+      rem: { linkCount: links.length, links: links.slice(0, 30) },
+    },
+    due,
+    report: lines, file,
+  };
+}

package/lib/inject.mjs

@@ -0,0 +1,83 @@
+import fsSync from 'node:fs';
+import { clampText, estTokens, dayOf } from './util.mjs';
+
+// ---------------------------------------------------------------- 注入
+
+/**
+ * C1 睡梦提醒：不依赖宿主调度器，在注入时按"欠一次梦"判断。
+ * 条件：距上次做梦 >= dreamAfterHours，或存在到期复习；且确有新对话/复习项。
+ */
+function dreamStatus(store, config, now = Date.now()) {
+  if (config.dreamReminder === false) return null;
+  const last = store.stats?.lastDream ? new Date(store.stats.lastDream).getTime() : 0;
+  const ageHours = Number.isFinite(last) ? Math.floor((now - (last || 0)) / 3600000) : Infinity;
+  const captured = store.stats?.capturedSinceDream || 0;
+  const dueCount = store.due().length;
+  const overdue = !Number.isFinite(ageHours) ? true : ageHours >= Number(config.dreamAfterHours ?? 24);
+  if (!overdue && dueCount === 0) return null;
+  if (captured === 0 && dueCount === 0) return null;
+  return { ageHours: Number.isFinite(ageHours) ? ageHours : null, captured, dueCount, overdue };
+}
+
+export function buildInjection(store, config) {
+  const profileRaw = fsSync.existsSync(store.profileFile)
+    ? fsSync.readFileSync(store.profileFile, 'utf8')
+    : '';
+  const profile = clampText(profileRaw.replace(/^#.*\n+/, '').trim() || '（暂无画像）', config.profileTokens);
+
+  const dream = dreamStatus(store, config);
+  const reminder = [];
+  if (dream) {
+    reminder.push('### 睡梦');
+    const parts = [];
+    if (dream.ageHours !== null) parts.push(`距上次做梦 ${dream.ageHours} 小时`);
+    if (dream.captured > 0) parts.push(`新增对话 ${dream.captured} 条`);
+    if (dream.dueCount > 0) parts.push(`${dream.dueCount} 条记忆到期该复习`);
+    reminder.push(`- ${parts.join(' · ')} → 建议先 memory_dream 做三阶段整理`);
+  }
+  const reminderTokens = reminder.length ? estTokens(reminder.join('\n')) : 0;
+
+  const visible = store.visible();
+  const total = visible.length;
+  const lines = [];
+  let used = 0;
+  const limitLines = Math.min(config.maxHotLines, 20);
+  const due = store.due();
+  const dueIds = new Set(due.map(e => e.id));
+  for (const e of visible) {
+    if (lines.length >= limitLines) break;
+    const date = dayOf(e.updated || e.created);
+    const tags = (e.tags || []).slice(0, 2).map(t => `#${t}`).join(' ');
+    const mark = dueIds.has(e.id) ? '⏰' : (e.pinned ? '★' : '·');
+    const line = `- ${mark} ${date} ${String(e.title).slice(0, 60)}${tags ? ' ' + tags : ''}`;
+    const cost = estTokens(line);
+    if (used + cost > config.budgetTokens - config.profileTokens - reminderTokens) break;
+    lines.push(line);
+    used += cost;
+  }
+
+  const shown = lines.length;
+  const cold = Math.max(0, total - shown);
+  const body = [
+    '## 小肥鱼记忆（本地，跨会话）',
+    '### 画像',
+    profile,
+    '',
+    shown > 0 ? '### 热索引（置顶★ / 到期⏰ / 显著性排序）' : '### 热索引',
+    ...(shown > 0 ? lines : ['（还没有记忆）']),
+    cold > 0 ? `\n> 冷区还有 ${cold} 条，需要时 memory_search 检索；memory_read 取全文。` : '',
+    due.length > 0 ? `> ⏰ ${due.length} 条记忆已到复习期（睡眠摘要里会列出，主动回顾能加固记忆）。` : '',
+    reminder.join('\n'),
+    '> 规则：只在结论时刻 memory_save；不确定就 memory_search 查证，查不到就说不知道，不要编。',
+  ].filter(Boolean).join('\n');
+
+  return {
+    text: body.trim() + '\n',
+    l1Lines: shown,
+    cold,
+    due: due.length,
+    dreamDue: Boolean(dream),
+    l1Tokens: estTokens(body),
+    profileTokens: estTokens(profile),
+  };
+}

package/lib/lock.mjs

@@ -0,0 +1,41 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 跨进程串行化：用 lock 文件把"读索引 → 改 → 写索引"包起来。
+ * 同一时刻只允许一个 DSH 实例改记忆；拿不到锁会在 timeout 后报错，
+ * 调用方可以重试（不会永久卡死）。
+ */
+export async function withLock(dir, fn, { timeoutMs = 5000, staleMs = 15000 } = {}) {
+  await fs.mkdir(dir, { recursive: true });
+  const lock = path.join(dir, '.index.lock');
+  const start = Date.now();
+  let handle;
+  for (;;) {
+    try {
+      handle = await fs.open(lock, 'wx');
+      break;
+    } catch (error) {
+      if (error.code !== 'EEXIST') throw error;
+      try {
+        const stat = await fs.stat(lock);
+        if (Date.now() - stat.mtimeMs > staleMs) {
+          await fs.unlink(lock).catch(() => {});
+          continue;
+        }
+      } catch {
+        continue; // 锁刚被释放
+      }
+      if (Date.now() - start > timeoutMs) {
+        throw new Error('memory-fish: index lock timeout (another DSH instance may be writing)');
+      }
+      await new Promise(r => setTimeout(r, 25));
+    }
+  }
+  try {
+    return await fn();
+  } finally {
+    try { await handle.close(); } catch { /* ignore */ }
+    await fs.unlink(lock).catch(() => {});
+  }
+}

package/lib/log.mjs

@@ -0,0 +1,44 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 极简调试日志：默认关闭（不产生任何 IO），
+ * 配置 debug: true 时把结构化日志追加到 <dir>/debug.log（超过 1MB 自动清空）。
+ */
+let enabled = false;
+let file = null;
+
+export function configureLogger({ enabled: on = false, file: target = null } = {}) {
+  enabled = Boolean(on);
+  file = target || null;
+  if (enabled && file) {
+    try { fs.mkdirSync(path.dirname(file), { recursive: true }); } catch { /* ignore */ }
+  }
+}
+
+function format(part) {
+  if (typeof part === 'string') return part;
+  if (part instanceof Error) return part.message;
+  try { return JSON.stringify(part); } catch { return String(part); }
+}
+
+function write(level, parts) {
+  if (!enabled) return;
+  const line = JSON.stringify({
+    ts: new Date().toISOString(),
+    level,
+    msg: parts.map(format).join(' '),
+  });
+  try {
+    if (!file) return;
+    if (fs.existsSync(file) && fs.statSync(file).size > 1024 * 1024) fs.writeFileSync(file, '');
+    fs.appendFileSync(file, line + '\n');
+  } catch { /* 日志失败绝不影响主流程 */ }
+}
+
+export const log = {
+  debug: (...parts) => write('debug', parts),
+  info: (...parts) => write('info', parts),
+  warn: (...parts) => write('warn', parts),
+  error: (...parts) => write('error', parts),
+};

package/lib/panel.mjs

@@ -0,0 +1,215 @@
+import { promises as fs } from 'node:fs';
+import fsSync from 'node:fs';
+import path from 'node:path';
+import { dayOf, isDue, out } from './util.mjs';
+import { buildInjection } from './inject.mjs';
+
+// ---------------------------------------------------------------- 面板 / 做梦
+
+/** 面板请求来源校验：只允许本机同源请求（防 DNS rebinding / 跨站写入）。 */
+export function trustedRequest(request, expectedMethod) {
+  if (expectedMethod && request.method && request.method !== expectedMethod) return false;
+  const h = request.headers ?? {};
+  const site = h['sec-fetch-site'];
+  if (typeof site === 'string' && site !== 'same-origin' && site !== 'none') return false;
+  if (typeof h.origin === 'string') {
+    try { if (new URL(h.origin).host !== h.host) return false; } catch { return false; }
+  }
+  if (h.host !== undefined) {
+    const okHost = /^(localhost|127\.0\.0\.1|\[::1\])(:\d+)?$/i.test(h.host)
+      || /^\d{1,3}(\.\d{1,3}){3}(:\d+)?$/.test(h.host)
+      || /^\[[0-9a-f:]+\](:\d+)?$/i.test(h.host);
+    if (!okHost) return false;
+  }
+  return true;
+}
+
+export function replyJson(response, code, payload) {
+  response.writeHead(code, { 'content-type': 'application/json; charset=utf-8' });
+  response.end(JSON.stringify(payload));
+}
+
+
+const PANEL_HTML = `<!doctype html>
+<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>小肥鱼记忆</title>
+<style>
+:root{--bg:#0f1419;--card:#171d26;--line:#263041;--fg:#e6edf3;--dim:#8b98a9;--accent:#4cc2ff;--warn:#ffb454;--ok:#5ee0a0}
+*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--fg);font:14px/1.6 system-ui,"Segoe UI",sans-serif}
+.wrap{max-width:1080px;margin:0 auto;padding:24px}
+h1{font-size:20px;margin:0 0 4px}h1 span{color:var(--dim);font-size:13px;font-weight:400}
+.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:12px;margin:16px 0}
+.card{background:var(--card);border:1px solid var(--line);border-radius:10px;padding:12px 14px}
+.card .k{color:var(--dim);font-size:12px}.card .v{font-size:22px;font-weight:600;margin-top:2px}
+.bar{height:8px;background:#0b0f14;border-radius:4px;overflow:hidden;margin-top:8px}
+.bar i{display:block;height:100%;background:linear-gradient(90deg,var(--ok),var(--accent))}
+.panel{background:var(--card);border:1px solid var(--line);border-radius:10px;padding:14px;margin:14px 0}
+.panel h2{font-size:14px;margin:0 0 10px;color:var(--accent);font-weight:600}
+textarea,input{width:100%;background:#0b0f14;color:var(--fg);border:1px solid var(--line);border-radius:8px;padding:8px;font:inherit}
+textarea{min-height:96px;resize:vertical}
+button{background:#1e2a3a;color:var(--fg);border:1px solid var(--line);border-radius:8px;padding:6px 12px;cursor:pointer;font:inherit}
+button:hover{border-color:var(--accent)}button.primary{background:var(--accent);color:#04121c;border-color:var(--accent);font-weight:600}
+button.danger{color:#ff8b8b}
+.row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}
+.mem{border-bottom:1px solid var(--line);padding:8px 0;display:flex;gap:10px;align-items:flex-start}
+.mem:last-child{border-bottom:0}
+.mem .t{flex:1}.mem .t b{font-weight:600}.mem .m{color:var(--dim);font-size:12px}
+.tag{display:inline-block;background:#1b2636;color:var(--accent);border-radius:6px;padding:0 6px;font-size:11px;margin-left:6px}
+.pin{color:var(--warn)}
+pre{white-space:pre-wrap;background:#0b0f14;border:1px solid var(--line);border-radius:8px;padding:10px;max-height:260px;overflow:auto;font-size:12px}
+.muted{color:var(--dim);font-size:12px}
+</style></head><body><div class="wrap">
+<h1>小肥鱼记忆 <span>dsh-memory-fish · 本地文件，零服务端</span></h1>
+<div class="cards" id="cards"></div>
+<div class="panel"><h2>L0 画像（常驻注入）</h2>
+<textarea id="profile"></textarea>
+<div class="row" style="margin-top:8px"><button class="primary" id="saveProfile">保存画像</button><span class="muted" id="profileHint"></span></div></div>
+<div class="panel"><h2>记忆（热索引 + 冷区）</h2>
+<div class="row"><input id="q" placeholder="搜索记忆（标题/标签/正文）" style="flex:1"><button id="searchBtn">搜索</button><button id="resetBtn">重置</button></div>
+<div id="list" style="margin-top:8px"></div></div>
+<div class="panel"><h2>睡梦机制（每天回顾对话，提炼记忆）</h2>
+<div class="muted" id="dreamInfo">还没有做梦记录</div>
+<div class="row" style="margin-top:8px"><button id="dreamBtn">现在做梦</button><button id="consolidateBtn">整理记忆</button><span class="muted" id="dreamHint"></span></div>
+<pre id="dreamReport" style="margin-top:10px">—</pre></div>
+</div>
+<script>
+const $=s=>document.querySelector(s);
+const esc=s=>String(s??'').replace(/[&<>"]/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c]));
+async function api(path,body){const r=await fetch(path,{method:body?'POST':'GET',headers:body?{'content-type':'application/json'}:{},body:body?JSON.stringify(body):undefined});return r.json()}
+function card(k,v,extra){return '<div class="card"><div class="k">'+esc(k)+'</div><div class="v">'+esc(v)+'</div>'+(extra||'')+'</div>'}
+async function refresh(){
+  const s=await api('api/state');
+  const pct=Math.min(100,Math.round(s.injected/budgetMax*100));
+  $('#cards').innerHTML=card('注入 tokens',s.injected+' / '+budgetMax,'<div class="bar"><i style="width:'+pct+'%"></i></div>')
+    +card('活跃记忆',s.active)+card('置顶',s.pinned)+card('待复习',s.due||0)+card('归档/遗忘',s.archived)
+    +card('今日对话',s.todayMessages)+card('候选线索',s.dreamCues);
+  if(document.activeElement!==$('#profile'))$('#profile').value=s.profile;
+  $('#profileHint').textContent='约 '+s.profileTokens+' tokens';
+  $('#dreamInfo').textContent='最近一次做梦：'+(s.lastDream||'无')+' · 已做 '+s.dreams+' 次';
+  $('#dreamReport').textContent=s.dreamReport||'—';
+  render(s.entries);
+}
+const budgetMax=600;
+function render(entries){
+  if(!entries.length){$('#list').innerHTML='<div class="muted">还没有记忆</div>';return}
+  $('#list').innerHTML=entries.map(e=>'<div class="mem"><div class="t"><b>'+((e.due&&!e.pinned)?'<span class="pin">⏰ </span>':(e.pinned?'<span class="pin">★ </span>':''))+esc(e.title)+'</b>'
+    +e.tags.map(t=>'<span class="tag">'+esc(t)+'</span>').join('')
+    +'<div class="m">'+esc(e.updated)+' · 生效 '+esc(e.validFrom||'')+' · 显著性 '+(e.salience??5)+' · 重要度 '+e.importance+' · 命中 '+e.hits+(e.nextReview?' · 复习 '+esc(e.nextReview.slice(0,10)):'')+'</div></div>'
+    +'<div class="row"><button onclick="act(\\''+(e.pinned?'unpin':'pin')+'\\',\\''+esc(e.id)+'\\')">'+(e.pinned?'取消置顶':'置顶')+'</button>'
+    +'<button class="danger" onclick="act(\\'forget\\',\\''+esc(e.id)+'\\')">遗忘</button></div></div>').join('');
+}
+async function act(action,id){
+  const r=await api('api/action',{action,id});
+  if(!r.ok)alert(r.message||'操作失败');
+  refresh();
+}
+$('#saveProfile').onclick=async()=>{const r=await api('api/action',{action:'profile',content:$('#profile').value});$('#profileHint').textContent=r.ok?'已保存（约 '+r.tokens+' tokens）':'失败';refresh()};
+$('#searchBtn').onclick=async()=>{const q=$('#q').value.trim();if(!q)return refresh();const r=await api('api/action',{action:'search',query:q});render(r.matches||[])};
+$('#resetBtn').onclick=()=>{$('#q').value='';refresh()};
+$('#dreamBtn').onclick=async()=>{$('#dreamHint').textContent='做梦ing…';const r=await api('api/action',{action:'dream'});$('#dreamHint').textContent=r.ok?('SWS 合并 '+r.phases.sws+' · SHY 归档 '+r.phases.shy+' · REM 链接 '+r.phases.rem+' · 待复习 '+r.due):'失败';refresh()};
+$('#consolidateBtn').onclick=async()=>{$('#dreamHint').textContent='整理中…';const r=await api('api/action',{action:'consolidate'});$('#dreamHint').textContent=r.ok?('合并 '+r.merged+' 条 / 归档 '+r.archived+' 条'):'失败';refresh()};
+refresh();setInterval(refresh,8000);
+</script></body></html>`;
+
+// ---------------------------------------------------------------- 面板路由（模块级，便于测试）
+
+export function registerPanelRoutes(webServer, store, cfg, toolImpl) {
+  if (!webServer || typeof webServer.register !== 'function') return;
+
+  const latestDream = async () => {
+    try {
+      const files = (await fs.readdir(store.dreamDir)).filter(f => f.endsWith('.md')).sort();
+      if (!files.length) return '';
+      const text = await fs.readFile(path.join(store.dreamDir, files[files.length - 1]), 'utf8');
+      return text.slice(0, 4000);
+    } catch { return ''; }
+  };
+
+  webServer.register({
+    kind: 'exact',
+    path: cfg.panelPath,
+    handler: async (request, response) => {
+      if (!trustedRequest(request, 'GET')) { replyJson(response, 403, { ok: false, error: 'cross-origin refused' }); return; }
+      response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+      response.end(PANEL_HTML);
+    },
+  });
+
+  webServer.register({
+    kind: 'exact',
+    path: `${cfg.apiBase}/state`,
+    handler: async (request, response) => {
+      if (!trustedRequest(request, 'GET')) { replyJson(response, 403, { ok: false, error: 'cross-origin refused' }); return; }
+      try {
+        if (!store.entries.length) await store.load();
+        const hot = buildInjection(store, cfg);
+        const profileRaw = fsSync.existsSync(store.profileFile) ? fsSync.readFileSync(store.profileFile, 'utf8') : '';
+        const journal = await store.readJournal(1);
+        const dreamReport = await latestDream();
+        const entries = store.visible().slice(0, 200).map(e => out({
+          id: e.id, title: e.title, pinned: !!e.pinned, tags: e.tags || [],
+          importance: e.importance ?? 3, salience: e.salience ?? 5,
+          stability: e.stability ?? null, nextReview: e.nextReview ?? null,
+          due: isDue(e), reviews: e.reviews || 0,
+          validFrom: dayOf(e.validFrom || e.created), historyCount: (e.history || []).length,
+          updated: dayOf(e.updated), hits: e.hits || 0,
+        }));
+        replyJson(response, 200, {
+          ok: true,
+          injected: hot.l1Tokens,
+          budget: cfg.budgetTokens,
+          profileTokens: hot.profileTokens,
+          profile: profileRaw.replace(/^#.*\n+/, '').trim(),
+          active: store.entries.filter(e => e.status === 'active').length,
+          archived: store.entries.filter(e => e.status !== 'active').length,
+          pinned: store.entries.filter(e => e.status === 'active' && e.pinned).length,
+          due: store.due().length,
+          todayMessages: journal.length,
+          dreamCues: dreamReport ? (dreamReport.match(/^\d+\. /gm) || []).length : 0,
+          dreams: store.stats.dreams || 0,
+          lastDream: store.stats.lastDream || '',
+          dreamReport,
+          entries,
+        });
+      } catch (error) {
+        replyJson(response, 500, { ok: false, error: String(error?.message ?? error) });
+      }
+    },
+  });
+
+  webServer.register({
+    kind: 'exact',
+    path: `${cfg.apiBase}/action`,
+    handler: async (request, response) => {
+      if (!trustedRequest(request, 'POST')) { replyJson(response, 403, { ok: false, error: 'cross-origin refused' }); return; }
+      try {
+        const chunks = [];
+        for await (const chunk of request) chunks.push(chunk);
+        const body = JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}');
+        const result = await runPanelAction(String(body.action ?? ''), body, store, cfg, toolImpl);
+        replyJson(response, 200, result);
+      } catch (error) {
+        replyJson(response, 400, { ok: false, message: String(error?.message ?? error) });
+      }
+    },
+  });
+}
+
+export async function runPanelAction(action, body, store, cfg, toolImpl) {
+  const exec = { signal: { aborted: false } };
+  if (action === 'pin') return await toolImpl.memory_pin.execute({ id: body.id, pinned: true }, exec);
+  if (action === 'unpin') return await toolImpl.memory_pin.execute({ id: body.id, pinned: false }, exec);
+  if (action === 'forget') return await toolImpl.memory_forget.execute({ id: body.id }, exec);
+  if (action === 'profile') return await toolImpl.memory_profile_save.execute({ content: body.content }, exec);
+  if (action === 'save') return await toolImpl.memory_save.execute(body, exec);
+  if (action === 'search') return await toolImpl.memory_search.execute({ query: body.query, includeArchived: true }, exec);
+  if (action === 'dream') {
+    const r = await toolImpl.memory_dream.execute({ autoSave: body.autoSave === true }, exec);
+    return out({ ok: true, cues: r.cues, day: r.day, phases: r.phases, due: (r.dueReview || []).length });
+  }
+  if (action === 'consolidate') {
+    const r = await toolImpl.memory_consolidate.execute({}, exec);
+    return out({ ok: true, merged: r.mergedCount, archived: r.archivedCount });
+  }
+  return { ok: false, message: 'unknown action' };
+}