dsh-plugin-om 0.0.19 → 0.0.21

package/README.md

@@ -33,7 +33,7 @@ dsh plugin --profile <profile> add dsh-plugin-om
 ```yaml
 - id: dsh-plugin-om
   config:
-    thresholdRatio: 0.2
+    observeThresholdTokens: 100000
     # 其他配置参考下文
 ```
 
@@ -69,7 +69,7 @@ dsh的"预设"分为两层，`dsh web`等同于`dsh --profile web`，调用的
 
 - 直接改`preset-agent`的定义(不推荐)
 - 定义不含`compaction-basic`的`preset-agent`
-- `compaction-basic`压缩阈值是80%上下文窗口，而只需要确保OM的配置中，`thresholdRatio`+`historyMergeRatio`<0.8，理论上没到强制摘要就会被OM压缩了(默认值满足这一条件)
+- `compaction-basic`压缩阈值是80%上下文窗口，而OM的观察阈值是绝对 token 数（默认 `observeThresholdTokens`=100000）：模型窗口小于该值/0.8（即 12.5 万 tokens）时宿主强制摘要会先于 OM 触发，需要把 `observeThresholdTokens` 调低到窗口的 0.8 以下
 
 ## 工作原理
 
@@ -79,27 +79,28 @@ dsh的"预设"分为两层，`dsh web`等同于`dsh --profile web`，调用的
 4. 提供recall/recall-semantic两个tool进行检索
 
 观察与反思共用同一套系统提示词（buildHistoryPrompt）：输入与输出都是合法的 <history> 块（模型消息 + index 的表达形式），先定义块、要求压缩、再给出数据源（下方 <history> 消息记录）。
+观察压缩按 `observeChunkTokens` 边界把未压缩消息分块（完整消息不跨块，thinking/text/toolcall&result 同块）压缩摘要，最多 `observeChunkParallelism` 块同时进行、其余块排队，各块合并为一个 <history> 块提交；提示词按块位次分档——前块要求简单摘要，最后一块要求「越往后越细」保留细节。任一摘要请求遇 429 限流后，插件全局进入冷却期：后续所有摘要请求在 `rateLimitWaitMs` 内不会发出。
 
 ### 压缩日志块结构
 
 - 观察压缩只精确替换被压缩的新消息区间：旧 <history> 块保留为独立消息，新观察日志作为新块追加在其后（多块并存按序排列），历史不会随压缩次数膨胀；反思合并时才把多个块合并为一条更紧凑的摘要
 - 压缩边界：消息列表中最后一个合法的 <history> 块（source 为插件，plugin 为插件标识 `dsh-plugin-om`；兼容旧日志的宿主 checkpoint 标记 `compact`）之后的消息视为未压缩；其前（含自身）视为已压缩，不重复压缩、不计入观察阈值
 - 观察输入经 `@xmldom/xmldom` 构建为合法 <history> 块（用户消息文本/assistant 文本/reasoning 特殊字符自动转义，图片/文件以注释补充；assistant 文本与 toolcall&result 原样；系统消息——user_message 中 source.kind 非 user 的部分，如宿主注入的上下文——渲染为 <sys type="KIND" index="N"></sys> 空块，内容不进入压缩输入）
-- 输出经 `@xmldom/xmldom` 解析校验：结构合法（标签匹配/闭合/单块）、不含 <reasoning>、index/start/end 连续（与预期覆盖区间一致），失败按 `compressRetryCount` 重试
+- 输出经 `@xmldom/xmldom` 解析校验：结构合法（标签匹配/闭合/单块）、不含 <reasoning>、index/start/end 连续（与预期覆盖区间一致），失败按 `compressRetryCount` 重试；观察分块时每块独立校验（预期覆盖各自 index 区间，失败按 `compressRetryCount` 重试），各块校验通过后再合并为一个 <history> 块提交
 - 块开标签带 `tip` 属性（对 AI 的提醒："当前块是历史消息的压缩产物，不要复述"）；块顶为构成逻辑注释（完整消息定义串 + 条目标签语义），消息正文不再附加前缀句
-- 压缩生命周期：每次摘要调用前先追加 `compaction/start`（载荷带 `phase`：`observe`/观察 或 `reflect`/反思，客户端据此渲染「正在压缩上下文（观察/反思）…」提示行）；摘要成功提交 summary + 替换消息 + end，summary 载荷带 `attemptCount`（第几次尝试成功）；摘要失败或重试耗尽时追加 `compaction/end(error)` 关闭生命周期（不产生 summary/替换），客户端随之撤回提示行
+- 压缩生命周期：每次摘要调用前先追加 `compaction/start`（载荷带 `phase`：`observe`/观察 或 `reflect`/反思，客户端据此渲染「正在压缩上下文（观察/反思）…」提示行）；摘要成功提交 summary + 替换消息 + end，summary 载荷带 `attemptCount`（重试次数；观察分块为各块重试之和，反思为尝试次数 - 1）；摘要失败或重试耗尽时追加 `compaction/end(error)` 关闭生命周期（不产生 summary/替换），客户端随之撤回提示行
 
 ### 压缩卡片（消息列表中的「已压缩」展示）
 
 插件自产的替换消息使用插件自身标记（source.plugin = `dsh-plugin-om`）；宿主 conversation UI 只识别内置的 `compact` 检查点，因此插件额外注册一个浏览器客户端 bundle（`src/client/`，经 `dsh.client` 声明、exports["./client"] → `dist/client.js`，由 dsh 客户端模块系统按 `/plugins/dsh-plugin-om/client.js` 加载），自行认领压缩生命周期事件与替换检查点，在消息列表渲染折叠式「已压缩」卡片：
 
 - 卡片默认折叠，采用与宿主「上下文注入」卡片同款样式：同一 DisclosureRow 外壳组件 + IconBrowseOutline16 图标，行内统计与展开体样式按宿主 ContextInjectionRow 的规则注入（插件 bundle 无法引用宿主编译期哈希的 CSS Module 类名，按宿主 client bundle 的同一机制注入 <style>），视觉一致
-- 标题直接展示「压缩前 N 条消息 · X 字符（约 A tokens）→ 压缩后 Y 字符（约 B tokens）」：压缩前字符数来自插件扩展 shadowedCharCount，压缩前 token 来自 shadowedTokenCount，压缩后字符数为摘要文本长度，压缩后 token 在客户端按 4 字符 ≈ 1 token 估算（与服务端 estimateTextTokens 同一启发式）；旧会话载荷缺少 shadowedCharCount 时回落为「已压缩 N 条历史记录（约 M tokens）」
+- 标题直接展示紧凑统计「N 条 · X 字符（A tokens）→ Y 字符（B tokens）」，数字按 k/w/M 单位化（≥1k 用 k、≥1w 用 w、≥1M 用 M，如 8.6k/3.5w/1.2M）：压缩前字符数来自插件扩展 shadowedCharCount，压缩前 token 来自 shadowedTokenCount，压缩后字符数为摘要文本长度，压缩后 token 在客户端按 4 字符 ≈ 1 token 估算（与服务端 estimateTextTokens 同一启发式）；旧会话载荷缺少 shadowedCharCount 时回落为「已压缩 N 条历史记录（约 M tokens）」
 - 点击展开显示压缩摘要文本，按代码块样式呈现（缩小字号、代码背景与等宽字体、保留换行）
 - summary 事件落在当前加载窗口之外时卡片不可展开（不显示空内容）
 - 卡片只认领插件自产的检查点（source.plugin = `dsh-plugin-om`）；宿主 `compact` 检查点仍由宿主自己渲染，不会出现双卡片
 - 压缩进行中（`compaction/start` 已到、summary/检查点未到）：渲染不可展开的「正在压缩上下文（观察/反思）…」提示行，按 start 载荷的 `phase` 区分文案（旧会话无 phase 时回落通用文案）；压缩失败收到 `compaction/end` 时以 hidden 可见性撤回提示行
-- summary 载荷带 `attemptCount`（第几次尝试成功）时，重试次数 > 0 在标题统计行追加「重试 N 次」（首次成功不显示；旧载荷无 attemptCount 时不显示）
+- summary 载荷带 `attemptCount`（重试次数）时，重试次数 > 0 在标题统计行追加「重试 N 次」（无重试不显示；旧载荷无 attemptCount 时不显示）
 - 平台模块（react / cordis / ui-primitives / ui-slots 等）走宿主冻结模块表（保持 external），其余依赖内联进 bundle
 
 ### 注意
@@ -119,9 +120,13 @@ dsh的"预设"分为两层，`dsh web`等同于`dsh --profile web`，调用的
 
 | 键                      | 默认     | 含义                                                                                                                                                                         |
 | ----------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `thresholdRatio`        | `0.1`    | 观察阈值：未压缩消息 ≥ 窗口 × 该比例触发压缩                                                                                                                                 |
-| `historyMergeRatio`     | `0.2`    | 反思阈值：全部 <history> 块总长 ≥ 窗口 × 该比例触发精简合并                                                                                                                                   |
-| `compressMaxTokens`     | `10000`  | 单次摘要（观察/反思调用）生成上限                                                                                                                                            |
+| `observeThresholdTokens` | `100000` | 观察阈值（tokens）：未压缩消息 token 估算 ≥ 该值时触发观察压缩                                                                                                              |
+| `reflectThresholdTokens` | `30000`  | 反思阈值（tokens）：全部 <history> 块 token 估算合计 ≥ 该值时触发精简合并                                                                                                            |
+| `compressMaxTokens`     | `10000`  | 反思（合并调用）生成上限；观察分块用 `observeChunkMaxTokens`                                                                                                                  |
+| `observeChunkTokens`    | `30000`  | 观察分块 token 边界：未压缩消息按该边界拆分为多块并行压缩（完整消息不跨块）                                                                                                  |
+| `observeChunkMaxTokens` | `5000`   | 观察分块单块摘要的生成上限（每块独立调用）                                                                                                                                  |
+| `observeChunkParallelism` | `2`    | 观察分块压缩的最大并行数：同时进行的单块摘要调用上限，其余块排队（`1` 即串行）                                                                                              |
+| `rateLimitWaitMs`       | `60000`  | 遇 429 限流后，下一次摘要请求发出前至少等待的毫秒数（插件全局共享冷却期：任一请求遇 429 后，所有后续摘要请求——含并行中的其他块——都等满该时长；`0` 视为不限流）                |
 | `tailMessageCount`      | `10`     | 尾部保留的不压缩消息条数（不压缩、不被替换、不进摘要日志）                                                                                                                   |
 | `compressRetryCount`    | `10`     | 摘要调用失败后的最大重试次数（不含首次；总尝试次数 = 该值 + 1）                                                                                                              |
 | `modelDir`              | 共享目录 | recall-semantic 嵌入模型目录（默认 `$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>`，跨插件版本共享；小文件随包分发并在缺失时自动补齐，onnx 缺失且启用语义召回时运行时自动下载到该目录；可指向自定义目录） |
@@ -130,7 +135,7 @@ dsh的"预设"分为两层，`dsh web`等同于`dsh --profile web`，调用的
 | `recallEnabled`         | `true`   | 是否注册 `recall` 工具（`false` 时禁用，不注册）                                                                                                                             |
 | `semanticRecallEnabled` | `true`   | 是否注册 `recall-semantic` 工具（`false` 时禁用，不注册、不触发模型下载）                                                                                                    |
 
-> 不建议将thresholdRatio设置的过高，越早OM收益越高，且当前的机制需要模型对消息计数，过多的消息会导致历史混乱
+> 不建议将观察阈值设置得过高：越早 OM 收益越高，且当前的机制需要模型对消息计数，过多的消息会导致历史混乱
 
 ### 关于配置项变更的说明
 
@@ -167,8 +172,8 @@ src/
 │   │                └─▶ model-download.ts          # 模型下载原语（URL/跳过判定/原子落盘；dev CLI 复用）
 │   └─ ④ 事件接线（仅主会话生效）
 │        └─ ctx.on('agent/pre-step') → compress.ts  # maybeCompress：两级压缩阻塞串行（先反思后观察；turn 中间即可触发）
-│              ├─ reflectPass → summarize.ts        # 全部 <history> 块总长 ≥ 窗口 × historyMergeRatio：多块拼接 + 共享提示词合并整个块区段
-│              ├─ observePass  → summarize.ts       # 未压缩消息 ≥ 窗口 × thresholdRatio：渲染 <history> 输入 → 观察日志 → 追加 + 替换
+│              ├─ reflectPass → summarize.ts        # 全部 <history> 块 token 估算 ≥ reflectThresholdTokens：多块拼接 + 共享提示词合并整个块区段
+│              ├─ observePass  → summarize.ts       # 未压缩消息 token 估算 ≥ observeThresholdTokens：渲染 <history> 输入 → 观察日志 → 追加 + 替换
 │              └─ 提交          → compress.ts        # compaction/start(摘要调用前，载荷 phase) → summary(attemptCount) → 替换消息(source 插件标识 + compactionId) → end；失败补 end(error)；usage 归入主会话
 ├── constants.ts              # 共享常量（PLUGIN_LABEL / HISTORY_TAG / HISTORY_TIP / COMPLETE_MESSAGE_DEFINITION / COMPACT_CHECKPOINT_PLUGIN）
 ├── types.ts                  # type-only：宿主类型再导出 + 领域类型（MessageNode / MessageIndex）
@@ -177,10 +182,11 @@ src/
 ├── log-index.ts              # 完整消息索引（index 定位 user/sys/assistant/具有result的toolcall；user_message 按 source.kind 分类：kind:user 为用户消息、其余为系统消息；本插件自产压缩日志消息不占位；未闭合 tool-call 不占位；recall 与摘要共用）
 ├── embedding.ts              # 本地 ONNX 嵌入（@huggingface/transformers + 本地模型；共享目录解析 / 小文件补齐 / 运行时按需下载编排 / 懒加载 / 批量 / cosine）
 ├── model-download.ts          # 模型下载原语（modelSourceUrl / needsDownload / 原子落盘 / 开始结束日志与失败镜像建议；运行时与 dev CLI 共用）
-├── summarize.ts              # 共享提示词 buildHistoryPrompt（观察/反思同一套）+ renderMessages（@xmldom/xmldom 构建 <history> 块输入：用户消息原样、系统消息渲染为 <sys> 空块、自动转义）+ 直连 ctx.llm.stream() 摘要（new 方式：指令作 system、输入为渲染消息；extractSummaryLog 提取校验：XML 结构合法 / 无 reasoning / index 连续 / 覆盖区间；重试与流式 usage 归入主会话；成功返回 attemptCount 供卡片展示重试次数）
+├── summarize.ts              # 共享提示词 buildHistoryPrompt（观察/反思同一套；mode 控制摘要粒度：summary 简单摘要 / detailed 越往后越细）+ renderMessages（@xmldom/xmldom 构建 <history> 块输入：用户消息原样、系统消息渲染为 <sys> 空块、自动转义）+ 直连 ctx.llm.stream() 摘要（new 方式：指令作 system、输入为渲染消息；extractSummaryLog 提取校验：XML 结构合法 / 无 reasoning / index 连续 / 覆盖区间；重试与流式 usage 归入主会话；每次请求前过全局限流等待门 rate-limit.ts；成功返回 attemptCount（尝试次数，载荷层换算为重试次数））
+├── rate-limit.ts             # 全局限流门（插件进程级共享状态）：429 识别（isRateLimitError）/ 冷却期记录（noteRateLimit）/ 等待门（gateRateLimit：最近一次 429 + rateLimitWaitMs 之前不放行，等待期间中止立即放弃，新 429 顺延冷却期）
 ├── recall.ts                 # recall 工具
 ├── semantic-recall.ts        # recall-semantic 工具（query 语义检索 + 区间限定 + 回退全量 + 匹配说明）
-└── compress.ts               # 两级自动压缩（测量 / mid-turn 区间计算 / 配对平衡回退 / source 标记判定摘要消息 / compaction/* 生命周期事件：start 在摘要调用前追加并带 phase，失败补 end(error) + 替换消息 source 插件标识）
+└── compress.ts               # 两级自动压缩（测量 / mid-turn 区间计算 / 配对平衡回退 / source 标记判定摘要消息 / 观察分块经 runWithConcurrency 有界并发池逐块压缩 + 合并 mergeChunkReports / compaction/* 生命周期事件：start 在摘要调用前追加并带 phase，失败补 end(error) + 替换消息 source 插件标识）
 src/client/
 ├── index.ts                   # 浏览器客户端入口（exports["./client"] → dist/client.js）：注入 slots/conversationEvents/locale，注册卡片定义与渲染器
 ├── definition.ts              # 压缩卡片业务定义：认领插件生命周期事件与替换检查点（source.plugin = dsh-plugin-om），聚合摘要卡片节点；start→压缩中提示行（running+phase）、end→hidden 撤回、summary→卡片（retryCount）

package/dist/client/OmCompactionCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OmCompactionCard.d.ts","sourceRoot":"","sources":["../../src/client/OmCompactionCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACzC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;CAC1C;AAgCD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,oDAA+C,qBAAqB,iCA+F/F,CAAC"}
+{"version":3,"file":"OmCompactionCard.d.ts","sourceRoot":"","sources":["../../src/client/OmCompactionCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAKpE,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACzC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;CAC1C;AAgCD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,oDAA+C,qBAAqB,iCAuF/F,CAAC"}

package/dist/client/definition.d.ts

@@ -38,7 +38,7 @@ export interface OmCompactionChatData {
     readonly summaryCharCount: number | null;
     /** 压缩后的估算 token 数（4 字符 ≈ 1 token，与服务端 estimateTextTokens 同一启发式），summary 不可用或非法时为 null。 */
     readonly summaryTokenCount: number | null;
-    /** 摘要调用重试次数（= 载荷 attemptCount - 1；载荷缺失或非法时为 null）。 */
+    /** 摘要调用重试次数（载荷 attemptCount 即重试次数；缺失或非法时为 null）。 */
     readonly retryCount: number | null;
 }
 /** 压缩生命周期关联状态：summary / checkpoint / end 事件证据。 */

package/dist/client/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/client/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,0BAA0B,EAC3B,MAAM,wCAAwC,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAInE,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,OAAO,QAAQ,gDAAgD,CAAC;IAC9D,UAAU,eAAe;QACvB,sCAAsC;QACtC,eAAe,EAAE,oBAAoB,CAAC;KACvC;CACF;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7C,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,4CAA4C;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0FAA0F;IAC1F,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,kDAAkD;AAClD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAgBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAe9E;AA0GD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,0BAA0B,CAAC,iBAAiB,CAuDhF,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/client/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,0BAA0B,EAC3B,MAAM,wCAAwC,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAInE,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,OAAO,QAAQ,gDAAgD,CAAC;IAC9D,UAAU,eAAe;QACvB,sCAAsC;QACtC,eAAe,EAAE,oBAAoB,CAAC;KACvC;CACF;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7C,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,4CAA4C;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0FAA0F;IAC1F,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,kDAAkD;AAClD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAgBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAe9E;AA0GD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,0BAA0B,CAAC,iBAAiB,CAuDhF,CAAC"}

package/dist/client/format.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 压缩卡片统计行的紧凑数字格式：<1k 原样；≥1k 用 k；≥1w（万）用 w；≥1M 用 M。
+ * 保留 1 位小数并去掉末尾的 .0（如 8642 → 8.6k、34567 → 3.5w、1234567 → 1.2M）。
+ */
+export declare function formatCompactCount(value: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/client/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/client/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxD"}

package/dist/client/locales.d.ts

@@ -10,7 +10,7 @@ export declare const NS = "om-compaction";
 export declare const zh: {
     readonly compaction: "上下文已压缩";
     readonly 'compaction.completed': "已压缩 {items} 条历史记录（约 {tokens} tokens）";
-    readonly 'compaction.stats': "压缩前 {items} 条消息 · {beforeChars} 字符（约 {beforeTokens} tokens）→ 压缩后 {afterChars} 字符（约 {afterTokens} tokens）";
+    readonly 'compaction.stats': "{items} 条 · {beforeChars} 字符（{beforeTokens} tokens）→ {afterChars} 字符（{afterTokens} tokens）";
     readonly 'compaction.expand': "点击查看压缩摘要";
     readonly 'compaction.unavailable': "压缩摘要不可用";
     readonly 'compaction.running': "正在压缩上下文…";

package/dist/client.js

@@ -47,7 +47,7 @@ window.__ModuleLoader__.load({
 				shadowedItemCount = Array.isArray(data.shadowedSeqs) && data.shadowedSeqs.every((seq) => Number.isSafeInteger(seq) && seq >= 0) ? data.shadowedSeqs.length : null;
 				shadowedTokenCount = Number.isSafeInteger(data.shadowedTokenCount) && data.shadowedTokenCount >= 0 ? data.shadowedTokenCount : null;
 				shadowedCharCount = data.shadowedCharCount !== void 0 && Number.isSafeInteger(data.shadowedCharCount) && data.shadowedCharCount >= 0 ? data.shadowedCharCount : null;
-				retryCount = data.attemptCount !== void 0 && Number.isSafeInteger(data.attemptCount) && data.attemptCount >= 1 ? data.attemptCount - 1 : null;
+				retryCount = data.attemptCount !== void 0 && Number.isSafeInteger(data.attemptCount) && data.attemptCount >= 0 ? data.attemptCount : null;
 			}
 			return {
 				running: false,
@@ -170,7 +170,7 @@ window.__ModuleLoader__.load({
 		const zh = {
 			compaction: "上下文已压缩",
 			"compaction.completed": "已压缩 {items} 条历史记录（约 {tokens} tokens）",
-			"compaction.stats": "压缩前 {items} 条消息 · {beforeChars} 字符（约 {beforeTokens} tokens）→ 压缩后 {afterChars} 字符（约 {afterTokens} tokens）",
+			"compaction.stats": "{items} 条 · {beforeChars} 字符（{beforeTokens} tokens）→ {afterChars} 字符（{afterTokens} tokens）",
 			"compaction.expand": "点击查看压缩摘要",
 			"compaction.unavailable": "压缩摘要不可用",
 			"compaction.running": "正在压缩上下文…",
@@ -182,7 +182,7 @@ window.__ModuleLoader__.load({
 		const en = {
 			compaction: "Context compacted",
 			"compaction.completed": "Compacted {items} messages (~{tokens} tokens)",
-			"compaction.stats": "{items} messages · {beforeChars} chars (~{beforeTokens} tokens) before → {afterChars} chars (~{afterTokens} tokens) after",
+			"compaction.stats": "{items} msgs · {beforeChars} chars ({beforeTokens} tokens) → {afterChars} chars ({afterTokens} tokens)",
 			"compaction.expand": "Click to view summary",
 			"compaction.unavailable": "Summary unavailable",
 			"compaction.running": "Compressing context…",
@@ -191,6 +191,23 @@ window.__ModuleLoader__.load({
 			"compaction.retries": "Retried {count} times"
 		};
 		//#endregion
+		//#region src/client/format.ts
+		/**
+		* 压缩卡片统计行的紧凑数字格式：<1k 原样；≥1k 用 k；≥1w（万）用 w；≥1M 用 M。
+		* 保留 1 位小数并去掉末尾的 .0（如 8642 → 8.6k、34567 → 3.5w、1234567 → 1.2M）。
+		*/
+		function formatCompactCount(value) {
+			/** 保留 1 位小数并去掉末尾 .0。 */
+			const trim = (n) => {
+				const text = String(Math.round(n * 10) / 10);
+				return text.endsWith(".0") ? text.slice(0, -2) : text;
+			};
+			if (value >= 1e6) return `${trim(value / 1e6)}M`;
+			if (value >= 1e4) return `${trim(value / 1e4)}w`;
+			if (value >= 1e3) return `${trim(value / 1e3)}k`;
+			return String(value);
+		}
+		//#endregion
 		//#region src/client/OmCompactionCard.tsx
 		/** 卡片样式类名（与宿主 ContextInjectionRow.module.css 同款规则，见下方注册）。 */
 		const css = {
@@ -228,33 +245,25 @@ window.__ModuleLoader__.load({
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DisclosureRow, {
 						className: css.root,
 						icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconBrowseOutline16, { size: 14 }),
-						title: t("compaction"),
+						title: runningLabel,
 						open: false,
 						expandable: false,
-						onToggle: () => {},
-						collapsedContent: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: css.sep,
-							"aria-hidden": true
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: css.summary,
-							"data-om-compaction-running": true,
-							children: runningLabel
-						})] })
+						onToggle: () => {}
 					})
 				});
 			}
 			const expandable = data.summary !== null;
 			const open = expandable && expanded;
-			/** 统计行文案（重试次数仅在有重试时追加；retryCount 缺失视为未重试）。 */
+			/** 统计行文案（数字按 k/w/M 单位化；重试次数仅在有重试时追加；retryCount 缺失视为未重试）。 */
 			const stats = data.shadowedItemCount !== null && data.shadowedCharCount !== null && data.shadowedTokenCount !== null && data.summaryCharCount !== null && data.summaryTokenCount !== null ? t("compaction.stats", {
-				items: data.shadowedItemCount,
-				beforeChars: data.shadowedCharCount,
-				beforeTokens: data.shadowedTokenCount,
-				afterChars: data.summaryCharCount,
-				afterTokens: data.summaryTokenCount
+				items: formatCompactCount(data.shadowedItemCount),
+				beforeChars: formatCompactCount(data.shadowedCharCount),
+				beforeTokens: formatCompactCount(data.shadowedTokenCount),
+				afterChars: formatCompactCount(data.summaryCharCount),
+				afterTokens: formatCompactCount(data.summaryTokenCount)
 			}) : data.shadowedItemCount !== null && data.shadowedTokenCount !== null ? t("compaction.completed", {
-				items: data.shadowedItemCount,
-				tokens: data.shadowedTokenCount
+				items: formatCompactCount(data.shadowedItemCount),
+				tokens: formatCompactCount(data.shadowedTokenCount)
 			}) : expandable ? t("compaction.expand") : t("compaction.unavailable");
 			const retry = data.retryCount !== null && data.retryCount > 0 ? ` \u00b7 ${t("compaction.retries", { count: data.retryCount })}` : "";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["memo","useState","DisclosureRow","IconBrowseOutline16"],"sources":["../src/constants.ts","../src/client/definition.ts","../src/client/locales.ts","../src/client/OmCompactionCard.tsx","../src/client/index.ts"],"sourcesContent":["/**\n * 共享常量：集中定义插件级魔法字符串与事件名，避免散落各模块。\n */\n\n/** 插件标识：压缩消息 source.plugin 取值（注入压缩日志的来源标记）与日志前缀。 */\nexport const PLUGIN_LABEL = 'dsh-plugin-om';\n\n/** 压缩日志标签名：<history>...</history> 包裹观察/反思日志块（输入与输出均为合法 history 块）。 */\nexport const HISTORY_TAG = 'history';\n\n/** 压缩日志块开标签上的 tip 属性（对 AI 的提醒：本块是历史压缩产物，不要复述）。 */\nexport const HISTORY_TIP = '当前块是历史消息的压缩产物，不要复述';\n\n/**\n * 「完整消息」定义（提示词 / recall 工具描述 / 块顶注释共用同一字符串）。\n * 完整消息是摘要日志与 recall 共用的定位单位；首条 index 为 0，按会话顺序递增、全局稳定。\n * 用户消息指 user_message 中 source.kind 为 user 的部分；其余部分（宿主注入的上下文等）\n * 为系统消息，同样是一条完整消息。\n */\nexport const COMPLETE_MESSAGE_DEFINITION =\n  '`完整消息`被定义为`用户消息`，`系统消息`，`模型输出文本`和`具有result的toolcall`的集合。首条`完整消息`的index是0，后续的index递增。';\n\n/** 判定 user/message 的 source 是否为本插件自产（压缩日志机制消息；含兼容旧宿主 checkpoint 标记 'compact'）。这类消息不占完整消息 index。 */\nexport function isPluginOwnedSource(\n  source: { kind?: string; plugin?: string } | undefined,\n): boolean {\n  if (source?.kind !== 'plugin') return false;\n  return source.plugin === PLUGIN_LABEL || source.plugin === COMPACT_CHECKPOINT_PLUGIN;\n}\n\n/** 旧日志压缩消息的宿主 checkpoint 标记 plugin 名（dsh-compaction-basic 的 COMPACT_CHECKPOINT_MARKER.plugin；历史兼容识别用）。 */\nexport const COMPACT_CHECKPOINT_PLUGIN = 'compact';\n","/**\n * 压缩卡片业务定义：认领插件自产的压缩生命周期事件与替换检查点，\n * 聚合出可渲染的摘要卡片节点。\n *\n * 宿主 conversation 客户端仅识别 source.plugin === 'compact' 的压缩检查点\n * （ui-conversation 的 compactionDefinition），插件自产的检查点标记为\n * PLUGIN_LABEL（'dsh-plugin-om'），由本定义认领。生命周期事件（compaction/start\n * |summary|end）同时会被宿主的 compactionDefinition 匹配，但宿主没有检查点证据\n * 时不产出节点（buildViewNode 返回 null），因此双方共存无视觉冲突。\n */\n\nimport type {\n  ConversationMatch,\n  ConversationNodeContext,\n  ConversationNodeDefinition,\n} from '@deepseek-ai/dsh-client-runtime/client';\nimport type { ChatNode, ChatNodeDataMap } from '@deepseek-ai/dsh-client-ui-conversation/client';\nimport type {} from '@deepseek-ai/dsh-compaction/types';\nimport type { SessionEvent } from '@deepseek-ai/dsh-session/types';\nimport { PLUGIN_LABEL } from '../constants.ts';\nimport type { CompactionSummaryPayload } from '../types.ts';\n\n/** 压缩卡片渲染器分发键（合并进 ChatNodeDataMap）。 */\nexport const COMPACTION_CARD_KIND = 'om-compaction';\n\ndeclare module '@deepseek-ai/dsh-client-ui-conversation/client' {\n  interface ChatNodeDataMap {\n    /** dsh-plugin-om 压缩替换检查点渲染的摘要卡片数据。 */\n    'om-compaction': OmCompactionChatData;\n  }\n}\n\n/** 压缩卡片载荷：摘要文本与遮蔽统计（seq/time 由节点本体提供，不重复存放）。 */\nexport interface OmCompactionChatData {\n  /** 压缩进行中（compaction/start 已到、checkpoint/end 未到）：渲染为「正在压缩上下文…」提示行。 */\n  readonly running: boolean;\n  /** 压缩 pass（观察/反思；来自 start 事件载荷的插件扩展，缺失或非运行态为 null）。 */\n  readonly phase: 'observe' | 'reflect' | null;\n  /** compaction/summary 的文本摘要；窗口裁剪把该事件留在窗外时为 null（卡片不可展开）。 */\n  readonly summary: string | null;\n  /** 已载入的 compaction/summary 事件 seq，窗外时为 null。 */\n  readonly summaryEventSeq: number | null;\n  /** 被遮蔽的表层节点数，summary 事件缺失或载荷非法时为 null。 */\n  readonly shadowedItemCount: number | null;\n  /** 遮蔽的 token 数，summary 事件缺失或载荷非法时为 null。 */\n  readonly shadowedTokenCount: number | null;\n  /** 压缩前的字符数（被压缩内容文本长度合计），载荷缺失或非法时为 null。 */\n  readonly shadowedCharCount: number | null;\n  /** 压缩后的字符数（摘要文本长度），summary 不可用或非法时为 null。 */\n  readonly summaryCharCount: number | null;\n  /** 压缩后的估算 token 数（4 字符 ≈ 1 token，与服务端 estimateTextTokens 同一启发式），summary 不可用或非法时为 null。 */\n  readonly summaryTokenCount: number | null;\n  /** 摘要调用重试次数（= 载荷 attemptCount - 1；载荷缺失或非法时为 null）。 */\n  readonly retryCount: number | null;\n}\n\n/** 压缩生命周期关联状态：summary / checkpoint / end 事件证据。 */\ninterface OmCompactionState {\n  readonly summary?: ConversationMatch;\n  readonly checkpoint?: ConversationMatch;\n  /** compaction/end（成功与失败都会到达；无 checkpoint 的 end 表示压缩失败，撤回进行中提示行）。 */\n  readonly end?: ConversationMatch;\n}\n\n/**\n * replace-surface 判定：surfaceOp 为 { op: 'replace' } 对象（与宿主 runtime 的\n * isReplacementSurfaceEvent 同义）。宿主该助手位于浏览器 bundle 内\n * （window.__ModuleLoader__ 闭包），node 端测试无法求值，故本地实现同一形状检查。\n */\nfunction isReplacementSurface(event: SessionEvent): boolean {\n  const surfaceOp = (event as { surfaceOp?: unknown }).surfaceOp;\n  return (\n    typeof surfaceOp === 'object' &&\n    surfaceOp !== null &&\n    (surfaceOp as { op?: unknown }).op === 'replace'\n  );\n}\n\n/**\n * 从压缩替换检查点（user/message + replace surface + source.plugin 为本插件）\n * 读取关联 identity。宿主的 'compact' 检查点由宿主自己渲染，本插件不认领，\n * 避免同一压缩出现两张卡片。\n */\nexport function checkpointCompactionId(event: SessionEvent): string | undefined {\n  if (event.type !== 'user/message' || !isReplacementSurface(event)) return undefined;\n  const data = event.data as unknown as {\n    source?: { kind?: unknown; plugin?: unknown; compactionId?: unknown };\n  };\n  const source = data.source;\n  if (\n    source === undefined ||\n    source.kind !== 'plugin' ||\n    source.plugin !== PLUGIN_LABEL ||\n    typeof source.compactionId !== 'string'\n  ) {\n    return undefined;\n  }\n  return source.compactionId;\n}\n\n/** 从 compaction/summary 载荷提取摘要文本与遮蔽统计（载荷非法时各字段回落 null）。 */\nfunction compactSummaryData(summaryMatch: ConversationMatch | undefined): OmCompactionChatData {\n  let summary: string | null = null;\n  let shadowedItemCount: number | null = null;\n  let shadowedTokenCount: number | null = null;\n  let shadowedCharCount: number | null = null;\n  let retryCount: number | null = null;\n  if (summaryMatch?.event.type === 'compaction/summary') {\n    // 宿主载荷类型是 union 且不含插件扩展字段，读取处收窄为插件扩展类型\n    const data = summaryMatch.event.data as CompactionSummaryPayload;\n    if (Array.isArray(data.summary)) {\n      const text = data.summary.map((block) => (block.type === 'text' ? block.text : '')).join('');\n      summary = text.trim() === '' ? null : text;\n    }\n    shadowedItemCount =\n      Array.isArray(data.shadowedSeqs) &&\n      data.shadowedSeqs.every((seq) => Number.isSafeInteger(seq) && seq >= 0)\n        ? data.shadowedSeqs.length\n        : null;\n    shadowedTokenCount =\n      Number.isSafeInteger(data.shadowedTokenCount) && data.shadowedTokenCount >= 0\n        ? data.shadowedTokenCount\n        : null;\n    shadowedCharCount =\n      data.shadowedCharCount !== undefined &&\n      Number.isSafeInteger(data.shadowedCharCount) &&\n      data.shadowedCharCount >= 0\n        ? data.shadowedCharCount\n        : null;\n    retryCount =\n      data.attemptCount !== undefined &&\n      Number.isSafeInteger(data.attemptCount) &&\n      data.attemptCount >= 1\n        ? data.attemptCount - 1\n        : null;\n  }\n  return {\n    running: false,\n    phase: null,\n    summary,\n    summaryEventSeq: summaryMatch?.event.seq ?? null,\n    shadowedItemCount,\n    shadowedTokenCount,\n    shadowedCharCount,\n    summaryCharCount: summary === null ? null : summary.length,\n    summaryTokenCount: summary === null ? null : Math.ceil(summary.length / 4),\n    retryCount,\n  };\n}\n\n/** 压缩进行中提示行的载荷（统计未就绪，全部为 null；phase 取自 start 事件载荷扩展，缺失回退 null）。 */\nfunction runningData(start: ConversationMatch | undefined): OmCompactionChatData {\n  /** start 事件载荷（phase 为插件扩展；非法值回退 null）。 */\n  const data = start?.event.data as { phase?: unknown } | undefined;\n  /** 合法 phase（观察/反思）。 */\n  const phase = data?.phase === 'observe' || data?.phase === 'reflect' ? data.phase : null;\n  return {\n    running: true,\n    phase,\n    summary: null,\n    summaryEventSeq: null,\n    shadowedItemCount: null,\n    shadowedTokenCount: null,\n    shadowedCharCount: null,\n    summaryCharCount: null,\n    summaryTokenCount: null,\n    retryCount: null,\n  };\n}\n\n/** 窗口只载入部分事件时的回落证据扫描（summary / 检查点 / end 各自独立）。 */\nfunction fallbackState(context: ConversationNodeContext<OmCompactionState>): OmCompactionState {\n  const summary = context.matches.find((match) => match.event.type === 'compaction/summary');\n  const checkpoint = context.matches.find(\n    (match) => checkpointCompactionId(match.event) !== undefined,\n  );\n  const end = context.matches.find((match) => match.event.type === 'compaction/end');\n  return {\n    ...(summary === undefined ? {} : { summary }),\n    ...(checkpoint === undefined ? {} : { checkpoint }),\n    ...(end === undefined ? {} : { end }),\n  };\n}\n\n/** 构建最终 Chat 目标节点（与 ui-conversation 的 chatNode 助手同构）。 */\nfunction chatNode<Kind extends keyof ChatNodeDataMap & string>(\n  context: ConversationNodeContext,\n  kind: Kind,\n  anchorSeq: number,\n  data: ChatNodeDataMap[Kind],\n  visibility: 'visible' | 'hidden' = 'visible',\n): ChatNode<Kind> {\n  return {\n    key: context.key,\n    kind,\n    id: context.id,\n    target: 'chat',\n    anchorSeq,\n    location: context.start?.location ?? context.matches[0]?.location ?? { kind: 'unresolved' },\n    visibility,\n    data,\n  };\n}\n\n/**\n * 插件压缩生命周期定义：compaction/start 开启上下文，summary / 替换检查点 /\n * end 作为 update 折叠证据；仅在存在替换检查点时产出卡片节点。\n */\nexport const omCompactionDefinition: ConversationNodeDefinition<OmCompactionState> = {\n  kind: COMPACTION_CARD_KIND,\n  target: 'chat',\n  match: (event) => {\n    const compactionId = checkpointCompactionId(event);\n    if (compactionId !== undefined) return { id: compactionId, role: 'update' };\n    if (\n      event.type === 'compaction/start' ||\n      event.type === 'compaction/summary' ||\n      event.type === 'compaction/end'\n    ) {\n      const id: unknown = event.data.compactionId;\n      if (typeof id !== 'string' || id === '') return null;\n      return { id, role: event.type === 'compaction/start' ? 'start' : 'update' };\n    }\n    return null;\n  },\n  start: () => ({}),\n  update: (context, match) => {\n    if (match.event.type === 'compaction/summary') return { ...context.state, summary: match };\n    if (match.event.type === 'compaction/end') return { ...context.state, end: match };\n    if (checkpointCompactionId(match.event) !== undefined)\n      return { ...context.state, checkpoint: match };\n    return context.state;\n  },\n  buildViewNode: (context) => {\n    const state = context.state ?? fallbackState(context);\n    // 替换检查点已到达 → 压缩完成，渲染摘要卡片（摘要统计就绪）\n    if (state.checkpoint !== undefined) {\n      const data = compactSummaryData(state.summary);\n      return chatNode(context, COMPACTION_CARD_KIND, state.checkpoint.event.seq, data);\n    }\n    // end 已到达但无检查点 → 压缩失败/中止：撤回进行中提示行——\n    // 已物化节点不能撤回，以 hidden visibility 保留同一 key（聊天视图按可见节点过滤，行从消息流消失）\n    if (state.end !== undefined) {\n      const anchorSeq = context.start?.event.seq ?? state.end.event.seq;\n      return chatNode(\n        context,\n        COMPACTION_CARD_KIND,\n        anchorSeq,\n        runningData(context.start),\n        'hidden',\n      );\n    }\n    // start 已到、checkpoint/end 未到 → 压缩进行中，渲染「正在压缩上下文…」提示行\n    if (context.start !== undefined) {\n      return chatNode(\n        context,\n        COMPACTION_CARD_KIND,\n        context.start.event.seq,\n        runningData(context.start),\n      );\n    }\n    return null;\n  },\n};\n","/**\n * `om-compaction` namespace dictionaries: 插件压缩卡片的界面文案。\n *\n * 与宿主 conversation 命名空间分离（独立 NS），插件卡片走自己的 keyed 渲染器，\n * 文案键不与对话插件的键冲突。\n */\n\n/** Dictionary namespace owned by this plugin. */\nexport const NS = 'om-compaction';\n\n/** Simplified Chinese dictionary (the key-set source of truth). */\nexport const zh = {\n  compaction: '上下文已压缩',\n  'compaction.completed': '已压缩 {items} 条历史记录（约 {tokens} tokens）',\n  'compaction.stats':\n    '压缩前 {items} 条消息 · {beforeChars} 字符（约 {beforeTokens} tokens）→ 压缩后 {afterChars} 字符（约 {afterTokens} tokens）',\n  'compaction.expand': '点击查看压缩摘要',\n  'compaction.unavailable': '压缩摘要不可用',\n  'compaction.running': '正在压缩上下文…',\n  'compaction.running.observe': '正在压缩上下文（观察）…',\n  'compaction.running.reflect': '正在压缩上下文（反思）…',\n  'compaction.retries': '重试 {count} 次',\n} as const;\n\n/** English dictionary（键集与 zh 一致）。 */\nexport const en: Record<keyof typeof zh, string> = {\n  compaction: 'Context compacted',\n  'compaction.completed': 'Compacted {items} messages (~{tokens} tokens)',\n  'compaction.stats':\n    '{items} messages · {beforeChars} chars (~{beforeTokens} tokens) before → {afterChars} chars (~{afterTokens} tokens) after',\n  'compaction.expand': 'Click to view summary',\n  'compaction.unavailable': 'Summary unavailable',\n  'compaction.running': 'Compressing context…',\n  'compaction.running.observe': 'Compressing context (observation)…',\n  'compaction.running.reflect': 'Compressing context (reflection)…',\n  'compaction.retries': 'Retried {count} times',\n};\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** Compaction card copy owned by dsh-plugin-om. */\n    'om-compaction': keyof typeof zh;\n  }\n}\n","/**\n * dsh-plugin-om 压缩卡片渲染器：与宿主「上下文注入」卡片同款的折叠行。\n *\n * 复用平台原语 DisclosureRow（宿主 ContextInjectionRow 用的同一外壳组件）；行内\n * 统计与展开体样式按宿主 ContextInjectionRow.module.css 的规则注入——宿主该卡片\n * 的样式是编译期哈希的 CSS Module，插件 bundle 无法引用其类名，故按宿主 client\n * bundle 的同一机制（注入 <style>）注册逐字一致的规则，保证视觉同款。\n *\n * 压缩检查点遮蔽的是模型可见表层，人类转录中的历史仍在其上方；卡片只报告\n * 模型从何处起不再看到那段历史。summary 来自检查点引用的 compaction/summary\n * 事件；窗口裁剪把该事件留在窗外时，行不可展开而不是显示空内容。\n */\n\nimport type { ChatNode } from '@deepseek-ai/dsh-client-ui-conversation/client';\nimport { DisclosureRow, IconBrowseOutline16 } from '@deepseek-ai/dsh-client-ui-primitives';\nimport type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';\nimport type { CSSProperties } from 'react';\nimport { memo, useState } from 'react';\n\n/** Keyed renderer props: 装配好的卡片节点 + 绑定 `om-compaction` 命名空间的 locale 座。 */\nexport interface OmCompactionCardProps {\n  readonly node: ChatNode<'om-compaction'>;\n  readonly t: TranslateNS<'om-compaction'>;\n}\n\n/** 卡片样式类名（与宿主 ContextInjectionRow.module.css 同款规则，见下方注册）。 */\nconst css = {\n  root: 'om-compaction-root',\n  chevron: 'om-compaction-chevron',\n  sep: 'om-compaction-sep',\n  summary: 'om-compaction-summary',\n  body: 'om-compaction-body',\n} as const;\n\n/** 宿主 ContextInjectionRow.module.css 的规则（逐字一致，仅类名按插件前缀）。 */\nconst cardCss = `\n.${css.root}{min-width:0}\n.${css.root}[data-open]{padding-bottom:4px}\n.${css.chevron}{color:var(--dsw-alias-label-secondary)}\n.${css.sep}{background:var(--dsw-alias-label-caption);border-radius:1px;flex:none;width:2px;height:2px;margin:0 8px}\n.${css.summary}{min-width:0;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;flex:auto;font-size:14px;line-height:24px;overflow:hidden}\n.${css.body}{box-sizing:border-box;background:var(--dsw-alias-markdown-code-block);width:calc(100% - 22px);max-height:141px;color:var(--dsw-alias-label-tertiary);font:400 11px/16px var(--ds-font-family-code);border:none;border-radius:8px;margin:4px 0 0 22px;padding:10px 16px 12px 12px;overflow:auto}\n`;\n\n/** 注册卡片样式（与宿主 client bundle 同机制；无 document 的环境如 node 测试直接跳过）。 */\nif (\n  typeof document !== 'undefined' &&\n  document.querySelector('style[data-dsh-plugin-om-card]') === null\n) {\n  const tag = document.createElement('style');\n  tag.dataset.dshPluginOmCard = 'true';\n  tag.textContent = cardCss;\n  document.head.appendChild(tag);\n}\n\n/** 折叠式压缩卡片（统计标题行 + 代码块样式 summary 展开，同「上下文注入」卡片）。 */\nexport const OmCompactionCard = memo(function OmCompactionCard({ node, t }: OmCompactionCardProps) {\n  const [expanded, setExpanded] = useState(false);\n  const { data } = node;\n  // 压缩进行中：start 已到、checkpoint/end 未到 → 不可展开的「正在压缩上下文…」提示行\n  if (data.running) {\n    /** 提示行文案（按 phase 区分观察/反思；缺失回退通用文案）。 */\n    const runningLabel =\n      data.phase === 'observe'\n        ? t('compaction.running.observe')\n        : data.phase === 'reflect'\n          ? t('compaction.running.reflect')\n          : t('compaction.running');\n    return (\n      <div style={styles.row}>\n        <DisclosureRow\n          className={css.root}\n          icon={<IconBrowseOutline16 size={14} />}\n          title={t('compaction')}\n          open={false}\n          expandable={false}\n          onToggle={() => {\n            /* 进行中提示行不可展开 */\n          }}\n          collapsedContent={\n            <>\n              <span className={css.sep} aria-hidden />\n              <span className={css.summary} data-om-compaction-running>\n                {runningLabel}\n              </span>\n            </>\n          }\n        />\n      </div>\n    );\n  }\n  const expandable = data.summary !== null;\n  const open = expandable && expanded;\n  /** 统计行文案（重试次数仅在有重试时追加；retryCount 缺失视为未重试）。 */\n  const stats =\n    data.shadowedItemCount !== null &&\n    data.shadowedCharCount !== null &&\n    data.shadowedTokenCount !== null &&\n    data.summaryCharCount !== null &&\n    data.summaryTokenCount !== null\n      ? t('compaction.stats', {\n          items: data.shadowedItemCount,\n          beforeChars: data.shadowedCharCount,\n          beforeTokens: data.shadowedTokenCount,\n          afterChars: data.summaryCharCount,\n          afterTokens: data.summaryTokenCount,\n        })\n      : data.shadowedItemCount !== null && data.shadowedTokenCount !== null\n        ? t('compaction.completed', {\n            items: data.shadowedItemCount,\n            tokens: data.shadowedTokenCount,\n          })\n        : expandable\n          ? t('compaction.expand')\n          : t('compaction.unavailable');\n  const retry =\n    data.retryCount !== null && data.retryCount > 0\n      ? ` \\u00b7 ${t('compaction.retries', { count: data.retryCount })}`\n      : '';\n  return (\n    <div style={styles.row}>\n      <DisclosureRow\n        className={css.root}\n        icon={<IconBrowseOutline16 size={14} />}\n        chevronClassName={css.chevron}\n        title={t('compaction')}\n        collapsedContent={\n          <>\n            <span className={css.sep} aria-hidden />\n            <span className={css.summary} data-om-compaction-summary>\n              {stats}\n              {retry}\n            </span>\n          </>\n        }\n        keepContentWhenOpen\n        expandable={expandable}\n        expandOnRowClick\n        open={open}\n        onToggle={() => {\n          setExpanded((value) => !value);\n        }}\n      >\n        {data.summary !== null && (\n          <div className={css.body} style={styles.body}>\n            {data.summary}\n          </div>\n        )}\n      </DisclosureRow>\n    </div>\n  );\n});\n\nconst styles: Record<string, CSSProperties> = {\n  row: {},\n  /** 摘要为 <history> 文本，保留换行（宿主 body 的白色空间由内容形态各自处理）。 */\n  body: { whiteSpace: 'pre-wrap' },\n};\n","/**\n * dsh-plugin-om 浏览器客户端贡献：压缩卡片。\n *\n * 服务端压缩替换消息继续使用插件自身的检查点标记（source.plugin =\n * 'dsh-plugin-om'）；宿主 conversation UI 只识别内置的 'compact' 标记，因此本\n * bundle 自行注册一条 conversation 业务定义 + keyed 渲染器，认领插件的压缩\n * 生命周期事件与替换检查点，在消息列表渲染「已压缩」卡片。\n */\nimport type { Context } from '@deepseek-ai/cordis';\n// Type-only: 拉取 locale 插件的 Context 合并（ctx.locale）。\nimport type {} from '@deepseek-ai/dsh-client-locale/client';\n// Type-only: 拉取 runtime 的 Context 合并（ctx.conversationEvents）。\nimport type {} from '@deepseek-ai/dsh-client-runtime/client';\n// Type-only: 'conversation.chat.node' 的 SlotMap 行与 ChatNodeDataMap 声明合并\n// （均由 ui-conversation 声明），注册调用才得以类型化。\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client';\nimport { omCompactionDefinition } from './definition.ts';\nimport { en, NS, zh } from './locales.ts';\nimport { OmCompactionCard } from './OmCompactionCard.tsx';\n\n/** Required services: 聊天节点槽、会话事件注册表与 locale 服务。 */\nexport const inject = ['slots', 'conversationEvents', 'locale'];\n\n/**\n * Client plugin body: 注册压缩卡片的业务定义与 keyed 渲染器。\n * 注册挂在 effect 包装器上，插件卸载时随之移除。\n * @param ctx - client root context.\n */\nexport function apply(ctx: Context): void {\n  ctx.effect(\n    () => ctx.locale.register(NS, { zh, en }),\n    'dsh-plugin-om: compaction card dictionaries',\n  );\n  ctx.effect(\n    () => ctx.conversationEvents.register(omCompactionDefinition),\n    'dsh-plugin-om: compaction definition',\n  );\n  ctx.slots.inject('conversation.chat.node', () =>\n    ctx.slots.register(\n      { name: 'conversation.chat.node', key: 'om-compaction', locale: NS },\n      OmCompactionCard,\n    ),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":["memo","useState","DisclosureRow","IconBrowseOutline16"],"sources":["../src/constants.ts","../src/client/definition.ts","../src/client/locales.ts","../src/client/format.ts","../src/client/OmCompactionCard.tsx","../src/client/index.ts"],"sourcesContent":["/**\n * 共享常量：集中定义插件级魔法字符串与事件名，避免散落各模块。\n */\n\n/** 插件标识：压缩消息 source.plugin 取值（注入压缩日志的来源标记）与日志前缀。 */\nexport const PLUGIN_LABEL = 'dsh-plugin-om';\n\n/** 压缩日志标签名：<history>...</history> 包裹观察/反思日志块（输入与输出均为合法 history 块）。 */\nexport const HISTORY_TAG = 'history';\n\n/** 压缩日志块开标签上的 tip 属性（对 AI 的提醒：本块是历史压缩产物，不要复述）。 */\nexport const HISTORY_TIP = '当前块是历史消息的压缩产物，不要复述';\n\n/**\n * 「完整消息」定义（提示词 / recall 工具描述 / 块顶注释共用同一字符串）。\n * 完整消息是摘要日志与 recall 共用的定位单位；首条 index 为 0，按会话顺序递增、全局稳定。\n * 用户消息指 user_message 中 source.kind 为 user 的部分；其余部分（宿主注入的上下文等）\n * 为系统消息，同样是一条完整消息。\n */\nexport const COMPLETE_MESSAGE_DEFINITION =\n  '`完整消息`被定义为`用户消息`，`系统消息`，`模型输出文本`和`具有result的toolcall`的集合。首条`完整消息`的index是0，后续的index递增。';\n\n/** 判定 user/message 的 source 是否为本插件自产（压缩日志机制消息；含兼容旧宿主 checkpoint 标记 'compact'）。这类消息不占完整消息 index。 */\nexport function isPluginOwnedSource(\n  source: { kind?: string; plugin?: string } | undefined,\n): boolean {\n  if (source?.kind !== 'plugin') return false;\n  return source.plugin === PLUGIN_LABEL || source.plugin === COMPACT_CHECKPOINT_PLUGIN;\n}\n\n/** 旧日志压缩消息的宿主 checkpoint 标记 plugin 名（dsh-compaction-basic 的 COMPACT_CHECKPOINT_MARKER.plugin；历史兼容识别用）。 */\nexport const COMPACT_CHECKPOINT_PLUGIN = 'compact';\n","/**\n * 压缩卡片业务定义：认领插件自产的压缩生命周期事件与替换检查点，\n * 聚合出可渲染的摘要卡片节点。\n *\n * 宿主 conversation 客户端仅识别 source.plugin === 'compact' 的压缩检查点\n * （ui-conversation 的 compactionDefinition），插件自产的检查点标记为\n * PLUGIN_LABEL（'dsh-plugin-om'），由本定义认领。生命周期事件（compaction/start\n * |summary|end）同时会被宿主的 compactionDefinition 匹配，但宿主没有检查点证据\n * 时不产出节点（buildViewNode 返回 null），因此双方共存无视觉冲突。\n */\n\nimport type {\n  ConversationMatch,\n  ConversationNodeContext,\n  ConversationNodeDefinition,\n} from '@deepseek-ai/dsh-client-runtime/client';\nimport type { ChatNode, ChatNodeDataMap } from '@deepseek-ai/dsh-client-ui-conversation/client';\nimport type {} from '@deepseek-ai/dsh-compaction/types';\nimport type { SessionEvent } from '@deepseek-ai/dsh-session/types';\nimport { PLUGIN_LABEL } from '../constants.ts';\nimport type { CompactionSummaryPayload } from '../types.ts';\n\n/** 压缩卡片渲染器分发键（合并进 ChatNodeDataMap）。 */\nexport const COMPACTION_CARD_KIND = 'om-compaction';\n\ndeclare module '@deepseek-ai/dsh-client-ui-conversation/client' {\n  interface ChatNodeDataMap {\n    /** dsh-plugin-om 压缩替换检查点渲染的摘要卡片数据。 */\n    'om-compaction': OmCompactionChatData;\n  }\n}\n\n/** 压缩卡片载荷：摘要文本与遮蔽统计（seq/time 由节点本体提供，不重复存放）。 */\nexport interface OmCompactionChatData {\n  /** 压缩进行中（compaction/start 已到、checkpoint/end 未到）：渲染为「正在压缩上下文…」提示行。 */\n  readonly running: boolean;\n  /** 压缩 pass（观察/反思；来自 start 事件载荷的插件扩展，缺失或非运行态为 null）。 */\n  readonly phase: 'observe' | 'reflect' | null;\n  /** compaction/summary 的文本摘要；窗口裁剪把该事件留在窗外时为 null（卡片不可展开）。 */\n  readonly summary: string | null;\n  /** 已载入的 compaction/summary 事件 seq，窗外时为 null。 */\n  readonly summaryEventSeq: number | null;\n  /** 被遮蔽的表层节点数，summary 事件缺失或载荷非法时为 null。 */\n  readonly shadowedItemCount: number | null;\n  /** 遮蔽的 token 数，summary 事件缺失或载荷非法时为 null。 */\n  readonly shadowedTokenCount: number | null;\n  /** 压缩前的字符数（被压缩内容文本长度合计），载荷缺失或非法时为 null。 */\n  readonly shadowedCharCount: number | null;\n  /** 压缩后的字符数（摘要文本长度），summary 不可用或非法时为 null。 */\n  readonly summaryCharCount: number | null;\n  /** 压缩后的估算 token 数（4 字符 ≈ 1 token，与服务端 estimateTextTokens 同一启发式），summary 不可用或非法时为 null。 */\n  readonly summaryTokenCount: number | null;\n  /** 摘要调用重试次数（载荷 attemptCount 即重试次数；缺失或非法时为 null）。 */\n  readonly retryCount: number | null;\n}\n\n/** 压缩生命周期关联状态：summary / checkpoint / end 事件证据。 */\ninterface OmCompactionState {\n  readonly summary?: ConversationMatch;\n  readonly checkpoint?: ConversationMatch;\n  /** compaction/end（成功与失败都会到达；无 checkpoint 的 end 表示压缩失败，撤回进行中提示行）。 */\n  readonly end?: ConversationMatch;\n}\n\n/**\n * replace-surface 判定：surfaceOp 为 { op: 'replace' } 对象（与宿主 runtime 的\n * isReplacementSurfaceEvent 同义）。宿主该助手位于浏览器 bundle 内\n * （window.__ModuleLoader__ 闭包），node 端测试无法求值，故本地实现同一形状检查。\n */\nfunction isReplacementSurface(event: SessionEvent): boolean {\n  const surfaceOp = (event as { surfaceOp?: unknown }).surfaceOp;\n  return (\n    typeof surfaceOp === 'object' &&\n    surfaceOp !== null &&\n    (surfaceOp as { op?: unknown }).op === 'replace'\n  );\n}\n\n/**\n * 从压缩替换检查点（user/message + replace surface + source.plugin 为本插件）\n * 读取关联 identity。宿主的 'compact' 检查点由宿主自己渲染，本插件不认领，\n * 避免同一压缩出现两张卡片。\n */\nexport function checkpointCompactionId(event: SessionEvent): string | undefined {\n  if (event.type !== 'user/message' || !isReplacementSurface(event)) return undefined;\n  const data = event.data as unknown as {\n    source?: { kind?: unknown; plugin?: unknown; compactionId?: unknown };\n  };\n  const source = data.source;\n  if (\n    source === undefined ||\n    source.kind !== 'plugin' ||\n    source.plugin !== PLUGIN_LABEL ||\n    typeof source.compactionId !== 'string'\n  ) {\n    return undefined;\n  }\n  return source.compactionId;\n}\n\n/** 从 compaction/summary 载荷提取摘要文本与遮蔽统计（载荷非法时各字段回落 null）。 */\nfunction compactSummaryData(summaryMatch: ConversationMatch | undefined): OmCompactionChatData {\n  let summary: string | null = null;\n  let shadowedItemCount: number | null = null;\n  let shadowedTokenCount: number | null = null;\n  let shadowedCharCount: number | null = null;\n  let retryCount: number | null = null;\n  if (summaryMatch?.event.type === 'compaction/summary') {\n    // 宿主载荷类型是 union 且不含插件扩展字段，读取处收窄为插件扩展类型\n    const data = summaryMatch.event.data as CompactionSummaryPayload;\n    if (Array.isArray(data.summary)) {\n      const text = data.summary.map((block) => (block.type === 'text' ? block.text : '')).join('');\n      summary = text.trim() === '' ? null : text;\n    }\n    shadowedItemCount =\n      Array.isArray(data.shadowedSeqs) &&\n      data.shadowedSeqs.every((seq) => Number.isSafeInteger(seq) && seq >= 0)\n        ? data.shadowedSeqs.length\n        : null;\n    shadowedTokenCount =\n      Number.isSafeInteger(data.shadowedTokenCount) && data.shadowedTokenCount >= 0\n        ? data.shadowedTokenCount\n        : null;\n    shadowedCharCount =\n      data.shadowedCharCount !== undefined &&\n      Number.isSafeInteger(data.shadowedCharCount) &&\n      data.shadowedCharCount >= 0\n        ? data.shadowedCharCount\n        : null;\n    retryCount =\n      data.attemptCount !== undefined &&\n      Number.isSafeInteger(data.attemptCount) &&\n      data.attemptCount >= 0\n        ? data.attemptCount\n        : null;\n  }\n  return {\n    running: false,\n    phase: null,\n    summary,\n    summaryEventSeq: summaryMatch?.event.seq ?? null,\n    shadowedItemCount,\n    shadowedTokenCount,\n    shadowedCharCount,\n    summaryCharCount: summary === null ? null : summary.length,\n    summaryTokenCount: summary === null ? null : Math.ceil(summary.length / 4),\n    retryCount,\n  };\n}\n\n/** 压缩进行中提示行的载荷（统计未就绪，全部为 null；phase 取自 start 事件载荷扩展，缺失回退 null）。 */\nfunction runningData(start: ConversationMatch | undefined): OmCompactionChatData {\n  /** start 事件载荷（phase 为插件扩展；非法值回退 null）。 */\n  const data = start?.event.data as { phase?: unknown } | undefined;\n  /** 合法 phase（观察/反思）。 */\n  const phase = data?.phase === 'observe' || data?.phase === 'reflect' ? data.phase : null;\n  return {\n    running: true,\n    phase,\n    summary: null,\n    summaryEventSeq: null,\n    shadowedItemCount: null,\n    shadowedTokenCount: null,\n    shadowedCharCount: null,\n    summaryCharCount: null,\n    summaryTokenCount: null,\n    retryCount: null,\n  };\n}\n\n/** 窗口只载入部分事件时的回落证据扫描（summary / 检查点 / end 各自独立）。 */\nfunction fallbackState(context: ConversationNodeContext<OmCompactionState>): OmCompactionState {\n  const summary = context.matches.find((match) => match.event.type === 'compaction/summary');\n  const checkpoint = context.matches.find(\n    (match) => checkpointCompactionId(match.event) !== undefined,\n  );\n  const end = context.matches.find((match) => match.event.type === 'compaction/end');\n  return {\n    ...(summary === undefined ? {} : { summary }),\n    ...(checkpoint === undefined ? {} : { checkpoint }),\n    ...(end === undefined ? {} : { end }),\n  };\n}\n\n/** 构建最终 Chat 目标节点（与 ui-conversation 的 chatNode 助手同构）。 */\nfunction chatNode<Kind extends keyof ChatNodeDataMap & string>(\n  context: ConversationNodeContext,\n  kind: Kind,\n  anchorSeq: number,\n  data: ChatNodeDataMap[Kind],\n  visibility: 'visible' | 'hidden' = 'visible',\n): ChatNode<Kind> {\n  return {\n    key: context.key,\n    kind,\n    id: context.id,\n    target: 'chat',\n    anchorSeq,\n    location: context.start?.location ?? context.matches[0]?.location ?? { kind: 'unresolved' },\n    visibility,\n    data,\n  };\n}\n\n/**\n * 插件压缩生命周期定义：compaction/start 开启上下文，summary / 替换检查点 /\n * end 作为 update 折叠证据；仅在存在替换检查点时产出卡片节点。\n */\nexport const omCompactionDefinition: ConversationNodeDefinition<OmCompactionState> = {\n  kind: COMPACTION_CARD_KIND,\n  target: 'chat',\n  match: (event) => {\n    const compactionId = checkpointCompactionId(event);\n    if (compactionId !== undefined) return { id: compactionId, role: 'update' };\n    if (\n      event.type === 'compaction/start' ||\n      event.type === 'compaction/summary' ||\n      event.type === 'compaction/end'\n    ) {\n      const id: unknown = event.data.compactionId;\n      if (typeof id !== 'string' || id === '') return null;\n      return { id, role: event.type === 'compaction/start' ? 'start' : 'update' };\n    }\n    return null;\n  },\n  start: () => ({}),\n  update: (context, match) => {\n    if (match.event.type === 'compaction/summary') return { ...context.state, summary: match };\n    if (match.event.type === 'compaction/end') return { ...context.state, end: match };\n    if (checkpointCompactionId(match.event) !== undefined)\n      return { ...context.state, checkpoint: match };\n    return context.state;\n  },\n  buildViewNode: (context) => {\n    const state = context.state ?? fallbackState(context);\n    // 替换检查点已到达 → 压缩完成，渲染摘要卡片（摘要统计就绪）\n    if (state.checkpoint !== undefined) {\n      const data = compactSummaryData(state.summary);\n      return chatNode(context, COMPACTION_CARD_KIND, state.checkpoint.event.seq, data);\n    }\n    // end 已到达但无检查点 → 压缩失败/中止：撤回进行中提示行——\n    // 已物化节点不能撤回，以 hidden visibility 保留同一 key（聊天视图按可见节点过滤，行从消息流消失）\n    if (state.end !== undefined) {\n      const anchorSeq = context.start?.event.seq ?? state.end.event.seq;\n      return chatNode(\n        context,\n        COMPACTION_CARD_KIND,\n        anchorSeq,\n        runningData(context.start),\n        'hidden',\n      );\n    }\n    // start 已到、checkpoint/end 未到 → 压缩进行中，渲染「正在压缩上下文…」提示行\n    if (context.start !== undefined) {\n      return chatNode(\n        context,\n        COMPACTION_CARD_KIND,\n        context.start.event.seq,\n        runningData(context.start),\n      );\n    }\n    return null;\n  },\n};\n","/**\n * `om-compaction` namespace dictionaries: 插件压缩卡片的界面文案。\n *\n * 与宿主 conversation 命名空间分离（独立 NS），插件卡片走自己的 keyed 渲染器，\n * 文案键不与对话插件的键冲突。\n */\n\n/** Dictionary namespace owned by this plugin. */\nexport const NS = 'om-compaction';\n\n/** Simplified Chinese dictionary (the key-set source of truth). */\nexport const zh = {\n  compaction: '上下文已压缩',\n  'compaction.completed': '已压缩 {items} 条历史记录（约 {tokens} tokens）',\n  'compaction.stats':\n    '{items} 条 · {beforeChars} 字符（{beforeTokens} tokens）→ {afterChars} 字符（{afterTokens} tokens）',\n  'compaction.expand': '点击查看压缩摘要',\n  'compaction.unavailable': '压缩摘要不可用',\n  'compaction.running': '正在压缩上下文…',\n  'compaction.running.observe': '正在压缩上下文（观察）…',\n  'compaction.running.reflect': '正在压缩上下文（反思）…',\n  'compaction.retries': '重试 {count} 次',\n} as const;\n\n/** English dictionary（键集与 zh 一致）。 */\nexport const en: Record<keyof typeof zh, string> = {\n  compaction: 'Context compacted',\n  'compaction.completed': 'Compacted {items} messages (~{tokens} tokens)',\n  'compaction.stats':\n    '{items} msgs · {beforeChars} chars ({beforeTokens} tokens) → {afterChars} chars ({afterTokens} tokens)',\n  'compaction.expand': 'Click to view summary',\n  'compaction.unavailable': 'Summary unavailable',\n  'compaction.running': 'Compressing context…',\n  'compaction.running.observe': 'Compressing context (observation)…',\n  'compaction.running.reflect': 'Compressing context (reflection)…',\n  'compaction.retries': 'Retried {count} times',\n};\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** Compaction card copy owned by dsh-plugin-om. */\n    'om-compaction': keyof typeof zh;\n  }\n}\n","/**\n * 压缩卡片统计行的紧凑数字格式：<1k 原样；≥1k 用 k；≥1w（万）用 w；≥1M 用 M。\n * 保留 1 位小数并去掉末尾的 .0（如 8642 → 8.6k、34567 → 3.5w、1234567 → 1.2M）。\n */\nexport function formatCompactCount(value: number): string {\n  /** 保留 1 位小数并去掉末尾 .0。 */\n  const trim = (n: number): string => {\n    const text = String(Math.round(n * 10) / 10);\n    return text.endsWith('.0') ? text.slice(0, -2) : text;\n  };\n  if (value >= 1_000_000) return `${trim(value / 1_000_000)}M`;\n  if (value >= 10_000) return `${trim(value / 10_000)}w`;\n  if (value >= 1_000) return `${trim(value / 1_000)}k`;\n  return String(value);\n}\n","/**\n * dsh-plugin-om 压缩卡片渲染器：与宿主「上下文注入」卡片同款的折叠行。\n *\n * 复用平台原语 DisclosureRow（宿主 ContextInjectionRow 用的同一外壳组件）；行内\n * 统计与展开体样式按宿主 ContextInjectionRow.module.css 的规则注入——宿主该卡片\n * 的样式是编译期哈希的 CSS Module，插件 bundle 无法引用其类名，故按宿主 client\n * bundle 的同一机制（注入 <style>）注册逐字一致的规则，保证视觉同款。\n *\n * 压缩检查点遮蔽的是模型可见表层，人类转录中的历史仍在其上方；卡片只报告\n * 模型从何处起不再看到那段历史。summary 来自检查点引用的 compaction/summary\n * 事件；窗口裁剪把该事件留在窗外时，行不可展开而不是显示空内容。\n */\n\nimport type { ChatNode } from '@deepseek-ai/dsh-client-ui-conversation/client';\nimport { DisclosureRow, IconBrowseOutline16 } from '@deepseek-ai/dsh-client-ui-primitives';\nimport type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';\nimport type { CSSProperties } from 'react';\nimport { memo, useState } from 'react';\nimport { formatCompactCount } from './format.ts';\n\n/** Keyed renderer props: 装配好的卡片节点 + 绑定 `om-compaction` 命名空间的 locale 座。 */\nexport interface OmCompactionCardProps {\n  readonly node: ChatNode<'om-compaction'>;\n  readonly t: TranslateNS<'om-compaction'>;\n}\n\n/** 卡片样式类名（与宿主 ContextInjectionRow.module.css 同款规则，见下方注册）。 */\nconst css = {\n  root: 'om-compaction-root',\n  chevron: 'om-compaction-chevron',\n  sep: 'om-compaction-sep',\n  summary: 'om-compaction-summary',\n  body: 'om-compaction-body',\n} as const;\n\n/** 宿主 ContextInjectionRow.module.css 的规则（逐字一致，仅类名按插件前缀）。 */\nconst cardCss = `\n.${css.root}{min-width:0}\n.${css.root}[data-open]{padding-bottom:4px}\n.${css.chevron}{color:var(--dsw-alias-label-secondary)}\n.${css.sep}{background:var(--dsw-alias-label-caption);border-radius:1px;flex:none;width:2px;height:2px;margin:0 8px}\n.${css.summary}{min-width:0;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;flex:auto;font-size:14px;line-height:24px;overflow:hidden}\n.${css.body}{box-sizing:border-box;background:var(--dsw-alias-markdown-code-block);width:calc(100% - 22px);max-height:141px;color:var(--dsw-alias-label-tertiary);font:400 11px/16px var(--ds-font-family-code);border:none;border-radius:8px;margin:4px 0 0 22px;padding:10px 16px 12px 12px;overflow:auto}\n`;\n\n/** 注册卡片样式（与宿主 client bundle 同机制；无 document 的环境如 node 测试直接跳过）。 */\nif (\n  typeof document !== 'undefined' &&\n  document.querySelector('style[data-dsh-plugin-om-card]') === null\n) {\n  const tag = document.createElement('style');\n  tag.dataset.dshPluginOmCard = 'true';\n  tag.textContent = cardCss;\n  document.head.appendChild(tag);\n}\n\n/** 折叠式压缩卡片（统计标题行 + 代码块样式 summary 展开，同「上下文注入」卡片）。 */\nexport const OmCompactionCard = memo(function OmCompactionCard({ node, t }: OmCompactionCardProps) {\n  const [expanded, setExpanded] = useState(false);\n  const { data } = node;\n  // 压缩进行中：start 已到、checkpoint/end 未到 → 不可展开的「正在压缩上下文…」提示行\n  if (data.running) {\n    /** 提示行文案（按 phase 区分观察/反思；缺失回退通用文案）。 */\n    const runningLabel =\n      data.phase === 'observe'\n        ? t('compaction.running.observe')\n        : data.phase === 'reflect'\n          ? t('compaction.running.reflect')\n          : t('compaction.running');\n    return (\n      <div style={styles.row}>\n        <DisclosureRow\n          className={css.root}\n          icon={<IconBrowseOutline16 size={14} />}\n          title={runningLabel}\n          open={false}\n          expandable={false}\n          onToggle={() => {\n            /* 进行中提示行不可展开 */\n          }}\n        />\n      </div>\n    );\n  }\n  const expandable = data.summary !== null;\n  const open = expandable && expanded;\n  /** 统计行文案（数字按 k/w/M 单位化；重试次数仅在有重试时追加；retryCount 缺失视为未重试）。 */\n  const stats =\n    data.shadowedItemCount !== null &&\n    data.shadowedCharCount !== null &&\n    data.shadowedTokenCount !== null &&\n    data.summaryCharCount !== null &&\n    data.summaryTokenCount !== null\n      ? t('compaction.stats', {\n          items: formatCompactCount(data.shadowedItemCount),\n          beforeChars: formatCompactCount(data.shadowedCharCount),\n          beforeTokens: formatCompactCount(data.shadowedTokenCount),\n          afterChars: formatCompactCount(data.summaryCharCount),\n          afterTokens: formatCompactCount(data.summaryTokenCount),\n        })\n      : data.shadowedItemCount !== null && data.shadowedTokenCount !== null\n        ? t('compaction.completed', {\n            items: formatCompactCount(data.shadowedItemCount),\n            tokens: formatCompactCount(data.shadowedTokenCount),\n          })\n        : expandable\n          ? t('compaction.expand')\n          : t('compaction.unavailable');\n  const retry =\n    data.retryCount !== null && data.retryCount > 0\n      ? ` \\u00b7 ${t('compaction.retries', { count: data.retryCount })}`\n      : '';\n  return (\n    <div style={styles.row}>\n      <DisclosureRow\n        className={css.root}\n        icon={<IconBrowseOutline16 size={14} />}\n        chevronClassName={css.chevron}\n        title={t('compaction')}\n        collapsedContent={\n          <>\n            <span className={css.sep} aria-hidden />\n            <span className={css.summary} data-om-compaction-summary>\n              {stats}\n              {retry}\n            </span>\n          </>\n        }\n        keepContentWhenOpen\n        expandable={expandable}\n        expandOnRowClick\n        open={open}\n        onToggle={() => {\n          setExpanded((value) => !value);\n        }}\n      >\n        {data.summary !== null && (\n          <div className={css.body} style={styles.body}>\n            {data.summary}\n          </div>\n        )}\n      </DisclosureRow>\n    </div>\n  );\n});\n\nconst styles: Record<string, CSSProperties> = {\n  row: {},\n  /** 摘要为 <history> 文本，保留换行（宿主 body 的白色空间由内容形态各自处理）。 */\n  body: { whiteSpace: 'pre-wrap' },\n};\n","/**\n * dsh-plugin-om 浏览器客户端贡献：压缩卡片。\n *\n * 服务端压缩替换消息继续使用插件自身的检查点标记（source.plugin =\n * 'dsh-plugin-om'）；宿主 conversation UI 只识别内置的 'compact' 标记，因此本\n * bundle 自行注册一条 conversation 业务定义 + keyed 渲染器，认领插件的压缩\n * 生命周期事件与替换检查点，在消息列表渲染「已压缩」卡片。\n */\nimport type { Context } from '@deepseek-ai/cordis';\n// Type-only: 拉取 locale 插件的 Context 合并（ctx.locale）。\nimport type {} from '@deepseek-ai/dsh-client-locale/client';\n// Type-only: 拉取 runtime 的 Context 合并（ctx.conversationEvents）。\nimport type {} from '@deepseek-ai/dsh-client-runtime/client';\n// Type-only: 'conversation.chat.node' 的 SlotMap 行与 ChatNodeDataMap 声明合并\n// （均由 ui-conversation 声明），注册调用才得以类型化。\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client';\nimport { omCompactionDefinition } from './definition.ts';\nimport { en, NS, zh } from './locales.ts';\nimport { OmCompactionCard } from './OmCompactionCard.tsx';\n\n/** Required services: 聊天节点槽、会话事件注册表与 locale 服务。 */\nexport const inject = ['slots', 'conversationEvents', 'locale'];\n\n/**\n * Client plugin body: 注册压缩卡片的业务定义与 keyed 渲染器。\n * 注册挂在 effect 包装器上，插件卸载时随之移除。\n * @param ctx - client root context.\n */\nexport function apply(ctx: Context): void {\n  ctx.effect(\n    () => ctx.locale.register(NS, { zh, en }),\n    'dsh-plugin-om: compaction card dictionaries',\n  );\n  ctx.effect(\n    () => ctx.conversationEvents.register(omCompactionDefinition),\n    'dsh-plugin-om: compaction definition',\n  );\n  ctx.slots.inject('conversation.chat.node', () =>\n    ctx.slots.register(\n      { name: 'conversation.chat.node', key: 'om-compaction', locale: NS },\n      OmCompactionCard,\n    ),\n  );\n}\n"],"mappings":"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"}

package/dist/compress.d.ts

@@ -1,7 +1,24 @@
-import type { Agent, Context, PluginConfig, Session } from './types.ts';
+import type { Agent, CompleteMessage, Context, PluginConfig, Session } from './types.ts';
 import { type RoutedTarget } from './utils.ts';
 /** 历史文本 token 估算：4 字符 ≈ 1 token（与宿主 dsh-token-meter 启发式一致）。 */
 export declare function estimateTextTokens(text: string): number;
+/**
+ * 有界并发池：最多 limit 个任务同时运行（limit 非法时按 1 处理），任务按 index 顺序
+ * 取用，结果数组与 items 按 index 对齐（任务自身以返回值表达失败，不在此抛出）。
+ * items 为空返回空数组。
+ */
+export declare function runWithConcurrency<T, R>(items: readonly T[], limit: number, task: (item: T, index: number) => Promise<R>): Promise<R[]>;
+/**
+ * 按 token 边界把完整消息序列分块（观察并行压缩用）：完整消息不跨块——
+ * 一条完整消息（含其 thinking/text/toolcall&result 全部 seqs）必然整体落在同一块，
+ * 单条超界的消息独立成块。空输入返回空数组。
+ */
+export declare function chunkCompleteMessages<M>(session: Session, cms: readonly CompleteMessage[], tokenBoundary: number, estimateMessage: (message: M) => number): CompleteMessage[][];
+/**
+ * 合并分块摘要为单个 <history> 块：剥离各块的 <history> 开/闭标签（保留块内全部内容），
+ * 以统一的开标签（带 tip 属性）与闭标签包裹拼接。块内内容原样保留（含格式说明注释）。
+ */
+export declare function mergeChunkReports(parts: readonly string[]): string;
 /** token 估算器的结构类型（仅需 estimateMessage；避免依赖完整 TokenMeter 接口）。 */
 export type TokenEstimator = {
     estimateMessage(message: unknown): number;
@@ -43,16 +60,16 @@ export declare function historySection(session: Session): {
     boundarySeq: number | undefined;
 };
 /**
- * 反思：全部 <history> 块 tokens 合计 ≥ 窗口 × historyMergeRatio 时，摘要调用
+ * 反思：全部 <history> 块 tokens 合计 ≥ reflectThresholdTokens 时，摘要调用
  * 精简合并（多个块拼接为输入，与观察共用同一套提示词），把整个块区段替换为一条
  * 更紧凑的摘要。失败不产生部分替换。
  */
-export declare function reflectPass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, window: number, target: RoutedTarget, signal?: AbortSignal): Promise<void>;
+export declare function reflectPass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, target: RoutedTarget, signal?: AbortSignal): Promise<void>;
 /**
- * 观察：未压缩消息 tokens ≥ 窗口 × thresholdRatio 时，摘要调用把未压缩消息压缩为
+ * 观察：未压缩消息 tokens ≥ observeThresholdTokens 时，摘要调用把未压缩消息压缩为
  * 观察日志，追加到旧摘要并替换被压缩消息区间。失败不产生部分替换。
  */
-export declare function observePass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, window: number, tailCount: number, target: RoutedTarget, signal?: AbortSignal): Promise<void>;
+export declare function observePass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, tailCount: number, target: RoutedTarget, signal?: AbortSignal): Promise<void>;
 /**
  * 压力检查 + 两级压缩：先反思（压缩过往摘要，有必要才做），后观察（压缩新消息，
  * 有必要才做）。在 pre-step 阻塞串行执行（避免压缩失败或重复压缩）。仅主会话生效。

package/dist/compress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EACV,KAAK,EAIL,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAoDD,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG;IAAE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAyBzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAc1E;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,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,CAaA;AA8GD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Hf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAwJf;AAED;;;GAGG;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,IAAI,CAAC,CAwCf"}
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EACV,KAAK,EAIL,eAAe,EACf,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBd;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,eAAe,EAAE,EAC/B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,GACtC,eAAe,EAAE,EAAE,CA6BrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiBlE;AAyED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG;IAAE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAyBzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAc1E;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,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,CAaA;AA8GD;;;;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,IAAI,CAAC,CA+Hf;AAED;;;GAGG;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,IAAI,CAAC,CAgMf;AAED;;;GAGG;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,IAAI,CAAC,CAyBf"}

package/dist/config.d.ts

@@ -1,11 +1,19 @@
 /** 插件配置项（全部可选覆盖，未给出或留空的键用默认值）。 */
 export type PluginConfig = {
-    /** 压力阈值比例：压力 ≥ 窗口 × 该比例时触发自动压缩。 */
-    thresholdRatio: number;
-    /** 反思阈值比例：摘要（<history> 内容）≥ 窗口 × 该比例时由反思摘要调用精简合并。 */
-    historyMergeRatio: number;
+    /** 观察阈值（tokens）：未压缩消息 tokens ≥ 该值时触发观察压缩。 */
+    observeThresholdTokens: number;
+    /** 反思阈值（tokens）：全部 <history> 块 tokens 合计 ≥ 该值时由反思摘要调用精简合并。 */
+    reflectThresholdTokens: number;
     /** 单次摘要（合并调用）生成上限（LLM maxTokens）。 */
     compressMaxTokens: number;
+    /** 观察分块 token 边界：未压缩消息按该边界拆分为多块并行压缩（完整消息不跨块）。 */
+    observeChunkTokens: number;
+    /** 观察分块单块摘要的生成上限（LLM maxTokens；每块独立调用）。 */
+    observeChunkMaxTokens: number;
+    /** 观察分块压缩的最大并行数：同时进行的单块摘要调用上限，其余块排队（默认 2）。 */
+    observeChunkParallelism: number;
+    /** 遇 429 限流后，下一次摘要请求发出前至少等待的毫秒数（全局限流冷却期，默认 60000）。 */
+    rateLimitWaitMs: number;
     /** 压缩边界：其后不压缩消息数下限（正整数，尾部保留）。 */
     tailMessageCount: number;
     /** 摘要调用失败后的最大重试次数（不含首次尝试；总尝试次数 = 该值 + 1，默认 11）。 */

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAWhD,CAAC;AAmCH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CA4BnE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,6CAA6C;IAC7C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,uBAAuB,EAAE,MAAM,CAAC;IAChC,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAehD,CAAC;AA2CH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CA4BnE"}

package/dist/index.d.ts

@@ -8,8 +8,8 @@
  *    按语义在全部完整消息（含被压缩/遮蔽）中检索，返回最匹配的完整消息与匹配说明
  *    （本地 ONNX embedding，模型随插件打包，懒加载）
  *  - compress.ts 自动压缩（OM 观察/反思两级阈值）：pre-step 阻塞串行执行——
- *    反思（摘要 ≥ 窗口 × historyMergeRatio 时摘要调用精简合并 <history>）、
- *    观察（未压缩消息 ≥ 窗口 × thresholdRatio 时摘要调用压缩为观察日志并追加）
+ *    反思（<history> 块 tokens 合计 ≥ reflectThresholdTokens 时摘要调用精简合并）、
+ *    观察（未压缩消息 tokens ≥ observeThresholdTokens 时摘要调用压缩为观察日志并追加）
  *
  * 约束：不引入自定义会话事件类型——压缩复用宿主已知的 compaction/* 生命周期事件
  * （start/summary/end）与 checkpoint 标记，结果写入消息记录与轨迹。