dsh-memory-fish 0.0.0-stage → 0.7.0

package/SECURITY.md

@@ -0,0 +1,61 @@
+# Security policy
+
+## Trust model
+
+`dsh-memory-fish` is a **local-first** plugin. It has **no network access** — no
+telemetry, no remote sync, no embedding API. All data lives under
+`~/.dsh/memory-fish/` (or the configured `dir`).
+
+The plugin runs inside the DeepSeek Harness host process, so it inherits the
+host's privileges. It can read and write the memory directory and register
+tools and local HTTP routes.
+
+## What is stored
+
+| Path | Content | Notes |
+|---|---|---|
+| `profile.md` | L0 profile shown to the model every session | user-editable |
+| `memories/*.md` | durable memories | plain Markdown |
+| `archive/*.md` | superseded/deleted versions | kept for audit |
+| `journal/*.jsonl` | raw conversation capture (optional) | **secrets are redacted before write** |
+| `dream/*.md` | nightly consolidation reports | |
+| `index.json`, `stats.json` | metadata | |
+
+`autoCapture` is on by default. It stores user/assistant message text (up to
+`captureMaxChars` per message) to `journal/`. The text is passed through a
+secret filter (`sk-…`, `api_key=…`, `password=…`, bearer tokens, PEM private
+keys) before it hits disk, but the filter is best-effort — do not paste
+credentials into chat.
+
+Set `autoCapture: false` and delete `journal/` if you do not want any raw
+conversation history on disk.
+
+## Local panel
+
+The optional HTTP panel is served by the DSH host web server on
+`/memory-fish/panel`. It enforces:
+
+- `Origin` vs `Host` match (blocks cross-site requests)
+- `Sec-Fetch-Site` must be `same-origin` or `none`
+- `Host` allow-list (localhost / loopback IPs only)
+- method policing per route
+
+It has **no authentication beyond that**: any local process that can open a
+connection to the host port can read and modify memories. Run DSH on a trusted
+machine and do not expose the port to the network.
+
+## Multi-instance writes
+
+Mutating operations take a lock file (`<dir>/.index.lock`) so two DSH instances
+do not corrupt `index.json`. Stale locks (older than 15 s) are broken
+automatically; a 5 s timeout raises an error instead of hanging. Mixing this
+plugin with other tools that write `index.json` directly is not supported.
+
+## Reporting a vulnerability
+
+Open a private security advisory on the repository, or email the maintainer.
+Please do not file a public issue for an exploitable problem.
+
+## Supported versions
+
+Only the latest minor release receives fixes.

package/client/client.js

@@ -0,0 +1,201 @@
+window.__ModuleLoader__.load({
+	id: "dsh-memory-fish",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		const react = require("react");
+		const h = react.createElement;
+
+		/** 与宿主同源的面板 API（host 插件注册的路由）。 */
+		const API = "/memory-fish/api";
+
+		async function api(path, body) {
+			const res = await fetch(`${API}${path}`, {
+				method: body === undefined ? "GET" : "POST",
+				headers: body === undefined ? {} : { "content-type": "application/json" },
+				body: body === undefined ? undefined : JSON.stringify(body)
+			});
+			return await res.json();
+		}
+
+		const S = {
+			wrap: { padding: "12px 4px", display: "flex", flexDirection: "column", gap: "14px", color: "var(--fg-primary, inherit)" },
+			cards: { display: "grid", gridTemplateColumns: "repeat(auto-fit,minmax(120px,1fr))", gap: "8px" },
+			card: { border: "1px solid var(--border-default, #2a3547)", borderRadius: "8px", padding: "8px 10px" },
+			k: { fontSize: "11px", opacity: 0.65 },
+			v: { fontSize: "18px", fontWeight: 600, marginTop: "2px" },
+			bar: { height: "6px", background: "rgba(127,127,127,.2)", borderRadius: "3px", overflow: "hidden", marginTop: "6px" },
+			barFill: { height: "100%", background: "var(--accent-primary, #4cc2ff)" },
+			section: { border: "1px solid var(--border-default, #2a3547)", borderRadius: "8px", padding: "10px" },
+			h2: { fontSize: "13px", fontWeight: 600, margin: "0 0 8px", opacity: 0.9 },
+			row: { display: "flex", gap: "8px", alignItems: "center", flexWrap: "wrap" },
+			input: { flex: 1, minWidth: "160px", padding: "5px 8px", borderRadius: "6px", border: "1px solid var(--border-default, #2a3547)", background: "transparent", color: "inherit", fontSize: "13px" },
+			textarea: { width: "100%", minHeight: "74px", padding: "6px 8px", borderRadius: "6px", border: "1px solid var(--border-default, #2a3547)", background: "transparent", color: "inherit", fontSize: "13px", fontFamily: "inherit", resize: "vertical" },
+			btn: { padding: "4px 10px", borderRadius: "6px", border: "1px solid var(--border-default, #2a3547)", background: "transparent", color: "inherit", cursor: "pointer", fontSize: "12px" },
+			btnPrimary: { padding: "4px 10px", borderRadius: "6px", border: "1px solid var(--accent-primary, #4cc2ff)", background: "var(--accent-primary, #4cc2ff)", color: "#04121c", cursor: "pointer", fontSize: "12px", fontWeight: 600 },
+			mem: { display: "flex", gap: "8px", alignItems: "flex-start", padding: "6px 0", borderBottom: "1px solid rgba(127,127,127,.18)" },
+			memMain: { flex: 1, minWidth: 0 },
+			title: { fontSize: "13px", fontWeight: 600 },
+			meta: { fontSize: "11px", opacity: 0.6, marginTop: "2px" },
+			tag: { display: "inline-block", marginLeft: "5px", padding: "0 5px", borderRadius: "4px", background: "rgba(76,194,255,.14)", color: "var(--accent-primary, #4cc2ff)", fontSize: "10px" },
+			pre: { whiteSpace: "pre-wrap", fontSize: "11px", lineHeight: 1.5, maxHeight: "220px", overflow: "auto", margin: "8px 0 0", opacity: 0.85 },
+			muted: { fontSize: "11px", opacity: 0.6 }
+		};
+
+		const name = "dsh-memory-fish";
+		const inject = ["slots"];
+
+		function apply(ctx) {
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "dsh-memory-fish",
+				order: 75,
+				label: () => "小肥鱼记忆"
+			}, () => h(MemoryPanel)));
+		}
+
+		function MemoryPanel() {
+			const [data, setData] = react.useState(null);
+			const [error, setError] = react.useState("");
+			const [query, setQuery] = react.useState("");
+			const [results, setResults] = react.useState(null);
+			const [profileDraft, setProfileDraft] = react.useState(null);
+			const [busy, setBusy] = react.useState("");
+			const [notice, setNotice] = react.useState("");
+
+			const load = react.useCallback(async () => {
+				try {
+					const d = await api("/state");
+					if (d.ok !== true) throw new Error(d.error || "加载失败");
+					setData(d);
+					setError("");
+					setProfileDraft(prev => prev === null ? d.profile : prev);
+				} catch (e) {
+					setError(String(e && e.message ? e.message : e));
+				}
+			}, []);
+
+			react.useEffect(() => {
+				load();
+				const timer = setInterval(load, 10000);
+				return () => clearInterval(timer);
+			}, [load]);
+
+			const act = async (label, body) => {
+				setBusy(label);
+				setNotice("");
+				try {
+					const r = await api("/action", body);
+					if (r.ok !== true) setNotice(r.message || r.error || "操作失败");
+					else setNotice("已完成");
+					await load();
+				} catch (e) {
+					setNotice(String(e && e.message ? e.message : e));
+				} finally {
+					setBusy("");
+				}
+			};
+
+			if (error !== "") return h("div", { style: S.wrap }, h("div", { style: S.muted }, `小肥鱼记忆加载失败：${error}`));
+			if (data === null) return h("div", { style: S.wrap }, h("div", { style: S.muted }, "正在加载记忆…"));
+
+			const pct = Math.min(100, Math.round((data.injected / Math.max(1, data.budget)) * 100));
+			const entries = results === null ? data.entries : results;
+
+			return h("div", { style: S.wrap },
+				h("div", { style: S.cards },
+					h(Card, { k: "注入 tokens", v: `${data.injected} / ${data.budget}`, extra: h("div", { style: S.bar }, h("i", { style: { ...S.barFill, width: `${pct}%`, display: "block" } })) }),
+					h(Card, { k: "活跃记忆", v: data.active }),
+					h(Card, { k: "置顶", v: data.pinned }),
+					h(Card, { k: "待复习", v: data.due ?? 0 }),
+					h(Card, { k: "归档 / 遗忘", v: data.archived }),
+					h(Card, { k: "今日对话", v: data.todayMessages }),
+					h(Card, { k: "候选线索", v: data.dreamCues })
+				),
+
+				h("div", { style: S.section },
+					h("h2", { style: S.h2 }, "L0 画像（每次会话常驻注入）"),
+					h("textarea", {
+						style: S.textarea,
+						value: profileDraft === null ? data.profile : profileDraft,
+						onChange: e => setProfileDraft(e.target.value)
+					}),
+					h("div", { style: { ...S.row, marginTop: "6px" } },
+						h("button", { style: S.btnPrimary, disabled: busy !== "", onClick: () => act("profile", { action: "profile", content: profileDraft ?? data.profile }) }, busy === "profile" ? "保存中…" : "保存画像"),
+						h("span", { style: S.muted }, `约 ${data.profileTokens} tokens`)
+					)
+				),
+
+				h("div", { style: S.section },
+					h("h2", { style: S.h2 }, "记忆（热索引 + 冷区）"),
+					h("div", { style: S.row },
+						h("input", {
+							style: S.input,
+							placeholder: "搜索记忆：标题 / 标签 / 正文",
+							value: query,
+							onChange: e => setQuery(e.target.value),
+							onKeyDown: async e => {
+								if (e.key !== "Enter") return;
+								if (query.trim() === "") { setResults(null); return; }
+								const r = await api("/action", { action: "search", query: query.trim() });
+								setResults(r.ok === true ? (r.matches || []) : []);
+							}
+						}),
+						h("button", { style: S.btn, onClick: async () => {
+							if (query.trim() === "") { setResults(null); return; }
+							const r = await api("/action", { action: "search", query: query.trim() });
+							setResults(r.ok === true ? (r.matches || []) : []);
+						} }, "搜索"),
+						h("button", { style: S.btn, onClick: () => { setQuery(""); setResults(null); } }, "重置")
+					),
+					entries.length === 0
+						? h("div", { style: { ...S.muted, marginTop: "8px" } }, results === null ? "还没有记忆" : "没有匹配的记忆")
+						: h("div", { style: { marginTop: "8px" } }, entries.map(e => h(MemoryRow, { key: e.id, entry: e, busy, onAct: act })))
+				),
+
+				h("div", { style: S.section },
+					h("h2", { style: S.h2 }, "睡梦机制"),
+					h("div", { style: S.muted }, `已做梦 ${data.dreams} 次 · 最近一次：${data.lastDream === "" ? "无" : data.lastDream}`),
+					h("div", { style: { ...S.row, marginTop: "6px" } },
+						h("button", { style: S.btnPrimary, disabled: busy !== "", onClick: () => act("dream", { action: "dream" }) }, busy === "dream" ? "做梦ing…" : "现在做梦"),
+						h("button", { style: S.btn, disabled: busy !== "", onClick: () => act("consolidate", { action: "consolidate" }) }, busy === "consolidate" ? "整理中…" : "整理记忆"),
+						notice === "" ? null : h("span", { style: S.muted }, notice)
+					),
+					data.dreamReport === "" ? null : h("pre", { style: S.pre }, data.dreamReport)
+				)
+			);
+		}
+
+		function Card(props) {
+			return h("div", { style: S.card },
+				h("div", { style: S.k }, props.k),
+				h("div", { style: S.v }, String(props.v)),
+				props.extra || null
+			);
+		}
+
+		function MemoryRow(props) {
+			const e = props.entry;
+			const isBusy = props.busy !== "";
+			const mark = e.due && !e.pinned ? "⏰ " : (e.pinned ? "★ " : "");
+			return h("div", { style: S.mem },
+				h("div", { style: S.memMain },
+					h("div", { style: S.title },
+						mark,
+						e.title,
+						(e.tags || []).map(t => h("span", { key: t, style: S.tag }, t))
+					),
+					h("div", { style: S.meta }, `${e.updated} · 生效 ${e.validFrom ?? ""} · 显著性 ${e.salience ?? 5} · 重要度 ${e.importance} · 命中 ${e.hits}${e.nextReview ? ` · 复习 ${String(e.nextReview).slice(0, 10)}` : ""}`)
+				),
+				h("button", { style: S.btn, disabled: isBusy, onClick: () => props.onAct(e.pinned ? "unpin" : "pin", { action: e.pinned ? "unpin" : "pin", id: e.id }) }, e.pinned ? "取消置顶" : "置顶"),
+				h("button", { style: S.btn, disabled: isBusy, onClick: () => props.onAct("forget", { action: "forget", id: e.id }) }, "遗忘")
+			);
+		}
+
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# 小肥鱼记忆（dsh-memory-fish）
+# 一行 insert：插件本体。宿主提供 peer 服务（@deepseek-ai/cordis、@deepseek-ai/dsh-tools）。
+- insert:
+    - id: memory-fish
+      name: dsh-memory-fish

package/icon.svg

@@ -0,0 +1,43 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
+  <rect width="128" height="128" rx="28" fill="#0f1419"/>
+  <defs>
+    <radialGradient id="g" cx="50%" cy="48%" r="58%">
+      <stop offset="0%" stop-color="#1e6f9f" stop-opacity=".5"/>
+      <stop offset="100%" stop-color="#0f1419" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+  <rect width="128" height="128" rx="28" fill="url(#g)"/>
+  <!-- tail -->
+  <path d="M80 64 L104 44 L98 64 Z" fill="#4cc2ff"/>
+  <path d="M80 64 L104 84 L98 64 Z" fill="#4cc2ff"/>
+  <!-- body -->
+  <ellipse cx="56" cy="64" rx="30" ry="24" fill="#56cdff"/>
+  <!-- memory strata -->
+  <rect x="54" y="55" width="24" height="6" rx="3" fill="#5ee0a0"/>
+  <rect x="54" y="65" width="21" height="6" rx="3" fill="#aaeBff"/>
+  <rect x="54" y="75" width="18" height="6" rx="3" fill="#ffffff"/>
+  <!-- neural nodes -->
+  <g stroke="#0f1419" stroke-width="1.6" opacity=".95">
+    <path d="M42 46 L56 40 L70 47 M56 40 L70 56 M42 46 L52 56"/>
+  </g>
+  <g fill="#0f1419">
+    <circle cx="42" cy="46" r="2.6"/><circle cx="56" cy="40" r="2.6"/>
+    <circle cx="70" cy="47" r="2.6"/><circle cx="70" cy="56" r="2.6"/>
+  </g>
+  <!-- eye + smile -->
+  <circle cx="40" cy="62" r="6" fill="#0f1419"/>
+  <circle cx="38" cy="59.5" r="2" fill="#fff"/>
+  <path d="M36 74 q6 7 12 1" stroke="#0f1419" stroke-width="2.6" fill="none" stroke-linecap="round"/>
+  <!-- belly pins -->
+  <g fill="#5ee0a0">
+    <rect x="38" y="88" width="6" height="9" rx="1.5"/>
+    <rect x="48" y="88" width="6" height="9" rx="1.5"/>
+    <rect x="58" y="88" width="6" height="9" rx="1.5"/>
+    <rect x="68" y="88" width="6" height="9" rx="1.5"/>
+  </g>
+  <!-- puzzle dorsal fin -->
+  <g fill="#5ee0a0">
+    <rect x="48" y="22" width="22" height="13" rx="3"/>
+    <circle cx="65" cy="22" r="5"/>
+  </g>
+</svg>

package/index.mjs

@@ -0,0 +1,101 @@
+/**
+ * dsh-memory-fish — 小肥鱼记忆
+ *
+ * 上下文成本恒定的本地记忆插件：
+ *   L0 画像 (≤200 tok, 常驻) + L1 热索引 (≤400 tok, 常驻)
+ *   L2 温记忆 (磁盘, memory_search/read 取) + L3 冷档案 (从不注入)
+ *
+ * 零依赖、零服务端、零进程。数据全部是 Markdown + JSON。
+ */
+
+import path from 'node:path';
+import { resolveConfig } from './lib/config.mjs';
+import { Store } from './lib/store.mjs';
+import { buildInjection } from './lib/inject.mjs';
+import { registerTools } from './lib/tools.mjs';
+import { registerPanelRoutes } from './lib/panel.mjs';
+import { nowIso, messageText, redactSecrets } from './lib/util.mjs';
+import { configureLogger, log } from './lib/log.mjs';
+
+export const name = 'dsh-memory-fish';
+export const inject = ['tools', 'systemPrompt'];
+
+export function apply(ctx, config = {}) {
+  const cfg = resolveConfig(config);
+  const store = new Store(cfg.dir);
+  configureLogger({ enabled: cfg.debug, file: path.join(cfg.dir, 'debug.log') });
+
+  // 启动时初始化（失败不拖垮宿主）
+  store.init().catch(() => {});
+
+  // ---- 注入 ----
+  try {
+    if (ctx.systemPrompt !== undefined) {
+      let order = 500;
+      try {
+        const raw = ctx.systemPrompt.getSectionOrder?.('TOOL_GOAL');
+        if (typeof raw === 'number' && Number.isFinite(raw)) order = raw;
+      } catch { /* 用默认 */ }
+      ctx.systemPrompt.section({
+        name: 'dsh-memory-fish:auto',
+        order,
+        text: () => {
+          try {
+            return buildInjection(store, cfg).text;
+          } catch {
+            return '';
+          }
+        },
+      });
+    }
+  } catch { /* 没有 systemPrompt 服务：工具仍然可用 */ }
+
+
+  const toolImpl = {};
+
+  // ---- 自动捕获：对话落 journal（L3 原始层，永不注入，供做梦回顾） ----
+  try {
+    if (cfg.autoCapture && typeof ctx.on === 'function') {
+      ctx.on('session/event', (session, event) => {
+        try {
+          if (!event || typeof event !== 'object') return;
+          if (cfg.skipSubagentSessions && session?.header?.origin === 'subagent') return;
+          const types = ['user/message', 'assistant/message'];
+          if (!types.includes(event.type)) return;
+          const message = event.type === 'user/message' ? event.data : event.data?.message;
+          if (!message || message.role === 'system') return;
+          const kind = message.source?.kind;
+          if (event.type === 'user/message' && kind && kind !== 'user') return; // 跳过注入的合成上下文
+          if (message.source?.kind === 'tool') return;
+          const text = messageText(message).trim();
+          if (!text) return;
+          const role = event.type === 'assistant/message' ? 'assistant' : 'user';
+          store.appendJournal({
+            ts: nowIso(),
+            session: String(session?.id ?? ''),
+            role,
+            text: redactSecrets(text).slice(0, cfg.captureMaxChars),
+          }).catch(() => {});
+          store.stats.captured = (store.stats.captured || 0) + 1;
+        } catch { /* 捕获失败绝不影响会话 */ }
+      });
+    }
+  } catch { /* 宿主没有事件总线 */ }
+
+  registerTools(ctx, store, cfg, toolImpl);
+
+  // ---- journal 清理（启动 5 秒后跑一次，不拖慢启动） ----
+  setTimeout(() => { store.pruneJournal(cfg.journalKeepDays).catch(() => {}); }, 5000);
+
+  // ---- 可视化面板：宿主的 webServer 路由；没有也不影响工具 ----
+  try {
+    const injectFn = ctx.inject;
+    if (typeof injectFn === 'function') {
+      injectFn.call(ctx, ['webServer'], (webCtx) => {
+        try {
+          registerPanelRoutes(webCtx?.webServer, store, cfg, toolImpl);
+        } catch { /* 面板挂了也不影响记忆工具 */ }
+      });
+    }
+  } catch { /* 宿主没有 webServer 服务 */ }
+}

package/lib/config.mjs

@@ -0,0 +1,44 @@
+import path from 'node:path';
+import os from 'node:os';
+
+// ---------------------------------------------------------------- 配置
+
+export const DEFAULTS = {
+  debug: false,          // 调试日志（写 <dir>/debug.log）
+  dir: path.join(os.homedir(), '.dsh', 'memory-fish'),
+  budgetTokens: 600,       // L0 + L1 硬预算
+  profileTokens: 200,      // L0 预算
+  maxHotLines: 12,         // L1 最多行数（人脑工作记忆 4±1，取 8-12）
+  archiveAfterDays: 60,    // 衰减归档阈值（天，低 salience 才适用）
+  dedupeThreshold: 0.75,   // 写入去重相似度（>= 更新）
+  noopThreshold: 0.92,     // 新颖性门控：>= 视为完全重复，不写只记一次检索
+  salienceBase: 3,         // 显著性基础分
+  reviewEnabled: true,     // 复习调度（SM-2 简化版）
+  autoCapture: true,       // 自动捕获：把对话写进 journal（L3 原始层，永不注入）
+  captureMaxChars: 4000,   // 单条消息最多记录字符数
+  skipSubagentSessions: true,
+  journalKeepDays: 30,     // journal 保留天数
+  dreamDays: 2,            // 做梦默认回顾最近几天的 journal
+  dreamAutoSave: false,    // 做梦时是否自动落库（默认只给候选）
+  dreamReminder: true,     // C1：到点后在注入块里提醒做梦（不依赖宿主调度器）
+  dreamAfterHours: 24,     // 距上次做梦超过多少小时算"欠一次"
+  panelPath: '/memory-fish/panel',
+  apiBase: '/memory-fish/api',
+};
+
+/** 运行期合并用户配置；只接受已知字段。 */
+export function resolveConfig(input = {}) {
+  const base = { ...DEFAULTS };
+  const out = { ...base };
+  if (input && typeof input === 'object') {
+    for (const key of Object.keys(base)) {
+      if (input[key] !== undefined) out[key] = input[key];
+    }
+  }
+  // 数值字段兜底，避免用户填字符串把预算算崩
+  for (const key of ['budgetTokens', 'profileTokens', 'maxHotLines', 'archiveAfterDays', 'dedupeThreshold', 'noopThreshold', 'captureMaxChars', 'journalKeepDays', 'dreamDays', 'dreamAfterHours']) {
+    const n = Number(out[key]);
+    if (Number.isFinite(n)) out[key] = n;
+  }
+  return out;
+}

package/lib/core.mjs

@@ -0,0 +1,104 @@
+import { promises as fs } from 'node:fs';
+import { SECRET_RE, similar, salienceFor, initialStability, addDays, slugify, stamp, nowIso, out, reinforce } from './util.mjs';
+import { buildInjection } from './inject.mjs';
+
+export async function saveMemoryCore(store, cfg, args) {
+  const title = String(args.title ?? '').trim();
+  const content = String(args.content ?? '').trim();
+  if (!title || !content) return out({ ok: false, code: 'invalid_input', message: 'title 与 content 不能为空' });
+  if (SECRET_RE.test(content) || SECRET_RE.test(title)) {
+    return out({ ok: false, code: 'secret_refused', message: '疑似密钥/凭据，拒绝保存。请去掉敏感值后重试。' });
+  }
+  if (!store.entries.length) await store.load();
+
+  const tags = (args.tags || []).map(t => String(t).trim()).filter(Boolean).slice(0, 3);
+  const importance = Math.min(5, Math.max(1, Math.trunc(Number(args.importance) || 3)));
+  const pin = args.pin === true;
+
+  let target = null;
+  let best = 0;
+  for (const e of store.entries) {
+    if (e.status !== 'active') continue;
+    const sim = similar(`${e.title}\n${e.content ?? ''}`, `${title}\n${content}`);
+    if (sim > best) { best = sim; target = e; }
+  }
+
+  // 新颖性门控：几乎一模一样 → NOOP，只记一次"被检索"（提取练习）
+  if (target && best >= cfg.noopThreshold) {
+    reinforce(target, 1.2);
+    await store.saveIndex();
+    return out({
+      ok: true, saved: false, updated: false, noop: true, id: target.id,
+      similarity: Number(best.toFixed(2)), reason: '与已有记忆几乎相同，已跳过写入（只记录一次复习）',
+    });
+  }
+
+  // 显著性：编码阶段的"值不值得记"
+  const novelty = best > 0 ? 1 - best : 1;
+  const salience = Math.max(
+    salienceFor({ title, content, importance, pin, novelty }),
+    args.salience ? Math.min(10, Math.max(1, Math.trunc(Number(args.salience)))) : 0,
+  );
+
+  if (target && best >= cfg.dedupeThreshold) {
+    const at = nowIso();
+    try {
+      const oldText = await fs.readFile(target.file, 'utf8');
+      await store.archiveContent(target, oldText);
+    } catch { /* 老文件丢了也继续 */ }
+    // P3 时间有效性：旧版本封存为历史（带 validFrom/validTo），当前版本换新有效期
+    target.history = [
+      ...(target.history || []),
+      {
+        title: target.title,
+        content: target.content,
+        validFrom: target.validFrom || target.created || at,
+        validTo: at,
+      },
+    ].slice(-10);
+    target.title = title;
+    target.content = content;
+    target.tags = tags.length ? tags : target.tags;
+    target.importance = Math.max(target.importance ?? 3, importance);
+    target.pinned = target.pinned || pin;
+    target.salience = Math.max(target.salience ?? 5, salience);
+    target.updated = at;
+    target.validFrom = at;
+    target.validTo = null;
+    // 再巩固：旧记忆被改写，复习节奏重新起算（但保留已有稳定性）
+    target.lastReview = at;
+    target.stability = Math.max(target.stability || initialStability(target.importance, target.salience), initialStability(target.importance, target.salience));
+    target.nextReview = addDays(at, Math.round(target.stability));
+    await store.writeMemory(target, content);
+    await store.saveIndex();
+    store.stats.updated += 1;
+    await store.saveStats();
+    return out({
+      ok: true, saved: true, updated: true, id: target.id,
+      similarity: Number(best.toFixed(2)), salience: target.salience,
+      validFrom: target.validFrom, historyCount: (target.history || []).length, scope: 'user',
+    });
+  }
+
+  const now = nowIso();
+  const stability = initialStability(importance, salience);
+  const id = `${stamp()}-${slugify(title)}`;
+  const entry = {
+    id, title, content, tags, importance, salience, pinned: pin,
+    created: now, updated: now, validFrom: now, validTo: null, history: [],
+    hits: 0, lastHit: null,
+    status: 'active', supersedes: [], links: [], chars: 0, tokens: 0, file: '',
+    stability, lastReview: now, nextReview: addDays(now, Math.round(stability)), reviews: 0,
+  };
+  await store.writeMemory(entry, content);
+  store.entries.push(entry);
+  await store.saveIndex();
+  store.stats.saved += 1;
+  await store.saveStats();
+  const hot = buildInjection(store, cfg);
+  return out({
+    ok: true, saved: true, updated: false, id, novelty: Number(novelty.toFixed(2)), salience, stability,
+    nextReview: entry.nextReview, validFrom: entry.validFrom, scope: 'user',
+    indexLines: hot.l1Lines, coldRemaining: hot.cold, injectedTokens: hot.l1Tokens,
+  });
+}