dsh-compact-relay 0.5.1 → 0.5.3

package/lib/dsh/model-task.js

@@ -5,8 +5,8 @@
  * 两个任务不是同一种产物（一个压成六段摘要、一个写九段交接单，校验/重试规则
  * 也不同），所以**不合并重试循环**；但下面四件事完全一样、以前各写一遍：
  *   1. 前置：会话存在性 → 解析 provider/model 路由 → 窗口预算预检 → 推理档位；
- *   2. cache 对齐参数：复用上次请求的 temperature/stop，但**绝不继承 reasoningEffort**
- *      （2026-10-19 真机坑：会话最后请求是 max 思考，摘要沿用 max → maxTokens 被思考吃光）；
+ *   2. cache 对齐参数：复用上次请求的 temperature/stop；reasoningEffort 由
+ *      prepareModelCall 显式决定（2026-10-27 起优先沿用主请求的档位，见下）；
  *   3. 单次流式调用 + finishProblem 归一（超限/工具调用/中断）；
  *   4. 成功结果的公共元信息（provider/model/maxTokens/attempts/usage）。
  *
@@ -14,7 +14,7 @@
  */
 import { actionError } from '../core/errors.js';
 import { assertBudget, callStream, reasoningEffortFor } from './llm-call.js';
-import { cacheControls, routeOf } from './route.js';
+import { cacheControls, cacheEffortOf, routeOf } from './route.js';
 import { finishProblem } from './stream.js';
 
 /**
@@ -33,7 +33,7 @@ import { finishProblem } from './stream.js';
  * @param {string} input.code 动作错误码
  * @param {string} input.noSessionMessage 会话不存在时的用户可见错误文案
  * @param {string} input.noTargetMessage 拿不到 provider/model 时的用户可见错误文案
- * @returns {Promise<{target:{provider:string, model:string}, reasoningEffort:'off'|undefined}>}
+ * @returns {Promise<{target:{provider:string, model:string}, reasoningEffort:string|undefined}>}
  */
 export async function prepareModelCall({
   ctx,
@@ -53,18 +53,22 @@ export async function prepareModelCall({
 
   // 架构 A2：调模型前先做窗口预算预检；超窗直接报 budget，不白等一次失败请求。
   await assertBudget({ ctx, target, inputTokens, maxTokens, label });
-  // P2-5：只有模型目录明确支持 off 才传；非推理/不支持 off 的模型交给 adapter 默认。
-  const reasoningEffort = await reasoningEffortFor(ctx, target);
+  // 2026-10-27 P1 取证：reasoningEffort 会切换 provider 的 thinking 开关，是缓存前缀的
+  // 断点。摘要/交接单回放的是主请求的前缀，所以默认**沿用主请求的档位**（cache 对齐）；
+  // 只有拿不到 header（无请求头 / 模型已切走）时，才退回旧策略：
+  // P2-5 的「模型目录支持 off 就 off」（省思考 token；这是从 P1 之前的行为，保留作兜底）。
+  const headerEffort = cacheEffortOf(session, target);
+  const reasoningEffort = headerEffort !== undefined ? headerEffort : await reasoningEffortFor(ctx, target);
 
   return { target, reasoningEffort };
 }
 
 /**
- * cache 对齐参数：复用上次请求的 temperature/stop，**不要继承 reasoningEffort**。
+ * cache 对齐参数：复用上次请求的 temperature/stop；reasoningEffort 不从这里拿。
  *
- * 2026-10-19 真机踩的坑：会话最后请求是 reasoningEffort=max，摘要调用沿用 max，
- * 思考 token 把 maxTokens(4096) 吃光 → finish=max-tokens → 「摘要在输出上限处被截断」。
- * 摘要/交接单本身都不需要长思考，是否固定 off 由模型能力决定（见 prepareModelCall）。
+ * reasoningEffort 由 prepareModelCall 决定（2026-10-27 起优先与主请求一致，保证缓存命中）。
+ * 2026-10-19 的旧坑（max 思考把 maxTokens 吃光）已由「summary/handoff.maxTokens 提到
+ * 16K + 保留截断重试」兜住，不再是「一律 off」的理由。
  *
  * @param {object} session
  * @param {{provider:string, model:string}} target

package/lib/dsh/relay.js

@@ -56,6 +56,9 @@ export function normalizeRelayRecord(data) {
     scheme: RECORD_SCHEMES.has(data.scheme) ? data.scheme : null,
     titleSeq: Number.isInteger(data.titleSeq) && data.titleSeq > 0 ? data.titleSeq : null,
     historyTitle: typeof data.historyTitle === 'string' && data.historyTitle.length > 0 ? data.historyTitle : null,
+    // 0.6：链根会话 id（收藏文件按链根定位）。老记录**不写这个键**，读侧回退 parentId——
+    // 条件展开保持旧记录读取形状不变（0.3 记录字节契约）。
+    ...(typeof data.rootId === 'string' && data.rootId.length > 0 ? { rootId: data.rootId } : {}),
   };
 }
 

package/lib/dsh/route.js

@@ -51,6 +51,25 @@ export function routeOf(ctx, session, agent) {
   return asRoute(agent?.options);
 }
 
+
+/**
+ * 复用「上一条真实请求」的推理档位（cache 对齐用）。
+ *
+ * 2026-10-27 P1 取证：摘要/交接单回放的是上一条主请求的前缀，但 reasoningEffort
+ * 会切换 provider 的 thinking 开关；一旦与主请求不同，缓存前缀会在第一条
+ * assistant 消息的渲染处断开（生产实测命中 2–5%，隔离 A/B：off 74.0% vs max 96.9%）。
+ * 所以只要 header 里的 provider/model 与本次目标一致，就原样沿用它的 reasoningEffort。
+ *
+ * @param {object} session
+ * @param {{provider: string, model: string}} target
+ * @returns {string|undefined}
+ */
+export function cacheEffortOf(session, target) {
+  const config = session?.requestHeader?.()?.config;
+  if (config === undefined || config.provider !== target.provider || config.model !== target.model) return undefined;
+  return typeof config.reasoningEffort === 'string' && config.reasoningEffort.length > 0 ? config.reasoningEffort : undefined;
+}
+
 /**
  * 复用上次真实请求的采样控制参数，让附带调用尽量贴近它的前缀缓存。
  * @param {object} session

package/lib/dsh/select-range.js

@@ -6,7 +6,6 @@
  * 工具调用必须配对（provider 的 toolPairingBalanced*）。
  */
 import { compactionPolicy } from '../core/policy.js';
-import { clipRangeByPins, latestPinnedSeqs } from '../core/pins.js';
 import { selectFullRange } from '../core/ranges.js';
 import { countSummaries, firstCompactableIdx, lastCheckpointSurfaceSeq, sessionLog } from './session-view.js';
 
@@ -33,7 +32,8 @@ export function selectCompactableRange({ session, nodes, engine, cfg, tokenOf })
 
   // M6：锁定的消息必须保留——范围里碰到就截到最早那条锁定消息之前；
   // 截空（锁定挡在最前面）就本次不压，由调用方提示 /unpin。
-  let range = clipRangeByPins(candidate, latestPinnedSeqs(sessionLog(session)));
+  // 0.6：pin 已退役（改「收藏」），不再按锁定消息截断选段；收藏不改变压缩范围。
+  let range = candidate;
   if (range === null) return null;
 
   // clip 缩短后终点可能落在 tool-call 中间（原来平衡的 candidate 被截断）：

package/lib/dsh/sessions.js

@@ -28,6 +28,7 @@ import {
   truncateTitleUtf8,
 } from '../core/relay.js';
 import { HANDOFF_PREAMBLE } from '../core/prompts.js';
+import { childRelayRecordOf } from '../core/relay-record.js';
 import { localIso } from './diag-counters.js';
 import { cacheControls, routeOf } from './route.js';
 import { relayRecordOf, writeRelayRecord } from './relay.js';
@@ -444,20 +445,26 @@ export async function createHandoffSession({ ctx, engine, session, agent, doc, t
   //    0.5.0 补：交接单已由调用方落盘，path 一并写进子记录 —— 接力条在子会话里直接
   //    拿到「查看交接单」的路径，父会话未加载/已归档时不再退化为「暂无交接单」。
   //    path 拿不到（旧调用方/失败）就不写这个键，不猜、不写空串。
+  //    0.5.2 S2：record 形状（含键顺序、不写父会话侧字段、条件 path）由
+  //    core/relay-record 的唯一构造器负责，这里只传语义参数。
   const titlePlan = plan ?? handoffTitlePlanOf(ctx, session);
   const relayAt = Date.now();
-  const relayWrote = writeRelayRecord(engine, childSession, {
-    parentId: session.id,
-    childId,
-    ordinal: titlePlan.index,
-    baseTitle: titlePlan.baseTitle,
-    title,
-    scheme: titlePlan.scheme,
-    titleSeq,
-    ...(typeof path === 'string' && path.length > 0 ? { path } : {}),
-    at: relayAt,
-    atIso: localIso(new Date(relayAt)),
-  });
+  const relayWrote = writeRelayRecord(
+    engine,
+    childSession,
+    childRelayRecordOf({
+      parentId: session.id,
+      childId,
+      ordinal: titlePlan.index,
+      baseTitle: titlePlan.baseTitle,
+      title,
+      scheme: titlePlan.scheme,
+      titleSeq,
+      path,
+      at: relayAt,
+      atIso: localIso(new Date(relayAt)),
+    }),
+  );
   if (!relayWrote) {
     log?.warn?.(`compact-relay: 新会话 ${childId} 接力链记录写入失败（下次从该会话交接将回退到标题解析）`);
   }

package/lib/index.js

@@ -16,6 +16,7 @@ import { createDiagCounters } from './dsh/diag-counters.js';
 import engine from './dsh/engine.js';
 import { createLedgerStore } from './dsh/ledger.js';
 import { createStateHub } from './dsh/state-hub.js';
+import { createFavoriteWatcher } from './dsh/favorite-watch.js';
 
 export const name = 'compact-relay';
 
@@ -74,8 +75,18 @@ export function apply(ctx, config) {
   // A9：readState 由这里注入，dsh 层不反向依赖 actions 层。
   const hub = createStateHub({ readState: (sessionId) => readState(deps, { sessionId }) });
   deps.hub = hub;
-  ctx.on('session/event', (session, event) => hub.onSessionEvent(session, event));
-  ctx.effect(() => () => hub.close(), 'compact-relay: state hub');
+  // 0.5.3 P1-6：推荐收藏——助手消息落地后异步打分，结果只进 readState 投影（绝不自动收藏）。
+  const favoriteWatch = createFavoriteWatcher(deps);
+  favoriteWatch.setHub(hub);
+  deps.favoriteWatch = favoriteWatch;
+  ctx.on('session/event', (session, event) => {
+    hub.onSessionEvent(session, event);
+    favoriteWatch.onEvent(session, event);
+  });
+  ctx.effect(() => () => {
+    favoriteWatch.close();
+    hub.close();
+  }, 'compact-relay: state hub + favorite watcher');
 
   // 0.3.4（BUG-010）：给模型一条「当前在可压缩区间」的动态 system-prompt 提示，
   // 让「这里适合压缩」从不可判断变成可判断。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-compact-relay",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "DeepSeek Harness 上下文指示器插件：提供容量监控、压缩预览与确认、九段式交接单生成及消息锁定功能。 · Context indicator for DSH: preview-then-confirm compaction, 9-section session handoff, and pinned messages.",
   "type": "module",
   "main": "lib/index.js",
@@ -53,7 +53,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "test": "node scripts/build-client.mjs --check && node --check lib/client.js && node test/smoke.mjs && node test/handoff.mjs && node test/plugin-load.mjs && node test/contract.mjs && node test/compact-log.mjs && node test/compress-cue.mjs && node test/state-passive.mjs && node test/native-compaction.mjs && node test/markdown-lite.mjs && node test/clip.mjs && node test/diagnostics.mjs && node test/pin-contract.mjs && node test/ledger.mjs && node test/handoff-p2.mjs && node test/relay-title-scheme.mjs && node test/relay-chain.mjs && node test/relay-chain-endpoint.mjs && node test/handoff-naming.mjs && node test/native-line.mjs && node test/handoff-guard.mjs && node test/settings-ux.mjs && node test/pin-health.mjs && node test/archive.mjs && node test/relay-bar.mjs",
+    "test": "node scripts/build-client.mjs --check && node --check lib/client.js && node test/smoke.mjs && node test/handoff.mjs && node test/plugin-load.mjs && node test/contract.mjs && node test/compact-log.mjs && node test/compress-cue.mjs && node test/state-passive.mjs && node test/native-compaction.mjs && node test/markdown-lite.mjs && node test/clip.mjs && node test/diagnostics.mjs && node test/pin-contract.mjs && node test/favorite.mjs && node test/favorites-unit.mjs && node test/favorite-suggest.mjs && node test/favorite-preview.mjs && node test/ledger.mjs && node test/handoff-p2.mjs && node test/relay-title-scheme.mjs && node test/relay-chain.mjs && node test/relay-chain-endpoint.mjs && node test/handoff-naming.mjs && node test/native-line.mjs && node test/handoff-guard.mjs && node test/settings-ux.mjs && node test/pin-health.mjs && node test/archive.mjs && node test/force-archive.mjs && node test/relay-bar.mjs && node test/relay-record.mjs && node test/contract-golden.mjs",
     "test:e2e": "node test/e2e/smoke.mjs",
     "test:e2e:settings": "node test/e2e/settings-ui.mjs",
     "test:e2e:settings-ux": "node test/e2e/settings-ux.mjs",