dsh-compaction-tower 0.0.0-stage → 0.1.39

package/lib/core.js

@@ -0,0 +1,268 @@
+/**
+ * 会话日志与块记录的底层读取。
+ *
+ * 这里不持有任何状态：一切从 session 的事件日志现算。
+ * 块记录（plugin:tower/block）是唯一的账本，重启后从日志重建。
+ */
+import { appendPluginRecord, pluginRecordOf } from '@deepseek-ai/dsh-session';
+import { isCompactCheckpointSource } from '@deepseek-ai/dsh-compaction';
+
+export { pluginRecordOf };
+
+/** 块记录的事件类型（宿主语法：plugin: + 全小写分段）。 */
+export const BLOCK_RECORD_TYPE = 'plugin:tower/block';
+
+/** 提交记录的事件类型：块号 ↔ 它换进表层的那个 checkpoint 节点。 */
+export const COMMIT_RECORD_TYPE = 'plugin:tower/commit';
+
+/**
+ * 所有 step/start 的 seq（升序）—— 用来划「保护最近 N 步」的边界。
+ *
+ * step = 一次模型请求。用户发一句话到 agent 收工是一个 turn，中间可能有很多 step；
+ * 保护窗口按 step 算才有意义（10 个用户轮次会把整段对话都圈进去）。
+ *
+ * @param {object} session
+ * @returns {number[]}
+ */
+export function stepStartSeqs(session) {
+  const seqs = [];
+  for (const event of iterateEvents(session)) {
+    if (event.type === 'step/start') seqs.push(event.seq);
+  }
+  return seqs;
+}
+
+/**
+ * 列出所有**已闭合**的 step 区间（step/start … step/end）。
+ *
+ * 一次扫描拿全部区间，避免对每条候选消息都重扫一遍事件（块覆盖上百条时是 O(n·m)）。
+ *
+ * @param {object} session
+ * @returns {Array<{start: number, end: number}>} 按 seq 升序
+ */
+export function stepSpans(session) {
+  const spans = [];
+  let start = null;
+  for (const event of iterateEvents(session)) {
+    if (event.type === 'step/start') start = event.seq;
+    else if (event.type === 'step/end' && start !== null) {
+      spans.push({ start, end: event.seq });
+      start = null;
+    }
+  }
+  return spans;
+}
+
+/**
+ * 找 seq 所在 step 的闭合边界（step/end 的 seq）。
+ *
+ * 宿主的 `compactRegion` 要求区间**按 step 对齐**：end 必须是某个已闭合 step 的最后一条
+ * 消息，否则会抛 `not a balanced boundary (would split a step, or the step is still open)`。
+ * 块是按消息切的，边界天然可能落在 step 中间，所以提交前要用这里对齐。
+ *
+ * @param {object} session
+ * @param {number} seq
+ * @returns {number|null} 该 step 的 step/end seq；step 还没闭合（或找不到）时返回 null
+ */
+export function closedStepEnd(session, seq) {
+  let start = null;
+  for (const event of iterateEvents(session)) {
+    if (event.type === 'step/start') {
+      start = event.seq;
+      continue;
+    }
+    if (event.type !== 'step/end') continue;
+    if (start !== null && seq >= start && seq <= event.seq) return event.seq;
+    start = null;
+  }
+  return null;
+}
+
+/**
+ * 按 seq 顺序遍历全部事件。
+ * 宿主没有暴露事件数组，seq 连续且不复用，所以用 eventAt 逐号取到 undefined 为止。
+ * @param {object} session
+ * @returns {Iterable<object>}
+ */
+export function* iterateEvents(session) {
+  for (let seq = 0; ; seq += 1) {
+    const event = session.eventAt(seq);
+    if (event === undefined) return;
+    yield event;
+  }
+}
+
+/**
+ * 读出全部块记录，按写入顺序（= 块号顺序）。
+ * @param {object} session
+ * @returns {Array<object>} 每项带 recordSeq（记录事件自己的 seq）
+ */
+export function readBlocks(session) {
+  const blocks = [];
+  for (const event of iterateEvents(session)) {
+    const record = pluginRecordOf(event);
+    if (record === undefined || record.type !== BLOCK_RECORD_TYPE) continue;
+    const data = record.data;
+    if (typeof data?.blockId !== 'string' || !Array.isArray(data.covers)) continue;
+    blocks.push({ ...data, recordSeq: event.seq });
+  }
+  return blocks;
+}
+
+/**
+ * 分配下一个块号。块号只增不减，删除记录也不会回填。
+ * @param {Array<object>} blocks 现有记录
+ * @returns {string} 形如 b00007
+ */
+export function nextBlockId(blocks) {
+  let max = 0;
+  for (const block of blocks) {
+    const match = /^b(\d+)$/.exec(block.blockId);
+    if (match !== null) max = Math.max(max, Number(match[1]));
+  }
+  return `b${String(max + 1).padStart(5, '0')}`;
+}
+
+/**
+ * 写入一个块记录。仅日志，不进表层——模型看不见。
+ * @param {object} session
+ * @param {object} data 无损 JSON
+ * @returns {object} 追加的事件
+ */
+export function appendBlock(session, data) {
+  return appendPluginRecord(session, BLOCK_RECORD_TYPE, data);
+}
+
+/**
+ * 读出全部提交记录，按写入顺序。
+ * @param {object} session
+ * @returns {Array<{blockId: string, checkpointSeq: number, compactionId?: string}>}
+ */
+export function readCommits(session) {
+  const commits = [];
+  for (const event of iterateEvents(session)) {
+    const record = pluginRecordOf(event);
+    if (record === undefined || record.type !== COMMIT_RECORD_TYPE) continue;
+    const data = record.data;
+    if (typeof data?.blockId !== 'string' || !Number.isInteger(data.checkpointSeq)) continue;
+    commits.push({ ...data, recordSeq: event.seq });
+  }
+  return commits;
+}
+
+/**
+ * 写入一条提交记录：块号 ↔ 它换进来的 checkpoint 节点。
+ *
+ * 这是块身份的**唯一权威来源**。不能靠 checkpoint 正文里的块头反推：格式一改，
+ * 历史块就全部失联，库存会重新把它们算成待命，塔又停摆。
+ * @param {object} session
+ * @param {{blockId: string, checkpointSeq: number, compactionId?: string}} data
+ * @returns {object} 追加的事件
+ */
+export function appendCommit(session, data) {
+  return appendPluginRecord(session, COMMIT_RECORD_TYPE, data);
+}
+
+/**
+ * 表层上每个 checkpoint 节点的「块号 → 该节点 seq」。
+ *
+ * 两个来源，权威优先：
+ *   1. 提交记录（plugin:tower/commit）—— 提交成功时当场写，与正文格式无关；
+ *   2. 正文里的块头 `[b00007 · T2 · …]` —— 只给没有提交记录的老会话兜底。
+ *      这条必须校验 source（`compact-checkpoint`），否则普通 user 消息里出现
+ *      同形字面量（例如让模型去读插件源码）就会被误认成 checkpoint。
+ * @param {object} session
+ * @returns {Map<string, number>}
+ */
+export function checkpointIndex(session) {
+  const surface = new Set(session.surface.nodes);
+  const index = new Map();
+  for (const commit of readCommits(session)) {
+    if (surface.has(commit.checkpointSeq)) index.set(commit.blockId, commit.checkpointSeq);
+  }
+  const claimed = new Set(index.values());
+  for (const seq of session.surface.nodes) {
+    if (claimed.has(seq)) continue;
+    const event = session.eventAt(seq);
+    if (event?.type !== 'user/message') continue;
+    const source = event.data?.source;
+    if (source === undefined || !isCompactCheckpointSource(source)) continue;
+    const text = (event.data?.content ?? [])
+      .filter((part) => part.type === 'text')
+      .map((part) => part.text)
+      .join('\n');
+    const match = /\[(b\d{5}) · T\d+/u.exec(text);
+    if (match !== null && !index.has(match[1])) index.set(match[1], seq);
+  }
+  return index;
+}
+
+/**
+ * 反向索引：checkpoint 节点 seq → 块号。
+ * 合并任务按位置找成员，需要这个方向；与 checkpointIndex 同源。
+ * @param {object} session
+ * @returns {Map<number, string>}
+ */
+export function checkpointOwner(session) {
+  const owner = new Map();
+  for (const [blockId, seq] of checkpointIndex(session)) owner.set(seq, blockId);
+  return owner;
+}
+
+/** 把 seq 渲染成模型可见引用。 */
+export function refOf(seq) {
+  return `m${String(seq).padStart(5, '0')}`;
+}
+
+/** 由 m00042 反解 seq；无法解析返回 undefined。 */
+export function seqOfRef(ref) {
+  const match = /^m(\d+)$/.exec(String(ref).trim());
+  return match === null ? undefined : Number(match[1]);
+}
+
+/** 8400 → "8.4K"。 */
+export function formatTokens(tokens) {
+  if (!Number.isFinite(tokens) || tokens < 0) return '0';
+  if (tokens < 1000) return String(Math.round(tokens));
+  if (tokens < 1_000_000) return `${(tokens / 1000).toFixed(1)}K`;
+  return `${(tokens / 1_000_000).toFixed(1)}M`;
+}
+
+/**
+ * 摘要消息的头部。这是模型唯一能看到的块元信息。
+ *
+ * T1（成员全是原文消息）给首尾引用；T2+（成员含下层块，seq 会乱序）不给自己区。
+ * @param {object} params
+ * @returns {string} 单行头部
+ */
+export function blockHeader({ blockId, tier, covers, coveredTokens, childBlockIds }) {
+  const count = `${covers.length} 条`;
+  const cost = `原 ${formatTokens(coveredTokens)} tok`;
+  if (tier === 1) {
+    const first = refOf(covers[0]);
+    const last = refOf(covers[covers.length - 1]);
+    return `[${blockId} · T1 · ${count} · ${first}…${last} · ${cost}]`;
+  }
+  const inner = childBlockIds.length > 0 ? `${childBlockIds.length} 个 T${tier - 1} 块` : '下层块';
+  return `[${blockId} · T${tier} · ${count}（含 ${inner}）· ${cost}]`;
+}
+
+/** 摘录一条消息的文本，用于搜索命中行与解压预览。 */
+export function describeMessage(message, maxChars = 200) {
+  const parts = [];
+  for (const block of message.content ?? []) {
+    if (block.type === 'text') parts.push(block.text);
+    else if (block.type === 'tool-call') parts.push(`→ ${block.name}(${JSON.stringify(block.arguments ?? {})})`);
+    else if (block.type === 'image') parts.push('[image]');
+  }
+  const text = parts.join(' ').replace(/\s+/g, ' ').trim();
+  return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+}
+
+/** 消息的角色标签，用于 [user] / [bash] 这种前缀。 */
+export function roleLabel(event, message) {
+  if (event.type === 'tool/result') return message.source?.toolName ?? 'tool';
+  if (event.type === 'assistant/message') return 'assistant';
+  if (event.type === 'system/message') return 'system';
+  return message.role ?? 'user';
+}

package/lib/engine.js

@@ -0,0 +1,66 @@
+/**
+ * 引擎补丁。
+ *
+ * DSH 的压缩后端 `dsh-compaction-basic` 挂在每个 preset 的隔离组里，
+ * profile 的 patch 层按 id 打不到那些嵌套行（buildMap 只递归 group + 数组 config）。
+ * 但它把两个扩展点挂在 `this` 上动态派发：
+ *
+ *   - `compactIfNeeded(agent, trigger, signal)` —— 什么时候压、压哪一段；
+ *   - `summarize(input, agent, signal)`         —— 摘要从哪来。
+ *
+ * 两个方法都在调用点重新读 `this.xxx`（见 regionDependencies 的
+ * `summarize: (input, owner, abort) => this.summarize(...)`），
+ * 所以换原型方法等于换掉全部隔离实例的行为，且不需要动 preset。
+ */
+import BasicCompactionEngine from '@deepseek-ai/dsh-compaction-basic';
+
+/** 幂等标记：同一进程内重复加载不会叠加补丁。 */
+const PATCHED = Symbol.for('dsh-compaction-tower.patched');
+
+/**
+ * 补丁当前指向的实例。
+ *
+ * 不能直接闭包捕获 `tower`：重新安装插件时 cordis 会重建插件模块，新实例换掉旧实例，
+ * 而原型上的补丁还在（`PATCHED` 标记挡住重复安装）。闭包捕获的话，补丁会永远捏着
+ * 旧实例 —— 旧实例照常收调用、往自己的 WeakMap 里写，界面读的却是新实例，表现就是
+ * 「内容越线了却没有任何判定」「观察者说拿不到压缩引擎」。
+ */
+let current = null;
+
+/**
+ * 安装补丁。
+ * @param {object} tower Tower 实例（提供 compactIfNeeded / serveSummary）
+ * @returns {'patched'|'already'|'unavailable'}
+ */
+export function installEnginePatches(tower) {
+  const proto = BasicCompactionEngine?.prototype;
+  if (proto === undefined) return 'unavailable';
+  if (typeof proto.compactIfNeeded !== 'function' || typeof proto.summarize !== 'function') return 'unavailable';
+  if (proto[PATCHED] === true) {
+    // 已经打过补丁：只把引用换成新实例，方法体不动。
+    current = tower;
+    return 'already';
+  }
+
+  const originalSummarize = proto.summarize;
+
+  proto.compactIfNeeded = function patchedCompactIfNeeded(agent, trigger, signal) {
+    // 顺手记下「这个 agent 用的引擎实例」：某些组合（web）从 agent.ctx 取不到它。
+    current?.rememberEngine?.(agent, this);
+    // 不传原方法：塔不交回宿主，溢出也一样（见 Tower.compactIfNeeded）。
+    return current.compactIfNeeded(this, agent, trigger, signal);
+  };
+  proto.summarize = function patchedSummarize(input, agent, signal) {
+    current?.rememberEngine?.(agent, this);
+    return current.serveSummary(this, originalSummarize, input, agent, signal);
+  };
+
+  Object.defineProperty(proto, PATCHED, { value: true, configurable: true });
+  current = tower;
+  return 'patched';
+}
+
+/** 补丁是否已经装上（供诊断）。 */
+export function enginePatched() {
+  return BasicCompactionEngine?.prototype?.[PATCHED] === true;
+}

package/lib/index.js

@@ -0,0 +1,101 @@
+/**
+ * DSH Tower：分层压缩后端。
+ *
+ * 三件事：
+ *   1. 补丁 dsh-compaction-basic 的两个扩展点（见 engine.js）；
+ *   2. 回合结束后台蒸馏（观察者）；
+ *   3. 注册 decompress / search_context 两个只读工具。
+ *
+ * 模型不参与压缩决策：没有 compress 工具，也没有提示它去压缩。
+ *
+ * 配置有三个来源，优先级从高到低：界面写入的覆盖层
+ * （`<DSH_HOME>/storages/compaction-tower/config.json`）→ profile 条目里的
+ * `config:`（cordis.patch.yml）→ DEFAULTS。见 config-store.js。
+ */
+import { Config } from './config.js';
+import { ConfigStore } from './config-store.js';
+import { enginePatched, installEnginePatches } from './engine.js';
+import { registerTools } from './tools.js';
+import { Tower } from './tower.js';
+
+export const name = 'compaction-tower';
+
+/** 没有这四样就什么都做不了：工具注册表、token 尺子、模型信息、会话落盘。 */
+export const inject = ['tools', 'tokenMeter', 'llm', 'sessions'];
+
+export { Config };
+
+/**
+ * 装载插件。
+ * @param {object} ctx 宿主 context
+ * @param {object} config 宿主传入的配置（profile 条目里写的那份）
+ */
+export function apply(ctx, config) {
+  const store = new ConfigStore(config ?? {});
+  const tower = new Tower(ctx, store.config);
+
+  // 界面保存后立刻换值：Tower 所有读配置的地方都走 this.config，无需重启。
+  store.onChange = (next) => {
+    tower.updateConfig(next);
+    if (process.env.TOWER_DEBUG === '1') console.error('tower[debug]: 配置已更新并生效');
+  };
+  if (store.loadProblem !== undefined) ctx.logger?.warn(`tower: ${store.loadProblem}`);
+
+  const patch = installEnginePatches(tower);
+  if (patch === 'unavailable') {
+    ctx.logger?.warn('tower: dsh-compaction-basic 没有暴露 compactIfNeeded/summarize，跳过引擎补丁；压缩将完全交给宿主');
+  } else if (patch === 'patched') {
+    ctx.logger?.info('tower: 已接管 compaction-basic 的触发与摘要扩展点');
+  }
+
+  ctx.effect(function* registerTowerTools() {
+    const dispose = registerTools(ctx, tower);
+    yield () => dispose?.();
+  }, 'compaction-tower tools');
+
+  // 请求前：补一批观察（分层库存算法见 select.js 的 planObservation）。
+  //
+  // 这里**不等**它：发起即返回，块写进内存后由这次请求前后的持久化检查点落盘。
+  // 所以它不会拖慢请求，只是让「下一次越线时手里有货」。
+  ctx.on('agent/pre-step', ({ agent, signal, turn }, next) => {
+    void tower.pump(agent, signal, turn, { wait: false });
+    return next();
+  });
+
+  ctx.on('agent/turn-stopping', (payload) => {
+    if (process.env.TOWER_DEBUG === '1') {
+      console.error(`tower[debug]: turn-stopping fired, keys=${Object.keys(payload ?? {}).join(',')}, hasAgent=${Boolean(payload?.agent)}`);
+    }
+    // 故意返回 promise：宿主会等它再把回合关掉。回合结束立刻关会话，
+    // 不等的话后台写进来的块落不了盘（详见 tower.js 的 observe）。
+    return tower.observe(payload?.agent, payload?.turn, payload?.signal);
+  });
+
+  // Web 界面要用的状态与配置路由：只有 web 组合里有 webServer，其余 profile 整块不跑。
+  ctx.plugin({
+    name: 'compaction-tower-routes',
+    inject: ['webServer', 'sessions', 'agents', 'llm'],
+    async apply(webCtx) {
+      if (process.env.TOWER_DEBUG === '1') console.error('tower[debug]: routes 子插件已激活');
+      const { registerTowerRoutes } = await import('./server.js');
+      webCtx.effect(function* registerRoutes() {
+        let dispose;
+        try {
+          dispose = registerTowerRoutes(webCtx, { tower, store });
+        } catch (error) {
+          console.error(`tower: 注册 Web 路由失败：${error?.message ?? error}`);
+          return;
+        }
+        if (process.env.TOWER_DEBUG === '1') {
+          console.error('tower[debug]: 已注册 /tower/state、/tower/action、/tower/config');
+        }
+        yield () => dispose?.();
+      }, 'compaction-tower routes');
+    },
+  });
+
+  return tower;
+}
+
+/** 诊断用：补丁状态。 */
+export { enginePatched };

package/lib/prompts.js

@@ -0,0 +1,124 @@
+/**
+ * 观察者的提示词。
+ *
+ * 三档：留空或选 host = 不接管，交给宿主的 `summarize` 用它自己的常量；
+ * zh = 同一副骨架的中文版；custom = 用户自己写。
+ */
+
+/**
+ * 宿主 `COMPACTION_INSTRUCTION` 的**展示副本**。
+ *
+ * 宿主的指令是包内常量、没有导出，插件拿不到正文；而界面上「选了宿主档就要能看见
+ * 它写了什么」是要的。所以这里抄一份**只供展示**。真正执行时仍然是宿主的 summarize
+ * 用它自己的常量 —— 这份副本即使落后于宿主版本，也只影响面板上显示的文字，
+ * 不影响压缩结果。
+ */
+export const SUMMARY_PROMPT_HOST_DISPLAY = [
+  'You are now acting as a compaction engine for this AI coding assistant. Condense the conversation ABOVE into a structured checkpoint that lets another model resume the work with no loss of essential context.',
+  '',
+  'Output EXACTLY the Markdown structure below: keep every section, in order. Use terse bullets, not prose paragraphs. Write "(none)" for an empty section — never drop a section.',
+  '',
+  '## Primary Request and Intent',
+  "- [the user's original and evolving goals; quote verbatim where the exact wording matters]",
+  '',
+  '## Key Technical Concepts',
+  '- [technologies, frameworks, patterns, and conventions in play]',
+  '',
+  '## Files and Code',
+  '- [exact path: why it matters, key changes or snippets]',
+  '',
+  '## Errors and Fixes',
+  '- [error: how it was resolved, plus any related user feedback]',
+  '',
+  '## Pending Jobs',
+  '- [explicitly requested work not yet completed]',
+  '',
+  '## Current Work',
+  '- [precisely what was in progress at this checkpoint]',
+  '',
+  '## Next Step',
+  '- [the single next action, directly in line with the most recent request, or "(none)"]',
+  '',
+  '## Critical Context',
+  '- [decisions and their rationale, constraints, user preferences, open questions, data needed to continue]',
+  '',
+  'Rules:',
+  '- Write concise English engineering prose. Preserve exact file paths, commands, error strings, identifiers, numeric values, function signatures, and syntax fragments.',
+  '- Capture user feedback and explicit instructions faithfully, especially corrections.',
+  '- Do NOT mention this summarization request or that the context was compacted.',
+  '- Output only the checkpoint text: do not call any tool or take any other action.',
+  '- If the conversation already contains a <compacted-summary> block, it is a PRIOR checkpoint. Do not copy it forward verbatim: preserve still-true facts, drop stale ones, and merge newer information into a single consolidated summary under the same structure.',
+].join('\n');
+
+/**
+ * 观察者的中文预设。
+ *
+ * 骨架与宿主 `COMPACTION_INSTRUCTION` 逐节对应（8 个英文小节标题一字不改），
+ * 只把「用简洁英文写」换成「用简洁中文写」。不是另起炉灶：小节结构是「另一个模型
+ * 能立刻接手」的保证，改骨架等于改协议。
+ */
+export const SUMMARY_PROMPT_ZH = [
+  '你现在充当这个 AI 编码助手的压缩引擎。把上面的对话浓缩成一份结构化检查点，让另一个模型能在不丢失关键上下文的前提下接手这项工作。',
+  '',
+  '严格按下面的 Markdown 结构输出：保留每一节、保持顺序。使用简短的项目符号，不要写成段落。某一节为空就写 "(none)" —— 任何一节都不许删。',
+  '',
+  '## Primary Request and Intent',
+  '- [用户最初的目标与不断演变的目标；措辞本身重要时逐字引用]',
+  '',
+  '## Key Technical Concepts',
+  '- [涉及的技术、框架、模式与约定]',
+  '',
+  '## Files and Code',
+  '- [精确路径：为什么重要、关键改动或代码片段]',
+  '',
+  '## Errors and Fixes',
+  '- [错误：如何解决，以及相关的用户反馈]',
+  '',
+  '## Pending Jobs',
+  '- [明确要求但尚未完成的工作]',
+  '',
+  '## Current Work',
+  '- [到这一刻为止，正在做的事情到底是什么]',
+  '',
+  '## Next Step',
+  '- [唯一的下一个动作，必须直接对齐最近一次请求；没有就写 "(none)"]',
+  '',
+  '## Critical Context',
+  '- [决定及其理由、约束、用户偏好、未解的问题、继续推进所需的数据]',
+  '',
+  '规则：',
+  '- 用简洁的中文技术叙述来写；上面 8 个小节标题保持英文原样，不要翻译或改写。',
+  '- 精确保留文件路径、命令、错误原文、标识符、数值、函数签名与语法片段。',
+  '- 忠实记录用户的反馈与明确指令，尤其是纠正。',
+  '- 不要提及这次摘要请求，也不要提到上下文被压缩过。',
+  '- 只输出检查点文本：不要调用任何工具，也不要做别的动作。',
+  '- 如果对话里已经存在 <compacted-summary> 块，那是之前的检查点：不要原样照抄，保留仍然成立的事实、丢掉过期的，把新信息并进同一结构下的一份合并摘要。',
+].join('\n');
+
+/** 观察者提示词三档：留空/宿主 = 用宿主英文原文，zh = 中文预设，custom = 自己写。 */
+export const SUMMARY_PROMPT_MODES = Object.freeze([
+  { value: 'host', label: '宿主（英文原文）' },
+  { value: 'zh', label: '中文版（同结构）' },
+  { value: 'custom', label: '自定义' },
+]);
+
+/** 面板里只读展示用：预设名 → 正文。随 /tower/config 一起下发。 */
+export const PROMPT_PRESETS = Object.freeze({
+  summaryHost: SUMMARY_PROMPT_HOST_DISPLAY,
+  summaryZh: SUMMARY_PROMPT_ZH,
+});
+
+/**
+ * 这次蒸馏该用哪段指令。
+ * @param {object} config 生效配置
+ * @returns {string|null} null 表示「交给宿主的 summarize」，即不接管这次调用
+ */
+export function summaryInstruction(config) {
+  if (config.summaryPromptMode === 'zh') return SUMMARY_PROMPT_ZH;
+  if (config.summaryPromptMode === 'custom') {
+    const text = String(config.summaryPrompt ?? '').trim();
+    // 选了自定义却没写内容：退回宿主，别让蒸馏发一条空指令出去。
+    return text.length === 0 ? null : text;
+  }
+  return null;
+}