sage-mem 0.9.8 → 0.9.9

package/README.md

@@ -53,9 +53,13 @@ sage-mem 换一条路：**每条记忆就是一个 Markdown 文件**。用编辑
 
 *工具抽屉 —— 关着时只占一个按钮，展开后两项各带状态：归档候选 2 条 / 保留名 3 个。（体检不在这里：它自己有一页。）*
 
+![锁定：按钮在「编辑」与「归档」之间，锁上后归档被禁用](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/lock-card.png)
+
+*锁定 —— 重要记忆（人设、偏好这类）点一下就锁上：**自动归档的候选里不再出现它，手动点归档也会被宿主拒绝**。锁存在状态目录里，不写进记忆自己的 frontmatter —— 那会被自动整理重写掉，锁一丢它又会回到候选里。*
+
 ![体检：独立一页，硬问题按类报红分节，「指向已归档」只作提示](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/audit.png)
 
-*体检（排在「自动做梦」之后的第 4 个页签）—— 索引悬空、漏索引、断链这类硬问题按类报红；「指向已归档」只作提示、不计入问题，也不提供一键修补按钮（改哪条由你决定）。*
+*体检（独立成一个页签）—— 索引悬空、漏索引、断链这类硬问题按类报红；「指向已归档」只作提示、不计入问题，也不提供一键修补按钮（改哪条由你决定）。从档案馆恢复一条记忆时，插件会顺手把它补回索引 —— 以前只搬文件、不补条目，于是顶层有文件、`MEMORY.md` 里没有，体检一直报「漏索引」。*
 
 ![更新提示：只在真有新版本时出现一条横幅](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/update-banner.png)
 
@@ -73,6 +77,10 @@ sage-mem 换一条路：**每条记忆就是一个 Markdown 文件**。用编辑
 
 *自动做梦 · 设置 —— 运行 / 设置 / 记录 二级分组；五个注入参数两列排开，并写清「当前生效」与「重启后」，不会让人误以为改完立刻生效。*
 
+![自动归档：独立一页，先说清它做什么，三档策略与三个闲置阈值都在这儿](https://raw.githubusercontent.com/gezi-wen/sage-mem/main/docs/images/archive-settings.png)
+
+*自动归档（独立成一个页签，排在「自动做梦」与「体检」之间）—— 它和自动做梦不是一件事：归档是**确定性规则**（按访问台账的闲置天数算，不调模型），混在模型那套设置里既难找、也容易让人以为归档会花钱。这一页决定「多久算闲置」，以及要不要真的动手；阈值**保存即生效**，不用重启。*
+
 ## 快速开始
 
 需要 DSH `0.1.2-rc.1` 或更高（见[兼容性](#dsh-兼容性)），Node.js `>= 18`。

package/lib/client.js

@@ -2007,6 +2007,8 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-tool-panel--full{width:100%;align-self:stretch;box-sizing:border-box;}",
 			// 已锁定的记忆：卡片上那个按钮要一眼看出「这条现在拒绝归档」，用警示色
 			".smem-btn-locked{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706);}",
+			// 「自动归档」页签里的天数输入框：窄一点，别让三个数字各占一整行
+			".smem-num{width:88px;}",
 			// 体检 / 候选是「翻清单」的面板：定高 + 内部滚动，列表不被顶出首屏。
 			// 原样编辑器（.smem-ar-editor）不设上限 —— 那是专心改一份文件的界面，给它完整高度。
 			".smem-tool-panel--cap{max-height:320px;overflow-y:auto;}",
@@ -2556,8 +2558,8 @@ const StarmapRuntime = (function (require, _react) {
 		};
 		const autoArchiveOf = (v) => (v === "off" || v === "auto" ? v : "report");
 
-		/** 头部带上的「我在哪」：四个 tab 的中文名（与 .smem-tabs 上的字面一致）。 */
-		const TAB_LABEL = { files: "文件列表", star: "记忆星图", autodream: "自动做梦", audit: "体检" };
+		/** 头部带上的「我在哪」：五个 tab 的中文名（与 .smem-tabs 上的字面一致）。 */
+		const TAB_LABEL = { files: "文件列表", star: "记忆星图", autodream: "自动做梦", archive: "自动归档", audit: "体检" };
 
 		/**
 		 * 工具面板头部的「收起」按钮：抽屉里开的工具要能一键收回去 ——
@@ -2836,7 +2838,6 @@ const StarmapRuntime = (function (require, _react) {
 			const sMemSet = react.useState(null); const memSet = sMemSet[0], setMemSet = sMemSet[1];
 			const sLimitsDraft = react.useState(null); const limitsDraft = sLimitsDraft[0], setLimitsDraft = sLimitsDraft[1];
 			const sSaveBusy = react.useState(false); const saveBusy = sSaveBusy[0], setSaveBusy = sSaveBusy[1];
-			const sAutoSaving = react.useState(false); const autoSaving = sAutoSaving[0], setAutoSaving = sAutoSaving[1];
 			const sReservedNew = react.useState(""); const reservedNew = sReservedNew[0], setReservedNew = sReservedNew[1];
 
 			// 派生量放在 effect 之前：下面几个 effect 的依赖数组要在渲染期就能取到值。
@@ -2936,35 +2937,6 @@ const StarmapRuntime = (function (require, _react) {
 				}, function (e) { setErr(detail(e)); });
 			}
 
-			/**
-			 * 自动归档三档：保存后**回读校验**。
-			 *
-			 * `setConfig` 对非法值沿用的是「忽略、保留原值」的语义（没有 `{ok:false}` 通道），
-			 * 所以不能只看它返回的 config —— 必须再 `getConfig()` 一次，确认那个值真的落在
-			 * 配置里。没变就报错：**不能让用户点了保存以为成了、实际什么都没发生**。
-			 */
-			function saveAutoArchive(v) {
-				setErr(null); setNotice(""); setAutoSaving(true);
-				callRemote("setConfig", [{ autoArchive: v }], function (d) {
-					if (d && d.config && d.config.autoArchive === v) {
-						setCfg(d.config);
-						setAutoSaving(false);
-						setNotice("自动归档已设为「" + AUTO_ARCHIVE_LABEL[v] + "」");
-						return;
-					}
-					// 返回的 config 里没看到新值 → 回读一次再定论
-					callRemote("getConfig", [], function (d2) {
-						const next = d2 && d2.config ? d2.config : null;
-						setAutoSaving(false);
-						if (next) setCfg(next);
-						const got = next ? autoArchiveOf(next.autoArchive) : null;
-						if (got === v) { setNotice("自动归档已设为「" + AUTO_ARCHIVE_LABEL[v] + "」"); return; }
-						setErr("保存没生效：配置里仍是「" + (got ? AUTO_ARCHIVE_LABEL[got] : "读不出来") +
-							"」。setConfig 对非法值会忽略并保留原值 —— 请重试，或看 DSH 启动日志。");
-					}, function (m) { setAutoSaving(false); setErr("保存后回读失败：" + m); });
-				}, function (m) { setAutoSaving(false); setErr(m); });
-			}
-
 			/** 保存 5 项上限。越界/非整数**本地先拦**（host 也是直接拒绝），别让它白跑一趟。 */
 			function saveLimits() {
 				if (!memRemote || typeof memRemote.setSettings !== "function") { setErr("宿主侧还没有 setSettings 接口（插件版本较旧）"); return; }
@@ -3262,28 +3234,9 @@ const StarmapRuntime = (function (require, _react) {
 				]),
 				]) : null,
 				segOf === "settings" ? h("div", { className: "smem-seg", key: "seg-set" }, [
-				h("div", { className: "smem-autodream-sec", key: "autoarchive" }, [
-					h("div", { className: "smem-autodream-row", key: "r" }, [
-						h("span", { className: "smem-autodream-key", key: "k" }, "自动归档"),
-						h(Seg, {
-							key: "v", value: autoArchiveOf(c.autoArchive),
-							options: [
-								{ value: "off", label: AUTO_ARCHIVE_LABEL.off },
-								{ value: "report", label: AUTO_ARCHIVE_LABEL.report },
-								{ value: "auto", label: AUTO_ARCHIVE_LABEL.auto },
-							],
-							// 点一档就存一档，但**存完要回读**：setConfig 对非法值是静默忽略，
-							// 只信返回值不够（见 saveAutoArchive 的注释）。
-							onChange: function (v) { if (v !== autoArchiveOf(c.autoArchive)) saveAutoArchive(v); },
-						}),
-						autoSaving ? h("span", { className: "smem-status", key: "s" }, "保存中…") : null,
-					]),
-					h("div", { className: "smem-autodream-note", key: "cost" }, AUTO_ARCHIVE_COST[autoArchiveOf(c.autoArchive)]),
-					autoArchiveOf(c.autoArchive) === "auto" && !c.apply
-						? h("div", { className: "smem-autodream-note smem-ad-warn", key: "deg" },
-								"注意：现在「改动方式」是只出报告 —— 这一档会自动降级成只出报告，不会动文件。")
-						: null,
-				]),
+				// 自动归档那一段（三档策略 + 三个阈值）**已挪到「自动归档」页签**（v0.9.9）：
+				// 归档是确定性规则、不调模型，和这一页的「让模型整理」不是一件事；
+				// 同一件事只在一处设定，这里不再重复摆一份。
 				h("div", { className: "smem-autodream-sec", key: "limits" }, [
 					h("div", { className: "smem-autodream-row", key: "h" }, [
 						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "记忆注入参数"),
@@ -3499,6 +3452,187 @@ const StarmapRuntime = (function (require, _react) {
 			]);
 		}
 
+		/**
+		 * 「自动归档」面板 —— 独立成一屏（v0.9.9）。
+		 *
+		 * 为什么独立出来（用户 2026-10-11）：这一块原来塞在「自动做梦 → 设置」里，
+		 * 他自己的原话是「扔这里连我都找不到」。而且它确实是**另一件事**：
+		 *   自动做梦 = 让模型读记忆、整理、改写（要调模型、有 token 成本）
+		 *   自动归档 = 按「多久没被注入过」把记忆移进 archive/（纯确定性规则、不调模型）
+		 * 混在模型那套设置里，既难找、也容易让人以为归档会花钱。
+		 *
+		 * 这一页管两件事：
+		 *   1. **三档策略**：关闭 / 只出报告 / 满足条件自动跑
+		 *   2. **三个阈值**（项目 / 参考 / 用户）：多少天没被注入就算闲置
+		 *
+		 * 数据全走 `remote.autodream` 的 `getConfig` / `setConfig` —— 阈值本来就在配置里
+		 * （`lib/autodream/config.js` 的 archiveAfterDays*），只是以前**界面够不着**。
+		 * 所以这一版没有新增任何 remote。
+		 *
+		 * 两处诚实标注：阈值**存完立即生效**（不经过模块加载期固化，与注入参数不同）；
+		 * 保存后**一定回读**（`setConfig` 对非法值是「忽略并保留原值」，只信返回值会骗人）。
+		 */
+		function ArchiveSettingsPanel(props) {
+			const remote = props.ctx && props.ctx.get ? props.ctx.get("remote.autodream") : null;
+			const sCfg = react.useState(null); const cfg = sCfg[0], setCfg = sCfg[1];
+			const sDraft = react.useState(null); const draft = sDraft[0], setDraft = sDraft[1];
+			const sErr = react.useState(null); const err = sErr[0], setErr = sErr[1];
+			const sNotice = react.useState(""); const notice = sNotice[0], setNotice = sNotice[1];
+			const sBusy = react.useState(false); const busy = sBusy[0], setBusy = sBusy[1];
+
+			const TH_KEYS = ["archiveAfterDaysProject", "archiveAfterDaysReference", "archiveAfterDaysUser"];
+			const TH_LABEL = { archiveAfterDaysProject: "项目", archiveAfterDaysReference: "参考", archiveAfterDaysUser: "用户" };
+			const TH_HINT = {
+				archiveAfterDaysProject: "project_* 连续这么多天没被注入 → 进候选",
+				archiveAfterDaysReference: "reference_* 同上（资料一般比项目留得久）",
+				archiveAfterDaysUser: "user_* 同上（人设这类动它要格外谨慎）",
+			};
+
+			/** 阈值 → 输入框草稿。存成字符串：number input 清空时立刻变 0 会很难用。 */
+			const draftOf = function (c) {
+				const src = c || {};
+				const out = {};
+				for (const k of TH_KEYS) out[k] = String(src[k] == null ? "" : src[k]);
+				return out;
+			};
+
+			react.useEffect(function () {
+				if (!remote || typeof remote.getConfig !== "function") {
+					setErr("宿主侧没有 autodream 配置接口（插件版本较旧）");
+					return;
+				}
+				remote.getConfig()
+					.then(function (r) {
+						const d = unwrap(r);
+						const c = d && d.config ? d.config : null;
+						if (!c) { setErr("读不出自动做梦配置"); return; }
+						setCfg(c);
+						setDraft(draftOf(c));
+					})
+					.catch(function (e) { setErr("读配置失败：" + ((e && e.message) || e)); });
+			}, []);
+
+			const c = cfg || {};
+			const mode = autoArchiveOf(c.autoArchive);
+
+			/**
+			 * 存完回读。
+			 * @param {Object} patch 要写的配置
+			 * @param {string} okMsg 成功提示
+			 * @param {Function} failOf (got) => string|null —— 返回 null 表示这次改动真的落进去了
+			 */
+			function save(patch, okMsg, failOf) {
+				setBusy(true); setErr(null); setNotice("");
+				remote.setConfig(patch)
+					.then(function () { return remote.getConfig(); })
+					.then(function (r) {
+						const d = unwrap(r);
+						const got = d && d.config ? d.config : null;
+						if (got) { setCfg(got); setDraft(draftOf(got)); }
+						const bad = failOf(got);
+						if (!bad) { setNotice(okMsg); return; }
+						setErr("保存没生效：" + bad + "。setConfig 对非法值会忽略并保留原值 —— 请重试，或看 DSH 启动日志。");
+					})
+					.catch(function (e) { setErr("保存失败：" + ((e && e.message) || e)); })
+					.then(function () { setBusy(false); });
+			}
+
+			function saveMode(v) {
+				save({ autoArchive: v }, "自动归档已设为「" + AUTO_ARCHIVE_LABEL[v] + "」", function (got) {
+					const g = got ? autoArchiveOf(got.autoArchive) : null;
+					return g === v ? null : ("配置里仍是「" + (g ? AUTO_ARCHIVE_LABEL[g] : "读不出来") + "」");
+				});
+			}
+
+			/** 越界/非整数**本地先拦**（host 也会拒），别让它白跑一趟。 */
+			function saveThresholds() {
+				const d = draft || {};
+				const patch = {};
+				for (const k of TH_KEYS) {
+					const n = Number(d[k]);
+					if (!Number.isFinite(n) || n < 1 || n > 3650) {
+						setErr(TH_LABEL[k] + "的阈值要是 1~3650 之间的天数（现在是「" + d[k] + "」）");
+						return;
+					}
+					patch[k] = Math.round(n);
+				}
+				save(patch, "归档条件已保存", function (got) {
+					const bad = TH_KEYS.filter(function (k) { return !got || Number(got[k]) !== patch[k]; });
+					if (!bad.length) return null;
+					return bad.map(function (k) { return TH_LABEL[k] + " 仍是 " + (got ? got[k] : "读不出来"); }).join("、");
+				});
+			}
+
+			return h("div", { className: "smem-seg" }, [
+				// ── ① 它做什么（这一屏存在的理由写在最前面）──
+				h("div", { className: "smem-autodream-sec", key: "what" }, [
+					h("div", { className: "smem-autodream-row", key: "h" }, [
+						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "自动归档做什么"),
+					]),
+					h("div", { className: "smem-autodream-note", key: "p1" },
+						"闲置太久没被注入过的记忆，会被移进 archive/ —— 不删除，随时能恢复。这一页决定「多久算闲置」，以及要不要真的动手。"),
+					h("div", { className: "smem-autodream-note", key: "p2" },
+						"它不调模型：候选完全按访问台账的天数算，同一份输入每次算出来都一样。"),
+					h("div", { className: "smem-autodream-note", key: "p3" },
+						"想现在看看会被收走哪些：文件列表 →「工具 ▾」→ 归档候选。"),
+				]),
+				// ── ② 三档策略 ──
+				h("div", { className: "smem-autodream-sec", key: "mode" }, [
+					h("div", { className: "smem-autodream-row", key: "r" }, [
+						h("span", { className: "smem-autodream-key", key: "k" }, "自动归档"),
+						h(Seg, {
+							key: "v", value: mode,
+							options: [
+								{ value: "off", label: AUTO_ARCHIVE_LABEL.off },
+								{ value: "report", label: AUTO_ARCHIVE_LABEL.report },
+								{ value: "auto", label: AUTO_ARCHIVE_LABEL.auto },
+							],
+							onChange: function (v) { if (v !== mode) saveMode(v); },
+						}),
+						busy ? h("span", { className: "smem-status", key: "s" }, "保存中…") : null,
+					]),
+					h("div", { className: "smem-autodream-note", key: "cost" }, AUTO_ARCHIVE_COST[mode]),
+					mode === "auto" && !c.apply
+						? h("div", { className: "smem-autodream-note smem-ad-warn", key: "deg" },
+								"注意：「自动做梦 → 改动方式」现在是只出报告 —— 这一档会自动降级成只出报告，不会动文件。")
+						: null,
+				]),
+				// ── ③ 三个阈值 ──
+				h("div", { className: "smem-autodream-sec", key: "th" }, [
+					h("div", { className: "smem-autodream-row", key: "h" }, [
+						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "闲置多少天算可以归档"),
+					]),
+					draft
+						? h("div", { key: "rows" }, TH_KEYS.map(function (k) {
+								return h("div", { className: "smem-autodream-row", key: k }, [
+									h("span", { className: "smem-autodream-key", key: "k" }, TH_LABEL[k]),
+									h("input", {
+										className: "smem-input smem-num", key: "i", type: "number", min: 1, max: 3650,
+										value: draft[k],
+										onChange: function (e) {
+											const nx = Object.assign({}, draft);
+											nx[k] = e.target.value;
+											setDraft(nx);
+										},
+									}),
+									h("span", { className: "smem-muted", key: "u" }, TH_HINT[k]),
+								]);
+							}))
+						: h("div", { className: "smem-muted", key: "loading" }, "读配置中…"),
+					h("div", { className: "smem-autodream-row", key: "btns" }, [
+						h("button", {
+							type: "button", className: "smem-btn smem-btn-primary", key: "save",
+							disabled: busy || !draft, onClick: saveThresholds,
+						}, busy ? "保存中…" : "保存归档条件"),
+						h("span", { className: "smem-muted", key: "n" }, "保存即生效，不用重启 DSH"),
+					]),
+					h("div", { className: "smem-autodream-note", key: "note" },
+						"天数按访问台账算（这条记忆上次被注入给模型是什么时候）。feedback_* 永不入选；锁定的记忆也不会被选中。"),
+				]),
+				err ? h("div", { className: "smem-err", key: "err" }, "⚠ " + err) : null,
+				notice ? h("div", { className: "smem-ok", key: "ok" }, "✓ " + notice) : null,
+			]);
+		}
 		function Section(props) {
 			const remote = props.ctx.get("remote.memory");
 			const sItems = react.useState([]);
@@ -4180,7 +4314,11 @@ const StarmapRuntime = (function (require, _react) {
 					h("button", { type: "button", className: "smem-tab" + (tab === "files" ? " smem-tab--on" : ""), key: "f", onClick: function () { setTab("files"); } }, "文件列表"),
 					h("button", { type: "button", className: "smem-tab" + (tab === "star" ? " smem-tab--on" : ""), key: "s", onClick: function () { setTab("star"); } }, "记忆星图"),
 					h("button", { type: "button", className: "smem-tab" + (tab === "autodream" ? " smem-tab--on" : ""), key: "d", onClick: function () { setTab("autodream"); } }, "自动做梦"),
-					// 体检排在「自动做梦」之后、独立成一屏：它只报告不修改，和「文件列表」里的
+					// 「自动归档」排在自动做梦之后：归档是**确定性规则**（按闲置天数算，不调模型），
+					// 和「让模型整理记忆」是两件事。塞在自动做梦的设置里用户找不到
+					// （2026-10-11 用户原话：「扔这里连我都找不到」）。
+					h("button", { type: "button", className: "smem-tab" + (tab === "archive" ? " smem-tab--on" : ""), key: "ar", onClick: function () { setTab("archive"); } }, "自动归档"),
+					// 体检再排在「自动归档」之后、独立成一屏：它只报告不修改，和「文件列表」里的
 					// 增删改是两件事，塞在工具抽屉里会让人以为它是个动作按钮。
 					h("button", { type: "button", className: "smem-tab" + (tab === "audit" ? " smem-tab--on" : ""), key: "a", onClick: openAuditTab }, "体检"),
 				]),
@@ -4387,6 +4525,8 @@ const StarmapRuntime = (function (require, _react) {
 					: tab === "star"
 					? h("div", { className: "smem-starmap", key: "starmap" },
 							h(StarmapRuntime.StarMap, { ctx: props.ctx }))
+					: tab === "archive"
+					? h(ArchiveSettingsPanel, { key: "archive", ctx: props.ctx })
 					: tab === "audit"
 					// 体检面板在上面已经渲染过了 —— 这里必须显式给 null，
 					// 否则会落进下面那个 `filesView` 兜底分支，变成「体检 + 一整套文件列表」同屏。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sage-mem",
   "description": "File-based memory plugin for DeepSeek Harness (DSH) — cross-session memory in plain markdown files, with a memory star-map view, type/tag filtering, retrieval aliases, and an optional autodream pass that consolidates memories on demand or on a schedule — with per-run rollback points, a per-file change declaration (what changed and why), and a separately selectable model for the consolidation pass",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "type": "module",
   "main": "lib/index.js",
   "exports": {