dsh-plugin-om 0.0.22 → 0.0.24

package/README.md

@@ -7,12 +7,15 @@
 ## 功能
 
 - **自动压缩**（仅主会话，`agent/pre-step` 时阻塞串行执行）：
-  - **观察**：净压力（上下文压力 − 已压缩 `<history>` 块 token 估算合计）≥ `observeThresholdTokens` 时，摘要未压缩消息并追加为新 `<history>` 块，精确替换被压缩的消息区间（旧块保留）
+  - **观察**：净压力（上下文压力 − 已压缩 `<history>` 块 token 估算合计 − 系统提示词 token 估算 − 工具定义 token 估算）≥ `observeThresholdTokens` 时，摘要未压缩消息并追加为新 `<history>` 块，精确替换被压缩的消息区间（旧块保留）
   - **反思**：全部 `<history>` 块 token 合计 ≥ `reflectThresholdTokens` 时，把多个摘要块合并为一条更紧凑的摘要
   - **输出容错**：摘要输出按首个 `<history>` 开标签到最后一个 `</history>` 定位；整块 XML 非法时按条目标签模糊提取并重建为合法块，再校验无 reasoning 与 index 连续
+  - **失败中断**：摘要尝试全部耗尽后拒绝当前 step（当前 turn 以 blocked 结束，不再继续 AI 会话；signal 中止除外），最后一次尝试的实际报错写入日志与 `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）按语义检索全部完整消息（只匹配文本，纯图片消息不进候选池）
-- **压缩卡片**：浏览器客户端在消息列表渲染折叠式「已压缩」卡片与「正在压缩上下文（观察/反思）…」提示行
+- **压缩卡片**：浏览器客户端在消息列表渲染折叠式「已压缩」卡片、「正在压缩上下文（观察/反思）…」提示行与可展开的「上下文压缩失败」错误行
+- **降级警告行**：浏览器客户端把 `om/warning` 事件渲染为可展开的「上下文压缩功能降级」警告行（折叠摘要 + 完整说明展开）
 
 ## 安装与启用
 
@@ -32,7 +35,7 @@ dsh plugin --profile <profile> add dsh-plugin-om
 ```yaml
 - id: dsh-plugin-om
   config:
-    observeThresholdTokens: 35000
+    observeThresholdTokens: 45000
 ```
 
 ### 开发插件
@@ -53,15 +56,15 @@ preset-agent 自带 `compaction-basic` 压缩，也会压缩上下文，其压
 
 | 键 | 默认 | 含义 |
 | --- | --- | --- |
-| `observeThresholdTokens` | `35000` | 观察阈值（tokens）：净压力 ≥ 该值时触发观察压缩 |
-| `reflectThresholdTokens` | `40000` | 反思阈值（tokens）：全部 `<history>` 块 token 合计 ≥ 该值时触发合并 |
-| `compressMaxTokens` | `5000` | 单次摘要生成上限 |
+| `observeThresholdTokens` | `45000` | 观察阈值（tokens）：净压力（上下文压力 − 已压缩块 − 系统提示词估算 − 工具定义估算）≥ 该值时触发观察压缩 |
+| `reflectThresholdTokens` | `120000` | 反思阈值（tokens）：全部 `<history>` 块 token 合计 ≥ 该值时触发合并 |
+| `compressMaxTokens` | 不设置 | 单次摘要生成上限（不设置时由模型适配器默认值决定） |
 | `rateLimitWaitMs` | `60000` | 遇 429 限流后下一次摘要请求前的等待毫秒数（全局冷却期；`0` 不限流） |
 | `tailMessageCount` | `5` | 尾部保留的不压缩消息条数 |
 | `compressRetryCount` | `5` | 摘要失败后的最大重试次数（不含首次） |
 | `modelDir` | 共享目录 | recall-semantic 嵌入模型目录（默认 `$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>`，onnx 缺失且启用语义召回时运行时自动下载） |
 | `omEnabled` | `true` | 是否启用自动压缩（`false` 时关闭，recall 工具不受影响） |
-| `debug` | dev | 步骤级日志开关（缺省按 `NODE_ENV !== 'production'` 判定；失败日志始终输出） |
+| `debug` | dev | 步骤级日志开关（缺省按 `NODE_ENV !== 'production'` 判定；每次压缩尝试的结果/报错与失败日志始终输出） |
 | `recallEnabled` | `true` | 是否注册 `recall` 工具 |
 | `semanticRecallEnabled` | `true` | 是否注册 `recall-semantic` 工具（`false` 时不注册、不触发模型下载） |
 
@@ -87,6 +90,7 @@ src/
 ├── index.ts                   # 打包入口：注册 recall 工具 + 接线 pre-step 自动压缩
 ├── config.ts                  # 配置默认值与宽松合并（未知键忽略、非法值回退默认）
 ├── constants.ts               # 共享常量（插件标识 / history 标签 / 完整消息定义）
+├── degrade.ts                 # 挂载失败降级上报（console 外部输出 + om/warning 会话事件，每会话去重）
 ├── types.ts                   # type-only：宿主类型再导出 + 领域类型
 ├── utils.ts                   # 零依赖工具函数（文本渲染 / 主会话判定 / 路由解析）
 ├── logger.ts                  # 插件日志门面（step 按 debug 开关过滤）
@@ -98,15 +102,16 @@ src/
 ├── embedding.ts               # 本地 ONNX 嵌入（懒加载 / 批量 / 运行时按需下载编排）
 ├── model-download.ts          # 模型下载原语（URL / 跳过判定 / 原子落盘）
 ├── summarize.ts               # 共享压缩提示词 + <history> 块渲染与输出校验 + 摘要调用
-├── compress.ts                # 两级自动压缩（观察/反思）与 compaction 生命周期事件
+├── compress.ts                # 两级自动压缩（观察/反思）、失败中断传播与 compaction 生命周期事件
 └── client/                    # 浏览器客户端 bundle（压缩卡片）
     ├── index.ts               # 客户端入口：注册卡片定义与渲染器
-    ├── definition.ts          # 压缩卡片业务定义（认领生命周期事件与替换检查点）
-    ├── OmCompactionCard.tsx   # 折叠卡片渲染器（统计标题 + summary 展开）
+    ├── definition.ts          # 压缩卡片业务定义（认领生命周期事件、替换检查点与 om/warning）
+    ├── OmCompactionCard.tsx   # 折叠卡片渲染器（统计标题 + summary/失败报错展开）
+    ├── OmWarningCard.tsx      # 功能降级警告行渲染器（折叠摘要 + 完整说明展开）
     ├── format.ts              # 统计数字紧凑格式化（k/w/M）
     └── 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/ 客户端卡片 + 整条链路集成测试）
 ```
 

package/dist/client/OmCompactionCard.d.ts

@@ -3,6 +3,7 @@
  * 复用平台原语 DisclosureRow；行内统计与展开体样式按宿主 ContextInjectionRow 的规则
  * 注入 <style>（宿主该卡片样式是编译期哈希的 CSS Module，插件 bundle 无法引用其类名）。
  * 卡片报告模型从何处起不再看到那段历史；summary 留在加载窗口外时行不可展开。
+ * 压缩失败节点渲染为可展开的错误行：折叠行显示错误摘要，展开体显示完整报错。
  */
 import type { ChatNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';

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

@@ -1 +1 @@
-{"version":3,"file":"OmCompactionCard.d.ts","sourceRoot":"","sources":["../../src/client/OmCompactionCard.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;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,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,oDAA+C,qBAAqB,iCAsF/F,CAAC"}
+{"version":3,"file":"OmCompactionCard.d.ts","sourceRoot":"","sources":["../../src/client/OmCompactionCard.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,oDAA+C,qBAAqB,iCA2H/F,CAAC"}

package/dist/client/OmWarningCard.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 功能降级警告行渲染器：与压缩卡片同款的折叠行。
+ * 折叠行显示降级说明摘要，展开体显示完整说明；数据来自 om/warning 事件载荷，
+ * 服务端按会话同问题去重后追加（每会话同一问题至多一行）。
+ */
+import type { ChatNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** Keyed renderer props: 装配好的警告行节点 + 绑定 `om-compaction` 命名空间的 locale 座。 */
+export interface OmWarningCardProps {
+    readonly node: ChatNode<'om-warning'>;
+    readonly t: TranslateNS<'om-compaction'>;
+}
+/** 折叠式功能降级警告行（降级说明摘要行 + 完整说明展开）。 */
+export declare const OmWarningCard: import("react").MemoExoticComponent<({ node, t }: OmWarningCardProps) => import("react").JSX.Element>;
+//# sourceMappingURL=OmWarningCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OmWarningCard.d.ts","sourceRoot":"","sources":["../../src/client/OmWarningCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;CAC1C;AAED,oCAAoC;AACpC,eAAO,MAAM,aAAa,oDAA4C,kBAAkB,iCAqCtF,CAAC"}

package/dist/client/definition.d.ts

@@ -1,18 +1,24 @@
 /**
  * 压缩卡片业务定义：认领插件自产的压缩生命周期事件（compaction/start|summary|end）
- * 与替换检查点（source.plugin = 'dsh-plugin-om'），聚合出可渲染的摘要卡片节点。
+ * 与替换检查点（source.plugin = 'dsh-plugin-om'），聚合出可渲染的摘要卡片节点；
+ * 并认领 om/warning 功能降级警告事件渲染为警告行。
  * 导出 COMPACTION_CARD_KIND / OmCompactionChatData / checkpointCompactionId /
- * omCompactionDefinition。宿主的 'compact' 检查点由宿主自己渲染，本定义不认领
+ * omCompactionDefinition / OM_WARNING_CARD_KIND / OmWarningChatData / omWarningDefinition。
+ * 宿主的 'compact' 检查点由宿主自己渲染，本定义不认领
  * （双方共存无视觉冲突：宿主无检查点证据时不产出节点）。
  */
 import type { ConversationMatch, ConversationNodeDefinition } from '@deepseek-ai/dsh-client-runtime/client';
 import type { SessionEvent } from '@deepseek-ai/dsh-session/types';
 /** 压缩卡片渲染器分发键（合并进 ChatNodeDataMap）。 */
 export declare const COMPACTION_CARD_KIND = "om-compaction";
+/** 功能降级警告行渲染器分发键（合并进 ChatNodeDataMap）。 */
+export declare const OM_WARNING_CARD_KIND = "om-warning";
 declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
     interface ChatNodeDataMap {
         /** dsh-plugin-om 压缩替换检查点渲染的摘要卡片数据。 */
         'om-compaction': OmCompactionChatData;
+        /** dsh-plugin-om 功能降级警告行数据。 */
+        'om-warning': OmWarningChatData;
     }
 }
 /** 压缩卡片载荷：摘要文本与遮蔽统计。 */
@@ -37,12 +43,14 @@ export interface OmCompactionChatData {
     readonly summaryTokenCount: number | null;
     /** 摘要调用重试次数，载荷缺失或非法时为 null。 */
     readonly retryCount: number | null;
+    /** 压缩失败的错误文案（来自 compaction/end 载荷 error）；非失败节点为 null。 */
+    readonly error: string | null;
 }
 /** 压缩生命周期关联状态：summary / checkpoint / end 事件证据。 */
 interface OmCompactionState {
     readonly summary?: ConversationMatch;
     readonly checkpoint?: ConversationMatch;
-    /** compaction/end（成功与失败都会到达；无 checkpoint 的 end 表示压缩失败，撤回进行中提示行）。 */
+    /** compaction/end（成功与失败都会到达；无 checkpoint 的 end 表示压缩失败或中止）。 */
     readonly end?: ConversationMatch;
 }
 /**
@@ -52,10 +60,23 @@ interface OmCompactionState {
 export declare function checkpointCompactionId(event: SessionEvent): string | undefined;
 /**
  * 插件压缩生命周期定义：compaction/start 开启上下文，summary / 替换检查点 / end
- * 作为 update 折叠证据。有检查点时产出摘要卡片；无检查点的 end 以 hidden 撤回
- * 进行中提示行（已物化节点以 hidden visibility 保留同一 key）；仅 start 时渲染
- * 「正在压缩上下文…」提示行。
+ * 作为 update 折叠证据。有检查点时产出摘要卡片；end 已到且无检查点时，error 为
+ * 非中止报错则产出可见失败行，error 为中止标识或缺失则以 hidden 撤回进行中提示行
+ * （已物化节点以 hidden visibility 保留同一 key）；仅 start 时渲染「正在压缩上下文…」
+ * 提示行。
  */
 export declare const omCompactionDefinition: ConversationNodeDefinition<OmCompactionState>;
+/** 功能降级警告行载荷：降级问题标识与面向用户的说明（载荷非法时为 null）。 */
+export interface OmWarningChatData {
+    /** 降级问题标识（om/warning 载荷 problem）。 */
+    readonly problem: string | null;
+    /** 面向用户的降级说明（om/warning 载荷 message）。 */
+    readonly message: string | null;
+}
+/**
+ * 插件功能降级警告定义：每条 om/warning 事件独立成节点（id 含 seq），渲染为可展开的
+ * 「功能降级」警告行。服务端按会话同问题去重后追加，每会话同一问题至多一行。
+ */
+export declare const omWarningDefinition: ConversationNodeDefinition;
 export {};
 //# sourceMappingURL=definition.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/client/definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,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,8BAA8B;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,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;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAe9E;AAwGD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,0BAA0B,CAAC,iBAAiB,CAsDhF,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/client/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;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,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,OAAO,QAAQ,gDAAgD,CAAC;IAC9D,UAAU,eAAe;QACvB,sCAAsC;QACtC,eAAe,EAAE,oBAAoB,CAAC;QACtC,+BAA+B;QAC/B,YAAY,EAAE,iBAAiB,CAAC;KACjC;CACF;AAED,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,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,8BAA8B;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,kDAAkD;AAClD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAgBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAe9E;AAuID;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,0BAA0B,CAAC,iBAAiB,CAqEhF,CAAC;AAEF,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,0BAkBjC,CAAC"}

package/dist/client/index.d.ts

@@ -1,8 +1,9 @@
 /**
- * 浏览器客户端入口（exports["./client"] → dist/client.js）：注册压缩卡片的
- * locale 字典、conversation 业务定义与 keyed 渲染器。宿主 conversation UI 只识别
- * 内置 'compact' 检查点，插件自产的压缩检查点（source.plugin = 'dsh-plugin-om'）
- * 由本 bundle 认领并在消息列表渲染「已压缩」卡片。
+ * 浏览器客户端入口（exports["./client"] → dist/client.js）：注册压缩卡片与功能降级
+ * 警告行的 locale 字典、conversation 业务定义与 keyed 渲染器。宿主 conversation UI 只
+ * 识别内置 'compact' 检查点，插件自产的压缩检查点（source.plugin = 'dsh-plugin-om'）
+ * 由本 bundle 认领并在消息列表渲染「已压缩」卡片；om/warning 事件渲染为「功能降级」
+ * 警告行。
  */
 import type { Context } from '@deepseek-ai/cordis';
 /** Required services: 聊天节点槽、会话事件注册表与 locale 服务。 */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWnD,mDAAmD;AACnD,eAAO,MAAM,MAAM,UAA4C,CAAC;AAEhE,2DAA2D;AAC3D,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAexC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAYnD,mDAAmD;AACnD,eAAO,MAAM,MAAM,UAA4C,CAAC;AAEhE,2DAA2D;AAC3D,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAyBxC"}

package/dist/client/locales.d.ts

@@ -14,7 +14,11 @@ export declare const zh: {
     readonly 'compaction.running': "正在压缩上下文…";
     readonly 'compaction.running.observe': "正在压缩上下文（观察）…";
     readonly 'compaction.running.reflect': "正在压缩上下文（反思）…";
+    readonly 'compaction.failed': "上下文压缩失败";
+    readonly 'compaction.failed.observe': "上下文压缩失败（观察）";
+    readonly 'compaction.failed.reflect': "上下文压缩失败（反思）";
     readonly 'compaction.retries': "重试 {count} 次";
+    readonly warning: "上下文压缩功能降级";
 };
 /** English dictionary（键集与 zh 一致）。 */
 export declare const en: Record<keyof typeof zh, string>;

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

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,eAAO,MAAM,EAAE,kBAAkB,CAAC;AAElC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;CAWL,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,CAW9C,CAAC;AAEF,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,mDAAmD;QACnD,eAAe,EAAE,MAAM,OAAO,EAAE,CAAC;KAClC;CACF"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,eAAO,MAAM,EAAE,kBAAkB,CAAC;AAElC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;CAeL,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,CAe9C,CAAC;AAEF,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,mDAAmD;QACnD,eAAe,EAAE,MAAM,OAAO,EAAE,CAAC;KAClC;CACF"}

package/dist/client.js

@@ -11,6 +11,8 @@ window.__ModuleLoader__.load({
 		//#region src/client/definition.ts
 		/** 压缩卡片渲染器分发键（合并进 ChatNodeDataMap）。 */
 		const COMPACTION_CARD_KIND = "om-compaction";
+		/** 功能降级警告行渲染器分发键（合并进 ChatNodeDataMap）。 */
+		const OM_WARNING_CARD_KIND = "om-warning";
 		/**
 		* replace-surface 判定：surfaceOp 为 { op: 'replace' } 对象（与宿主 runtime 的
 		* isReplacementSurfaceEvent 同义；宿主该助手位于浏览器 bundle，node 端测试无法求值，
@@ -51,6 +53,7 @@ window.__ModuleLoader__.load({
 			return {
 				running: false,
 				phase: null,
+				error: null,
 				summary,
 				summaryEventSeq: summaryMatch?.event.seq ?? null,
 				shadowedItemCount,
@@ -61,12 +64,38 @@ window.__ModuleLoader__.load({
 				retryCount
 			};
 		}
+		/** 从 compaction/start 载荷读取压缩 pass（observe/reflect；缺失或非法时回落 null）。 */
+		function startPhase(start) {
+			const data = start?.event.data;
+			return data?.phase === "observe" || data?.phase === "reflect" ? data.phase : null;
+		}
 		/** 压缩进行中提示行的载荷（统计未就绪，全部为 null）。 */
 		function runningData(start) {
-			const data = start?.event.data;
 			return {
 				running: true,
-				phase: data?.phase === "observe" || data?.phase === "reflect" ? data.phase : null,
+				phase: startPhase(start),
+				error: null,
+				summary: null,
+				summaryEventSeq: null,
+				shadowedItemCount: null,
+				shadowedTokenCount: null,
+				shadowedCharCount: null,
+				summaryCharCount: null,
+				summaryTokenCount: null,
+				retryCount: null
+			};
+		}
+		/**
+		* 压缩失败节点的载荷：end 已到且带非中止 error、无检查点时使用。
+		* error 取 compaction/end 载荷中的实际报错文案（非字符串或为空时回落 null）；
+		* 摘要与统计字段全部为 null。
+		*/
+		function failureData(start, end) {
+			const data = end.event.data;
+			return {
+				running: false,
+				phase: startPhase(start),
+				error: typeof data?.error === "string" && data.error !== "" ? data.error : null,
 				summary: null,
 				summaryEventSeq: null,
 				shadowedItemCount: null,
@@ -103,9 +132,10 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* 插件压缩生命周期定义：compaction/start 开启上下文，summary / 替换检查点 / end
-		* 作为 update 折叠证据。有检查点时产出摘要卡片；无检查点的 end 以 hidden 撤回
-		* 进行中提示行（已物化节点以 hidden visibility 保留同一 key）；仅 start 时渲染
-		* 「正在压缩上下文…」提示行。
+		* 作为 update 折叠证据。有检查点时产出摘要卡片；end 已到且无检查点时，error 为
+		* 非中止报错则产出可见失败行，error 为中止标识或缺失则以 hidden 撤回进行中提示行
+		* （已物化节点以 hidden visibility 保留同一 key）；仅 start 时渲染「正在压缩上下文…」
+		* 提示行。
 		*/
 		const omCompactionDefinition = {
 			kind: COMPACTION_CARD_KIND,
@@ -150,12 +180,43 @@ window.__ModuleLoader__.load({
 				}
 				if (state.end !== void 0) {
 					const anchorSeq = context.start?.event.seq ?? state.end.event.seq;
+					const endData = state.end.event.data;
+					if (typeof endData?.error === "string" && endData.error !== "" && !endData.error.startsWith("压缩已中止（signal aborted）")) return chatNode(context, COMPACTION_CARD_KIND, anchorSeq, failureData(context.start, state.end));
 					return chatNode(context, COMPACTION_CARD_KIND, anchorSeq, runningData(context.start), "hidden");
 				}
 				if (context.start !== void 0) return chatNode(context, COMPACTION_CARD_KIND, context.start.event.seq, runningData(context.start));
 				return null;
 			}
 		};
+		/**
+		* 插件功能降级警告定义：每条 om/warning 事件独立成节点（id 含 seq），渲染为可展开的
+		* 「功能降级」警告行。服务端按会话同问题去重后追加，每会话同一问题至多一行。
+		*/
+		const omWarningDefinition = {
+			kind: OM_WARNING_CARD_KIND,
+			target: "chat",
+			match: (event) => {
+				if (event.type !== "om/warning") return null;
+				return {
+					id: `om-warning:${event.seq}`,
+					role: "start"
+				};
+			},
+			start: () => ({}),
+			update: (context) => context.state,
+			buildViewNode: (context) => {
+				const start = context.start;
+				if (start === void 0) return null;
+				const data = start.event.data;
+				const problem = typeof data?.problem === "string" && data.problem !== "" ? data.problem : null;
+				const message = typeof data?.message === "string" && data.message !== "" ? data.message : null;
+				if (problem === null && message === null) return null;
+				return chatNode(context, OM_WARNING_CARD_KIND, start.event.seq, {
+					problem,
+					message
+				});
+			}
+		};
 		//#endregion
 		//#region src/client/locales.ts
 		/**
@@ -174,7 +235,11 @@ window.__ModuleLoader__.load({
 			"compaction.running": "正在压缩上下文…",
 			"compaction.running.observe": "正在压缩上下文（观察）…",
 			"compaction.running.reflect": "正在压缩上下文（反思）…",
-			"compaction.retries": "重试 {count} 次"
+			"compaction.failed": "上下文压缩失败",
+			"compaction.failed.observe": "上下文压缩失败（观察）",
+			"compaction.failed.reflect": "上下文压缩失败（反思）",
+			"compaction.retries": "重试 {count} 次",
+			warning: "上下文压缩功能降级"
 		};
 		/** English dictionary（键集与 zh 一致）。 */
 		const en = {
@@ -186,7 +251,11 @@ window.__ModuleLoader__.load({
 			"compaction.running": "Compressing context…",
 			"compaction.running.observe": "Compressing context (observation)…",
 			"compaction.running.reflect": "Compressing context (reflection)…",
-			"compaction.retries": "Retried {count} times"
+			"compaction.failed": "Context compaction failed",
+			"compaction.failed.observe": "Context compaction failed (observation)",
+			"compaction.failed.reflect": "Context compaction failed (reflection)",
+			"compaction.retries": "Retried {count} times",
+			warning: "Context compaction degraded"
 		};
 		//#endregion
 		//#region src/client/format.ts
@@ -248,6 +317,38 @@ window.__ModuleLoader__.load({
 					})
 				});
 			}
+			if (data.error !== null) {
+				const failedLabel = data.phase === "observe" ? t("compaction.failed.observe") : data.phase === "reflect" ? t("compaction.failed.reflect") : t("compaction.failed");
+				const errorSummary = data.error.length > 80 ? `${data.error.slice(0, 80)}…` : data.error;
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: styles.row,
+					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 }),
+						chevronClassName: css.chevron,
+						title: failedLabel,
+						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,
+							children: errorSummary
+						})] }),
+						keepContentWhenOpen: true,
+						expandable: true,
+						expandOnRowClick: true,
+						open: expanded,
+						onToggle: () => {
+							setExpanded((value) => !value);
+						},
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: css.body,
+							style: styles.body,
+							children: data.error
+						})
+					})
+				});
+			}
 			const expandable = data.summary !== null;
 			const open = expandable && expanded;
 			const stats = data.shadowedItemCount !== null && data.shadowedCharCount !== null && data.shadowedTokenCount !== null && data.summaryCharCount !== null && data.summaryTokenCount !== null ? t("compaction.stats", {
@@ -293,10 +394,46 @@ window.__ModuleLoader__.load({
 		});
 		const styles = {
 			row: {},
-			/** 摘要为 <history> 文本，保留换行。 */
+			/** 摘要与失败报错为多行文本，保留换行。 */
 			body: { whiteSpace: "pre-wrap" }
 		};
 		//#endregion
+		//#region src/client/OmWarningCard.tsx
+		/** 折叠式功能降级警告行（降级说明摘要行 + 完整说明展开）。 */
+		const OmWarningCard = (0, react.memo)(function OmWarningCard({ node, t }) {
+			const [expanded, setExpanded] = (0, react.useState)(false);
+			const { data } = node;
+			const message = data.message ?? (data.problem !== null ? data.problem : "");
+			const expandable = message !== "";
+			const messageSummary = message.length > 80 ? `${message.slice(0, 80)}…` : message;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DisclosureRow, {
+				className: "om-compaction-root",
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconBrowseOutline16, { size: 14 }),
+				chevronClassName: "om-compaction-chevron",
+				title: t("warning"),
+				collapsedContent: expandable ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "om-compaction-sep",
+					"aria-hidden": true
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "om-compaction-summary",
+					children: messageSummary
+				})] }) : void 0,
+				keepContentWhenOpen: true,
+				expandable,
+				expandOnRowClick: true,
+				open: expandable && expanded,
+				onToggle: () => {
+					if (expandable) setExpanded((value) => !value);
+				},
+				children: expandable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "om-compaction-body",
+					style: bodyStyle,
+					children: message
+				})
+			}) });
+		});
+		const bodyStyle = { whiteSpace: "pre-wrap" };
+		//#endregion
 		//#region src/client/index.ts
 		/** Required services: 聊天节点槽、会话事件注册表与 locale 服务。 */
 		const inject = [
@@ -311,11 +448,17 @@ window.__ModuleLoader__.load({
 				en
 			}), "dsh-plugin-om: compaction card dictionaries");
 			ctx.effect(() => ctx.conversationEvents.register(omCompactionDefinition), "dsh-plugin-om: compaction definition");
+			ctx.effect(() => ctx.conversationEvents.register(omWarningDefinition), "dsh-plugin-om: om/warning definition");
 			ctx.slots.inject("conversation.chat.node", () => ctx.slots.register({
 				name: "conversation.chat.node",
 				key: "om-compaction",
 				locale: NS
 			}, OmCompactionCard));
+			ctx.slots.inject("conversation.chat.node", () => ctx.slots.register({
+				name: "conversation.chat.node",
+				key: "om-warning",
+				locale: NS
+			}, OmWarningCard));
 		}
 		//#endregion
 		exports.apply = apply;