dsh-compact-relay 0.3.6 → 0.4.1

package/lib/adapters/prompt.js

@@ -1,27 +1,74 @@
 /**
- * 模型入口（0.3.4）——「当前在可压缩区间」的动态提示。
+ * 模型入口（0.3.4 / 0.4 P0-1）——「当前可以记一个压缩节点」的动态提示。
  *
  * BUG-010：0.3.1 的 `mark_stage` 工具在 427 个真实会话里 0 次调用。根因不是模型
  * 不听话，而是工具描述承诺「系统会告诉你容量」但系统从没说过 —— 条件不可判断。
- * 现在宿主每轮把一条 runtime context 注入 system prompt，告诉模型当前容量落在
- * 可压缩区间；模型据此判断「刚完成一个自然节点」时该不该调 `mark_compress_point`。
+ * 0.3.4 起宿主每轮把一条 runtime context 注入 system prompt，告诉模型当前容量。
+ *
+ * 0.4 P0-1（Win 173 会话里 cue 注入 18 次、工具仍 0 调用）：
+ *  1. 文案 v2 与区间 v2 在 core/compress-cue.js（4 类完成信号 + 被拒零副作用）；
+ *  2. **注入门控**在本文件（方案 §3.2）：只有全部满足才注入——
+ *     a) 容量落在 cue 区间（10%–40%，且不越过压缩线，见 cueBandOf）；
+ *     b) 距上次注入 ≥ CUE_MIN_TURNS 轮（本轮按 text 回调调用次数计，纯内存不落盘）；
+ *     c) 一轮内最多一次（连续调用时 b 天然保证）；
+ *  3. 实际注入一次就 `deps.diag.bumpCueInjected()`（供 P0-2 诊断包看数），
+ *     只记次数、不记提示原文（隐私口径与 P0-2 一致）。
  *
  * 约束：
  *  - `systemPrompt.context` 的 text 回调必须是**同步**函数 → 只读
  *    `dsh/state-hub.js` 维护的内存缓存，不 await、不 measure；
  *  - 拿不到会话/缓存/阈值就返回空串（宿主不会展示空 context）；
- *  - 全程 try/catch：提示是锦上添花，任何异常都不能影响宿主组装 prompt。
+ *  - 全程 try/catch：提示是锦上添花，任何异常都不能影响宿主组装 prompt；
+ *  - 本文件（adapters）不 import lib/dsh/：计数走 deps.diag 既有注入。
  */
 import {
   COMPRESS_CUE_NAME,
   COMPRESS_CUE_ORDER,
   compressCueText,
+  cueBandOf,
 } from '../core/compress-cue.js';
-import { compressionMinRatio } from '../core/policy.js';
+import { CUE_MIN_TURNS, compressionMinRatio } from '../core/policy.js';
 
 /** 供测试/文档引用的 context 名称。 */
 export { COMPRESS_CUE_NAME };
 
+/**
+ * 每会话的注入节奏（进程内，不新增持久状态）：
+ *   calls             text 回调被调用次数（≈轮数）
+ *   lastInjectedCall  上次真正注入发生在第几次调用（null = 还没注入过）
+ *
+ * 进程内 Map 只服务宿主生命周期；上限 200 个会话，避免长期运行无限增长。
+ */
+const MAX_TRACKED_SESSIONS = 200;
+const cueTurns = new Map();
+
+/**
+ * 取（并前移）某会话的注入节奏计数。
+ * @param {string} sessionId
+ * @returns {{calls:number, lastInjectedCall:number|null}}
+ */
+function cueTurnOf(sessionId) {
+  let turn = cueTurns.get(sessionId);
+  if (turn === undefined) {
+    turn = { calls: 0, lastInjectedCall: null };
+    cueTurns.set(sessionId, turn);
+    if (cueTurns.size > MAX_TRACKED_SESSIONS) {
+      const oldest = cueTurns.keys().next().value;
+      cueTurns.delete(oldest);
+    }
+  }
+  turn.calls += 1;
+  return turn;
+}
+
+/**
+ * 测试用：清空注入节奏（相当于宿主重启）。生产路径不需要调用。
+ * @returns {void}
+ */
+export function resetCueTurns() {
+  cueTurns.clear();
+}
+
 /**
  * 计算某个 agent 本轮该显示的动态提示（同步、异常安全）。
  * @param {{context?:object, deps?:object, hub?:object}} input
@@ -42,14 +89,28 @@ export function compressCueFor({ context, deps, hub } = {}) {
     if (!Number.isFinite(thresholds.compactRatio)) return '';
     if (!Number.isFinite(cached.ratio) || !Number.isFinite(cached.window) || cached.window <= 0) return '';
 
-    // 最小线是「配置值 vs 动态下限（保留尾部 + 最小可压 token）/窗口」的较大者（纯函数）。
-    const minRatio = compressionMinRatio(thresholds, deps?.cfg?.retention, cached.window);
-    return compressCueText({
+    // 每次 text 回调（≈一轮）都计数：即使本轮不注入，也要推进轮次，限频才有意义。
+    const turn = cueTurnOf(sessionId);
+
+    // 门控 a：区间 = max(10%, 动态最小线) ≤ ratio < min(40%, 压缩线)。
+    const dynamicMinRatio = compressionMinRatio(thresholds, deps?.cfg?.retention, cached.window);
+    const band = cueBandOf({ compactRatio: thresholds.compactRatio, dynamicMinRatio });
+    if (!(cached.ratio >= band.minRatio && cached.ratio < band.maxRatio)) return '';
+
+    // 门控 b/c：距上次注入 ≥ CUE_MIN_TURNS 轮（同一轮内多次调用必然不足）。
+    if (turn.lastInjectedCall !== null && turn.calls - turn.lastInjectedCall < CUE_MIN_TURNS) return '';
+
+    const text = compressCueText({
       ratio: cached.ratio,
-      minRatio,
-      compactRatio: thresholds.compactRatio,
+      minRatio: band.minRatio,
+      maxRatio: band.maxRatio,
       compressHint: cached.compressHint ?? null,
     });
+    if (text === '') return '';
+
+    turn.lastInjectedCall = turn.calls;
+    deps?.diag?.bumpCueInjected?.();
+    return text;
   } catch {
     return '';
   }

package/lib/adapters/tool.js

@@ -8,6 +8,11 @@
  * 模型无法判断条件 → 427 个真实会话 0 次调用。0.3.4 起由宿主每轮注入可压缩区间
  * 提示（lib/adapters/prompt.js），工具描述只描述「它自己会做什么」：
  * 服务端工具会返回当前容量并复核区间，太低/到线都拒绝且不改历史。
+ *
+ * 0.4 P0-1（方案 §3.3）：Win 173 会话 cue 注入 18 次、工具 0 调用 → 描述 v2：
+ *  - 明确「用户和模型都可以调用」（不只是模型的自发动作）；
+ *  - 「被拒不需要致歉」：拒绝零副作用、不改历史、不需要重试或道歉（降低调用心理成本）；
+ *  - 给出典型调用时机；把「不需要每个小步骤都调用」弱化后挪到句尾，不再抢在条件前面。
  */
 import { markCompressHint } from '../actions/compress-hint.js';
 import engine from '../dsh/engine.js';
@@ -22,10 +27,10 @@ export function registerTool(ctx, deps) {
       name: 'mark_compress_point',
       description:
         '记录一个「压缩节点」：在指示灯环上标出「这里适合把前面的旧历史压成摘要」。' +
-        '在你刚完成一个明确的任务/阶段、并且认为之后可以安全地压缩旧历史继续往下做时调用。' +
-        '不确定当前是否合适时也可以调用：工具会返回当前上下文容量并做判断，' +
-        '容量太低（压缩不划算）或已经到压缩线（直接建议用户压缩即可）会被拒绝，拒绝不会改动任何历史。' +
-        '不需要每个小步骤都调用。每次判断只记一条，压缩或交接后旧记录自动失效。',
+        '用户和模型都可以调用；不确定时调用是安全的：工具会自己判断容量，太早或已到压缩线会拒绝，' +
+        '被拒不需要致歉、不会改动历史、也不影响会话，不需要重试。' +
+        '典型调用时机：阶段完成（功能已实现并验证 / 文档已交付 / 问题已定位并修复）、准备交接前、长任务中途确认可回退点。' +
+        '调用后工具会返回当前容量与判断结果；每次判断只记一条，压缩或交接后旧记录自动失效。小步骤不用调用。',
       parameters: {},
       output: {
         schema: { type: 'string' },