sage-mem 0.6.4 → 0.7.0

package/lib/client.js

@@ -1,7 +1,7 @@
 /**
  * sage-mem — 客户端半：DSH 设置页「记忆管理」界面（文件管理器）。
  *
- * 手写 ModuleLoader bundle（与官方 dsh-client-* 包的构建产物同格式）：
+ * 手写 ModuleLoader bundle（`window.__ModuleLoader__.load({ id, factory })` 格式）：
  * window.__ModuleLoader__.load({ id, factory })，factory 内 require('react')
  * 可用，module.exports 导出标准 Cordis 插件（apply/inject）。
  *
@@ -1311,7 +1311,7 @@ const StarmapRuntime = (function (require, _react) {
 
 		/**
 		 * Client 插件：$mount strict remote contribution（第三方 remote 不在
-		 * dsh-api-remotes 的固定列表里，必须自己挂），再注册 footer 按钮与 overlay。
+		 * 宿主的固定 remote 清单里，必须自己挂），再注册 footer 按钮与 overlay。
 		 */
 		async function apply(ctx) {
 			appCtx = ctx;
@@ -1366,7 +1366,7 @@ const StarmapRuntime = (function (require, _react) {
 		const starmapListSchema = { parse(v) { if (!v || typeof v !== "object") throw new Error("expected object"); if (!Array.isArray(v.stars)) throw new Error("expected stars array"); v.stars.forEach((f) => starmapStarSchema.parse(f)); return v; } };
 		const starmapReadSchema = parseSchema({ "name": isStr, "content": isStr });
 
-		// ── dream 的 codec ──
+		// ── autodream 的 codec ──
 		// 刻意写得宽：这几个方法返回的是配置 / 状态对象，字段会随版本增删。
 		// 用 parseSchema 逐字段硬写一遍的代价是 —— host 那边加一个字段，client 的旧
 		// schema 就把整条调用当「缺字段」拒掉（parseSchema 会 throw missing field），
@@ -1383,12 +1383,6 @@ const StarmapRuntime = (function (require, _react) {
 				return v;
 			},
 		};
-		const boolCodec = {
-			parse(v) {
-				if (typeof v !== "boolean") throw new Error("sage-mem: expected boolean");
-				return v;
-			},
-		};
 
 		const TYPERT_REMOTE = {
 			package: "sage-mem",
@@ -1462,87 +1456,139 @@ const StarmapRuntime = (function (require, _react) {
 					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapRead", schema: starmapReadSchema, create: () => starmapReadSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
-				// ── dream（做梦）──
-				// 2026-09-27 踩到的坑：namespace 不会自动出现。dsh-api-remotes 里那份
-				// remote 清单是**官方构建期生成的产物**，只有 memory / starmap 在里面；
-				// 后加的 dream 不在，于是 `ctx.get("remote.dream")` 永远 undefined ——
-				// 界面上表现为「remote.dream 不可用」，而 host 半日志明确写着
-				// 「dream gateway mounted ok」（服务是真的挂上了，只是 client 不知道）。
-				// 修法就是这七条：和 memory / starmap 一样，自己声明 + $mount。
+				// ── autodream（自动做梦）──
+				// 踩到的坑：namespace 不会自动出现。宿主那份 remote 清单是**构建期生成的
+				// 产物**，只有 memory / starmap 在里面；
+				// 后加的 autodream 不在，于是 `ctx.get("remote.autodream")` 永远 undefined ——
+				// 界面上表现为「remote.autodream 不可用」，而 host 半日志明确写着
+				// 「autodream gateway mounted ok」（服务是真的挂上了，只是 client 不知道）。
+				// 修法就是自己声明 + $mount，和 memory / starmap 一样（现在共十一条：
+				// 七个原有方法 + listRuns / readDeclaration / rollback / listModels）。
 				{
-					id: "sage-mem#dream/getConfig",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/getConfig",
+					service: "autodream",
+					namespace: "autodream",
 					method: "getConfig",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamConfigResult", schema: objCodec, create: () => objCodec },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamConfigResult", schema: objCodec, create: () => objCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
-					id: "sage-mem#dream/setConfig",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/setConfig",
+					service: "autodream",
+					namespace: "autodream",
 					method: "setConfig",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "patch", wire: "patch", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#DreamPatch", schema: objCodec, create: () => objCodec } },
+						{ name: "patch", wire: "patch", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamPatch", schema: objCodec, create: () => objCodec } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamConfigResult", schema: objCodec, create: () => objCodec },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamConfigResult", schema: objCodec, create: () => objCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
-					id: "sage-mem#dream/status",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/status",
+					service: "autodream",
+					namespace: "autodream",
 					method: "status",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamStatus", schema: objCodec, create: () => objCodec },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamStatus", schema: objCodec, create: () => objCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
-					id: "sage-mem#dream/runNow",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/runNow",
+					service: "autodream",
+					namespace: "autodream",
 					method: "runNow",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "force", wire: "force", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#Boolean", schema: boolCodec, create: () => boolCodec } },
+						// 契约：runNow({reason})。前端只负责给一个缘由字符串（落进
+						// manifest.reason 给人看）；「手动触发跳过门控」由 host 半决定。
+						{ name: "opts", wire: "opts", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamOpts", schema: objCodec, create: () => objCodec } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamRunResult", schema: objCodec, create: () => objCodec },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamRunResult", schema: objCodec, create: () => objCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
-					id: "sage-mem#dream/listReports",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/listReports",
+					service: "autodream",
+					namespace: "autodream",
 					method: "listReports",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamReportList", schema: arrCodec, create: () => arrCodec },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamReportList", schema: arrCodec, create: () => arrCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
-					id: "sage-mem#dream/readReport",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/readReport",
+					service: "autodream",
+					namespace: "autodream",
 					method: "readReport",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamReportRef", schema: strSchema, create: () => strSchema } },
 					],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: objCodec, create: () => objCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
-					id: "sage-mem#dream/listSnapshots",
-					service: "dream",
-					namespace: "dream",
+					id: "sage-mem#autodream/listSnapshots",
+					service: "autodream",
+					namespace: "autodream",
 					method: "listSnapshots",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamSnapshotList", schema: arrCodec, create: () => arrCodec },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamSnapshotList", schema: arrCodec, create: () => arrCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				// ── 2026-10-01 新增：运行记录 / 整理声明 / 回滚 / 模型目录 ──
+				// 都是「单个对象参数」形态（与 setConfig(patch) 同形），契约第二节的
+				// {limit} / {runId} / {snapshotId, scope} 逐字对应这个对象的字段。
+				{
+					id: "sage-mem#autodream/listRuns",
+					service: "autodream",
+					namespace: "autodream",
+					method: "listRuns",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "opts", wire: "opts", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamOpts", schema: objCodec, create: () => objCodec } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamRunList", schema: arrCodec, create: () => arrCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#autodream/readDeclaration",
+					service: "autodream",
+					namespace: "autodream",
+					method: "readDeclaration",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "opts", wire: "opts", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamOpts", schema: objCodec, create: () => objCodec } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamDeclaration", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#autodream/rollback",
+					service: "autodream",
+					namespace: "autodream",
+					method: "rollback",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "opts", wire: "opts", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamOpts", schema: objCodec, create: () => objCodec } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamRollbackResult", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#autodream/listModels",
+					service: "autodream",
+					namespace: "autodream",
+					method: "listModels",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamModelList", schema: objCodec, create: () => objCodec },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 			],
@@ -1557,7 +1603,7 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-muted{color:var(--dsw-alias-label-secondary);font-size:12px;}",
 			".smem-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;}",
 			// 筛选条：类型 + 自定义标签两组 chip，与搜索框是 AND 关系。
-			// 只消费宿主变量，浅色深色同一套语言（这是融入型界面，见 frontend-craft）。
+			// 只消费宿主 CSS 变量，不另造配色 —— 浅色深色共用同一套语言。
 			".smem-filters{display:flex;align-items:center;gap:6px;flex-wrap:wrap;}",
 			".smem-filters-label{font-size:11.5px;color:var(--dsw-alias-label-secondary);flex:none;}",
 			".smem-sep{width:1px;height:15px;background:var(--dsw-alias-border-l2);flex:none;margin:0 3px;}",
@@ -1602,14 +1648,14 @@ const StarmapRuntime = (function (require, _react) {
 			'.smem-tab--on{color:var(--dsw-alias-label-primary);}',
 			'.smem-tab--on:after{content:"";position:absolute;left:0;right:0;bottom:-1px;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary);}',
 			// 高度预算压到 62vh（原 70vh）：设置弹窗本身高度有限，
-			// 70vh 在 1050px 视口下会把星图底部的图例和计数挤出面板之外（实测截图被裁）。
+			// 70vh 在较矮的设置弹窗视口下会把星图底部的图例和计数挤出面板之外。
 			".smem-starmap{display:flex;flex-direction:column;height:min(62vh,660px);min-height:400px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;overflow:hidden;}",
-			// ── 「做梦」面板 ──
+			// ── 「自动做梦」面板 ──
 			// 融入型：全部走宿主变量，控件复用已有的 chip / input / btn 语言，不另造一套。
-			".smem-dream{display:flex;flex-direction:column;gap:12px;}",
-			".smem-dream-sec{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1);padding:10px 12px;display:flex;flex-direction:column;gap:9px;}",
-			".smem-dream-row{display:flex;align-items:center;gap:9px;flex-wrap:wrap;}",
-			".smem-dream-key{font-size:12px;color:var(--dsw-alias-label-secondary);flex:none;min-width:78px;}",
+			".smem-autodream{display:flex;flex-direction:column;gap:12px;}",
+			".smem-autodream-sec{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1);padding:10px 12px;display:flex;flex-direction:column;gap:9px;}",
+			".smem-autodream-row{display:flex;align-items:center;gap:9px;flex-wrap:wrap;}",
+			".smem-autodream-key{font-size:12px;color:var(--dsw-alias-label-secondary);flex:none;min-width:78px;}",
 			".smem-switch{border:1px solid var(--dsw-alias-border-l2);background:transparent;border-radius:999px;width:38px;height:21px;position:relative;cursor:pointer;flex:none;padding:0;}",
 			'.smem-switch::after{content:"";position:absolute;top:2px;left:2px;width:15px;height:15px;border-radius:50%;background:var(--dsw-alias-label-secondary);transition:left .15s,background .15s;}',
 			'.smem-switch[data-on="1"]{border-color:var(--dsw-alias-brand-primary,#4d76e6);background:var(--dsw-alias-brand-primary,#4d76e6);}',
@@ -1617,14 +1663,31 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-num{width:66px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-base);color:inherit;padding:4px 8px;font-size:12px;font-family:inherit;outline:none;}",
 			".smem-num:focus{border-color:var(--dsw-alias-brand-primary,#4d76e6);}",
 			".smem-status{font-size:12px;color:var(--dsw-alias-label-secondary);}",
-			".smem-dream-note{font-size:11.5px;color:var(--dsw-alias-label-secondary);line-height:1.5;}",
-			".smem-dream-list{display:flex;flex-direction:column;gap:6px;}",
+			".smem-autodream-note{font-size:11.5px;color:var(--dsw-alias-label-secondary);line-height:1.5;}",
+			".smem-autodream-list{display:flex;flex-direction:column;gap:6px;}",
 			".smem-report{border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 9px;font-size:12px;cursor:pointer;background:transparent;color:inherit;text-align:left;font-family:inherit;}",
 			".smem-report:hover{border-color:var(--dsw-alias-border-l2);}",
 			'.smem-report[data-on="1"]{border-color:var(--dsw-alias-brand-primary,#4d76e6);}',
 			".smem-report-pre{max-height:320px;overflow:auto;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:10px 12px;background:var(--dsw-alias-bg-layer-2);font-size:12px;white-space:pre-wrap;overflow-wrap:anywhere;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;line-height:1.6;}",
-			".smem-dream-adv>summary{cursor:pointer;font-size:12px;color:var(--dsw-alias-label-secondary);}",
-			".smem-dream-adv>div{display:flex;flex-direction:column;gap:8px;padding-top:9px;}",
+			".smem-autodream-adv>summary{cursor:pointer;font-size:12px;color:var(--dsw-alias-label-secondary);}",
+			".smem-autodream-adv>div{display:flex;flex-direction:column;gap:8px;padding-top:9px;}",
+			// ── 2026-10-01 新增：回滚点区 / 整理声明区 ──
+			// 新元素一律 .smem-ad-* 前缀，不动主题外的全局样式（契约第六节第 6 条）。
+			".smem-ad-select{flex:1;min-width:190px;}",
+			".smem-ad-err{color:var(--dsw-alias-state-error-primary,#ef4444);}",
+			".smem-ad-wrap{display:flex;flex-direction:column;gap:6px;}",
+			".smem-ad-snap{display:flex;align-items:center;gap:8px;flex-wrap:wrap;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 9px;font-size:12px;}",
+			".smem-ad-main{flex:1;min-width:140px;overflow-wrap:anywhere;}",
+			".smem-ad-sub{color:var(--dsw-alias-label-secondary);font-size:11.5px;overflow-wrap:anywhere;}",
+			".smem-ad-badge{display:inline-flex;align-items:center;font-size:11px;color:var(--dsw-alias-label-secondary);border:1px solid var(--dsw-alias-border-l1);border-radius:6px;padding:0 5px;white-space:nowrap;}",
+			".smem-ad-badge--warn{color:var(--dsw-alias-state-warning-primary,#d97706);border-color:var(--dsw-alias-state-warning-primary,#d97706);}",
+			".smem-ad-badge--legacy{opacity:.78;}",
+			".smem-ad-confirm{border:1px solid var(--dsw-alias-state-error-primary,#ef4444);border-radius:8px;padding:7px 9px;font-size:12px;line-height:1.55;display:flex;flex-direction:column;gap:6px;overflow-wrap:anywhere;}",
+			".smem-ad-rb{font-size:12px;line-height:1.5;overflow-wrap:anywhere;}",
+			".smem-ad-run{display:flex;align-items:center;gap:8px;flex-wrap:wrap;width:100%;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 9px;background:transparent;color:inherit;text-align:left;font-family:inherit;font-size:12px;cursor:pointer;}",
+			".smem-ad-run:hover{border-color:var(--dsw-alias-border-l2);}",
+			'.smem-ad-run[data-on="1"]{border-color:var(--dsw-alias-brand-primary,#4d76e6);}',
+			".smem-ad-md{max-height:360px;overflow:auto;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:10px 12px;background:var(--dsw-alias-bg-layer-2);font-size:12px;white-space:pre-wrap;overflow-wrap:anywhere;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;line-height:1.6;}",
 		].join("\n");
 
 		const TYPE_META = {
@@ -1635,7 +1698,7 @@ const StarmapRuntime = (function (require, _react) {
 		};
 		const TYPE_ORDER = ["user", "feedback", "project", "reference"];
 		// 筛选条上的显示名：emoji 在筛选条里太吵，只用文字；special 是星图的兜底类，
-		// 文件列表里出现它说明 frontmatter 写了 type: special（本机有 2 条）。
+		// 文件列表里出现它说明 frontmatter 写了 type: special。
 		const TYPE_LABEL = { user: "用户", feedback: "反馈", project: "项目", reference: "参考", special: "特殊" };
 		const TYPE_SORT = ["user", "feedback", "project", "reference", "special"];
 
@@ -1663,7 +1726,7 @@ const StarmapRuntime = (function (require, _react) {
 		//      保存一次就把 baseline / node_type / originSessionId / updated 全抹掉
 		//      （baseline 一丢，「每次会话必读」的记忆从此不再注入）。
 		//   2) 类型正则必须锚行首：`  node_type: memory` 里的 `type:` 否则会被先命中，
-		//      捕获到 memory → 不在 TYPE_ORDER 里 → 兜底成 reference（全库 45 条中招）。
+		//      捕获到 memory → 不在 TYPE_ORDER 里 → 兜底成 reference。
 		//   3) 换行必须容忍 CRLF（Windows 编辑器碰一次就是 \r\n）；回写沿用原文件的
 		//      换行风格，从而 LF / CRLF 都能逐字节 round-trip。
 
@@ -1713,8 +1776,8 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		/**
-		 * 兜底：读 node_type。本机有两份老文件没有 type 行，node_type 直接就是类型
-		 * （project_ui-lab.md → project、user_courses-2026fall.md → user）。
+		 * 兜底：读 node_type。个别老文件没有 type 行，node_type 直接就是类型
+		 * （例如 project_example.md → project）。
 		 * 只由调用方在 detectType 返回空时使用 —— detectType 本身绝不认 node_type。
 		 */
 		function detectNodeType(text) {
@@ -1959,17 +2022,37 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		/**
-		 * 「做梦」面板 —— 让记忆自己整理一遍（引擎在 host 半 lib/dream.js）。
+		 * 模型路线的编码：`<select>` 的 value ↔ {provider, model}。
+		 *
+		 * 用 JSON 数组而不是 "provider/model" 拼串 —— provider 名里带斜杠的情况
+		 * （比如 openrouter 的 "deepseek/deepseek-chat"）会把分隔符解析弄错。
+		 * 空串代表「跟随当前会话默认模型」（值是 ['', '']）。
+		 */
+		function encodeRoute(provider, model) {
+			return JSON.stringify([String(provider == null ? "" : provider), String(model == null ? "" : model)]);
+		}
+		function decodeRoute(v) {
+			try {
+				const a = JSON.parse(String(v == null ? "" : v));
+				if (Array.isArray(a) && a.length === 2) {
+					return { provider: String(a[0] == null ? "" : a[0]), model: String(a[1] == null ? "" : a[1]) };
+				}
+			} catch (_) {}
+			return { provider: "", model: "" };
+		}
+
+		/**
+		 * 「自动做梦」面板 —— 让记忆自己整理一遍（引擎在 host 半 lib/autodream.js）。
 		 *
-		 * 数据全走 remote.dream（host 半的 DreamGateway）。两条实现约定：
+		 * 数据全走 remote.autodream（host 半的 AutodreamGateway）。两条实现约定：
 		 *   1. **轮询而不是等待**。「立即整理」启动后台任务后立刻返回 —— 一趟可能跑
 		 *      几分钟，把 remote 调用挂在那儿等会撞上前端超时。进度靠每 2 秒拉一次
 		 *      status() 显示。
 		 *   2. **不替用户做判断**。触发方式 / 改动方式 / 输入源三件事各自明说代价
 		 *      （比如「记忆 + 会话记录」会把私密对话送进模型），默认全是最保守的那一档。
 		 */
-		function DreamPanel(props) {
-			const remote = props.ctx && props.ctx.get ? props.ctx.get("remote.dream") : null;
+		function AutodreamPanel(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 sSt = react.useState(null); const st = sSt[0], setSt = sSt[1];
 			const sErr = react.useState(null); const err = sErr[0], setErr = sErr[1];
@@ -1978,153 +2061,291 @@ const StarmapRuntime = (function (require, _react) {
 			const sReports = react.useState([]); const reports = sReports[0], setReports = sReports[1];
 			const sOpen = react.useState(null); const open = sOpen[0], setOpen = sOpen[1];
 			const sBody = react.useState(""); const body = sBody[0], setBody = sBody[1];
-			const sModelEdit = react.useState(false); const modelEdit = sModelEdit[0], setModelEdit = sModelEdit[1];
 			const sProv = react.useState(""); const prov = sProv[0], setProv = sProv[1];
 			const sModel = react.useState(""); const model = sModel[0], setModel = sModel[1];
+			// ── 2026-10-01 新增：模型目录 / 回滚点 / 整理记录 / 整理声明 ──
+			const sModels = react.useState(null); const models = sModels[0], setModels = sModels[1];
+			const sSnaps = react.useState([]); const snaps = sSnaps[0], setSnaps = sSnaps[1];
+			const sRuns = react.useState([]); const runs = sRuns[0], setRuns = sRuns[1];
+			const sDeclOpen = react.useState(null); const declOpen = sDeclOpen[0], setDeclOpen = sDeclOpen[1];
+			const sDeclBody = react.useState(""); const declBody = sDeclBody[0], setDeclBody = sDeclBody[1];
+			const sConfirm = react.useState(null); const confirmSnap = sConfirm[0], setConfirmSnap = sConfirm[1];
+			const sRbBusy = react.useState(null); const rbBusy = sRbBusy[0], setRbBusy = sRbBusy[1];
+			const sRbMsg = react.useState(null); const rbMsg = sRbMsg[0], setRbMsg = sRbMsg[1];
+			const sListErr = react.useState(null); const listErr = sListErr[0], setListErr = sListErr[1];
+			const sWasRunning = react.useState(false); const wasRunning = sWasRunning[0], setWasRunning = sWasRunning[1];
+
+			// 派生量放在 effect 之前：下面几个 effect 的依赖数组要在渲染期就能取到值。
+			const c = cfg || {};
+			const running = !!(st && st.running);
+			const last = (st && st.lastResult) || null;
+			const route = (st && st.route) || null;
+			const rollbackScope = c.rollbackScope === "all" ? "all" : "files";
 
 			react.useEffect(function () {
-				if (!remote) { setErr("remote.dream 不可用 —— 插件的 host 半可能没加载成功，看 DSH 启动日志"); return undefined; }
+				if (!remote) { setErr("remote.autodream 不可用 —— 插件的 host 半可能没加载成功，看 DSH 启动日志"); return undefined; }
 				let alive = true;
 				function pull() {
-					remote.status().then(function (r) {
-						if (!alive) return;
-						const d = unwrap(r);
-						if (d) { setSt(d); if (d.config) setCfg(d.config); }
+					callRemote("status", [], function (d) {
+						if (!alive || !d) return;
+						setSt(d); if (d.config) setCfg(d.config);
 						setErr(null);
-					}).catch(function (e) { if (alive) setErr(detail(e)); });
+					}, function (m) { if (alive) setErr(m); });
 				}
 				pull();
-				remote.listReports().then(function (r) { if (alive) setReports(unwrap(r) || []); }).catch(function () {});
+				refreshLists();
+				loadModels();
 				const id = setInterval(pull, 2000);
 				return function () { alive = false; clearInterval(id); };
 			}, [remote]);
 
+			// 一趟跑完（running true → false）就把回滚点 / 整理记录 / 报告刷一遍：
+			// 刚跑完那一刻列表还是旧的，等下一次进面板才更新会让人以为没生效。
+			react.useEffect(function () {
+				if (wasRunning && !running) refreshLists();
+				if (wasRunning !== running) setWasRunning(running);
+			}, [running]);
+
+			// 模型行的手填框：配置里的 provider/model 变了就同步过去（保存后回填）。
+			react.useEffect(function () {
+				setProv(c.provider || "");
+				setModel(c.model || "");
+			}, [c.provider, c.model]);
+
+			/**
+			 * 所有 remote 调用的统一出口。
+			 *
+			 * 契约的硬约束是「每个调用都 try/catch，失败显示错误文案、不白屏」，而
+			 * 这里还有第三种失败：host 半是旧版本、方法根本不在 remote 对象上
+			 * （typeof !== "function"）—— 那会在 `.then` 之前就抛 TypeError。
+			 * 三种都收敛到 onErr，面板只会多一行红字。
+			 */
+			function callRemote(name, args, onOk, onErr) {
+				const fn = remote ? remote[name] : null;
+				if (typeof fn !== "function") { if (onErr) onErr("host 半没有 " + name + " 接口（版本较旧？）"); return; }
+				let p;
+				try { p = fn.apply(remote, args || []); }
+				catch (e) { if (onErr) onErr(detail(e)); return; }
+				Promise.resolve(p).then(function (r) { if (onOk) onOk(unwrap(r)); })
+					.catch(function (e) { if (onErr) onErr(detail(e)); });
+			}
+
 			function patch(p) {
 				setErr(null); setNotice("");
-				remote.setConfig(p).then(function (r) {
-					const d = unwrap(r);
+				callRemote("setConfig", [p], function (d) {
 					if (d && d.config) setCfg(d.config);
-				}).catch(function (e) { setErr(detail(e)); });
+				}, function (m) { setErr(m); });
+			}
+
+			/** 报告 / 回滚点 / 整理记录三份列表一起刷。 */
+			function refreshLists() {
+				callRemote("listReports", [], function (d) {
+					setReports(Array.isArray(d) ? d : []);
+				}, function () {});
+				callRemote("listSnapshots", [], function (d) {
+					setSnaps(Array.isArray(d) ? d : []);
+				}, function (m) { setListErr(m); });
+				callRemote("listRuns", [{ limit: 20 }], function (d) {
+					setRuns(Array.isArray(d) ? d : []);
+				}, function (m) { setListErr(m); });
+			}
+
+			function loadModels() {
+				callRemote("listModels", [], function (d) {
+					setModels(d && typeof d === "object" && !Array.isArray(d) ? d : { catalogAvailable: false, routes: [], note: "" });
+				}, function (m) {
+					setModels({ catalogAvailable: false, routes: [], note: "模型目录不可用（" + m + "）—— 请在下面手填 provider 与 model。" });
+				});
 			}
 
 			function run() {
 				setErr(null); setNotice(""); setBusy(true);
-				remote.runNow(true).then(function (r) {
-					const d = unwrap(r);
+				// 契约：runNow({ reason })。reason 只落进 manifest 给人看；门控的豁免
+				// 由 host 半负责（手动点了按钮就不该被「还没到 N 小时」挡回来）。
+				callRemote("runNow", [{ reason: "设置页手动触发" }], function (d) {
 					if (d && d.ok === false) setErr(d.error || "启动失败");
-					else setNotice("已开始整理 —— 进度每 2 秒刷新一次");
-					return remote.listReports().then(function (rr) { setReports(unwrap(rr) || []); });
-				}).catch(function (e) { setErr(detail(e)); }).then(function () { setBusy(false); });
+					else { setNotice("已开始整理 —— 进度每 2 秒刷新一次"); refreshLists(); }
+					setBusy(false);
+				}, function (m) { setErr(m); setBusy(false); });
 			}
 
 			function openReport(name) {
 				if (name === null) { setOpen(null); setBody(""); return; }
 				setOpen(name); setBody("载入中…");
-				remote.readReport(name).then(function (r) {
-					const d = unwrap(r);
+				callRemote("readReport", [name], function (d) {
 					setBody((d && d.content) || "(空)");
-				}).catch(function (e) { setBody("读取失败：" + detail(e)); });
+				}, function (m) { setBody("读取失败：" + m); });
 			}
 
-			const c = cfg || {};
-			const running = !!(st && st.running);
-			const last = (st && st.lastResult) || null;
+			/** 整理声明：点开才拉，拉回来的是 Markdown 原文，直接用 pre 呈现。 */
+			function openDecl(runId) {
+				if (declOpen === runId) { setDeclOpen(null); setDeclBody(""); return; }
+				setDeclOpen(runId); setDeclBody("载入中…");
+				callRemote("readDeclaration", [{ runId: runId }], function (d) {
+					setDeclBody((d && d.markdown) || "(这一趟没有留下声明正文)");
+				}, function (m) { setDeclBody("读取失败：" + m); });
+			}
 
-			return h("div", { className: "smem-dream" }, [
-				h("div", { className: "smem-dream-sec", key: "top" }, [
-					h("div", { className: "smem-dream-row", key: "r" }, [
+			/**
+			 * 回滚。二次确认在 JSX 里（点了「回滚」先展开确认条），这里只负责调用。
+			 * 结果就地回显 —— 恢复几个、移走几个、保护快照 id，全都写在同一行里。
+			 */
+			function doRollback(sp) {
+				const scope = rollbackScope;
+				setErr(null); setNotice(""); setRbMsg(null); setRbBusy(sp.name);
+				callRemote("rollback", [{ snapshotId: sp.name, scope: scope }], function (d) {
+					const x = d || {};
+					if (x.ok === false) {
+						setRbMsg({ bad: true, text: "回滚失败：" + (x.error || "未知原因") });
+					} else {
+						setRbMsg({ bad: false, text: "已回滚到 " + String(sp.atHuman || "") + "：恢复 " +
+							(x.restored == null ? "?" : x.restored) + " 个文件，移走 " + (x.parked == null ? "?" : x.parked) + " 个" +
+							// skipped = 想动但没动的（archive/ 已有同名、或回滚点里没那一版）。
+							// 不显示它等于「部分成功」被说成「成功」——回滚这种事不能含糊。
+							(x.skipped ? "，跳过 " + x.skipped + " 个（详见回滚报告）" : "") +
+							(x.protection ? " · 保护快照 " + x.protection : "") + (x.report ? " · 报告 " + x.report : "") });
+						setConfirmSnap(null);
+					}
+					setRbBusy(null);
+					refreshLists();
+				}, function (m) { setRbMsg({ bad: true, text: "回滚失败：" + m }); setRbBusy(null); });
+			}
+
+			// 实际生效路线（契约：route 可能为 null；source==='none' 时 error 里是原因）。
+			const routeBad = !route || route.source === "none" || !route.provider || !route.model;
+			const routeInfo = routeBad
+				? ("实际生效路线：拿不到 —— " + ((route && route.error) || "宿主没能解析出 provider / model（配置留空且取不到会话默认模型）"))
+				: ("实际生效路线：" + route.provider + " / " + route.model + (route.fromDefault ? "（跟随默认）" : "（配置指定）"));
+
+			// 模型 <select> 的取值：''=跟随默认；否则是 "provider::model" 的 JSON 编码。
+			// 配置里指定的路线万一下架了（不在目录里），也要让它显示出来 —— 否则
+			// 下拉框会悄悄跳到「跟随默认」，与下面那行「实际生效路线」自相矛盾。
+			const modelRoutes = (models && Array.isArray(models.routes)) ? models.routes : [];
+			const modelValue = (c.provider && c.model) ? encodeRoute(c.provider, c.model) : "";
+			const modelValueInCatalog = modelValue === "" || modelRoutes.some(function (r) {
+				return encodeRoute(r.provider, r.model) === modelValue;
+			});
+
+			return h("div", { className: "smem-autodream" }, [
+				h("div", { className: "smem-autodream-sec", key: "top" }, [
+					h("div", { className: "smem-autodream-row", key: "r" }, [
 						h("button", {
 							type: "button", key: "sw", className: "smem-switch",
 							"data-on": c.enabled ? "1" : "0",
 							title: c.enabled ? "点击停用" : "点击启用",
-							"aria-label": "启用或停用做梦",
+							"aria-label": "启用或停用自动做梦",
 							onClick: function () { patch({ enabled: !c.enabled }); },
 						}),
-						h("span", { key: "t", style: { fontWeight: "600" } }, "做梦"),
+						h("span", { key: "t", style: { fontWeight: "600" } }, "自动做梦"),
 						h("span", { className: "smem-status", key: "s" },
 							running ? ("运行中 · " + String((st && st.phase) || "准备中")) : (c.enabled ? "已启用 · 空闲" : "未启用")),
 					]),
-					h("div", { className: "smem-dream-note", key: "n" },
+					h("div", { className: "smem-autodream-note", key: "n" },
 						"把记忆目录通读一遍：合并重复的、删掉被推翻的、修索引与断链、把相对日期换成绝对日期。"),
 				]),
-				h("div", { className: "smem-dream-sec", key: "mode" }, [
-					h("div", { className: "smem-dream-row", key: "a" }, [
-						h("span", { className: "smem-dream-key", key: "k" }, "触发"),
+				h("div", { className: "smem-autodream-sec", key: "mode" }, [
+					h("div", { className: "smem-autodream-row", key: "a" }, [
+						h("span", { className: "smem-autodream-key", key: "k" }, "触发"),
 						h(Seg, {
 							key: "v", value: c.trigger,
 							options: [{ value: "manual", label: "只手动" }, { value: "auto", label: "满足条件自动跑" }],
 							onChange: function (v) { patch({ trigger: v }); },
 						}),
 					]),
-					h("div", { className: "smem-dream-row", key: "b" }, [
-						h("span", { className: "smem-dream-key", key: "k" }, "改动方式"),
+					h("div", { className: "smem-autodream-row", key: "b" }, [
+						h("span", { className: "smem-autodream-key", key: "k" }, "改动方式"),
 						h(Seg, {
 							key: "v", value: c.apply ? "apply" : "report",
 							options: [{ value: "report", label: "只出报告" }, { value: "apply", label: "直接改写（先快照）" }],
 							onChange: function (v) { patch({ apply: v === "apply" }); },
 						}),
 					]),
-					h("div", { className: "smem-dream-row", key: "c" }, [
-						h("span", { className: "smem-dream-key", key: "k" }, "输入源"),
+					h("div", { className: "smem-autodream-row", key: "c" }, [
+						h("span", { className: "smem-autodream-key", key: "k" }, "输入源"),
 						h(Seg, {
 							key: "v", value: c.source,
 							options: [{ value: "memory", label: "仅记忆目录" }, { value: "memory+sessions", label: "记忆 + 会话记录" }],
 							onChange: function (v) { patch({ source: v }); },
 						}),
 					]),
-					h("div", { className: "smem-dream-note", key: "w" },
+					h("div", { className: "smem-autodream-note", key: "w" },
 						c.source === "memory+sessions"
 							? "会解压会话记录做定向搜索 —— 私密对话会进入模型上下文，token 成本也更高。"
 							: "只看记忆文件本身，不碰会话记录。"),
-					h("div", { className: "smem-dream-note", key: "w2" },
+					h("div", { className: "smem-autodream-note", key: "w2" },
 						c.apply
-							? "改写前会自动把整个记忆目录快照一份（memory 上一层 .sage-mem/snapshots/），改坏可回退。"
+							? "改写前会自动把整个记忆目录快照一份（memory 上一层 .sage-mem/autodream/snapshots/），改坏可回退。"
 							: "只读模式：这一趟连写工具都不会挂给模型，所以它不可能改到任何文件。"),
 				]),
-				h("details", { className: "smem-dream-adv", key: "adv" }, [
+				h("details", { className: "smem-autodream-adv", key: "adv" }, [
 					h("summary", { key: "s" }, "高级设置"),
 					h("div", { key: "d" }, [
-						c.trigger === "auto" ? h("div", { className: "smem-dream-row", key: "gate" }, [
-							h("span", { className: "smem-dream-key", key: "k" }, "自动触发"),
+						c.trigger === "auto" ? h("div", { className: "smem-autodream-row", key: "gate" }, [
+							h("span", { className: "smem-autodream-key", key: "k" }, "自动触发"),
 							h("span", { className: "smem-status", key: "a" }, "距上次 ≥"),
 							h("input", { className: "smem-num", key: "h", type: "number", min: "1", max: "720", value: c.minHours, onChange: function (e) { patch({ minHours: Number(e.target.value) }); } }),
 							h("span", { className: "smem-status", key: "b" }, "小时，且期间 ≥"),
 							h("input", { className: "smem-num", key: "m", type: "number", min: "1", max: "200", value: c.minSessions, onChange: function (e) { patch({ minSessions: Number(e.target.value) }); } }),
 							h("span", { className: "smem-status", key: "c" }, "个会话有更新"),
 						]) : null,
-						h("div", { className: "smem-dream-row", key: "model" }, [
-							h("span", { className: "smem-dream-key", key: "k" }, "模型"),
-							modelEdit
-								? [
-										h("input", { className: "smem-input", key: "p", style: { flex: "1", minWidth: "110px" }, value: prov, placeholder: "provider（留空=默认）", onChange: function (e) { setProv(e.target.value); } }),
-										h("input", { className: "smem-input", key: "m", style: { flex: "1", minWidth: "110px" }, value: model, placeholder: "model（留空=默认）", onChange: function (e) { setModel(e.target.value); } }),
-										h("button", { type: "button", className: "smem-btn smem-btn-primary", key: "ok", onClick: function () { patch({ provider: prov, model: model }); setModelEdit(false); setNotice("模型已保存"); } }, "保存"),
-										h("button", { type: "button", className: "smem-btn", key: "no", onClick: function () { setModelEdit(false); } }, "取消"),
-									]
-								: [
-										h("span", { className: "smem-status", key: "cur" },
-											st && st.route ? (st.route.provider + " / " + st.route.model + (st.route.fromDefault ? "（跟随聊天页默认）" : "")) : "（拿不到默认模型）"),
-										h("button", {
-											type: "button", className: "smem-btn", key: "e",
-											onClick: function () { setProv(c.provider || ""); setModel(c.model || ""); setModelEdit(true); },
-										}, "改"),
-									],
+						h("div", { className: "smem-autodream-row", key: "model" }, [
+							h("span", { className: "smem-autodream-key", key: "k" }, "模型"),
+							// 有可枚举的模型目录就给 <select>（首项 = 跟随会话默认，值 "":""）；
+							// 目录不可用就退化成两个文本框（契约第六节第 2 条）。
+							(models && models.catalogAvailable)
+								? h("select", {
+										className: "smem-input smem-ad-select", key: "sel",
+										value: modelValue,
+										onChange: function (e) {
+											const v = e.target.value;
+											if (!v) { patch({ provider: "", model: "" }); return; }
+											const r = decodeRoute(v);
+											patch({ provider: r.provider, model: r.model });
+										},
+									}, [h("option", { key: "__def", value: "" },
+											"跟随当前会话默认模型" + ((models.defaultRoute && models.defaultRoute.provider && models.defaultRoute.model)
+												? ("（" + String(models.defaultRoute.provider) + " / " + String(models.defaultRoute.model) + "）")
+												: ""),
+										)].concat(
+											modelValueInCatalog ? [] : [h("option", { key: "__cur", value: modelValue }, String(c.provider) + " / " + String(c.model) + "（配置里指定，不在目录中）")],
+											modelRoutes.map(function (r) {
+												return h("option", { key: String(r.provider) + "/" + String(r.model), value: encodeRoute(r.provider, r.model) },
+													r.label || (String(r.provider) + " / " + String(r.model)));
+											}),
+										))
+								: models
+									? [
+											h("input", { className: "smem-input", key: "p", style: { flex: "1", minWidth: "110px" }, value: prov, placeholder: "provider（留空=跟随默认）", onChange: function (e) { setProv(e.target.value); } }),
+											h("input", { className: "smem-input", key: "m", style: { flex: "1", minWidth: "110px" }, value: model, placeholder: "model（留空=跟随默认）", onChange: function (e) { setModel(e.target.value); } }),
+											h("button", { type: "button", className: "smem-btn smem-btn-primary", key: "ok", onClick: function () { patch({ provider: prov, model: model }); setNotice("模型已保存"); } }, "保存"),
+										]
+									: [
+											h("span", { className: "smem-status", key: "load" }, "模型目录载入中…"),
+											h("button", { type: "button", className: "smem-btn", key: "man", onClick: function () { setModels({ catalogAvailable: false, routes: [], note: "" }); } }, "手填"),
+										],
 						]),
-						h("div", { className: "smem-dream-row", key: "steps" }, [
-							h("span", { className: "smem-dream-key", key: "k" }, "最多轮数"),
+						h("div", {
+							className: "smem-autodream-note" + (routeBad ? " smem-ad-err" : ""),
+							key: "route",
+						}, (routeBad ? "✗ " : "✓ ") + routeInfo),
+						models && models.catalogAvailable === false && models.note
+							? h("div", { className: "smem-autodream-note", key: "mnote" }, String(models.note))
+							: null,
+						h("div", { className: "smem-autodream-row", key: "steps" }, [
+							h("span", { className: "smem-autodream-key", key: "k" }, "最多轮数"),
 							h("input", { className: "smem-num", key: "v", type: "number", min: "1", max: "80", value: c.maxSteps, onChange: function (e) { patch({ maxSteps: Number(e.target.value) }); } }),
 							h("span", { className: "smem-status", key: "s" }, "一轮 = 一次模型调用 + 它要的工具调用"),
 						]),
-						h("div", { className: "smem-dream-row", key: "keep" }, [
-							h("span", { className: "smem-dream-key", key: "k" }, "保留快照"),
+						h("div", { className: "smem-autodream-row", key: "keep" }, [
+							h("span", { className: "smem-autodream-key", key: "k" }, "保留快照"),
 							h("input", { className: "smem-num", key: "v", type: "number", min: "1", max: "50", value: c.maxSnapshotKeep, onChange: function (e) { patch({ maxSnapshotKeep: Number(e.target.value) }); } }),
 							h("span", { className: "smem-status", key: "s" }, "份"),
 						]),
 						h("div", { className: "smem-status", key: "paths" }, "配置与状态：" + ((st && st.paths && st.paths.configPath) || "—")),
 					]),
 				]),
-				h("div", { className: "smem-dream-sec", key: "run" }, [
-					h("div", { className: "smem-dream-row", key: "r" }, [
+				h("div", { className: "smem-autodream-sec", key: "run" }, [
+					h("div", { className: "smem-autodream-row", key: "r" }, [
 						h("button", {
 							type: "button", className: "smem-btn smem-btn-primary", key: "go",
 							disabled: busy || running || !remote,
@@ -2136,7 +2357,7 @@ const StarmapRuntime = (function (require, _react) {
 								: (st && st.hoursSince != null ? ("距上次整理 " + st.hoursSince.toFixed(1) + " 小时") : "从未整理过")),
 					]),
 					running && st && st.steps && st.steps.length
-						? h("div", { className: "smem-dream-note", key: "prog" }, st.steps.map(function (x) {
+						? h("div", { className: "smem-autodream-note", key: "prog" }, st.steps.map(function (x) {
 								return "第 " + x.step + " 轮：" + (x.tools.length ? x.tools.join("、") : "结束");
 							}).join("　·　"))
 						: null,
@@ -2150,22 +2371,119 @@ const StarmapRuntime = (function (require, _react) {
 								(last.report ? " · 报告 " + last.report : ""))
 						: null,
 				]),
-				h("div", { className: "smem-dream-sec", key: "rep" }, [
-					h("div", { className: "smem-dream-row", key: "h" }, [
+				// ── 回滚点（新）──────────────────────────────────────────────
+				// 只改这一个文件、只用既有 h() 写法；数据全走 remote.autodream。
+				h("div", { className: "smem-autodream-sec", key: "snap" }, [
+					h("div", { className: "smem-autodream-row", key: "h" }, [
+						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "回滚点"),
+						h("span", { className: "smem-status", key: "c" }, String(snaps.length) + " 个"),
+						h("button", { type: "button", className: "smem-btn", key: "rf", onClick: refreshLists }, "刷新"),
+					]),
+					h("div", { className: "smem-autodream-row", key: "scope" }, [
+						h("span", { className: "smem-autodream-key", key: "k" }, "回滚范围"),
+						h(Seg, {
+							key: "v", value: rollbackScope,
+							options: [{ value: "files", label: "只恢复本次动过的文件" }, { value: "all", label: "整目录回到该时点" }],
+							onChange: function (v) { patch({ rollbackScope: v }); },
+						}),
+					]),
+					h("div", { className: "smem-autodream-note", key: "n" },
+						"回滚前会自动把整个记忆目录再存一份保护快照 —— 所以回滚本身也能再退回来。多出来的文件只移进 archive/，不删除。"),
+					snaps.length === 0
+						? h("div", { className: "smem-status", key: "e" }, "还没有回滚点 —— 用「直接改写」跑过一次就有了。")
+						: h("div", { className: "smem-autodream-list", key: "l" }, snaps.slice(0, 15).map(function (sp) {
+								const label = sp.legacy ? "旧版快照" : (sp.runId ? ("运行 " + String(sp.runId)) : "回滚保护");
+								return h("div", { className: "smem-ad-wrap", key: String(sp.name) }, [
+									h("div", { className: "smem-ad-snap", key: "row" }, [
+										h("div", { className: "smem-ad-main", key: "m" }, [
+											h("div", { key: "l1" }, String(sp.atHuman || "") + " · " + (sp.files == null ? "?" : sp.files) + " 个文件"),
+											h("div", { className: "smem-ad-sub", key: "l2" }, label + " · " + String(sp.name || "")),
+										]),
+										sp.legacy ? h("span", { className: "smem-ad-badge smem-ad-badge--legacy", key: "lg" }, "旧版") : null,
+										confirmSnap === sp.name
+											? null
+											: h("button", {
+													type: "button", className: "smem-btn", key: "go",
+													disabled: rbBusy !== null,
+													onClick: function () { setRbMsg(null); setConfirmSnap(sp.name); },
+												}, "回滚"),
+									]),
+									confirmSnap === sp.name
+										? h("div", { className: "smem-ad-confirm", key: "cf" }, [
+												h("div", { key: "t", style: { fontWeight: "600" } }, "确认回滚到 " + String(sp.atHuman || "") + "？"),
+												h("div", { key: "d" }, "范围：" + (rollbackScope === "all"
+													? "整目录回到该时点 —— 快照里没有、当前目录里有的文件会被移进 archive/（不删除）"
+													: "只恢复这次运行动过的文件 —— 该次新建的移进 archive/，该次归档的移回顶层") +
+													"。回滚前会先存一份保护快照，所以这一步本身也能退。"),
+												h("div", { className: "smem-autodream-row", key: "acts" }, [
+													h("button", {
+														type: "button", className: "smem-btn smem-btn-danger", key: "yes",
+														disabled: rbBusy === sp.name,
+														onClick: function () { doRollback(sp); },
+													}, rbBusy === sp.name ? "回滚中…" : "确认回滚"),
+													h("button", { type: "button", className: "smem-btn", key: "no", onClick: function () { setConfirmSnap(null); } }, "取消"),
+												]),
+											])
+										: null,
+								]);
+							})),
+					rbMsg ? h("div", { className: "smem-ad-rb " + (rbMsg.bad ? "smem-ad-err" : "smem-ok"), key: "rb" }, (rbMsg.bad ? "⚠ " : "✓ ") + rbMsg.text) : null,
+				]),
+				// ── 整理声明（新）──────────────────────────────────────────
+				h("div", { className: "smem-autodream-sec", key: "runs" }, [
+					h("div", { className: "smem-autodream-row", key: "h" }, [
+						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "整理记录"),
+						h("span", { className: "smem-status", key: "c" }, String(runs.length) + " 条"),
+						h("button", { type: "button", className: "smem-btn", key: "rf", onClick: refreshLists }, "刷新"),
+					]),
+					h("div", { className: "smem-autodream-note", key: "n" },
+						"每一趟都留一份整理声明：改了什么、为什么改、哪些想法被拒了。点一条看全文。"),
+					runs.length === 0
+						? h("div", { className: "smem-status", key: "e" }, "还没有整理记录 —— 跑一次就有了。")
+						: h("div", { className: "smem-autodream-list", key: "l" }, runs.slice(0, 15).map(function (rn) {
+								return h("div", { className: "smem-ad-wrap", key: String(rn.runId) }, [
+									h("button", {
+										type: "button", className: "smem-ad-run",
+										"data-on": declOpen === rn.runId ? "1" : "0",
+										onClick: function () { openDecl(rn.runId); },
+									}, [
+										h("span", { key: "t" }, String(rn.atHuman || "")),
+										h("span", { className: "smem-ad-badge", key: "m" }, rn.mode === "apply" ? "直接改写" : "只出报告"),
+										h("span", { key: "c" }, "改 " + (rn.changeCount == null ? "?" : rn.changeCount) + " 条"),
+										rn.report ? h("span", { className: "smem-ad-sub", key: "r" }, "报告 " + String(rn.report)) : null,
+										rn.rolledBackAt
+											? h("span", { className: "smem-ad-badge smem-ad-badge--warn", key: "rb" },
+													"已回滚" + (rn.rolledBackAtHuman ? (" · " + String(rn.rolledBackAtHuman)) : ""))
+											: null,
+										h("span", { className: "smem-ad-sub", key: "x" }, declOpen === rn.runId ? "收起" : "看声明"),
+									]),
+									declOpen === rn.runId
+										? h("pre", { className: "smem-ad-md", key: "body" }, declBody)
+										: null,
+								]);
+							})),
+				]),
+				h("div", { className: "smem-autodream-sec", key: "rep" }, [
+					h("div", { className: "smem-autodream-row", key: "h" }, [
 						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "历史报告"),
 						h("span", { className: "smem-status", key: "c" }, String(reports.length) + " 份"),
 					]),
 					reports.length === 0
-						? h("div", { className: "smem-status", key: "e" }, "还没有报告 —— 跑一次就有了。报告写在 memory/dream/ 下，不会混进记忆列表。")
-						: h("div", { className: "smem-dream-list", key: "l" }, reports.slice(0, 12).map(function (r) {
+						? h("div", { className: "smem-status", key: "e" }, "还没有报告 —— 跑一次就有了。报告写在 memory/autodream/ 下，不会混进记忆列表。")
+						: h("div", { className: "smem-autodream-list", key: "l" }, reports.slice(0, 12).map(function (r) {
 								return h("button", {
 									type: "button", key: r.name, className: "smem-report",
 									"data-on": open === r.name ? "1" : "0",
 									onClick: function () { openReport(open === r.name ? null : r.name); },
-								}, String(r.atHuman || "") + " · " + r.name + " · " + fmtSize(r.bytes) + (open === r.name ? " · 收起" : " · 查看"));
+								}, [
+									h("span", { key: "t" }, String(r.atHuman || "") + " · " + String(r.name) + " · " + fmtSize(r.bytes)),
+									r.legacy ? h("span", { className: "smem-ad-badge smem-ad-badge--legacy", key: "lg", style: { marginLeft: "6px" } }, "旧版") : null,
+									h("span", { className: "smem-ad-sub", key: "x", style: { marginLeft: "6px" } }, open === r.name ? "收起" : "查看"),
+								]);
 							})),
 					open && body ? h("pre", { className: "smem-report-pre", key: "body" }, body) : null,
 				]),
+				listErr && !err ? h("div", { className: "smem-err", key: "lerr" }, "⚠ " + listErr) : null,
 				err ? h("div", { className: "smem-err", key: "err" }, "⚠ " + err) : null,
 				notice && !err ? h("div", { className: "smem-ok", key: "ok" }, "✓ " + notice) : null,
 			]);
@@ -2387,7 +2705,7 @@ const StarmapRuntime = (function (require, _react) {
 				h("div", { className: "smem-tabs", key: "tabs" }, [
 					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 === "dream" ? " smem-tab--on" : ""), key: "d", onClick: function () { setTab("dream"); } }, "做梦"),
+					h("button", { type: "button", className: "smem-tab" + (tab === "autodream" ? " smem-tab--on" : ""), key: "d", onClick: function () { setTab("autodream"); } }, "自动做梦"),
 				]),
 				h("div", { className: "smem-head", key: "head" }, [
 					h("span", { className: "smem-title", key: "t" }, "记忆文件（sage-mem）"),
@@ -2398,7 +2716,7 @@ const StarmapRuntime = (function (require, _react) {
 						: "共 " + String(items.length) + " 个文件"),
 				]),
 				// 搜索 / 刷新 / 添加 / 筛选都只属于「文件列表」这个视图。
-				// 放在 tab 分支外面，会让星图和做梦页也顶着一排用不上的控件
+				// 放在 tab 分支外面，会让星图和自动做梦页也顶着一排用不上的控件
 				// （2026-09-27 截图走查时发现：「+ 添加记忆」出现在星图页上）。
 				tab === "files" ? h("div", { className: "smem-toolbar", key: "bar" }, [
 					h("input", { className: "smem-search", key: "q", value: query, placeholder: "搜索文件名 / 描述 / 类型 / 标签…", onChange: function (e) { setQuery(e.target.value); } }),
@@ -2450,11 +2768,11 @@ const StarmapRuntime = (function (require, _react) {
 								})),
 							]),
 							h("label", { className: "smem-label", key: "ln" }, "文件名（.md，留空自动 " + formType + "_note.md）"),
-							h("input", { className: "smem-input", key: "tn", value: formName, onChange: function (e) { setFormName(e.target.value); }, placeholder: "例如 project_traveler.md" }),
+							h("input", { className: "smem-input", key: "tn", value: formName, onChange: function (e) { setFormName(e.target.value); }, placeholder: "例如 project_example.md" }),
 							h("label", { className: "smem-label", key: "ld" }, "描述（写进 frontmatter，检索与列表都靠它）"),
 							h("input", { className: "smem-input", key: "td", value: formDesc, onChange: function (e) { setFormDesc(e.target.value); }, placeholder: "一句话说清这条记忆是什么" }),
 							h("label", { className: "smem-label", key: "lt" }, "自定义标签（可选，逗号分隔；会写进 frontmatter 的 tags，列表页可按它筛）"),
-							h("input", { className: "smem-input", key: "tt", value: formTags, onChange: function (e) { setFormTags(e.target.value); }, placeholder: "例如 发布, 脱敏, dsh" }),
+							h("input", { className: "smem-input", key: "tt", value: formTags, onChange: function (e) { setFormTags(e.target.value); }, placeholder: "例如 部署, 笔记, dsh" }),
 							h("label", { className: "smem-label", key: "lb" }, "正文（可选，frontmatter 自动生成）"),
 							h("textarea", { className: "smem-textarea", key: "tb", rows: 6, value: formBody, onChange: function (e) { setFormBody(e.target.value); }, placeholder: "要长期记住的细节" }),
 							h("div", { className: "smem-row", key: "btns" }, [
@@ -2463,8 +2781,8 @@ const StarmapRuntime = (function (require, _react) {
 							]),
 						])
 					: null,
-				tab === "dream"
-					? h(DreamPanel, { key: "dream", ctx: props.ctx })
+				tab === "autodream"
+					? h(AutodreamPanel, { key: "autodream", ctx: props.ctx })
 					: tab === "star"
 					? h("div", { className: "smem-starmap", key: "starmap" },
 							h(StarmapRuntime.StarMap, { ctx: props.ctx }))
@@ -2499,7 +2817,7 @@ const StarmapRuntime = (function (require, _react) {
 
 		/**
 		 * Client 插件：$mount strict remote contribution（第三方 remote 不在
-		 * dsh-api-remotes 的固定列表里，必须自己挂），再注册设置页签。
+		 * 宿主的固定 remote 清单里，必须自己挂），再注册设置页签。
 		 */
 		async function apply(ctx) {
 			await ctx.remote.$mount(TYPERT_REMOTE);