dsh-plugin-om 0.0.25 → 0.0.26

package/README.md

@@ -7,10 +7,11 @@
 ## 功能
 
 - **自动压缩**（仅主会话，`agent/pre-step` 时阻塞串行执行）：
-  - **观察**：净压力（上下文压力 − 已压缩 `<history>` 块 token 估算合计 − 系统提示词 token 估算 − 工具定义 token 估算）≥ `observeThresholdTokens` 时，摘要未压缩消息并追加为新 `<history>` 块，精确替换被压缩的消息区间（旧块保留）
+  - **观察**：净压力（上下文压力 − 已压缩 `<history>` 块 token 估算合计 − 系统提示词 token 估算 − 工具定义 token 估算）首次 ≥ `observeThresholdTokens` 时记录待定标记（触发点 = 当时的最后一条完整消息），本次不压缩；待定后新增完整消息数达到 `tailMessageCount` 时，摘要压缩边界至触发点的全部消息并追加为新 `<history>` 块，精确替换被压缩的消息区间（旧块保留，等待期消息成为新的未压缩尾部）。待定标记以 log-only `om/observe-pending` / `om/observe-invalidate` 会话事件持久化（重启后从日志恢复），摘要失败保留待定、下个 pre-step 直接重试；`tailMessageCount=0` 时触发当轮立即执行
   - **反思**：全部 `<history>` 块 token 合计 ≥ `reflectThresholdTokens` 时，把多个摘要块合并为一条更紧凑的摘要
   - **输出容错**：摘要输出按首个 `<history>` 开标签到最后一个 `</history>` 定位；整块 XML 非法时按条目标签模糊提取并重建为合法块，再校验无 reasoning 与 index 连续
-  - **失败中断**：摘要尝试全部耗尽后拒绝当前 step（当前 turn 以 blocked 结束，不再继续 AI 会话；signal 中止除外），最后一次尝试的实际报错写入日志与 `compaction/end` error
+  - **失败中断**：摘要尝试全部耗尽后拒绝当前 step（当前 turn 以 blocked 结束，不再继续 AI 会话；signal 中止除外），最后一次尝试的实际报错与诊断子会话 sessionId 写入日志与 `compaction/end` error
+  - **失败诊断落盘**：摘要最终失败（含 signal 中止）时，把每次尝试的完整提示词与模型原始输出原样落盘为一个 one-shot 诊断子会话（`subagent/descriptor` 标记、以 subagent 形式出现在宿主子代理列表中；内容零加工、无额外消息），sessionId 随失败结果进主会话日志与 `compaction/end` error 载荷
   - **降级容错**：挂载失败类问题（systemPrompt 服务缺失、tokenMeter 服务异常）不阻塞压缩——systemPrompt 按 0 计、tokenMeter 计价按 0 计或跳过观察；问题始终 `console.warn` 输出到宿主进程外部，并写入 log-only `om/warning` 会话事件（同会话同一问题至多一条）。系统提示词/工具定义估算的普通运行时报错仅记日志，同样按 0 计
 - **recall 工具**：按完整消息 index 区间回看原始会话（含被压缩内容；命中消息中的图片附件随结果保留）
 - **recall-semantic 工具**：本地嵌入模型（paraphrase-multilingual-MiniLM-L12-v2）按语义检索全部完整消息（只匹配文本，纯图片消息不进候选池）
@@ -60,7 +61,7 @@ preset-agent 自带 `compaction-basic` 压缩，也会压缩上下文，其压
 | `reflectThresholdTokens` | `120000` | 反思阈值（tokens）：全部 `<history>` 块 token 合计 ≥ 该值时触发合并 |
 | `compressMaxTokens` | 不设置 | 单次摘要生成上限（不设置时由模型适配器默认值决定） |
 | `rateLimitWaitMs` | `60000` | 遇 429 限流后下一次摘要请求前的等待毫秒数（全局冷却期；`0` 不限流） |
-| `tailMessageCount` | `5` | 尾部保留的不压缩消息条数 |
+| `tailMessageCount` | `5` | 观察触发后延迟执行的等待完整消息条数（新增完整消息数达到该值才执行压缩；`0` 表示触发当轮立即执行） |
 | `compressRetryCount` | `5` | 摘要失败后的最大重试次数（不含首次） |
 | `modelDir` | 共享目录 | recall-semantic 嵌入模型目录（默认 `$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>`，onnx 缺失且启用语义召回时运行时自动下载） |
 | `omEnabled` | `true` | 是否启用自动压缩（`false` 时关闭，recall 工具不受影响） |
@@ -70,6 +71,8 @@ preset-agent 自带 `compaction-basic` 压缩，也会压缩上下文，其压
 
 > 不建议把观察阈值设置得过高：越早压缩收益越高，且机制依赖模型对消息计数，过多消息会导致历史混乱。
 
+> 想直观理解机制并估算不同参数下的 token 成本，可打开交互式[机制说明与成本计算器](https://fanethedivine.github.io/dsh-plugin-om/)（部署在 GitHub Pages，不随插件包分发）：右侧参数侧边栏（滑块 + 数字输入联动）+ 居中的合并单元格成本表（每格显示 om 关闭红 / om 开启绿），可调节系统提示词、dsh 注入消息、阈值、压缩比与三类 token 价格，对比 20k–250k 原始会话规模下启用 om 的 token 消耗量与费用。
+
 ## npm 命令
 
 | 命令 | 作用 |
@@ -102,6 +105,7 @@ src/
 ├── embedding.ts               # 本地 ONNX 嵌入（懒加载 / 批量 / 运行时按需下载编排）
 ├── model-download.ts          # 模型下载原语（URL / 跳过判定 / 原子落盘）
 ├── summarize.ts               # 共享压缩提示词 + <history> 块渲染与输出校验 + 摘要调用
+├── compaction-log.ts          # 压缩失败诊断落盘（诊断子会话创建 + descriptor + 逐尝试原样消息组）
 ├── compress.ts                # 两级自动压缩（观察/反思）、失败中断传播与 compaction 生命周期事件
 └── client/                    # 浏览器客户端 bundle（压缩卡片）
     ├── index.ts               # 客户端入口：注册卡片定义与渲染器
@@ -112,6 +116,10 @@ src/
     └── locales.ts             # om-compaction 文案字典（zh/en）
 models/                        # 嵌入模型目录（小文件随包分发；onnx 运行时按需下载，不进 git）
 scripts/                       # release-archive.mjs（CHANGELOG 归档）/ download-model.mjs（预下载 CLI）
-tests/                         # vitest 测试（服务端各模块 + tests/client/ 客户端卡片 + 整条链路集成测试）
+tests/                         # vitest 测试（服务端各模块 + tests/client/ 客户端卡片 + tests/web/ 成本模型 + 整条链路集成测试）
+web/                           # 机制说明与成本计算器站点（独立 Vite + React + Tailwind CSS + shadcn/ui 工程，发布到 GitHub Pages，不随插件包分发）
+    ├── src/model.ts           # 成本模型纯函数（om 开/关全会话模拟与三类 token 计价）
+    └── src/components/        # 机制简述（观察/反思/dsh注入） / 侧边栏参数面板（滑块+input） / 合并单元格成本表 / shadcn/ui 原语
+.github/workflows/web-deploy.yml  # web/ 变更合入 main 时构建并部署 GitHub Pages
 ```
 

package/dist/compaction-log.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 压缩失败诊断落盘：摘要 run 最终失败时，把每次尝试的完整提示词与模型原始输出
+ * 原样落盘为一个 one-shot 诊断子会话（header origin 'subagent' + 首事件
+ * subagent/descriptor），使其以 subagent 形式出现在宿主子代理列表中，便于查看
+ * 失败调用的完整会话。导出 recordCompactionFailure / SummaryAttemptRecord /
+ * compactionLogLabel / COMPACTION_LOG_PROVIDER。
+ *
+ * - 子会话内容零加工：每次尝试一对 user/message（实际提示词全文，含 <history> 块）
+ *   + assistant/message（模型原始输出全文，异常/中止时为已收集的部分输出），
+ *   不插入任何额外消息；失败原因不进子会话，走主会话日志与 compaction/end error 载荷
+ * - 失败原因与诊断子会话 sessionId 由调用方写入主会话日志（compress.ts / index.ts）
+ * - 落盘自身绝不抛错：任何失败仅 logger.warn 并返回 undefined，不影响压缩失败流程
+ */
+import type { Context, Session } from './types.ts';
+import { type RoutedTarget } from './utils.ts';
+/** 诊断子会话的 descriptor provider（宿主子代理列表识别用）。 */
+export declare const COMPACTION_LOG_PROVIDER = "om-compaction-log";
+/** 一次失败摘要尝试的完整记录：prompt=实际提示词全文（含 <history> 块），rawOutput=模型原始输出全文。 */
+export type SummaryAttemptRecord = {
+    prompt: string;
+    rawOutput: string;
+};
+/** 诊断子会话 label：含压缩阶段与尝试次数。 */
+export declare function compactionLogLabel(phase: 'observe' | 'reflect' | undefined, attemptCount: number): string;
+/**
+ * 把一次最终失败的摘要 run 落盘为诊断子会话：ctx.sessions.create 创建子会话
+ * （header origin 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、
+ * cwd 继承主会话），追加 one-shot descriptor（provider om-compaction-log，label 含
+ * 压缩阶段与尝试次数），逐尝试原样追加「提示词 + 原始输出」消息组，flush 持久化
+ * 检查点，返回子会话 id。落盘自身绝不抛错：任何失败仅 logger.warn 并返回
+ * undefined（不影响压缩失败流程）。
+ */
+export declare function recordCompactionFailure(ctx: Context, parentSession: Session, options: {
+    /** 压缩 pass（诊断子会话 label 用）。 */
+    phase: 'observe' | 'reflect' | undefined;
+    /** 摘要调用的路由目标（assistant/message 的 model 来源标记）。 */
+    target: RoutedTarget;
+    /** 逐尝试的完整记录（提示词 + 原始输出；中止在首次请求前时为空）。 */
+    attempts: readonly SummaryAttemptRecord[];
+    /** 插件 debug 开关（落盘失败的 warn 是否带步骤细节）。 */
+    debug: boolean;
+}): Promise<string | undefined>;
+//# sourceMappingURL=compaction-log.d.ts.map

package/dist/compaction-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-log.d.ts","sourceRoot":"","sources":["../src/compaction-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAE3D,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AASzE,8BAA8B;AAC9B,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EACxC,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AA8BD;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE;IACP,8BAA8B;IAC9B,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,iDAAiD;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,wCAAwC;IACxC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC1C,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmC7B"}

package/dist/compress.d.ts

@@ -1,12 +1,17 @@
 import type { Agent, Context, PluginConfig, Session } from './types.ts';
 import { type RoutedTarget } from './utils.ts';
-/** 压缩 pass 结果：failed=false 表示无需中断（成功、跳过或非摘要耗尽的局部失败）；failed=true 携带最后一次尝试的实际报错与是否因 signal 中止。 */
+/**
+ * 压缩 pass 结果：failed=false 表示无需中断（成功、跳过或非摘要耗尽的局部失败）；
+ * failed=true 携带最后一次尝试的实际报错、是否因 signal 中止与诊断子会话 id
+ * （最终失败时每次尝试的完整提示词与模型原始输出落盘为诊断子会话；落盘失败时缺失）。
+ */
 export type CompressPassResult = {
     failed: false;
 } | {
     failed: true;
     error: string;
     aborted: boolean;
+    diagnosticSessionId?: string;
 };
 /** 历史文本 token 估算：4 字符 ≈ 1 token（与宿主 dsh-token-meter 启发式一致）。 */
 export declare function estimateTextTokens(text: string): number;
@@ -16,11 +21,12 @@ export declare function estimateTextTokens(text: string): number;
  */
 export declare function isPairBalancedAfter(session: Session, seq: number): boolean;
 /**
- * 观察压缩区间：压缩边界后的首个表层节点 → 表层长度-1-tailCount（尾部保留 tailCount
- * 条不压缩）；区间终点回退到 tool-call/result 配对平衡点（不切段）。无可行区间返回
- * undefined。返回区间起止表层 seq 与被遮蔽 seq 列表。
+ * 观察压缩区间：压缩边界后的首个表层节点 → 触发点完整消息（endMessageIndex）对应的
+ * 表层终点（取该完整消息最后一个事件 seq 在表层中的位置）；区间终点回退到
+ * tool-call/result 配对平衡点（不切段）。触发点完整消息不存在或其事件已不在表层
+ * （被后续压缩遮蔽）时返回 undefined。返回区间起止表层 seq 与被遮蔽 seq 列表。
  */
-export declare function computeCompressRange(session: Session, tailCount: number): {
+export declare function computeCompressRange(session: Session, endMessageIndex: number): {
     start: number;
     end: number;
     shadowedSeqs: number[];
@@ -38,6 +44,16 @@ export declare function historySection(session: Session): {
     }>;
     boundarySeq: number | undefined;
 };
+/**
+ * 查找当前活跃的观察压缩待定标记：按日志顺序取最后一条 om/observe-pending，其后须无
+ * 引用它的 om/observe-invalidate（已失效），且其后的压缩边界 seq 不大于标记 seq（边界
+ * 后移说明标记期间已发生过压缩，标记过期——兜底「执行成功但失效标记未写出」的崩溃
+ * 窗口）。无活跃标记返回 undefined。
+ */
+export declare function findObservePending(session: Session): {
+    seq: number;
+    triggerMessageIndex: number;
+} | undefined;
 /**
  * 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，摘要调用把整个块
  * 区段合并替换为一条更紧凑的摘要。失败不产生部分替换；摘要尝试全部耗尽返回
@@ -45,12 +61,16 @@ export declare function historySection(session: Session): {
  */
 export declare function reflectPass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, target: RoutedTarget, signal?: AbortSignal): Promise<CompressPassResult>;
 /**
- * 观察：净压力 tokens（上下文压力 − 已压缩 <history> 块 token 合计 − 系统提示词
- * token 估算 − 工具定义 token 估算）≥ observeThresholdTokens 时，摘要调用把未压缩
- * 消息压缩为观察日志，追加到旧摘要并替换被压缩消息区间。失败不产生部分替换；
- * 摘要尝试全部耗尽返回失败结果（error = 最后一次尝试的实际报错/具体问题）。
+ * 观察（触发 → 待定 → 延迟执行）：无活跃待定标记时测净压力 tokens（上下文压力 − 已压缩
+ * <history> 块 token 合计 − 系统提示词 token 估算 − 工具定义 token 估算），首次 ≥
+ * observeThresholdTokens 时记录待定标记（触发点 = 当时的最后一条完整消息 index），本次
+ * 不压缩（tailMessageCount=0 当轮直接执行，不落待定标记）；已有待定标记时按新增完整
+ * 消息数 ≥ tailMessageCount 决定执行，压缩区间截至触发点（新增消息成为新未压缩尾部，
+ * 延迟窗口内压力允许短暂超阈值）。执行成功（或无可行区间）后写待定失效标记；摘要
+ * 失败保留待定，下个 pre-step 直接重试执行。摘要尝试全部耗尽返回失败结果
+ * （error = 最后一次尝试的实际报错/具体问题）。
  */
-export declare function observePass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, tailCount: number, target: RoutedTarget, signal?: AbortSignal): Promise<CompressPassResult>;
+export declare function observePass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, waitCount: number, target: RoutedTarget, signal?: AbortSignal): Promise<CompressPassResult>;
 /**
  * 压力检查 + 两级压缩入口：先反思后观察，pre-step 阻塞串行执行；仅主会话生效。
  * 反思摘要耗尽失败时直接返回失败结果（观察无需继续，本轮将被拒绝）；观察失败同样

package/dist/compress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EACV,KAAK,EAIL,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG,gGAAgG;AAChG,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtD,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AA4CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAY1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAqBpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAUA;AA0GD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAiH7B;AAwED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CA0J7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAwB7B"}
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EACV,KAAK,EAKL,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AA4CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAY1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,MAAM,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CA8BpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAmB1D;AA0HD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAgI7B;AAwED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAwO7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAwB7B"}

package/dist/config.d.ts

@@ -8,7 +8,7 @@ export type PluginConfig = {
     compressMaxTokens: number | undefined;
     /** 遇 429 限流后下一次摘要请求前的等待毫秒数（全局冷却期）。 */
     rateLimitWaitMs: number;
-    /** 尾部保留的不压缩消息条数。 */
+    /** 观察触发后延迟执行的等待完整消息条数（新增完整消息数达到该值才执行压缩；0 表示触发当轮立即执行）。 */
     tailMessageCount: number;
     /** 摘要失败后的最大重试次数（不含首次）。 */
     compressRetryCount: number;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAYhD,CAAC;AAqCH,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAoBnE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAYhD,CAAC;AAqCH,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAoBnE"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,6BAA6B;AAC7B,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,wDAAwD;AACxD,eAAO,MAAM,MAAM,UAA6C,CAAC;AAEjE,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAoD1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,6BAA6B;AAC7B,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,wDAAwD;AACxD,eAAO,MAAM,MAAM,UAA6C,CAAC;AAEjE,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAwD1D"}

package/dist/index.mjs

@@ -1,5 +1,7 @@
 import { scopeOf } from "@deepseek-ai/dsh-scope";
 import { renderPrompt } from "@deepseek-ai/dsh-system-prompt";
+import { SessionId } from "@deepseek-ai/dsh-session";
+import { SUBAGENT_DESCRIPTOR_VERSION } from "@deepseek-ai/dsh-subagent";
 import { copyFileSync, existsSync, mkdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
@@ -155,6 +157,11 @@ function routedTarget(session) {
 * assistant（模型输出文本）、toolcall（单个工具调用及其结果，result 按 callId 匹配并入）。
 * index 从 0 起、按日志顺序递增、只追加不重排（压缩后旧摘要条目引用的 index 仍然有效）。
 */
+/** 查找 seq 在表层节点序列中的下标（不在则返回 -1）。 */
+function surfaceIndexOf(nodes, seq) {
+	for (let i = 0; i < nodes.length; i += 1) if (nodes[i] === seq) return i;
+	return -1;
+}
 /**
 * 完整消息索引：按日志顺序把消息事件折叠为完整消息序列（四类，见文件头）。
 * 工具调用结果按 source.callId 匹配其 tool-call 并入该条；未匹配的 result 独立成条（防御）。
@@ -7427,7 +7434,7 @@ var require_dom_parser = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.onWarningStopParsing = onWarningStopParsing;
 }));
 //#endregion
-//#region src/rate-limit.ts
+//#region src/compaction-log.ts
 var import_lib = (/* @__PURE__ */ __commonJSMin(((exports) => {
 	var conventions = require_conventions();
 	exports.assign = conventions.assign;
@@ -7467,6 +7474,96 @@ var import_lib = (/* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.onErrorStopParsing = domParser.onErrorStopParsing;
 	exports.onWarningStopParsing = domParser.onWarningStopParsing;
 })))();
+/** 诊断子会话的 descriptor provider（宿主子代理列表识别用）。 */
+const COMPACTION_LOG_PROVIDER = "om-compaction-log";
+/** 压缩 pass 的中文标签（诊断子会话 label 用；未知阶段回落「压缩」）。 */
+function phaseLabel(phase) {
+	if (phase === "observe") return "观察";
+	if (phase === "reflect") return "反思";
+	return "压缩";
+}
+/** 诊断子会话 label：含压缩阶段与尝试次数。 */
+function compactionLogLabel(phase, attemptCount) {
+	return `OM 压缩失败日志（${phaseLabel(phase)} · ${attemptCount} 次尝试）`;
+}
+/** 追加一次尝试的「提示词 → 原始输出」消息组（surfaceOp append；id 为品牌类型，session.append 运行时校验）。 */
+function appendAttemptMessages(child, attempt, step, target) {
+	const userMessage = {
+		id: uuid(),
+		role: "user",
+		content: [{
+			type: "text",
+			text: attempt.prompt
+		}],
+		source: {
+			kind: "plugin",
+			plugin: PLUGIN_LABEL
+		}
+	};
+	child.append("user/message", userMessage, { surfaceOp: "append" });
+	const assistantMessage = {
+		id: uuid(),
+		role: "assistant",
+		content: [{
+			type: "text",
+			text: attempt.rawOutput
+		}],
+		source: {
+			kind: "model",
+			provider: target.provider,
+			model: target.model
+		}
+	};
+	child.append("assistant/message", {
+		turn: 0,
+		step,
+		message: assistantMessage
+	}, { surfaceOp: "append" });
+}
+/**
+* 把一次最终失败的摘要 run 落盘为诊断子会话：ctx.sessions.create 创建子会话
+* （header origin 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、
+* cwd 继承主会话），追加 one-shot descriptor（provider om-compaction-log，label 含
+* 压缩阶段与尝试次数），逐尝试原样追加「提示词 + 原始输出」消息组，flush 持久化
+* 检查点，返回子会话 id。落盘自身绝不抛错：任何失败仅 logger.warn 并返回
+* undefined（不影响压缩失败流程）。
+*/
+async function recordCompactionFailure(ctx, parentSession, options) {
+	const logger = makeLogger(ctx, options.debug);
+	try {
+		const header = parentSession.header;
+		const child = ctx.sessions.create(SessionId(`om-compaction-log-${uuid()}`), { meta: {
+			...header.cwd === void 0 ? {} : { cwd: header.cwd },
+			parentSession: parentSession.id,
+			origin: "subagent",
+			delegationDepth: (header.delegationDepth ?? 0) + 1
+		} });
+		child.append("subagent/descriptor", {
+			version: SUBAGENT_DESCRIPTOR_VERSION,
+			mode: "one-shot",
+			provider: COMPACTION_LOG_PROVIDER,
+			label: compactionLogLabel(options.phase, options.attempts.length)
+		});
+		for (let i = 0; i < options.attempts.length; i += 1) {
+			const attempt = options.attempts[i];
+			if (attempt === void 0) continue;
+			appendAttemptMessages(child, attempt, i + 1, options.target);
+		}
+		try {
+			await ctx.sessions.flush(child);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			logger.warn(`压缩失败诊断子会话 flush 失败（子会话 ${child.id} 已创建）: ${message}`);
+		}
+		return child.id;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		logger.warn(`压缩失败诊断子会话落盘失败: ${message}`);
+		return;
+	}
+}
+//#endregion
+//#region src/rate-limit.ts
 /**
 * 全局限流门（插件进程级共享状态）：任一摘要请求遇 429 后进入冷却期，
 * 此后所有摘要请求发出前先等待到「最近一次 429 + rateLimitWaitMs」之后。
@@ -7542,7 +7639,7 @@ function buildHistoryPrompt() {
 		"- <reasoning> 只作参考，输出产物中不包含 <reasoning> 块。",
 		"- 将具有关联性的 <assistant> 消息按内在逻辑连贯性划分为连续模块，聚合为 <assistant start=\"\" end=\"\"> 块：块内描述模块的目的、行为与结果；涉及的具体文件保留在模块内容中，多个前缀相同的路径合并简写。",
 		"- 单条重要的完整消息以 <assistant index=\"\"> 单独呈现，内容不受限制。",
-		"- 加载的 skill 属于关键信息：应当产出独立块且不过多省略。",
+		"- 加载的 skill 属于**关键信息**：应当产出独立块且不过多省略。",
 		"- 条目按 index 顺序覆盖本次压缩的全部完整消息：index/start/end 必须连续（区间内 index 连续、相邻条目相接），不跳号、不重叠、不遗漏。",
 		"",
 		"【摘要粒度】",
@@ -7936,38 +8033,55 @@ function extractSummaryDetailed(raw, expected) {
 * 直连 LLM 执行一次摘要（观察或反思），返回文本与可选 token usage。
 * 失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）均记录日志并重试，每次尝试的
 * 结果或报错始终写入日志（成功 info / 失败 warn，不受 debug 影响）；全部尝试耗尽
-* 返回失败结果（携带最后一次尝试的实际报错/具体问题，不产生任何日志变更）。
-* signal 中止（含限流等待被中止）立即放弃并标记 aborted。每次请求发出前先过全局
-* 限流等待门。
+* 返回失败结果（携带最后一次尝试的实际报错/具体问题）。最终失败（耗尽或 signal
+* 中止）时把每次尝试的完整提示词与模型原始输出原样落盘为诊断子会话（phase 标注
+* 观察或反思），诊断子会话 id 随失败结果返回。signal 中止（含限流等待被中止）
+* 立即放弃并标记 aborted。每次请求发出前先过全局限流等待门。
 */
 async function runSummarySubagent(ctx, agent, instruction, contextText, maxTokens, target, debug, signal, options) {
 	const session = agent.session;
 	const logger = makeLogger(ctx, debug);
 	const maxAttempts = options?.maxAttempts ?? 11;
 	let lastFailure = {};
+	/** 逐尝试的完整记录（提示词 + 原始输出原样收集，仅最终失败时落盘）。 */
+	const attempts = [];
+	/** 最终失败的统一出口：落盘诊断子会话并携带其 id 返回。 */
+	const finishFailure = async (error, aborted) => {
+		const diagnosticSessionId = await recordCompactionFailure(ctx, session, {
+			phase: options?.phase,
+			target,
+			attempts,
+			debug
+		});
+		return {
+			ok: false,
+			error,
+			aborted,
+			...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
+		};
+	};
 	for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
 		if (signal?.aborted) {
 			logger.warn(`摘要调用中止（第 ${attempt}/${maxAttempts} 次尝试前 signal 已中止），放弃本次压缩`);
-			return {
-				ok: false,
-				error: COMPACTION_ABORTED_ERROR,
-				aborted: true
-			};
+			return await finishFailure(COMPACTION_ABORTED_ERROR, true);
 		}
 		const rateLimitWaitMs = options?.rateLimitWaitMs ?? 6e4;
 		if (!await gateRateLimit(rateLimitWaitMs, signal)) {
 			logger.warn(`摘要调用中止（第 ${attempt}/${maxAttempts} 次尝试前限流等待被 signal 中止），放弃本次压缩`);
-			return {
-				ok: false,
-				error: COMPACTION_ABORTED_ERROR,
-				aborted: true
-			};
+			return await finishFailure(COMPACTION_ABORTED_ERROR, true);
 		}
 		logger.step(`摘要调用开始（第 ${attempt}/${maxAttempts} 次，provider ${target.provider}，model ${target.model}，maxTokens ${maxTokens === void 0 ? "未设置" : String(maxTokens)}）`);
+		const prompt = `${instruction}\n\n${contextText ?? ""}`;
+		const collector = new StreamCollector();
+		let streamCompleted = false;
 		try {
 			const requestOptions = buildSummaryOptions(session, instruction, contextText, maxTokens, target, signal);
-			const collector = new StreamCollector();
 			for await (const chunk of ctx.llm.stream(requestOptions)) collector.push(chunk);
+			streamCompleted = true;
+			attempts.push({
+				prompt,
+				rawOutput: collector.text
+			});
 			const extracted = extractSummaryDetailed(collector.text, options?.expected);
 			const finish = collector.finish;
 			if (finish.kind !== "stop") {
@@ -7990,6 +8104,10 @@ async function runSummarySubagent(ctx, agent, instruction, contextText, maxToken
 				...usage === void 0 ? {} : { usage }
 			};
 		} catch (error) {
+			if (!streamCompleted) attempts.push({
+				prompt,
+				rawOutput: collector.text
+			});
 			const message = error instanceof Error ? error.message : String(error);
 			if (isRateLimitError(message)) {
 				noteRateLimit();
@@ -8001,29 +8119,30 @@ async function runSummarySubagent(ctx, agent, instruction, contextText, maxToken
 	}
 	const lastError = lastFailure.error ?? lastFailure.reason ?? "未知原因";
 	logger.warn(`摘要调用最终失败（已尝试 ${maxAttempts} 次，最后错误：${lastError}），拒绝放行本轮 step`);
-	return {
-		ok: false,
-		error: lastError,
-		aborted: false
-	};
+	return await finishFailure(lastError, false);
 }
 //#endregion
 //#region src/compress.ts
 /**
 * 两级自动压缩（观察/反思）与 compaction 生命周期提交。
 * 导出 estimateTextTokens / isPairBalancedAfter / computeCompressRange / historySection /
-* reflectPass / observePass / maybeCompress。
+* findObservePending / reflectPass / observePass / maybeCompress。
 *
 * - 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，摘要合并为一条
-* - 观察：净压力（上下文压力 − 已压缩块 token 合计 − 系统提示词 token 估算 − 工具定义
-*   token 估算）≥ observeThresholdTokens 时，
-*   摘要未压缩消息为新 <history> 块并精确替换被压缩区间（旧块保留）
+* - 观察（触发 → 待定 → 延迟执行）：净压力（上下文压力 − 已压缩块 token 合计 − 系统提示词
+*   token 估算 − 工具定义 token 估算）首次 ≥ observeThresholdTokens 时记录待定标记
+*   （触发点 = 当时的最后一条完整消息 index），本次不压缩；待定后新增完整消息数 ≥
+*   tailMessageCount 时，把压缩边界至触发点的全部消息摘要为新 <history> 块并精确替换
+*   被压缩区间（旧块保留），等待期间的新消息成为下一轮未压缩尾部（延迟窗口内压力允许
+*   短暂超阈值）；tailMessageCount=0 时触发当轮直接执行（不落待定标记）
+* - 待定标记以 log-only om/observe-pending / om/observe-invalidate 事件持久化在会话
+*   日志中（重启后从日志恢复）；摘要失败保留待定，下个 pre-step 直接重试执行
 * - 两级在 pre-step 阻塞串行执行（先反思后观察）；仅主会话生效；omEnabled=false 关闭
 * - 压缩边界：最后一个合法 <history> 块之后的消息视为未压缩，其前不重复压缩
 * - 摘要尝试全部耗尽时 pass 返回失败结果（携带最后一次尝试的实际报错），压缩流程
 *   向上传播，pre-step 据此拒绝本 step 中断当前 turn；signal 中止标记 aborted（不中断）
 * - 提交走宿主 compaction/* 生命周期事件（start 带 phase → summary → 替换消息 → end），
-*   失败补 end(error，实际报错)；替换消息 source 标记插件标识供 UI 认领
+*   失败补 end(error，实际报错 + 诊断子会话 sessionId)；替换消息 source 标记插件标识供 UI 认领
 * - 挂载失败类问题（systemPrompt/tokenMeter 服务异常）始终 console 到外部进程，并追加
 *   log-only om/warning 事件（客户端渲染功能降级警告行，每会话同一问题至多一次）；
 *   辅助估算的普通运行时报错仅记日志。降级与报错都不阻塞压缩（tokenMeter 压力数据
@@ -8087,17 +8206,26 @@ function isPairBalancedAfter(session, seq) {
 	return false;
 }
 /**
-* 观察压缩区间：压缩边界后的首个表层节点 → 表层长度-1-tailCount（尾部保留 tailCount
-* 条不压缩）；区间终点回退到 tool-call/result 配对平衡点（不切段）。无可行区间返回
-* undefined。返回区间起止表层 seq 与被遮蔽 seq 列表。
+* 观察压缩区间：压缩边界后的首个表层节点 → 触发点完整消息（endMessageIndex）对应的
+* 表层终点（取该完整消息最后一个事件 seq 在表层中的位置）；区间终点回退到
+* tool-call/result 配对平衡点（不切段）。触发点完整消息不存在或其事件已不在表层
+* （被后续压缩遮蔽）时返回 undefined。返回区间起止表层 seq 与被遮蔽 seq 列表。
 */
-function computeCompressRange(session, tailCount) {
+function computeCompressRange(session, endMessageIndex) {
 	const surface = [...session.surface.nodes];
 	if (surface.length === 0) return void 0;
 	const { boundarySeq } = historySection(session);
 	const startIdx = boundarySeq === void 0 ? 0 : surface.indexOf(boundarySeq) + 1;
 	if (startIdx >= surface.length) return void 0;
-	let endIdx = surface.length - 1 - tailCount;
+	const target = indexCompleteMessages(session).find((cm) => cm.index === endMessageIndex);
+	if (target === void 0) return void 0;
+	let endIdx = -1;
+	for (let i = target.seqs.length - 1; i >= 0; i -= 1) {
+		const seq = target.seqs[i];
+		if (seq === void 0) continue;
+		endIdx = surfaceIndexOf(surface, seq);
+		if (endIdx !== -1) break;
+	}
 	if (endIdx < startIdx) return void 0;
 	while (endIdx >= startIdx) {
 		const node = surface[endIdx];
@@ -8137,6 +8265,42 @@ function historySection(session) {
 		boundarySeq
 	};
 }
+/**
+* 查找当前活跃的观察压缩待定标记：按日志顺序取最后一条 om/observe-pending，其后须无
+* 引用它的 om/observe-invalidate（已失效），且其后的压缩边界 seq 不大于标记 seq（边界
+* 后移说明标记期间已发生过压缩，标记过期——兜底「执行成功但失效标记未写出」的崩溃
+* 窗口）。无活跃标记返回 undefined。
+*/
+function findObservePending(session) {
+	let pending;
+	for (let seq = 0; seq < session.events.length; seq += 1) {
+		const event = session.events[seq];
+		if (!event) continue;
+		if (event.type === "om/observe-pending") pending = {
+			seq,
+			triggerMessageIndex: event.data.triggerMessageIndex
+		};
+		else if (event.type === "om/observe-invalidate" && pending !== void 0 && event.data.pendingSeq === pending.seq) pending = void 0;
+	}
+	if (pending === void 0) return void 0;
+	const { boundarySeq } = historySection(session);
+	if (boundarySeq !== void 0 && boundarySeq > pending.seq) return void 0;
+	return pending;
+}
+/** 追加观察压缩待定标记（log-only）：记录触发点完整消息 index，返回事件 seq。 */
+function appendObservePending(session, triggerMessageIndex) {
+	return session.append("om/observe-pending", {
+		key: "observe",
+		triggerMessageIndex
+	}).seq;
+}
+/** 追加观察压缩待定失效标记（log-only）：声明指定 pending 已失效，返回事件 seq。 */
+function appendObserveInvalidate(session, pendingSeq) {
+	return session.append("om/observe-invalidate", {
+		key: "observe",
+		pendingSeq
+	}).seq;
+}
 /** 当前打开中的 turn 号（最近 turn/start 且未被 turn/end 关闭）；无则 null。 */
 function openTurnOf(session) {
 	let turn = null;
@@ -8180,13 +8344,18 @@ function appendCompactionSummary(session, data) {
 	};
 	return session.append("compaction/summary", payload).seq;
 }
-/** 追加 compaction/end（log-only，结束生命周期；error 记录失败原因）。 */
-function appendCompactionEnd(session, lifecycle, error) {
-	return session.append("compaction/end", {
+/**
+* 追加 compaction/end（log-only，结束生命周期；error 记录失败原因，
+* diagnosticSessionId 记录最终失败时的诊断子会话 id）。
+*/
+function appendCompactionEnd(session, lifecycle, error, diagnosticSessionId) {
+	const payload = {
 		compactionId: lifecycle.compactionId,
 		turn: lifecycle.turn,
-		...error === void 0 ? {} : { error }
-	}).seq;
+		...error === void 0 ? {} : { error },
+		...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
+	};
+	return session.append("compaction/end", payload).seq;
 }
 /** 追加 <history> 压缩日志消息（surfaceOp 替换遮蔽区间，source 标记插件自产 + compactionId）。 */
 function appendHistoryMessage(session, content, sourceEventSeqs, surfaceOp, compactionId) {
@@ -8258,17 +8427,19 @@ async function reflectPass(ctx, agent, config, target, signal) {
 			start: 0,
 			end: expectedEnd
 		},
-		rateLimitWaitMs: config.rateLimitWaitMs
+		rateLimitWaitMs: config.rateLimitWaitMs,
+		phase: "reflect"
 	});
 	if (!summaryResult.ok) {
-		logger.warn(`反思：摘要调用失败（${summaryResult.error}），追加 compaction/end(error)`);
+		logger.warn(`反思：摘要调用失败（${summaryResult.error}），诊断子会话 ${summaryResult.diagnosticSessionId ?? "未落盘"}，追加 compaction/end(error)`);
 		try {
-			appendCompactionEnd(session, lifecycle, summaryResult.error);
+			appendCompactionEnd(session, lifecycle, summaryResult.error, summaryResult.diagnosticSessionId);
 		} catch {}
 		return {
 			failed: true,
 			error: summaryResult.error,
-			aborted: summaryResult.aborted
+			aborted: summaryResult.aborted,
+			...summaryResult.diagnosticSessionId === void 0 ? {} : { diagnosticSessionId: summaryResult.diagnosticSessionId }
 		};
 	}
 	const report = summaryResult.text;
@@ -8367,49 +8538,99 @@ function measurePressureTokens(ctx, session, logger) {
 	}
 }
 /**
-* 观察：净压力 tokens（上下文压力 − 已压缩 <history> 块 token 合计 − 系统提示词
-* token 估算 − 工具定义 token 估算）≥ observeThresholdTokens 时，摘要调用把未压缩
-* 消息压缩为观察日志，追加到旧摘要并替换被压缩消息区间。失败不产生部分替换；
-* 摘要尝试全部耗尽返回失败结果（error = 最后一次尝试的实际报错/具体问题）。
+* 观察（触发 → 待定 → 延迟执行）：无活跃待定标记时测净压力 tokens（上下文压力 − 已压缩
+* <history> 块 token 合计 − 系统提示词 token 估算 − 工具定义 token 估算），首次 ≥
+* observeThresholdTokens 时记录待定标记（触发点 = 当时的最后一条完整消息 index），本次
+* 不压缩（tailMessageCount=0 当轮直接执行，不落待定标记）；已有待定标记时按新增完整
+* 消息数 ≥ tailMessageCount 决定执行，压缩区间截至触发点（新增消息成为新未压缩尾部，
+* 延迟窗口内压力允许短暂超阈值）。执行成功（或无可行区间）后写待定失效标记；摘要
+* 失败保留待定，下个 pre-step 直接重试执行。摘要尝试全部耗尽返回失败结果
+* （error = 最后一次尝试的实际报错/具体问题）。
 */
-async function observePass(ctx, agent, config, tailCount, target, signal) {
+async function observePass(ctx, agent, config, waitCount, target, signal) {
 	const session = agent.session;
 	const logger = makeLogger(ctx, config.debug);
-	logger.step(`观察检查（观察阈值 ${config.observeThresholdTokens} tokens，尾部保留 ${tailCount} 条）`);
-	const threshold = config.observeThresholdTokens;
-	const pressureTokens = measurePressureTokens(ctx, session, logger);
-	if (pressureTokens === void 0) return { failed: false };
+	logger.step(`观察检查（观察阈值 ${config.observeThresholdTokens} tokens，延迟等待 ${waitCount} 条完整消息）`);
 	const { blocks } = historySection(session);
-	const historyTokens = blocks.reduce((total, block) => total + estimateTextTokens(block.text), 0);
-	const systemTokens = await estimateSystemPromptTokens(ctx, agent, logger, signal);
-	const toolsTokens = estimateToolsTokens(session, logger);
-	const netTokens = pressureTokens - historyTokens - systemTokens - toolsTokens;
-	if (netTokens < threshold) {
-		logger.step(`观察：净压力 ${netTokens} tokens（上下文压力 ${pressureTokens} − 已压缩块 ${historyTokens} − 系统提示词 ${systemTokens} − 工具定义 ${toolsTokens}）< 阈值 ${threshold}，跳过`);
-		return { failed: false };
+	const pending = findObservePending(session);
+	let triggerMessageIndex;
+	let pendingSeq;
+	let triggerNote;
+	if (pending === void 0) {
+		const threshold = config.observeThresholdTokens;
+		const pressureTokens = measurePressureTokens(ctx, session, logger);
+		if (pressureTokens === void 0) return { failed: false };
+		const historyTokens = blocks.reduce((total, block) => total + estimateTextTokens(block.text), 0);
+		const systemTokens = await estimateSystemPromptTokens(ctx, agent, logger, signal);
+		const toolsTokens = estimateToolsTokens(session, logger);
+		const netTokens = pressureTokens - historyTokens - systemTokens - toolsTokens;
+		if (netTokens < threshold) {
+			logger.step(`观察：净压力 ${netTokens} tokens（上下文压力 ${pressureTokens} − 已压缩块 ${historyTokens} − 系统提示词 ${systemTokens} − 工具定义 ${toolsTokens}）< 阈值 ${threshold}，跳过`);
+			return { failed: false };
+		}
+		logger.step(`观察：净压力 ${netTokens} tokens（上下文压力 ${pressureTokens} − 已压缩块 ${historyTokens} − 系统提示词 ${systemTokens} − 工具定义 ${toolsTokens}）≥ 阈值 ${threshold}，触发压缩`);
+		const lastMessageIndex = indexCompleteMessages(session).length - 1;
+		if (lastMessageIndex < 0) {
+			logger.step("观察：会话尚无完整消息，跳过");
+			return { failed: false };
+		}
+		triggerMessageIndex = lastMessageIndex;
+		if (waitCount > 0) {
+			try {
+				pendingSeq = appendObservePending(session, triggerMessageIndex);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				logger.warn(`观察：待定标记追加失败，本轮跳过（下轮重新评估）: ${message}`);
+				return { failed: false };
+			}
+			logger.step(`观察：记录待定标记（触发点完整消息 index ${triggerMessageIndex}），等待 ${waitCount} 条新完整消息后压缩`);
+			return { failed: false };
+		}
+		triggerNote = `触发点完整消息 index ${triggerMessageIndex}`;
+	} else {
+		const arrived = indexCompleteMessages(session).length - 1 - pending.triggerMessageIndex;
+		if (arrived < waitCount) {
+			logger.step(`观察：待定标记等待中（触发点完整消息 index ${pending.triggerMessageIndex}，新增 ${arrived}/${waitCount} 条），跳过`);
+			return { failed: false };
+		}
+		logger.step(`观察：待定标记延迟到期（触发点完整消息 index ${pending.triggerMessageIndex}，新增 ${arrived} ≥ ${waitCount} 条），执行压缩`);
+		triggerMessageIndex = pending.triggerMessageIndex;
+		pendingSeq = pending.seq;
+		triggerNote = `待定标记触发点完整消息 index ${pending.triggerMessageIndex}`;
 	}
-	logger.step(`观察：净压力 ${netTokens} tokens（上下文压力 ${pressureTokens} − 已压缩块 ${historyTokens} − 系统提示词 ${systemTokens} − 工具定义 ${toolsTokens}）≥ 阈值 ${threshold}，触发压缩`);
-	const range = computeCompressRange(session, tailCount);
+	const clearPending = () => {
+		if (pendingSeq === void 0) return;
+		try {
+			appendObserveInvalidate(session, pendingSeq);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			logger.warn(`观察：待定失效标记追加失败: ${message}`);
+		}
+	};
+	const range = computeCompressRange(session, triggerMessageIndex);
 	if (!range) {
-		logger.step("观察：无可行压缩区间（边界后消息过短或配对无法平衡），跳过");
+		logger.step("观察：无可行压缩区间（边界后无消息、触发点已被压缩或配对无法平衡），清除待定标记视为完成");
+		clearPending();
 		return { failed: false };
 	}
 	logger.step(`观察：压缩区间 [${range.start}..${range.end}]，遮蔽 ${range.shadowedSeqs.length} 个表层节点`);
 	const replaceSeqs = range.shadowedSeqs;
 	const replaceStart = replaceSeqs[0];
 	if (replaceStart === void 0) {
-		logger.step("观察：区间内无新消息（全部为压缩日志块），跳过");
+		logger.step("观察：区间内无新消息（全部为压缩日志块），清除待定标记视为完成");
+		clearPending();
 		return { failed: false };
 	}
 	const shadowedSet = new Set(replaceSeqs);
 	const inRangeCms = indexCompleteMessages(session).filter((cm) => cm.seqs.every((seq) => shadowedSet.has(seq)));
 	if (inRangeCms.length === 0) {
-		logger.step("观察：区间内无完整消息，跳过");
+		logger.step("观察：区间内无完整消息，清除待定标记视为完成");
+		clearPending();
 		return { failed: false };
 	}
 	const startIndex = inRangeCms[0]?.index ?? 0;
 	const endIndex = inRangeCms[inRangeCms.length - 1]?.index ?? startIndex;
-	logger.step(`观察：保留旧块 ${blocks.length} 条，替换新消息 [${replaceSeqs[0]}..${range.end}]（${replaceSeqs.length} 条），尾部保留 ${tailCount} 条（不压缩、不进日志），新消息 index ${startIndex}..${endIndex}`);
+	logger.step(`观察：保留旧块 ${blocks.length} 条，替换 [${replaceStart}..${range.end}]（${replaceSeqs.length} 个表层节点，压缩至${triggerNote}），新消息 index ${startIndex}..${endIndex}`);
 	const instruction = buildHistoryPrompt();
 	const contextText = renderMessages(session, replaceSeqs);
 	const lifecycle = {
@@ -8430,17 +8651,19 @@ async function observePass(ctx, agent, config, tailCount, target, signal) {
 			start: startIndex,
 			end: endIndex
 		},
-		rateLimitWaitMs: config.rateLimitWaitMs
+		rateLimitWaitMs: config.rateLimitWaitMs,
+		phase: "observe"
 	});
 	if (!summaryResult.ok) {
-		logger.warn(`观察：摘要调用失败（${summaryResult.error}），追加 compaction/end(error)`);
+		logger.warn(`观察：摘要调用失败（${summaryResult.error}），诊断子会话 ${summaryResult.diagnosticSessionId ?? "未落盘"}，追加 compaction/end(error)`);
 		try {
-			appendCompactionEnd(session, lifecycle, summaryResult.error);
+			appendCompactionEnd(session, lifecycle, summaryResult.error, summaryResult.diagnosticSessionId);
 		} catch {}
 		return {
 			failed: true,
 			error: summaryResult.error,
-			aborted: summaryResult.aborted
+			aborted: summaryResult.aborted,
+			...summaryResult.diagnosticSessionId === void 0 ? {} : { diagnosticSessionId: summaryResult.diagnosticSessionId }
 		};
 	}
 	const report = summaryResult.text;
@@ -8488,7 +8711,8 @@ async function observePass(ctx, agent, config, tailCount, target, signal) {
 		}, lifecycle.compactionId);
 		logger.step("观察提交：追加 compaction/end");
 		appendCompactionEnd(session, lifecycle);
-		logger.info(`观察压缩完成（净压力 ${netTokens} tokens（上下文压力 ${pressureTokens} − 已压缩块 ${historyTokens}）≥ 阈值 ${threshold}，替换 ${replaceSeqs.length} 个表层节点，约 ${shadowedTokenCount} tokens）`);
+		clearPending();
+		logger.info(`观察压缩完成（替换 ${replaceSeqs.length} 个表层节点，约 ${shadowedTokenCount} tokens，压缩至${triggerNote}）`);
 		return { failed: false };
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
@@ -8517,7 +8741,7 @@ async function maybeCompress(ctx, agent, config, signal) {
 		return { failed: false };
 	}
 	logger.step(`会话路由：provider ${target.provider}，model ${target.model}`);
-	const tailCount = config.tailMessageCount;
+	const waitCount = config.tailMessageCount;
 	logger.step("反思 pass 开始");
 	const reflect = await reflectPass(ctx, agent, config, target, signal);
 	if (reflect.failed) {
@@ -8525,7 +8749,7 @@ async function maybeCompress(ctx, agent, config, signal) {
 		return reflect;
 	}
 	logger.step("反思 pass 结束，观察 pass 开始");
-	const observe = await observePass(ctx, agent, config, tailCount, target, signal);
+	const observe = await observePass(ctx, agent, config, waitCount, target, signal);
 	logger.step("观察 pass 结束，压缩流程完成");
 	return observe;
 }
@@ -9146,8 +9370,9 @@ function buildSemanticRecallTool(options) {
 * dsh-plugin-om 入口（tsdown 打包入口）：导出 name / inject / apply。
 * apply 注册 recall / recall-semantic 工具，并接线 agent/pre-step 自动压缩
 * （先反思后观察，仅主会话生效）。压缩摘要尝试全部耗尽时拒绝本 step 中断当前
-* turn（signal 中止除外）。压缩与检索的实现见 compress.ts / recall.ts /
-* semantic-recall.ts。
+* turn（signal 中止除外），主会话日志记录失败原因与诊断子会话 sessionId（每次
+* 尝试的完整提示词与模型原始输出由 compaction-log.ts 落盘为诊断子会话）。压缩与
+* 检索的实现见 compress.ts / compaction-log.ts / recall.ts / semantic-recall.ts。
 */
 /** 插件名（Loader 识别入口的稳定标识）。 */
 const name = "dsh-plugin-om";
@@ -9187,7 +9412,8 @@ function apply(ctx, config) {
 			logger.warn(`pre-step 处理失败: ${error instanceof Error ? error.message : String(error)}`);
 		}
 		if (outcome.failed && !outcome.aborted) {
-			logger.warn(`上下文压缩失败，拒绝本 step 中断当前 turn：${outcome.error}`);
+			const diagnostic = outcome.diagnosticSessionId === void 0 ? "" : `（诊断子会话 ${outcome.diagnosticSessionId}）`;
+			logger.warn(`上下文压缩失败，拒绝本 step 中断当前 turn：${outcome.error}${diagnostic}`);
 			return { kind: "reject" };
 		}
 		return next();

package/dist/summarize.d.ts

@@ -7,7 +7,9 @@
  * 定位与校验（首个 <history> 开标签到最后一个 </history>；整块 XML 非法时按条目标签
  * 模糊提取重建 / 无 reasoning / index 连续），失败按 maxAttempts 重试；每次尝试的
  * 结果或报错始终写入日志（成功 info / 失败 warn，失败原因说明具体问题而非解析器
- * 原始报错）；全部耗尽返回失败结果（携带最后一次尝试的实际报错）。每次请求前
+ * 原始报错）；全部耗尽返回失败结果（携带最后一次尝试的实际报错）。最终失败
+ * （含 signal 中止）时把每次尝试的完整提示词与模型原始输出经 compaction-log.ts
+ * 原样落盘为诊断子会话，sessionId 随失败结果向上传播进主会话日志。每次请求前
  * 过全局限流等待门；token usage 归入主会话记录。
  */
 import type { Agent, Context, Session, TokenUsage } from './types.ts';
@@ -32,13 +34,15 @@ export type SummarySuccess = {
     /** 成功时的尝试次数（1 起；载荷层换算为重试次数 = 该值 - 1）。 */
     attemptCount: number;
 };
-/** 摘要调用失败结果：最后一次尝试的实际报错/具体问题 + 是否因 signal 中止。 */
+/** 摘要调用失败结果：最后一次尝试的实际报错/具体问题 + 是否因 signal 中止 + 诊断子会话 id。 */
 export type SummaryFailure = {
     ok: false;
     /** 最后一次尝试的实际报错（异常消息）或未通过校验的具体问题说明。 */
     error: string;
     /** 因 signal 中止（含限流等待被中止）而放弃；此时 error 为 COMPACTION_ABORTED_ERROR。 */
     aborted: boolean;
+    /** 诊断子会话 id（最终失败时每次尝试的完整提示词与模型原始输出落盘处；落盘失败时缺失）。 */
+    diagnosticSessionId?: string;
 };
 /** 摘要调用结果（成功/失败二选一）。 */
 export type SummaryOutcome = SummarySuccess | SummaryFailure;
@@ -95,13 +99,16 @@ export declare const SUMMARY_DEFAULT_MAX_ATTEMPTS = 11;
  * 直连 LLM 执行一次摘要（观察或反思），返回文本与可选 token usage。
  * 失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）均记录日志并重试，每次尝试的
  * 结果或报错始终写入日志（成功 info / 失败 warn，不受 debug 影响）；全部尝试耗尽
- * 返回失败结果（携带最后一次尝试的实际报错/具体问题，不产生任何日志变更）。
- * signal 中止（含限流等待被中止）立即放弃并标记 aborted。每次请求发出前先过全局
- * 限流等待门。
+ * 返回失败结果（携带最后一次尝试的实际报错/具体问题）。最终失败（耗尽或 signal
+ * 中止）时把每次尝试的完整提示词与模型原始输出原样落盘为诊断子会话（phase 标注
+ * 观察或反思），诊断子会话 id 随失败结果返回。signal 中止（含限流等待被中止）
+ * 立即放弃并标记 aborted。每次请求发出前先过全局限流等待门。
  */
 export declare function runSummarySubagent(ctx: Context, agent: Agent, instruction: string, contextText: string | undefined, maxTokens: number | undefined, target: RoutedTarget, debug: boolean, signal?: AbortSignal, options?: {
     maxAttempts?: number;
     expected?: SummaryValidationRange;
     rateLimitWaitMs?: number;
+    /** 压缩 pass（诊断子会话 label 标注观察/反思；未提供时 label 回落「压缩」）。 */
+    phase?: 'observe' | 'reflect';
 }): Promise<SummaryOutcome>;
 //# sourceMappingURL=summarize.d.ts.map

package/dist/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,OAAO,KAAK,EAAE,KAAK,EAAmB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAyC3C;AA0CD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAsDhF;AAED,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC;AA2E7D,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,2oBAA6K,CAAC;AAE9M,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CASrE;AACD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBvC;AAED,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA+EtE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,sBAAsB,GAChC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA4CrC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAG/F;AAED,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAK/C;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9F,OAAO,CAAC,cAAc,CAAC,CAoFzB"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -29,6 +29,27 @@ declare module '@deepseek-ai/dsh-session/types' {
             /** 面向用户的简短说明。 */
             message: string;
         };
+        /**
+         * 观察压缩待定标记（log-only，不进 surface）：净压力首次达到观察阈值时追加，
+         * 记录触发点完整消息 index，本次不压缩；延迟等待 tailMessageCount 条新完整消息后
+         * 执行压缩（区间截至触发点）。同一会话同时至多一条活跃待定标记（key 固定 'observe'）。
+         */
+        'om/observe-pending': {
+            /** 标记键（固定 'observe'，与 om/observe-invalidate 配对）。 */
+            key: 'observe';
+            /** 触发点：追加时的最后一条完整消息 index。 */
+            triggerMessageIndex: number;
+        };
+        /**
+         * 观察压缩待定失效标记（log-only，不进 surface）：待定标记对应的压缩执行完成
+         * （成功提交或无可行区间）后追加，声明指定 pending 已失效、可重新触发观察。
+         */
+        'om/observe-invalidate': {
+            /** 标记键（固定 'observe'）。 */
+            key: 'observe';
+            /** 被失效的 om/observe-pending 事件 seq。 */
+            pendingSeq: number;
+        };
     }
 }
 /** 官方包宿主类型再导出：插件 API 与工具签名统一从这里取型。 */
@@ -79,6 +100,15 @@ export type CompactionSummaryPayload = SessionEventMap['compaction/summary'] & {
     /** 摘要重试次数（观察分块为各块重试之和，反思为尝试次数 - 1）。 */
     attemptCount?: number;
 };
+/**
+ * 插件扩展的 compaction/end 载荷：宿主类型 + diagnosticSessionId（压缩最终失败时
+ * 落盘的诊断子会话 id）。宿主 append 不做 schema 剥离，扩展字段原样持久化；
+ * 客户端读取时按可选处理（UI 渲染行为不变）。
+ */
+export type CompactionEndPayload = SessionEventMap['compaction/end'] & {
+    /** 压缩最终失败时的诊断子会话 id（落盘失败时缺失）。 */
+    diagnosticSessionId?: string;
+};
 /**
  * 插件扩展的 compaction/start 载荷：宿主类型 + phase（压缩 pass）。
  * 客户端读取时按可选处理，缺失回落通用压缩中文案。

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-om",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",