@nightpainters/dsh-ling 1.5.1 → 1.5.2

package/lib/host/snapshot.js

@@ -8,6 +8,12 @@ import { selectL1, formatL1Section } from './l1.js';
 import { currentMode } from './mode.js';
 import { neutralizeMustache } from './util.js';
 
+// §4「超量折叠成一行」的那行计数(由 `memory.js` 的 branchLogDigest 在明细之后 push 进 `lines`)
+// —— 它是**汇总**,不是明细。零明细时它撑不起整段(见下方渲染判据);有明细时照旧显示。
+// 判据只用开头:明细行一律以主语(主人/器灵)或动作词开头,不会长成 `…另有 N 笔改动`。
+// 若哪天 memory.js 改了措辞,这里退化成"照旧渲染"(fail-open)—— 只影响占不占地方,不吞明细。
+const BRANCH_LOG_FOLD_LINE = /^…另有 \d+ 笔改动/;
+
 export function buildSnapshotText(ctx, memory, settings, sessionId, { keywords = [], now = Date.now(), bumpHits = false } = {}) {
   const s = settings.get();
   const personaEnabled = s.persona?.enabled !== false;
@@ -44,23 +50,52 @@ export function buildSnapshotText(ctx, memory, settings, sessionId, { keywords =
   // "树变了" —— 这是复盘时"互相纠正"能成立的前提(不需要推送:复盘对话密集,
   // 每说一句就注入一次 ⇒ 感知延迟只有一轮,体感即实时)。
   // 只报**没见过的**改动(水位 = branch_log 自增 id),否则每轮重复注入同一批。
+  // ── B3(1.5.2):水位从"一条按会话"变成**三条并存**,判定都在 `branchLogDigest` 里 ──
+  //   · `branch_log_wm.<sessionId>` 本会话已看到哪(照旧,B#9);
+  //   · `branch_log_wm.announced`   **全局**"已示人"边界 ⇒ 新会话不再重播已播过的(B3-1);
+  //   · `branch_log_wm.retired`     **全局**超窗"计数式处置"边界(§2 老改动只计数不展开)。
+  // 取数改成 FIFO(水位之上最早的一批),水位才可能停在未示人的内容之前(B3-2)。
   // B#9(2026-09-22 审计):**渲染不消费水位** —— 这里只读、不写。
   // buildSnapshotText 也会被"只重建、未开口"的路径调用(invalidateSession / refreshIdleSnapshot),
   // 在那里推进水位会把主人刚改的东西标记成已读,等到真正注入时反而看不到。
-  // 水位按**会话**存(`branch_log_wm.<sessionId>`),推进由 inject.js 在真正要开口时做。
+  // 推进由 inject.js 在真正要开口时做(它同时管 `.last` 与 §3 的开关)。
   let logMaxId = 0;
+  let logShownMaxId = 0;
+  let logRetiredMaxId = 0;
   try {
     if (typeof memory.branchLogDigest === 'function') {
       const wmk = 'branch_log_wm.' + String(sessionId || '');
       const prev = Number(memory.kvGet(wmk) || 0);
-      const d = memory.branchLogDigest({ limit: 5, afterId: prev });
-      if (d && Array.isArray(d.lines) && d.lines.length) {
+      // `now` 必须透传(B3):时间窗(§2)与水位推进要用**同一个时钟**,否则测试不可复现,
+      // 生产上也会出现"按渲染时刻算过期、按投递时刻推进"的错位。
+      const d = memory.branchLogDigest({ limit: 5, afterId: prev, now });
+      // 全表最大 id:与开关、与是否成文**都无关**。它是 `branch_log_wm.last`(复盘退出判据)
+      // 的输入 —— 关掉播报也不能让"欠交代"这笔账停摆(见 inject.advanceLogWatermark 注解)。
+      logMaxId = Number(d?.maxId) || 0;
+      // 真正示人的边界:只有真渲染了明细行时才非零。旧实现/打桩没有该字段 ⇒ 退回 maxId
+      // (兼容 mustache 套里 `{lines, maxId:9}` 那种形状)。
+      const shown = Number(d?.shownMaxId);
+      logShownMaxId = Number.isFinite(shown) ? Math.max(0, shown) : logMaxId;
+      logRetiredMaxId = Number(d?.retiredMaxId) || 0;
+      // ── 明细 0 条 ⇒ **整段不渲染**(主人拍板,2026-09-27)──────────────────────────
+      // 判据是"有没有**明细**行",不是"`lines` 非空":那行「…另有 N 笔改动」**也装在 `lines` 里**
+      // (memory.js:1190 附近在明细之后 push),所以只判 `lines.length` 时"零明细"照样成文 ——
+      // 注入面就只剩一行不放内容的计数(主人截图:395 笔改动、一条明细也没有)。
+      // 只改**渲染**:三个水位字段照旧原样返回(下方 return),`.last` / `announced` / `retired`
+      // 的推进与改前逐值相同 —— 不渲染 ≠ 把那批改动标成已读(它们仍在有效下界 `wm` 之上,
+      // 下一轮照样进候选;与 §3 开关"只管渲染、不管交代记账"同一取向)。
+      const logLines = Array.isArray(d?.lines) ? d.lines : [];
+      const logDetailLines = logLines.filter((x) => !BRANCH_LOG_FOLD_LINE.test(String(x)));
+      // §3 独立开关:只管**树改动播报**(总闸仍是 cordis 层的 cfg.injectEnabled)。
+      // 关掉时:不成文、也不推进"已示人/已处置"水位(否则关着关着就把一段内容标成已读 ⇒
+      // 再打开时那段内容永远看不到)。`.last` 照走 —— 它是复盘退出判据,不是"已示人"判据:
+      // **开关只管"渲染",不管"交代记账"**(停推进会卡死复盘模式的退出,回归见 tree 套 9-5)。
+      if (s.memory?.branchLogEnabled !== false && logDetailLines.length) {
         // A-03 / D-S03(1.5.1 红蓝对抗):段首此前**写死**「主人刚改动了记忆树」,而 schema v12 起
         // 每一行都已带主语(`branchLogDigest` 按 actor 分流成「主人」/「器灵」)⇒ 器灵经工具
         // 改的树,在它**下一轮的系统提示**里被读成"主人刚改动",与 tools.js 的设计意图正相反。
         // 段首改中性措辞,**主语交给每一行** —— 谁改的由行内说,不由段头替它说。
-        parts.push(['【记忆树有改动】', ...d.lines.map((x) => '- ' + x)].join('\n'));
-        logMaxId = Number(d.maxId) || 0;
+        parts.push(['【记忆树有改动】', ...logLines.map((x) => '- ' + x)].join('\n'));
       }
     }
   } catch { /* 感知失败不影响注入 */ }
@@ -71,8 +106,14 @@ export function buildSnapshotText(ctx, memory, settings, sessionId, { keywords =
   return {
     text,
     mode,
-    // B#9:本段文本渲染到了哪条 branch_log(inject.js 在真正注入时据此推进水位)
+    // B#9:本段文本渲染到了哪条 branch_log(inject.js 在真正注入时据此推进水位)。
+    // B3(1.5.2)拆成三个,别混用:
+    //   logMaxId       全表最大 id   ⇒ `.last`(复盘退出判据)
+    //   logShownMaxId  真正示人的边界 ⇒ 会话水位 + `announced`
+    //   logRetiredMaxId 超窗只计数的边界 ⇒ `retired`
     logMaxId,
+    logShownMaxId,
+    logRetiredMaxId,
     builtAt: new Date(now).toISOString(),
     personaVersion: snapshotVersion(s),
     memoryVersion: memory.kvGet('memory_version') || '0',
@@ -81,7 +122,7 @@ export function buildSnapshotText(ctx, memory, settings, sessionId, { keywords =
 
 export function snapshotVersion(s) {
   const p = s?.persona || {};
-  return [p.userTitle, p.aiName, p.aiTitle, p.tone, p.toneWork, p.toneLife, p.language, p.extraLore, p.enabled, JSON.stringify(p.hardRules), JSON.stringify(p.bottomLines), p.sealed, s?.mode?.lastMode]
+  return [p.userTitle, p.aiName, p.aiTitle, p.tone, p.toneWork, p.toneLife, p.language, p.extraLore, p.duty, p.enabled, JSON.stringify(p.hardRules), JSON.stringify(p.bottomLines), p.sealed, s?.mode?.lastMode]
     .join('|');
 }
 

package/lib/host/summarizer.js

@@ -1,6 +1,6 @@
 // dsh-ling host — DSH 会话概述器 v1(轻量)。
 // 把 dsh_turns_raw 中每个顶层会话聚合成 source='dsh' 的 conv_overview:
-//   title = 首条真人消息单行截断;summary = 首问摘要 + 轮次;类别/关键词启发式。
+//   title = 首条真人消息经启发式清洗后的要点句(剥问候/称呼前缀 → 无实义则往后取前 6 条真人发言里第一条有实义的 → 句读处收尾、不切半句、上限 58 字;全失败才硬截首句);summary = 首问(≤140 字)+ 轮次;类别/关键词启发式。
 // 增量:每会话水位 kv('sumdsh:<sid>') = 已概述的最大 seq;有新增才重建。
 // 无 LLM 深摘要(v1);原文保留在 dsh_turns_raw,供 M2 概述升级。
 import { categorizeTitle } from './classify.js';

package/lib/index.js

@@ -8,6 +8,7 @@ import { SettingsFile } from './host/settings-file.js';
 import { MemoryStore } from './host/memory.js';
 import { FreezeGate } from './host/freeze.js';
 import { registerMemorySection } from './host/inject.js';
+import { wireSessionLine } from './host/session-line.js';
 import { wireLifecycle } from './host/lifecycle.js';
 import { registerApi } from './host/api.js';
 import { summarizeDsh } from './host/summarizer.js';
@@ -56,6 +57,10 @@ export function apply(ctx, config = {}) {
 
   const disposers = [];
   disposers.push(registerMemorySection(ctx, gate, memory, settings));
+  // E0「那一行跟着会话走」:只加一个 agent/pre-step 监听(全库目前没有别处用它)。
+  // 形态 A —— 只往 `decision.messages` 追加,**不碰** systemPrompt 的 section()/context(),
+  // 也绝不调用带 surfaceOp 的 session.append。关掉开关:settings.memory.sessionProgressLine=false。
+  disposers.push(wireSessionLine(ctx, memory, settings, cfg.sessionLine || {}));
   disposers.push(wireLifecycle(ctx, gate, memory, settings, cfg));
   disposers.push(registerApi(ctx, { gate, memory, settings }, cfg));
   // E4 可取证访问日志:只挂两个全局钩子,core 侧补丁留的调用点见 lib/audit/patch-spec.js。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightpainters/dsh-ling",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "器灵 · 跑在你自己电脑上的记忆与人格助手插件:三层记忆、从历史里长出来的人格档案、定型锁与自由生长",
   "type": "module",
   "main": "./lib/index.js",
@@ -24,7 +24,7 @@
     "access": "public"
   },
   "scripts": {
-    "test": "node tests/unit.mjs && node tests/access-log.test.mjs && node tests/archive.test.mjs && node tests/autotree.test.mjs && node tests/backfill.test.mjs && node tests/branch.test.mjs && node tests/assistant.test.mjs && node tests/capture.test.mjs && node tests/clock.test.mjs && node tests/clock-skill.test.mjs && node tests/deep.test.mjs && node tests/dswebsum.test.mjs && node tests/export.test.mjs && node tests/feedback.test.mjs && node tests/forget-backfill.test.mjs && node tests/genesis.test.mjs && node tests/guard.test.mjs && node tests/habitgen.test.mjs && node tests/idle.test.mjs && node tests/importfile.test.mjs && node tests/importlog.test.mjs && node tests/l1lines.test.mjs && node tests/memories.test.mjs && node tests/mode.test.mjs && node tests/mustache.test.mjs && node tests/retitle.test.mjs && node tests/rules.test.mjs && node tests/suggest.test.mjs && node tests/summarize.test.mjs && node tests/times.test.mjs && node tests/tone.test.mjs && node tests/tools.test.mjs && node tests/tree.test.mjs && node tests/patch-spec.test.mjs",
+    "test": "node tests/unit.mjs && node tests/access-log.test.mjs && node tests/archive.test.mjs && node tests/autotree.test.mjs && node tests/backfill.test.mjs && node tests/branch.test.mjs && node tests/assistant.test.mjs && node tests/capture.test.mjs && node tests/clock.test.mjs && node tests/clock-skill.test.mjs && node tests/deep.test.mjs && node tests/dswebsum.test.mjs && node tests/duty.test.mjs && node tests/export.test.mjs && node tests/feedback.test.mjs && node tests/forget-backfill.test.mjs && node tests/genesis.test.mjs && node tests/guard.test.mjs && node tests/habitgen.test.mjs && node tests/idle.test.mjs && node tests/importfile.test.mjs && node tests/importlog.test.mjs && node tests/l1lines.test.mjs && node tests/memories.test.mjs && node tests/mode.test.mjs && node tests/mustache.test.mjs && node tests/retitle.test.mjs && node tests/rules.test.mjs && node tests/sessionline.test.mjs && node tests/suggest.test.mjs && node tests/summarize.test.mjs && node tests/times.test.mjs && node tests/tone.test.mjs && node tests/tools.test.mjs && node tests/tree.test.mjs && node tests/patch-spec.test.mjs",
     "check": "node tools/check-install.mjs",
     "check:publish": "node tools/check-publish.mjs"
   },
@@ -51,16 +51,63 @@
   "engines": {
     "node": ">=22.5.0"
   },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.4",
+    "@deepseek-ai/dsh-agent-default-model": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-skill": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.1.7-rc.2"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-agent-default-model": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-session-controller": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-store": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-host-webserver": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    }
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-store",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-slots",
         "@deepseek-ai/dsh-api-session-controller"
       ],
       "platform": "web"