@modusensus/dsh-mneme 0.12.0 → 0.14.0-beta.1

package/lib/dsh-go/views/settings.js

@@ -0,0 +1,398 @@
+// 设置 / 状态: two sibling areas, mirroring mneme's own panel where 设置 and
+// 状态 are separate top-level tabs. The app's tab bar only fits three tabs at
+// 80dp on a phone, so the third tab holds a two-item switch (设置 | 状态) and
+// each area keeps its own inner navigation: 设置 is a card menu (like mneme's
+// Settings cards) and 状态 is mneme's Status page with its grouped cards.
+import { ENUM_FLAGS, FLAG_GROUPS, MODE_OPTIONS, flagAction, flagPath } from "../text.js";
+import {
+  act,
+  actions,
+  b,
+  caption,
+  divider,
+  empty,
+  fold,
+  heading,
+  kv,
+  metric,
+  mono,
+  select,
+  text,
+  toggle,
+} from "./common.js";
+import { conflictPage } from "./memory.js";
+import { statusSection } from "./status.js";
+
+const SETTINGS_VIEWS = ["settings", "status"];
+
+// 设置页的顺序与分组对齐 mneme 电脑端面板（个性化 / 记忆引擎 / 搜索 / 连接与
+// 安全 / 帮助）。功能开关是记忆引擎的一部分，所以不再藏进子页面，直接铺在设置
+// 页上；只有需要表单的子页（命令 / 向量 / 外部访问 / 工作动态 / 关于）才进入
+// 「点一行 → 子页面」的导航。
+const PAGES = [
+  { key: "commands", title: "自定义指令", hint: "把常用提示词存成 / 命令，聊天时直接键入调用。", icon: "command" },
+  {
+    key: "vector",
+    title: "向量检索",
+    hint: "搜索不再只认字面：接入任意 OpenAI 兼容的 embedding 接口后，意思相近的记忆也能被召回。",
+    icon: "chart",
+  },
+  {
+    key: "external",
+    title: "外部访问",
+    hint: "开放一个本机接口，让其他工具（插件、命令行、桌面应用）也能读写这份记忆库，默认只允许本机连接。改动保存后重启 DSH 生效。",
+    icon: "globe",
+  },
+  {
+    key: "choro",
+    title: "代码库地志",
+    hint: "给常用仓库生成一份代码骨架：模块划分、文件数、约定与构建方式，开会话时按档位注入。",
+    icon: "code",
+  },
+  { key: "help", title: "关于", icon: "info" },
+];
+
+const pageRow = (page) => ({
+  title: page.title,
+  ...(page.hint === undefined ? {} : { subtitle: page.hint }),
+  icon: page.icon,
+  action: { id: "open-panel", args: { k: page.key } },
+});
+
+const rows = (keys) => ({
+  type: "list",
+  items: PAGES.filter((page) => keys.includes(page.key)).map(pageRow),
+});
+
+function personalRows() {
+  return {
+    type: "list",
+    items: [
+      {
+        title: "用户画像",
+        subtitle: "写一段自我介绍（角色、背景、偏好），Agent 每轮对话都会自动带上。",
+        icon: "user",
+        action: { id: "open-profile", args: { k: "profile" } },
+      },
+      {
+        title: "规则",
+        subtitle: "给 Agent 立下必须遵守的规矩，随时增删，下一轮即生效。",
+        icon: "list",
+        action: { id: "open-profile", args: { k: "rules" } },
+      },
+      {
+        title: "Agent 眼中的你",
+        subtitle: "dream 巩固后自动维护的一份逐条事实清单；这里可以逐条改、加、归档。",
+        icon: "sparkle",
+        action: { id: "open-panel", args: { k: "facts" } },
+      },
+      {
+        title: "人格定义（beta）",
+        subtitle: "给这位 Agent 一张角色卡：名字、性格、回复要求。",
+        icon: "robot",
+        action: { id: "open-profile", args: { k: "persona" } },
+      },
+    ],
+  };
+}
+
+function settingsMenu(state) {
+  const group = FLAG_GROUPS.find((g) => g.key === state.flagGroup) ?? FLAG_GROUPS[0];
+  return [
+    heading("个性化"),
+    personalRows(),
+    heading("记忆引擎"),
+    {
+      type: "segmented",
+      label: "\u200b",
+      bind: "data.mode",
+      options: MODE_OPTIONS,
+      onChange: { id: "mode" },
+    },
+    caption(
+      "轻量模式只保留核心能力：记忆读写、自动注入、热记忆；巩固、实体抽取、语义搜索等全部关闭，适合低配机器或只想「记住偏好」的场景。标准模式开启全部功能。",
+    ),
+    rows(["choro"]),
+    heading("功能开关"),
+    select(
+      "分组",
+      "data.flagGroup",
+      FLAG_GROUPS.map((g) => ({ label: g.label, value: g.key })),
+      "switch-group",
+    ),
+    caption(group.note),
+    ...group.items.map(([key, label]) => toggle(label, flagPath(key), flagAction(key))),
+    // 枚举项不是开关：给一组下拉（目前只有地志注入档位，挂在工作流组下）。
+    ...ENUM_FLAGS.filter((flag) => group.key === "workflow").flatMap((flag) => [
+      select(flag.label, flagPath(flag.key), flag.options, flagAction(flag.key)),
+      caption(flag.hint),
+    ]),
+    // 「其它」组按 /features 的 effective 动态列出未收录的布尔旗标：视图结构
+    // 不能靠数据分支，所以用 list + 数据行（点一行翻转一侧）。
+    ...(group.key === "extra" ? [{ type: "list", items: b("data.extraRows") }] : []),
+    caption(b("data.flagsMeta")),
+    caption(
+      "控制插件在后台做哪些事。改动即时保存，重启 DSH 后生效；嵌套开关（如「质量过滤 · 启用」）在电脑端面板里按点号归类。",
+    ),
+    heading("搜索"),
+    rows(["vector"]),
+    heading("连接与安全"),
+    rows(["external"]),
+    heading("帮助"),
+    rows(["commands", "help"]),
+    divider(),
+    actions(act("刷新", "refresh", undefined, "refresh")),
+  ];
+}
+
+function workbenchPanel() {
+  const nodes = [
+    kv(b("data.wbKv")),
+    heading("已沉淀"),
+    { type: "list", items: b("data.wbDeposited") },
+    caption("沉淀 = 被 mneme 当成工作流或项目状态写下来的条目。"),
+    heading("归档"),
+  ];
+  nodes.push({ type: "list", items: b("data.wbArchived") });
+  nodes.push(caption("点按任意一条可以恢复它。"));
+  return nodes;
+}
+
+function commandsPanel(state) {
+  const nodes = [{ type: "list", items: b("data.cmdRows") }];
+  if (state.cmdCount === 0) nodes.push(empty("还没有自定义命令", "在下面填一条，之后就能随时叫它。", "command"));
+  nodes.push({
+    type: "form",
+    submit: { id: "cmd-add" },
+    submitLabel: "新增命令",
+    children: [
+      { type: "textField", label: "命令名", bind: "data.sCmdName", required: true, maxLength: 40 },
+      { type: "textField", label: "说明", bind: "data.sCmdDesc", maxLength: 120 },
+      { type: "textField", label: "指令正文", bind: "data.sCmdIns", multiline: true, maxLines: 4, maxLength: 2000 },
+    ],
+  });
+  if (state.cmdCount > 0) {
+    nodes.push(
+      select(
+        "要删除的命令",
+        "data.sCmdPick",
+        [
+          { label: "不删除", value: "" },
+          ...state.commands.map((cmd) => ({ label: String(cmd.name ?? cmd.id), value: String(cmd.id) })),
+        ],
+        "cmd-pick",
+      ),
+    );
+    if (state.sCmdPick !== "") {
+      nodes.push({ type: "confirm", id: "cmd-delete", confirmLabel: "删除命令", cancelLabel: "取消" });
+    }
+  }
+  return nodes;
+}
+
+function vectorPanel() {
+  return [
+    kv(b("data.vectorKv")),
+    toggle("启用向量检索", "data.sVecEnabled", "vector-toggle"),
+    {
+      type: "form",
+      submit: { id: "vector-save" },
+      submitLabel: "保存向量配置",
+      children: [
+        { type: "textField", label: "接口地址", bind: "data.sVecUrl", placeholder: "https://…/v1", maxLength: 200 },
+        {
+          type: "textField",
+          label: "模型",
+          bind: "data.sVecModel",
+          placeholder: "text-embedding-3-small",
+          maxLength: 80,
+        },
+      ],
+    },
+    actions(act("重建索引", "vector-reindex", undefined, "refresh")),
+    caption(b("data.vectorNote")),
+  ];
+}
+
+function externalPanel() {
+  return [
+    toggle("开启外部访问", "data.sExtEnabled", "external-toggle"),
+    {
+      type: "form",
+      submit: { id: "external-save" },
+      submitLabel: "保存外部访问",
+      children: [
+        { type: "textField", label: "端口", bind: "data.sExtPort", placeholder: "8790", maxLength: 5 },
+        { type: "textField", label: "监听地址", bind: "data.sExtHost", placeholder: "127.0.0.1", maxLength: 60 },
+      ],
+    },
+    caption("令牌由 mneme 自己管理，面板不读取也不显示明文；需要令牌时到电脑端的 mneme 设置里看。"),
+  ];
+}
+
+function helpPanel() {
+  return [
+    kv(b("data.helpKv")),
+    actions(act("检测新版本", "check-version", undefined, "download")),
+    caption(b("data.versionNote")),
+  ];
+}
+
+const PANEL_TITLES = {
+  facts: "Agent 眼中的你",
+  choro: "代码库地志",
+  workbench: "工作台",
+  commands: "自定义命令",
+  vector: "向量检索",
+  external: "外部访问",
+  help: "关于",
+};
+
+function factsPanel() {
+  // 结构必须与数据无关（宿主先给视图、后推数据；按数据分支的地方会在首屏定形）。
+  // 所以「编辑框 / 归档按钮」永远在树里，点的哪条事实由 data.factEditHint 说明、
+  // 内容由 data.sFactEdit 填。
+  return [
+    select(
+      "哪张卡",
+      "data.factsAgent",
+      b("data.factsCardOptions"),
+      "facts-agent",
+    ),
+    { type: "list", items: b("data.factsRows") },
+    { type: "textField", label: "修改这条事实", bind: "data.sFactEdit", multiline: true, maxLines: 3, maxLength: 300 },
+    text(b("data.factsEditHint"), { size: "caption" }),
+    actions(act("保存修改", "facts-save", undefined, "save")),
+    { type: "confirm", id: "facts-archive", confirmLabel: "归档这条", cancelLabel: "取消" },
+    {
+      type: "form",
+      submit: { id: "facts-add" },
+      submitLabel: "添加一条",
+      children: [
+        { type: "textField", label: "新事实（一句话）", bind: "data.sFactNew", required: true, maxLength: 200 },
+      ],
+    },
+    actions(act("立即更新", "facts-run", undefined, "sparkle")),
+    caption(b("data.factsRunText")),
+    caption("事实由模型在 dream 巩固后自己维护；手填的画像永远优先，事实不会覆盖它。"),
+  ];
+}
+
+function choroPanel(state) {
+  return [
+    select("仓库", "data.choroRepo", b("data.choroRepoOptions"), "choro-repo"),
+    { type: "list", items: b("data.choroRows") },
+    text(b("data.choroNote"), { size: "caption" }),
+    fold("模块页", [mono(b("data.choroPageText"))], false),
+    { type: "confirm", id: "choro-run", confirmLabel: "重建骨架", cancelLabel: "取消" },
+    caption("重建会把已富化的模块页退回骨架；语义段要命令行 --t1 重新生成。"),
+  ];
+}
+
+function panelBody(state) {
+  switch (state.sPanel) {
+    case "facts":
+      return factsPanel(state);
+    case "choro":
+      return choroPanel(state);
+    case "workbench":
+      return workbenchPanel();
+    case "commands":
+      return commandsPanel(state);
+    case "vector":
+      return vectorPanel();
+    case "external":
+      return externalPanel();
+    case "help":
+      return helpPanel();
+    default:
+      return [];
+  }
+}
+
+function panelPage(state) {
+  return [
+    actions(act("返回", "back", undefined, "reply"), act("刷新", "refresh", undefined, "refresh")),
+    heading(PANEL_TITLES[state.sPanel] ?? "设置"),
+    ...panelBody(state),
+  ];
+}
+
+function settingsBody(state) {
+  if (state.page === "profile") return profilePage(state);
+  if (state.page === "conflict") return conflictPage(state);
+  if (state.sPanel !== "menu") return panelPage(state);
+  return settingsMenu(state);
+}
+
+function statusBody(state) {
+  return [
+    {
+      type: "grid",
+      columns: 2,
+      children: [
+        metric("记忆总数", "data.totalText"),
+        metric("近 30 天注入", "data.injectedText"),
+        metric("注入命中率", "data.slotRateText", "good"),
+        metric("待确认冲突", "data.conflictsText", state.pendingConflicts > 0 ? "warn" : undefined),
+      ],
+    },
+    ...statusSection(state),
+    actions(act("刷新", "refresh", undefined, "refresh")),
+  ];
+}
+
+export function settingsTab(state) {
+  const view = SETTINGS_VIEWS.includes(state.settingsView) ? state.settingsView : "settings";
+  return [
+    {
+      type: "segmented",
+      label: "\u200b",
+      bind: "data.settingsView",
+      options: [
+        { label: "设置", value: "settings" },
+        { label: "状态", value: "status" },
+      ],
+      onChange: { id: "switch-settings-view" },
+    },
+    ...(view === "status" ? statusBody(state) : settingsBody(state)),
+  ];
+}
+
+export function profilePage(state) {
+  const nodes = [
+    actions(act("返回", "back", undefined, "reply"), act("刷新", "refresh", undefined, "refresh")),
+    {
+      type: "segmented",
+      label: "\u200b",
+      bind: "data.profileTab",
+      options: [
+        { label: "画像", value: "profile" },
+        { label: "规则", value: "rules" },
+        { label: "人格", value: "persona" },
+      ],
+      onChange: { id: "profile-tab" },
+    },
+  ];
+  if (state.profileTab === "persona") {
+    nodes.push(kv(b("data.previewItems")));
+    nodes.push(fold("人格设定", [mono(b("data.personaText"))], false));
+    return nodes;
+  }
+  nodes.push({
+    type: "textField",
+    label: state.profileTab === "rules" ? "规则（JSON 数组）" : "用户画像",
+    bind: "data.editText",
+    multiline: true,
+    maxLines: 8,
+    maxLength: 4000,
+  });
+  nodes.push(actions(act("保存", "profile-save", undefined, "save")));
+  if (state.profileTab === "profile") {
+    nodes.push(actions(act("从记忆提取草稿", "profile-extract", undefined, "sparkle")));
+    if (state.extractText !== "") nodes.push(text(b("data.extractText"), { size: "caption" }));
+  }
+  return nodes;
+}
+
+export { panelPage };

package/lib/dsh-go/views/status.js

@@ -0,0 +1,51 @@
+// 运行状态: the runtime picture mneme's own Status tab shows, grouped into
+// collapsible blocks so the settings tab stays short.
+import { act, actions, b, caption, chart, fold, heading, kv } from "./common.js";
+
+export function statusSection(state) {
+  return [
+    fold("库内一览", [kv(b("data.statusKv"))], true),
+    fold("注入与召回", [kv(b("data.injectKv")), heading("常被召回"), { type: "list", items: b("data.topRows") }], true),
+    fold("注入预览", [caption(b("data.injectPreviewText"))], false),
+    fold("后台巩固", [kv(b("data.dreamKv")), { type: "list", items: b("data.runRows") }], false),
+    fold(
+      "模型用量",
+      [
+        {
+          type: "chart",
+          kind: "bar",
+          categories: b("data.tokenCategories"),
+          series: b("data.tokenSeries"),
+          unit: "次",
+          caption: "近 28 天",
+        },
+        kv(b("data.tokenKv")),
+      ],
+      false,
+    ),
+    fold(
+      "热度分布",
+      [
+        { type: "chart", kind: "bar", categories: ["热", "温", "冷"], series: b("data.heatSeries"), unit: "条" },
+        caption(b("data.heatNote")),
+      ],
+      false,
+    ),
+    fold("冲突队列", [actions(act("打开冲突队列", "open-conflict", undefined, "warning"))], false),
+    fold("工作动态", [actions(act("打开工作动态", "open-panel", { k: "workbench" }, "todo"))], false),
+    fold(
+      "维护",
+      [
+        actions(
+          act("检查可回收", "reclaim", undefined, "clear"),
+          act("真跑回收", "reclaim-prepare", undefined, "delete"),
+        ),
+        ...(state.reclaimConfirm === true
+          ? [{ type: "confirm", id: "reclaim-run", confirmLabel: "真跑回收", cancelLabel: "取消" }]
+          : []),
+        caption(b("data.reclaimText")),
+      ],
+      false,
+    ),
+  ];
+}

package/lib/embedding.js

@@ -265,6 +265,20 @@ export function createEmbedder({ store, settings, logger, vectorIndex }) {
       return null;
     },
 
+    // Same as embedSingle, but keeps the reason a vector did not come back.
+    // embedSingle() drops it on purpose — its callers only care whether a
+    // vector exists — but the boot backfill has to tell "this row is broken"
+    // from "the provider was unreachable", and a bare null erases that
+    // distinction. Callers feature-detect this method and fall back to
+    // embedSingle() so older adapters keep working unchanged.
+    async embedSingleDetailed(text) {
+      const cfg = settings.getVectorConfig();
+      if (!configComplete(cfg)) return { vector: null, reason: "config-incomplete" };
+      const out = await embedTextDetailed(cfg, text);
+      if (out.vector) _dimension = out.vector.length;
+      return out;
+    },
+
     /** Model fingerprint (model#hex), or undefined when not configured. */
     get modelHash() {
       const cfg = settings.getVectorConfig();
@@ -284,7 +298,7 @@ export function createEmbedder({ store, settings, logger, vectorIndex }) {
      */
     async reindexMissing(limit = 50) {
       const cfg = settings.getVectorConfig();
-      if (!cfg?.enabled) return { indexed: 0, skipped: 0 };
+      if (!cfg?.enabled) return { indexed: 0, failed: 0, skipped: 0 };
       const model = modelHashOf(cfg.model);
       // Fall back to the plain selector for stores that predate the
       // provenance column (older hosts, test doubles).
@@ -292,17 +306,37 @@ export function createEmbedder({ store, settings, logger, vectorIndex }) {
         ? store.needsEmbeddingFor(model, limit)
         : store.needsEmbedding(limit);
       let indexed = 0;
+      let failed = 0;
       for (const row of rows) {
-        const text = [row.title, row.content].filter(Boolean).join("\n");
-        const vector = await embedText(cfg, text);
-        if (vector) {
-          store.setEmbedding(row.id, vector, model);
-          _dimension = vector.length;
-          indexed++;
+        try {
+          const text = [row.title, row.content].filter(Boolean).join("\n");
+          // Prefer the reason-preserving call for the same reason the boot
+          // backfill does: a bare null cannot tell "this row is unembeddable"
+          // from "the provider was unreachable", and the receipt ledger files
+          // both under one indistinguishable entry.
+          const detailed = typeof this.embedSingleDetailed === "function"
+            ? await this.embedSingleDetailed(text)
+            : null;
+          const vector = detailed ? detailed.vector : await embedText(cfg, text);
+          if (vector?.length) {
+            store.setEmbedding(row.id, vector, model);
+            _dimension = vector.length;
+            indexed++;
+          } else {
+            failed++;
+          }
+        } catch (error) {
+          // A throw used to abort the whole loop and surface as a rejected
+          // promise from the API route; one bad row must not stop the rest.
+          failed++;
+          logger?.warn?.(`[dsh-mneme] reindex embed failed for ${row.id}: ${String(error)}`);
         }
       }
       if (indexed > 0) markModel(cfg, _dimension || undefined);
-      return { indexed, skipped: rows.length - indexed };
+      // #604: `skipped: rows.length - indexed` folded "tried and got nothing"
+      // into "never touched". Every selected row is attempted here, so nothing
+      // is skipped; what failed is reported as failed.
+      return { indexed, failed, skipped: 0 };
     }
   };
 }

package/lib/entities/extractor.js

@@ -1,4 +1,9 @@
 const VALID_TYPES = new Set(["person", "project", "concept", "technology", "organization"]);
+// #619：affective_context **刻意不在**这张白名单里。它不是结构关系，是「某人
+// 在某一次场合对某事的情绪」——判它需要 provenance（这条记忆来自哪个会话），
+// 而实体抽取发生在写入当下、手里没有会话边界，判不了「一次场合」与「反复出现
+// 的特质」。让它在这里也能写，就等于给 entity_relations 开第二个只带 {model}
+// 的写入口，同一张表两种 schema。唯一的写入者是 sleep 的 affective 相位。
 const VALID_RELATIONS = new Set(["uses", "depends_on", "part_of", "related_to"]);
 const MAX_MEMORY_CHARS = 4000;
 
@@ -25,6 +30,8 @@ RULES:
 
 CONSTRAINTS:
 - "type" must be one of: person, project, concept, technology, organization. If unsure, use "concept".
+- Relation "type" must be one of: uses, depends_on, part_of, related_to. If unsure, use related_to.
+- Do NOT emit emotional or affective relations. An emotion belongs to one occasion and needs session provenance to judge it; that is recorded separately, not here.
 - "relations" from/to must reference entity names from the "entities" list.
 - Maximum ${maxEntities} entities. Maximum ${maxAttrs} attributes per entity. Truncate if exceeded.
 - Only include entity-related attributes. Ignore irrelevant miscellaneous details.
@@ -72,12 +79,19 @@ function sanitizeConfidence(conf) {
   return Math.min(1, Math.max(0, num));
 }
 
+// #619：未知关系类型**不再静默降级成 related_to**。旧行为是「写入成功、不报错、
+// 图上没有那条轴」——最难排查的一种失败：模型抽对了，库里却读不出它抽的是情感边
+// 还是普通关联。现在返回 null，由调用方丢弃并 logger.warn 带原始类型名。
+// 注意这与 sanitizeType（未知实体类型 → concept）刻意不同：实体类型是可容错的
+// 粗分类，关系类型是语义轴本身，猜错一条边就是给图加错误事实。
 function sanitizeRelationType(type) {
-  if (VALID_RELATIONS.has(type)) return type;
-  return "related_to";
+  if (typeof type !== "string") return null;
+  const normalized = type.trim();
+  if (VALID_RELATIONS.has(normalized)) return normalized;
+  return null;
 }
 
-function sanitizeExtractedData(data, config) {
+function sanitizeExtractedData(data, config, logger = null) {
   const maxEntities = config.entityExtractionMaxEntities ?? 10;
   const maxAttrs = config.entityExtractionMaxAttrs ?? 20;
   
@@ -115,19 +129,31 @@ function sanitizeExtractedData(data, config) {
   }
   
   const relations = [];
+  const rejectedRelationTypes = [];
   if (Array.isArray(data.relations)) {
     for (const rawRel of data.relations) {
       if (!rawRel || typeof rawRel.from !== "string" || typeof rawRel.to !== "string") continue;
       if (!seenNames.has(rawRel.from) || !seenNames.has(rawRel.to)) continue;
+      const relationType = sanitizeRelationType(rawRel.type);
+      if (!relationType) {
+        // #619：不再降级成 related_to——记下原始类型名，交给调用方 warn。
+        rejectedRelationTypes.push(String(rawRel.type));
+        continue;
+      }
       relations.push({
         from: rawRel.from,
         to: rawRel.to,
-        type: sanitizeRelationType(rawRel.type)
+        type: relationType
       });
     }
   }
-  
-  return { entities, relations };
+  if (rejectedRelationTypes.length > 0) {
+    logger?.warn?.(
+      `[extractor] dropped ${rejectedRelationTypes.length} relation(s) with unknown type(s): ${[...new Set(rejectedRelationTypes)].join(", ")}`
+    );
+  }
+
+  return { entities, relations, rejectedRelationTypes };
 }
 
 async function resolveEntity(entity, store) {
@@ -178,7 +204,7 @@ export async function extractEntities(memory, { store, config, callLLM, logger }
       return { ok: false, error: "Failed to parse JSON from LLM response" };
     }
     
-    const { entities, relations } = sanitizeExtractedData(rawData, config);
+    const { entities, relations, rejectedRelationTypes } = sanitizeExtractedData(rawData, config, logger);
     
     const resolvedEntities = [];
     const entityIdMap = new Map();
@@ -247,6 +273,9 @@ export async function extractEntities(memory, { store, config, callLLM, logger }
       entities: resolvedEntities,
       attrs,
       relations: savedRelations,
+      // #619：被丢弃的未知关系类型（含原始名字）。调用方据此判断「模型没抽」
+      // 与「抽了但类型不认识」——两者的运维动作完全不同。
+      rejectedRelationTypes,
       skipped: skipCount
     };
     

package/lib/hot-memory.js

@@ -1,4 +1,6 @@
 import { safeSlice } from "./safe-slice.js";
+// Issue #611：图片块改用占位文本，不再落进空串（见 roundsFromEvents 里的注释）。
+import { contentToText } from "./attachment-text.js";
 
 // Session-scoped hot memory (v0.5.0 召回率优化 1.3): a short-term buffer of
 // the latest dialogue rounds, kept strictly apart from the long-term memory
@@ -58,7 +60,19 @@ export function createHotMemory({ maxRounds = 5, maxTokens = 2000 } = {}) {
 // 配对规则与 inject.js 原实现一致：user/message（source.kind 缺省或 "user"）开启
 // 新一轮；下一条 assistant 起源的事件关闭该轮。tool/system 等携带正文的事件不得
 // 冒充模型回复；rewind 标记（source.kind = "dsh-rewind"）不是用户提问。
-export function roundsFromEvents(events, maxRounds, visibleSeqs = null) {
+//
+// omitPendingRound（Issue #637）：尾部 pending 轮是「正在组装的这一轮」——它的
+// 提问已经以真实 user message 出现在 prompt 里，热记忆再渲染一份只有空 `A:` 的
+// 行是纯冗余；更糟的是回答落地后这一行会从空 `A:` 抖成正文，而宿主对动态
+// systemPrompt context 的契约是「文本变了就追加一份快照」（旧份永久留在会话
+// 历史里），于是同一轮内注入块反复变体、旧快照越积越多（报告实测 4 轮 → 10 份
+// runtime-context、75% 重复率，其中记忆与设置两段是恒定的，抖动全来自热记忆）。
+// 只省略尾部这一条；循环中途被新 user/message 顶掉的历史 pending 是已被放弃的
+// 提问，渲染成空 `A:` 是既有语义，不动。注入侧传 true：一轮内块文本恒定，回答
+// 落地时块恰好变一次 = 每轮一份快照（该机制下的理论最小值）。默认 false = 既有
+// 行为逐字节不变——后台渲染与直调方（含既有测试锁的「已完成日志渲染」形状）
+// 照旧拿到 pending 轮。
+export function roundsFromEvents(events, maxRounds, visibleSeqs = null, { omitPendingRound = false } = {}) {
   const rounds = [];
   let pendingQuery = null;
   const textOf = (event) => {
@@ -73,15 +87,12 @@ export function roundsFromEvents(events, maxRounds, visibleSeqs = null) {
     // reasoning 里出现 Go template / Vue / Handlebars / 正则 / 日志原文的概率远高于
     // 正文，把它带进 hot memory 会让 `{{...}}` 模板片段注入 prompt。旧的扁平形状
     // （字符串 part）照旧取用，无 type 字段的兜底视为正文。
-    return parts
-      .map((p) => {
-        if (typeof p === "string") return p;
-        if (p?.type && p.type !== "text") return "";
-        return p?.text ?? "";
-      })
-      .filter(Boolean)
-      .join("\n")
-      .trim();
+    //
+    // Issue #611：图片 part 原先在这里也落进空串分支，于是「用户发了截图」这件事
+    // 在 hot memory 里完全消失。改走 attachment-text 的占位口径：`[图: 名称 宽x高]`。
+    // hot memory 每轮都进 prompt，占位刻意保持短——它不是描述，只是「这里有过一张
+    // 图」的坐标。
+    return contentToText(parts).trim();
   };
   for (const event of events) {
     // surface 投影：不在「模型可见面」上的事件（被 rewind 撤回、被 compact 替换）
@@ -103,6 +114,6 @@ export function roundsFromEvents(events, maxRounds, visibleSeqs = null) {
     rounds.push({ query: pendingQuery, response: safeSlice(body, 800) });
     pendingQuery = null;
   }
-  if (pendingQuery) rounds.push({ query: pendingQuery, response: "" });
+  if (pendingQuery && !omitPendingRound) rounds.push({ query: pendingQuery, response: "" });
   return rounds.slice(-maxRounds);
 }