sage-mem 0.7.0 → 0.7.1

package/README.md

@@ -176,7 +176,7 @@ SAGE_MEM_DIR=/path/to/your/memory
 
 报告落在 `memory/autodream/<runId>.md`——子目录，不会被扫成记忆条目。
 
-> **关于自动触发**：整理沿用插件自己的定时器（`ctx.timer`，默认 30 分钟查一次门控），**没有**接进设置页那个「自动化任务」面板。原因不是偷懒：那个面板的服务到期只做一件事——往一个已存在的会话投一条 user 消息让那个 agent 正常跑一轮；它没有回调、没有条件门、也要求绑定一个会话 id。而自动做梦刻意**不走会话**（工具集由插件给、步数有上限、不污染会话记录），两者的触发模型对不上。硬接的代价远大于收益，所以不做。
+> **关于自动触发**：整理沿用插件自己的定时器（`ctx.timer`，默认 30 分钟查一次门控），**没有**接进设置页那个「自动化任务」面板。原因是两者的触发模型对不上——那个面板的语义是「到点唤醒一个会话、让它跑一轮对话」，而自动做梦刻意**不走会话**（工具集由插件给、步数有上限、不污染会话记录），两者的触发模型对不上。硬接的代价远大于收益，所以不做。
 
 ### 改名说明（0.7.0）
 

package/lib/autodream-audit.js

@@ -12,7 +12,7 @@
  *
  * **纯只读**：不修任何东西。修哪条、怎么修，由 autodream agent 或人决定。
  *
- * 这一份解析是 sage-mem host 半 parseFrontmatter 的同源精简版，故意不共用：
+ * 这一份解析是 sage-mem 宿主侧 parseFrontmatter 的同源精简版，故意不共用：
  * 那边带着一长串历史坑的注释与行为（baseline、type 回落），审计只读不写，
  * 重复二十行换零回归风险是划算的。
  */
@@ -37,7 +37,7 @@ const NON_ENTRY_FILES = new Set(['session-log.md'])
 const YAML_LEAF_RE = /^[A-Za-z0-9_.-]+:\s*(.*)$/
 
 /**
- * 极简 frontmatter 解析，读法与 host 半一致：
+ * 极简 frontmatter 解析，读法与 宿主侧一致：
  * 顶层 `type:` 优先，没有才下钻 `metadata.type:`。
  * @param {string} content — 文件全文
  * @returns {{name: string, description: string, type: string, hasFrontmatter: boolean}}

package/lib/autodream.js

@@ -855,7 +855,7 @@ export class AutodreamEngine {
       messages: req.messages,
       maxTokens: req.maxTokens,
       signal: req.signal,
-      purpose: 'session-title', // 复用「非交互式调用」的语义槽，避免被当成主对话轮次记账
+      purpose: 'session-title', // 标记为非交互式调用，避免被当成主对话轮次记账
     }
     if (req.tools && req.tools.length) options.tools = req.tools
     for await (const chunk of llm.stream(options)) {

package/lib/client.js

@@ -1,11 +1,11 @@
 /**
- * sage-mem — 客户端半：DSH 设置页「记忆管理」界面（文件管理器）。
+ * sage-mem — 界面侧：DSH 设置页「记忆管理」界面（文件管理器）。
  *
  * 手写 ModuleLoader bundle（`window.__ModuleLoader__.load({ id, factory })` 格式）：
  * window.__ModuleLoader__.load({ id, factory })，factory 内 require('react')
  * 可用，module.exports 导出标准 Cordis 插件（apply/inject）。
  *
- * 数据通道：TypertRemoteService（host 半 MemoryGateway），通过
+ * 数据通道：TypertRemoteService（宿主侧 MemoryGateway），通过
  * ctx.get("remote.memory") 调用文件列表/读/写/删。remote 返回 {ok, value}
  * 信封。浏览器侧无 zod，schema 手写（codec 只要求 mode==="strict" + parse）。
  *
@@ -64,7 +64,7 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-starmap/types#StarList", schema: listSchema, create: () => listSchema },
-					sourceLocation: { "file": "workspace/sage-starmap/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-starmap#starmap/readFile",
@@ -76,7 +76,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-starmap/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
 					result: { mode: "strict", typeSymbol: "sage-starmap/types#FileContent", schema: readSchema, create: () => readSchema },
-					sourceLocation: { "file": "workspace/sage-starmap/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 			],
 		};
@@ -109,7 +109,7 @@ const StarmapRuntime = (function (require, _react) {
 
 		// ── 常量与纯函数 ─────────────────────────────────────────────
 		//
-		// 配色（2026-09-27 重做）：原来五个色都是高饱和高亮度（#ffd27d / #6fe3ff /
+		// 配色（重做过一版）：原来五个色都是高饱和高亮度（#ffd27d / #6fe3ff /
 		// #b18cff / #7dffb0），配上当时的星芒与脉冲环，整体读起来像贴纸。
 		// 现在统一降饱和、压亮度 —— 深空画布上够辨认，又不抢眼。
 		const KIND_META = {
@@ -373,7 +373,7 @@ const StarmapRuntime = (function (require, _react) {
 			".smap-modal{width:min(980px,94vw);height:min(680px,92vh);background:linear-gradient(160deg,#0d1226,#111a33);border:1px solid rgba(140,160,220,.22);border-radius:16px;box-shadow:0 24px 80px rgba(0,0,0,.55);padding:16px 18px;display:flex;flex-direction:column;overflow:hidden;pointer-events:auto;animation:smap-pop-in .22s cubic-bezier(.2,.9,.3,1.15);}",
 			"@keyframes smap-fade-in{from{opacity:0}to{opacity:1}}",
 			"@keyframes smap-pop-in{from{opacity:0;transform:scale(.96) translateY(10px)}to{opacity:1;transform:none}}",
-			// 2026-09-27（B 方案「自洽夜空」）：星图整块含 header 与图例，同属一张深色画布。
+			// 星图整块含 header 与图例，同属一张深色画布。
 			//
 			// 不这么做的下场是实测出来的：宿主切到**浅色主题**后，这个组件里硬编码的
 			// 浅色文字（#dbe4f5 系）落在白色卡片上，标题、搜索框、图例几乎看不见 ——
@@ -449,7 +449,7 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		const SMAP_BG_VS = "attribute vec2 aPos; void main(){ gl_Position = vec4(aPos, 0.0, 1.0); }";
-		// 底色（2026-09-27 重做）。旧版是四层 fbm 噪声算出来的蓝紫星云，还带 uTime 动画 ——
+		// 底色（重做过一版）。旧版是四层 fbm 噪声算出来的蓝紫星云，还带 uTime 动画 ——
 		// 「会呼吸的彩色底」正是廉价感的一大来源，而且每帧都要重算噪声。
 		// 现在只剩一条静态径向渐变：中心略亮的中性深灰，边缘更暗。uTime 保留声明
 		// 只为让 uniform 列表不变（用不到时 getUniformLocation 返回 null，调用是安全空操作）。
@@ -484,7 +484,7 @@ const StarmapRuntime = (function (require, _react) {
 			"}",
 		].join("\n");
 
-		// 星点（2026-09-27 重做）。去掉了三样东西，它们就是「塑料感」的来源：
+		// 星点（重做过一版）。去掉了三样东西，它们是「塑料感」的来源：
 		//   1. 衍射星芒（横竖两条十字 spike）—— 用户明确要求去掉
 		//   2. 脉冲扩散环（fract(uTime*0.3) 画出来的同心圆）—— 看起来像贴纸上的亮环
 		//   3. 呼吸闪烁（sin(uTime) 调制整体透明度）—— 满屏一起闪，廉价
@@ -958,7 +958,7 @@ const StarmapRuntime = (function (require, _react) {
 				drawBox.t0 = Date.now();
 				renderer.render(0);
 
-				// ── 按需重绘（2026-09-27 重做）──
+				// ── 按需重绘（重做过一版）──
 				// 旧版是一个常驻 rAF 循环：只要星图页开着就永远满帧重画，后台标签页也一样，
 				// 而画面其实早就静止了。新的规矩只有三种情况会画：
 				//   1. 入场展示动画期间（约 1.3s，星点按诞生时间依次点亮）
@@ -1395,7 +1395,7 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#FileList", schema: listSchema, create: () => listSchema },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#memory/readFile",
@@ -1407,7 +1407,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: readSchema, create: () => readSchema },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#memory/writeFile",
@@ -1420,7 +1420,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ name: "content", wire: "content", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: strSchema, create: () => strSchema } },
 					],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#WriteResult", schema: writeSchema, create: () => writeSchema },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#memory/deleteFile",
@@ -1432,7 +1432,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#DeleteResult", schema: deleteSchema, create: () => deleteSchema },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#starmap/listStars",
@@ -1442,7 +1442,7 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapList", schema: starmapListSchema, create: () => starmapListSchema },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#starmap/readFile",
@@ -1454,13 +1454,13 @@ const StarmapRuntime = (function (require, _react) {
 						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapRead", schema: starmapReadSchema, create: () => starmapReadSchema },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				// ── autodream（自动做梦）──
 				// 踩到的坑：namespace 不会自动出现。宿主那份 remote 清单是**构建期生成的
 				// 产物**，只有 memory / starmap 在里面；
 				// 后加的 autodream 不在，于是 `ctx.get("remote.autodream")` 永远 undefined ——
-				// 界面上表现为「remote.autodream 不可用」，而 host 半日志明确写着
+				// 界面上表现为「remote.autodream 不可用」，而 宿主侧日志明确写着
 				// 「autodream gateway mounted ok」（服务是真的挂上了，只是 client 不知道）。
 				// 修法就是自己声明 + $mount，和 memory / starmap 一样（现在共十一条：
 				// 七个原有方法 + listRuns / readDeclaration / rollback / listModels）。
@@ -1472,7 +1472,7 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamConfigResult", schema: objCodec, create: () => objCodec },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/setConfig",
@@ -1484,7 +1484,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ 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#AutodreamConfigResult", schema: objCodec, create: () => objCodec },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/status",
@@ -1494,7 +1494,7 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamStatus", schema: objCodec, create: () => objCodec },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/runNow",
@@ -1504,11 +1504,11 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [
 						// 契约：runNow({reason})。前端只负责给一个缘由字符串（落进
-						// manifest.reason 给人看）；「手动触发跳过门控」由 host 半决定。
+						// manifest.reason 给人看）；「手动触发跳过门控」由 宿主侧决定。
 						{ 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#AutodreamRunResult", schema: objCodec, create: () => objCodec },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/listReports",
@@ -1518,7 +1518,7 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamReportList", schema: arrCodec, create: () => arrCodec },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/readReport",
@@ -1530,7 +1530,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ 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 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/listSnapshots",
@@ -1540,9 +1540,9 @@ const StarmapRuntime = (function (require, _react) {
 					invocation: { kind: "direct" },
 					parameters: [],
 					result: { mode: "strict", typeSymbol: "sage-mem/types#AutodreamSnapshotList", schema: arrCodec, create: () => arrCodec },
-					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
-				// ── 2026-10-01 新增：运行记录 / 整理声明 / 回滚 / 模型目录 ──
+				// ── 运行记录 / 整理声明 / 回滚 / 模型目录 ──
 				// 都是「单个对象参数」形态（与 setConfig(patch) 同形），契约第二节的
 				// {limit} / {runId} / {snapshotId, scope} 逐字对应这个对象的字段。
 				{
@@ -1555,7 +1555,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ 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 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/readDeclaration",
@@ -1567,7 +1567,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ 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 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/rollback",
@@ -1579,7 +1579,7 @@ const StarmapRuntime = (function (require, _react) {
 						{ 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 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
 					id: "sage-mem#autodream/listModels",
@@ -1589,7 +1589,7 @@ const StarmapRuntime = (function (require, _react) {
 					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 },
+					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 			],
 		};
@@ -1671,7 +1671,7 @@ const StarmapRuntime = (function (require, _react) {
 			".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-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);}",
@@ -1720,7 +1720,7 @@ const StarmapRuntime = (function (require, _react) {
 
 		// ── frontmatter 纯逻辑（顶层自包含普通函数，不碰 React state）─────
 		//
-		// 2026-09-25 P0 数据事故的根因全在这几行里，三条硬规矩：
+		// 这里曾出过一次 P0 级数据丢失事故，根因全在这几行里，三条硬规矩：
 		//   1) 绝不「重建」frontmatter —— 就地合并，除 description / type 外每一行
 		//      逐字保留。旧版 buildFrontmatter() 只写 name/description/type 三个字段，
 		//      保存一次就把 baseline / node_type / originSessionId / updated 全抹掉
@@ -1730,7 +1730,7 @@ const StarmapRuntime = (function (require, _react) {
 		//   3) 换行必须容忍 CRLF（Windows 编辑器碰一次就是 \r\n）；回写沿用原文件的
 		//      换行风格，从而 LF / CRLF 都能逐字节 round-trip。
 
-		/** 去掉值两侧成对的引号（与 host 半 parseFrontmatter 的剥法一致）。 */
+		/** 去掉值两侧成对的引号（与 宿主侧 parseFrontmatter 的剥法一致）。 */
 		function stripQuotes(v) {
 			const s = typeof v === "string" ? v.trim() : "";
 			return s.replace(/^["']|["']$/g, "").trim();
@@ -1764,7 +1764,7 @@ const StarmapRuntime = (function (require, _react) {
 		 * 识别记忆类型。锚行首（^ + m），**不看 node_type**：
 		 *   1) 顶层 `type: X`
 		 *   2) metadata 块内的缩进写法 `  type: X`
-		 * 优先级与 host 半 parseFrontmatter 一致（顶层优先）。找不到返回 ""。
+		 * 优先级与 宿主侧 parseFrontmatter 一致（顶层优先）。找不到返回 ""。
 		 */
 		function detectType(text) {
 			const fm = fmInner(text);
@@ -1794,7 +1794,7 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		/**
-		 * 取顶层 tags 的值。三种写法都认，与 host 半 parseTags 保持同一套规则：
+		 * 取顶层 tags 的值。三种写法都认，与 宿主侧 parseTags 保持同一套规则：
 		 *   tags: ["a", "b"]       （flow，本插件自己写出去的就是这种）
 		 *   tags:\n  - a\n  - b    （block，手写文件常见）
 		 *   tags: a, b             （松散逗号串）
@@ -2042,9 +2042,9 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		/**
-		 * 「自动做梦」面板 —— 让记忆自己整理一遍（引擎在 host 半 lib/autodream.js）。
+		 * 「自动做梦」面板 —— 让记忆自己整理一遍（引擎在 宿主侧 lib/autodream.js）。
 		 *
-		 * 数据全走 remote.autodream（host 半的 AutodreamGateway）。两条实现约定：
+		 * 数据全走 remote.autodream（宿主侧的 AutodreamGateway）。两条实现约定：
 		 *   1. **轮询而不是等待**。「立即整理」启动后台任务后立刻返回 —— 一趟可能跑
 		 *      几分钟，把 remote 调用挂在那儿等会撞上前端超时。进度靠每 2 秒拉一次
 		 *      status() 显示。
@@ -2063,7 +2063,7 @@ const StarmapRuntime = (function (require, _react) {
 			const sBody = react.useState(""); const body = sBody[0], setBody = sBody[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];
@@ -2083,7 +2083,7 @@ const StarmapRuntime = (function (require, _react) {
 			const rollbackScope = c.rollbackScope === "all" ? "all" : "files";
 
 			react.useEffect(function () {
-				if (!remote) { setErr("remote.autodream 不可用 —— 插件的 host 半可能没加载成功，看 DSH 启动日志"); return undefined; }
+				if (!remote) { setErr("remote.autodream 不可用 —— 插件的 宿主侧可能没加载成功，看 DSH 启动日志"); return undefined; }
 				let alive = true;
 				function pull() {
 					callRemote("status", [], function (d) {
@@ -2116,13 +2116,13 @@ const StarmapRuntime = (function (require, _react) {
 			 * 所有 remote 调用的统一出口。
 			 *
 			 * 契约的硬约束是「每个调用都 try/catch，失败显示错误文案、不白屏」，而
-			 * 这里还有第三种失败：host 半是旧版本、方法根本不在 remote 对象上
+			 * 这里还有第三种失败：宿主侧是旧版本、方法根本不在 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; }
+				if (typeof fn !== "function") { if (onErr) onErr("宿主侧没有 " + name + " 接口（版本较旧？）"); return; }
 				let p;
 				try { p = fn.apply(remote, args || []); }
 				catch (e) { if (onErr) onErr(detail(e)); return; }
@@ -2161,7 +2161,7 @@ const StarmapRuntime = (function (require, _react) {
 			function run() {
 				setErr(null); setNotice(""); setBusy(true);
 				// 契约：runNow({ reason })。reason 只落进 manifest 给人看；门控的豁免
-				// 由 host 半负责（手动点了按钮就不该被「还没到 N 小时」挡回来）。
+				// 由 宿主侧负责（手动点了按钮就不该被「还没到 N 小时」挡回来）。
 				callRemote("runNow", [{ reason: "设置页手动触发" }], function (d) {
 					if (d && d.ok === false) setErr(d.error || "启动失败");
 					else { setNotice("已开始整理 —— 进度每 2 秒刷新一次"); refreshLists(); }
@@ -2717,7 +2717,7 @@ const StarmapRuntime = (function (require, _react) {
 				]),
 				// 搜索 / 刷新 / 添加 / 筛选都只属于「文件列表」这个视图。
 				// 放在 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); } }),
 					h("button", { type: "button", className: "smem-btn", key: "refresh", disabled: busy || loading, onClick: load }, "刷新"),

package/lib/index.js

@@ -504,9 +504,9 @@ export class MemoryGateway extends TypertRemoteService {
         //
         // 旧写法 `if (userMessages.length === 0)` 依赖一个真实存在的时序：assemble
         // 触发时当前这条用户消息还没写进 session。已在 DSH 0.1.7-rc.1 上核实为真 ——
-        //   dsh-agent-loop/lib/index.js:906  const claimed = this.inbox.claim(...)   // 只从 pending 队列取走
-        //   dsh-agent-loop/lib/index.js:907  await this.loopCtx.systemPrompt.assemble(...)  // ← 本监听器在这里跑
-        //   dsh-agent-loop/lib/index.js:1046 this.session.append("user/message", ...)  // 落 session 在 preStep 之后
+        //   宿主从 pending 队列取走本轮输入
+        //   组装 system prompt（本监听器在这里跑）
+        //   之后才把这条 user 消息落进 session
         // 所以全新会话首步 pick 到 0 条 user message，分支命中。
         //
         // 但**恢复 / 续聊会话**的历史消息早就在 session 里，条数永远 ≥ 1 → 分支永不
@@ -673,8 +673,8 @@ async function scanStars(ctx) {
 }
 
 /**
- * 记忆星图（host 半）—— 只读扫描记忆目录，把每条记忆解析成一颗「星」。
- * 通过 TypertRemoteService 暴露两个 remote 方法给浏览器半：
+ * 记忆星图（宿主侧）—— 只读扫描记忆目录，把每条记忆解析成一颗「星」。
+ * 通过 TypertRemoteService 暴露两个 remote 方法给界面侧：
  *   - starmap.listStars()  全部星（元数据，不含正文）
  *   - starmap.readFile(n)  单条记忆全文（文件名白名单校验）
  */

package/lib/typert.host.js

@@ -264,7 +264,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileList', schema: listResultSchema, create: () => listResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#memory/readFile',
@@ -276,7 +276,7 @@ export const TYPERT = {
 				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: readResultSchema, create: () => readResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#memory/writeFile',
@@ -289,7 +289,7 @@ export const TYPERT = {
 				{ name: 'content', wire: 'content', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: fileContentSchema, create: () => fileContentSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#WriteResult', schema: writeResultSchema, create: () => writeResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#memory/deleteFile',
@@ -301,7 +301,7 @@ export const TYPERT = {
 				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DeleteResult', schema: deleteResultSchema, create: () => deleteResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#starmap/listStars',
@@ -311,7 +311,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapList', schema: starmapListSchema, create: () => starmapListSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#starmap/readFile',
@@ -323,7 +323,7 @@ export const TYPERT = {
 				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapRead', schema: starmapReadSchema, create: () => starmapReadSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		// ── autodream 的七个方法 ──
 		// 全部挂在 package `sage-mem` 下（和 memory 同一份 manifest），
@@ -338,7 +338,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamConfigResult', schema: autodreamConfigResultSchema, create: () => autodreamConfigResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/setConfig',
@@ -350,7 +350,7 @@ export const TYPERT = {
 				{ name: 'patch', wire: 'patch', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamPatch', schema: autodreamPatchSchema, create: () => autodreamPatchSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamConfigResult', schema: autodreamConfigResultSchema, create: () => autodreamConfigResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/status',
@@ -360,7 +360,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamStatus', schema: autodreamStatusSchema, create: () => autodreamStatusSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/runNow',
@@ -372,7 +372,7 @@ export const TYPERT = {
 				{ name: 'opts', wire: 'opts', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamOpts', schema: autodreamOptsSchema, create: () => autodreamOptsSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamRunResult', schema: autodreamRunResultSchema, create: () => autodreamRunResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/listReports',
@@ -382,7 +382,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamReportList', schema: reportListSchema, create: () => reportListSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/readReport',
@@ -394,7 +394,7 @@ export const TYPERT = {
 				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamReportRef', schema: reportRefSchema, create: () => reportRefSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: readResultSchema, create: () => readResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/listSnapshots',
@@ -404,7 +404,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamSnapshotList', schema: snapshotListSchema, create: () => snapshotListSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/listRuns',
@@ -416,7 +416,7 @@ export const TYPERT = {
 				{ name: 'opts', wire: 'opts', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamOpts', schema: autodreamOptsSchema, create: () => autodreamOptsSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamRunList', schema: runListSchema, create: () => runListSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/readDeclaration',
@@ -428,7 +428,7 @@ export const TYPERT = {
 				{ name: 'opts', wire: 'opts', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamOpts', schema: autodreamOptsSchema, create: () => autodreamOptsSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamDeclaration', schema: declarationSchema, create: () => declarationSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/rollback',
@@ -440,7 +440,7 @@ export const TYPERT = {
 				{ name: 'opts', wire: 'opts', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamOpts', schema: autodreamOptsSchema, create: () => autodreamOptsSchema } },
 			],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamRollbackResult', schema: rollbackResultSchema, create: () => rollbackResultSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 		{
 			id: 'sage-mem#autodream/listModels',
@@ -450,7 +450,7 @@ export const TYPERT = {
 			invocation: { kind: 'direct' },
 			parameters: [],
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#AutodreamModelList', schema: modelListSchema, create: () => modelListSchema },
-			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 		},
 	],
 	model: {

package/package.json

@@ -1,89 +1,89 @@
-{
-  "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.7.0",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./typert": "./lib/typert.host.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib/",
-    "cordis.patch.yml",
-    "NOTICE"
-  ],
-  "license": "Apache-2.0",
-  "engines": {
-    "node": ">=18",
-    "dsh": ">=0.1.2-rc.1"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ]
-    },
-    "compatibility": {
-      "dsh": ">=0.1.2-rc.1",
-      "dshReleases": {
-        "0.1.2-rc.1": "compatible",
-        "0.1.3-alpha.1": "compatible",
-        "0.1.3-alpha.2": "compatible",
-        "0.1.5-rc.1": "compatible",
-        "0.1.6-alpha.1": "compatible",
-        "0.1.6-alpha.2": "compatible",
-        "0.1.7-rc.1": "compatible",
-        "0.1.7-rc.2": "compatible",
-        "0.2.0-rc.1": "compatible",
-        "0.2.0-rc.2": "compatible"
-      }
-    }
-  },
-  "dependencies": {
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "react": "^18.0.0"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.2-rc.1",
-    "react": "^18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gezi-wen/sage-mem.git"
-  },
-  "homepage": "https://github.com/gezi-wen/sage-mem#readme",
-  "bugs": {
-    "url": "https://github.com/gezi-wen/sage-mem/issues"
-  },
-  "keywords": [
-    "memory",
-    "ai-memory",
-    "agent-memory",
-    "long-term-memory",
-    "cross-session-memory",
-    "context-management",
-    "knowledge-management",
-    "markdown",
-    "dsh",
-    "dsh-plugin",
-    "deepseek",
-    "deepseek-harness",
-    "cordis",
-    "typert",
-    "plugin",
-    "ai-agent",
-    "agent",
-    "claude-code"
-  ]
-}
+{
+  "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.7.1",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./typert": "./lib/typert.host.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml",
+    "NOTICE"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18",
+    "dsh": ">=0.1.2-rc.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    },
+    "compatibility": {
+      "dsh": ">=0.1.2-rc.1",
+      "dshReleases": {
+        "0.1.2-rc.1": "compatible",
+        "0.1.3-alpha.1": "compatible",
+        "0.1.3-alpha.2": "compatible",
+        "0.1.5-rc.1": "compatible",
+        "0.1.6-alpha.1": "compatible",
+        "0.1.6-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible",
+        "0.1.7-rc.2": "compatible",
+        "0.2.0-rc.1": "compatible",
+        "0.2.0-rc.2": "compatible"
+      }
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "react": "^18.0.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.2-rc.1",
+    "react": "^18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gezi-wen/sage-mem.git"
+  },
+  "homepage": "https://github.com/gezi-wen/sage-mem#readme",
+  "bugs": {
+    "url": "https://github.com/gezi-wen/sage-mem/issues"
+  },
+  "keywords": [
+    "memory",
+    "ai-memory",
+    "agent-memory",
+    "long-term-memory",
+    "cross-session-memory",
+    "context-management",
+    "knowledge-management",
+    "markdown",
+    "dsh",
+    "dsh-plugin",
+    "deepseek",
+    "deepseek-harness",
+    "cordis",
+    "typert",
+    "plugin",
+    "ai-agent",
+    "agent",
+    "claude-code"
+  ]
+}