@blueking/chat-x 0.0.45-beta.5 → 0.0.45-dev.1

package/dist/mcp/generated/docs/interrupt-message.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染 human-in-the-loop 中断消息，分发工具审批，并回显用户问题回答结果。 源码位置：src/components/chat-message/interrupt-message/interrupt-message.vue。
+渲染 human-in-the-loop 中断消息，分发工具审批，并按 reason 回显 resume 结果（审批单 / 用户回答）。 源码位置：src/components/chat-message/interrupt-message/interrupt-message.vue。
 
 ### 关联组件
 - **message-render** — role 为 interrupt 时渲染本组件
@@ -17,14 +17,14 @@
 
 - **源码位置**：`src/components/chat-message/interrupt-message/interrupt-message.vue`
 - **能力域**：Agent 能力
-- **能力说明**：渲染 human-in-the-loop 中断消息，分发工具审批，并回显用户问题回答结果。
+- **能力说明**：渲染 human-in-the-loop 中断消息，分发工具审批，并按 `result.reason` 回显 resume 结果。
 
 > **能力域**：Agent 能力
 
 human-in-the-loop 中断消息渲染器（导出名 **`InterruptMessageRender`**）。对应 `MessageRole.Interrupt`，解析 `content.outcome` 渲染审批卡片或兜底提示。
 
 > 通常由 [MessageRender](/components/message/message-render) 自动调用，无需业务侧直接引入。
-> `UserQuestion` 的待回答卡片由 [ChatContainer](/components/setup/chat-container) 放在输入区上方，本组件只负责 success 后的会话内回答回显。
+> `UserQuestion` 的待回答卡片由 [ChatContainer](/components/setup/chat-container) 放在输入区上方，本组件在 `outcome.success` 时按 `result.reason` 回显审批单或用户回答。
 
 ## 渲染架构
 
@@ -38,12 +38,15 @@ InterruptMessageRender
             └── 未注册 reason → 兜底块（item.message 或「暂不支持的中断消息」）
 
 content.outcome.type === 'success'
-└── result.reason === aidev:user_question → UserQuestionAnsweredCard 回显回答（支持 #answeredQuestion 透传 #answer）
+└── resultRenderers[result.reason]
+      ├── aidev:tool_approval → ToolApprovalCard（readonly，隐藏取消审批）
+      └── aidev:user_question → UserQuestionAnsweredCard（支持 #answeredQuestion 透传 #answer）
 ```
 
 | `InterruptReason`              | 子组件              |
 | ------------------------------ | ------------------- |
-| `aidev:tool_approval`          | `ToolApprovalCard`  |
+| `aidev:tool_approval`（待审批） | `ToolApprovalCard`  |
+| `aidev:tool_approval`（已处理） | `ToolApprovalCard`（`readonly`，只读回显） |
 | `aidev:user_question`（待回答） | 输入区 `UserQuestionCard`，本组件不渲染 |
 | `aidev:user_question`（已回答） | `UserQuestionAnsweredCard` |
 | 其他 / 未注册                  | 兜底文案区域        |
@@ -124,6 +127,19 @@ content.outcome.type === 'success'
 
 **渲染效果**
 
+## AIDevToolApproval 已处理回显（outcome.success）
+
+`outcome.type === 'success'` 且 `result.reason === InterruptReason.AIDevToolApproval` 时，会话内以只读 `ToolApprovalCard` 回显审批单。`result.payload.metadata` 需透传中断时的 `metadata`（含 `ticket`）：
+
+```vue
+<InterruptMessageRender
+  :content="resumedMessage.content"
+  role="interrupt"
+/>
+```
+
+**渲染效果**
+
 ## UserQuestion 已回答回显（outcome.success）
 
 `outcome.type === 'success'` 且 `result.reason === InterruptReason.UserQuestion` 时，会话内回显用户回答。可通过 `#answeredQuestion` slot 自定义单题回显：
@@ -141,10 +157,6 @@ content.outcome.type === 'success'
 
 **渲染效果**
 
-## 其他已 resume（outcome.success）
-
-非 `UserQuestion` 的 success 态不渲染中断卡片，仅保留可选顶部 `content.message`：
-
 ## 不支持的中断类型（兜底）
 
 ```vue

package/dist/mcp/generated/docs/interrupt.md

@@ -1,10 +1,10 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-定义 RunFinishedOutcome、BaseInterrupt、AIDevToolApprovalInterrupt、UserQuestionInterrupt、BaseResume、InterruptMessage 与 OnInterruptResume。 与 MessageRole.Interrupt、InterruptMessageRender、UserQuestionCard、ToolApprovalCard 配合，对应 RUN_FINISHED outcome。
+定义 RunFinishedOutcome、BaseInterrupt、AIDevToolApprovalInterrupt、AIDevToolApprovalResume、UserQuestionInterrupt、InterruptResult、BaseResume、InterruptMessage 与 OnInterruptResume。 与 MessageRole.Interrupt、InterruptMessageRender、UserQuestionCard、ToolApprovalCard 配合，对应 RUN_FINISHED outcome。
 
 ### 关联组件
-- **interrupt-message** — 根据 outcome.interrupts 与 reason 渲染中断 UI，success 时回显 UserQuestion 回答
+- **interrupt-message** — 根据 outcome.interrupts 与 reason 渲染中断 UI，success 时按 result.reason 回显审批单或用户回答
 - **user-question-card** — UserQuestion 交互面板，挂载在 ChatInput 上方
 - **tool-approval-card** — AIDevToolApproval 专用卡片
 - **message-render** — role 为 interrupt 时派发 InterruptMessageRender
@@ -53,7 +53,7 @@ type RunFinishedOutcome =
 | `type`        | 说明                                                                 |
 | ------------- | -------------------------------------------------------------------- |
 | `'interrupt'` | 等待用户响应；`interrupts` 驱动 UI 渲染审批卡片、用户问题面板等       |
-| `'success'`   | 用户已通过 `resume` 处理；若 `result.reason === UserQuestion` 则回显回答内容 |
+| `'success'`   | 用户已通过 `resume` 处理；按 `result.reason` 在会话内回显审批单（`AIDevToolApproval`）或用户回答（`UserQuestion`） |
 
 ## BaseInterrupt
 
@@ -76,18 +76,31 @@ type BaseInterrupt<T extends InterruptReason, M extends Record<string, any>> = {
 AI Dev 第三方工具审批中断，`reason` 为 `InterruptReason.AIDevToolApproval`（`'aidev:tool_approval'`）：
 
 ```typescript
+type AIDevToolApprovalInterruptPayloadMetaData = {
+  ticket: {
+    approvers: string[];
+    sn: string;
+    status: APPROVAL_STATUS;
+    submit_time: string;
+    title: string;
+    url: string;
+  };
+};
+
 type AIDevToolApprovalInterrupt = BaseInterrupt<
   InterruptReason.AIDevToolApproval,
-  {
-    ticket: {
-      approvers: string[];
-      sn: string;
-      status: APPROVAL_STATUS;
-      submit_time: string;
-      title: string;
-      url: string;
-    };
-  }
+  AIDevToolApprovalInterruptPayloadMetaData
+>;
+```
+
+## AIDevToolApprovalResume
+
+AI Dev 第三方工具审批中断响应（resume 后用于 `outcome.success` 时会话内回显审批单）。`payload.metadata` 透传中断时的 `metadata`（含 `ticket`），以便复用 `ToolApprovalCard` 只读渲染：
+
+```typescript
+type AIDevToolApprovalResume = BaseResume<
+  InterruptReason.AIDevToolApproval,
+  { metadata: AIDevToolApprovalInterruptPayloadMetaData }
 >;
 ```
 
@@ -135,8 +148,18 @@ type Interrupt =
   | BaseInterrupt<InterruptReason, Record<string, any>>;
 ```
 
+## InterruptResult
+
+中断处理结果（resume 后回传/持久化，用于 `outcome.success` 时会话内回显）。按 `reason` 区分不同结果形态，统一具备 `BaseResume` 的 `{ interruptId, reason, status }`；新增中断类型的回显结果只需在此联合扩展：
+
+```typescript
+type InterruptResult = AIDevToolApprovalResume | UserQuestionResume;
+```
+
 ## InterruptResume 联合类型
 
+用户操作后通过 `onInterruptResume` 回传的负载（与 `InterruptResult` 用途不同：`InterruptResume` 侧重**动作回传**，`InterruptResult` 侧重**success 态会话内回显**）：
+
 ```typescript
 type InterruptResume = FlowNodeResume | ToolApprovalResume | UserQuestionResume;
 ```
@@ -228,7 +251,7 @@ type InterruptMessage = BaseMessage<
   {
     message?: string;
     outcome?: RunFinishedOutcome;
-    result?: BaseResume<InterruptReason>;
+    result?: InterruptResult;
     runId?: string;
     threadId?: string;
   }
@@ -239,7 +262,7 @@ type InterruptMessage = BaseMessage<
 | ---------- | ------------------------------------------------------------ |
 | `message`  | 消息组顶部可选说明文案，由 `InterruptMessageRender` 展示     |
 | `outcome`  | `type: 'interrupt'` 时从 `interrupts` 渲染交互；`success` 时进入已处理态 |
-| `result`   | 用户 resume 后回传的单对象 payload；`UserQuestion` 会用于会话内回显 |
+| `result`   | 用户 resume 后回传/持久化的 `InterruptResult`；按 `reason` 在会话内回显审批单或用户回答 |
 | `runId`    | 关联 AG-UI run 标识                                          |
 | `threadId` | 关联会话线程标识                                             |
 

package/dist/mcp/generated/docs/tool-approval-card.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染 AIDevToolApproval 中断的审批信息与取消操作。 源码位置：src/components/chat-message/interrupt-message/tool-approval-card.vue。
+渲染 AIDevToolApproval 中断的审批信息与取消操作；outcome.success 回显时以 readonly 只读展示。 源码位置：src/components/chat-message/interrupt-message/tool-approval-card.vue。
 
 ### 关联组件
 - **interrupt-message** — InterruptMessageRender 按 reason 派发渲染
@@ -14,7 +14,7 @@
 
 - **源码位置**：`src/components/chat-message/interrupt-message/tool-approval-card.vue`
 - **能力域**：Agent 能力
-- **能力说明**：渲染 AIDevToolApproval 中断的审批信息与取消操作。
+- **能力说明**：渲染 AIDevToolApproval 中断的审批信息与取消操作；`readonly` 时用于 outcome.success 只读回显。
 
 > **能力域**：Agent 能力
 
@@ -29,9 +29,11 @@ ToolApprovalCard
 ├── 标题栏：左侧色条 + 单据标题 + 复制图标 + 状态徽章（评审中/已通过/已拒绝/已撤销等）
 ├── 字段区：单据编号、提交时间
 ├── 处理人：当前处理人（overflow-tips 省略）
-└── 操作区：查看单据详情（新窗口打开 url）、取消审批（仅 pending / draft）
+└── 操作区：查看单据详情（新窗口打开 url）、取消审批（仅 pending / draft 且非 readonly）
 ```
 
+`readonly` 为 `true` 时用于 `outcome.success` 结果回显：隐藏「取消审批」按钮，不接受审批取消交互。通常由 [InterruptMessageRender](/components/agent/interrupt-message) 内部传入，业务侧无需手动设置。
+
 状态徽章样式：
 
 | `ticket.status`                         | 视觉     |
@@ -122,6 +124,19 @@ ToolApprovalCard
 
 **渲染效果**
 
+## 只读回显（readonly）
+
+`outcome.success` 时 [InterruptMessageRender](/components/agent/interrupt-message) 会将 `AIDevToolApprovalResume.payload.metadata` 还原为 `interrupt` 形态，并以 `readonly` 挂载本组件：
+
+```vue
+<ToolApprovalCard
+  :interrupt="approvedInterrupt"
+  readonly
+/>
+```
+
+**渲染效果**（待审批态下 readonly 不展示「取消审批」）
+
 ## API
 
 ### Props
@@ -130,6 +145,7 @@ ToolApprovalCard
 | ----------------- | ---------------------------- | ------ | -------------------------------------------- |
 | interrupt         | `AIDevToolApprovalInterrupt` | —      | **必填**，含 `metadata.ticket`               |
 | onInterruptResume | `OnInterruptResume`          | —      | 取消审批时触发，签名为 `(payload, interrupt)`，payload 为 `{ operation: InterruptResumeOperation.ApprovalCancel, payload: { interrupt_id } }` |
+| readonly          | `boolean`                    | —      | 只读回显态（`outcome.success` 结果回显）：隐藏取消审批按钮，不接受交互 |
 
 ### Events / Slots / Expose
 

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-06-10T07:05:58.442Z",
+  "generatedAt": "2026-06-16T12:27:28.867Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -206,8 +206,8 @@
       "name": "InterruptMessage 中断消息",
       "slug": "interrupt-message",
       "kind": "component",
-      "description": "渲染 human-in-the-loop 中断消息，分发工具审批，并回显用户问题回答结果。",
-      "aiSummary": "渲染 human-in-the-loop 中断消息，分发工具审批，并回显用户问题回答结果。 源码位置：src/components/chat-message/interrupt-message/interrupt-message.vue。",
+      "description": "渲染 human-in-the-loop 中断消息，分发工具审批，并按 reason 回显 resume 结果。",
+      "aiSummary": "渲染 human-in-the-loop 中断消息，分发工具审批，并按 reason 回显 resume 结果（审批单 / 用户回答）。 源码位置：src/components/chat-message/interrupt-message/interrupt-message.vue。",
       "relatedComponents": [
         {
           "slug": "message-render",
@@ -302,8 +302,8 @@
       "name": "ToolApprovalCard 工具审批卡片",
       "slug": "tool-approval-card",
       "kind": "component",
-      "description": "渲染 AIDevToolApproval 中断的审批信息与取消操作。",
-      "aiSummary": "渲染 AIDevToolApproval 中断的审批信息与取消操作。 源码位置：src/components/chat-message/interrupt-message/tool-approval-card.vue。",
+      "description": "渲染 AIDevToolApproval 中断的审批信息与取消操作，支持只读回显态。",
+      "aiSummary": "渲染 AIDevToolApproval 中断的审批信息与取消操作；outcome.success 回显时以 readonly 只读展示。 源码位置：src/components/chat-message/interrupt-message/tool-approval-card.vue。",
       "relatedComponents": [
         {
           "slug": "interrupt-message",
@@ -1673,11 +1673,11 @@
       "slug": "interrupt",
       "kind": "type",
       "description": "AG-UI human-in-the-loop 中断相关类型，含 Interrupt、UserQuestion、InterruptMessage 与 resume 回调。",
-      "aiSummary": "定义 RunFinishedOutcome、BaseInterrupt、AIDevToolApprovalInterrupt、UserQuestionInterrupt、BaseResume、InterruptMessage 与 OnInterruptResume。 与 MessageRole.Interrupt、InterruptMessageRender、UserQuestionCard、ToolApprovalCard 配合，对应 RUN_FINISHED outcome。",
+      "aiSummary": "定义 RunFinishedOutcome、BaseInterrupt、AIDevToolApprovalInterrupt、AIDevToolApprovalResume、UserQuestionInterrupt、InterruptResult、BaseResume、InterruptMessage 与 OnInterruptResume。 与 MessageRole.Interrupt、InterruptMessageRender、UserQuestionCard、ToolApprovalCard 配合，对应 RUN_FINISHED outcome。",
       "relatedComponents": [
         {
           "slug": "interrupt-message",
-          "relation": "根据 outcome.interrupts 与 reason 渲染中断 UI，success 时回显 UserQuestion 回答"
+          "relation": "根据 outcome.interrupts 与 reason 渲染中断 UI，success 时按 result.reason 回显审批单或用户回答"
         },
         {
           "slug": "user-question-card",

package/dist/utils/utils.d.ts

@@ -1,8 +1,8 @@
 export declare const getCookieByName: (name: string) => string | null;
 /**
- *
+ * 将毫秒耗时格式化为紧凑字符串（数字与单位之间不留空格）
  * @param duration 耗时，单位：毫秒
- * @returns 返回格式化后的耗时字符串，如：1m 30s 500ms
+ * @returns 如 1m30s500ms；与 formatElapsedTime 风格一致
  */
 export declare const formatDuration: (duration: number) => string;
 export declare const generateUUID: () => string;

package/package.json

@@ -1,26 +1,8 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.45-beta.5",
+  "version": "0.0.45-dev.1",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
-  "scripts": {
-    "prepublishOnly": "vite --config vite.config.ts build && pnpm dts && pnpm mcp:build",
-    "dev": "vite --config vite.config.ts",
-    "dts": "vue-tsc --project tsconfig.dts.json",
-    "build": "vitest && vite --config vite.config.ts build && pnpm dts",
-    "preview": "vite --config vite.config.ts build --mode preview && pnpm dts",
-    "lint:script": "eslint . --ext .vue,.ts --fix",
-    "lint:style": "stylelint \"**/*.{scss,css,vue}\" --fix",
-    "lint:all": "pnpm lint:script && pnpm lint:style",
-    "test": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "wiki:dev": "vitepress dev wikis",
-    "wiki:build": "vitepress build wikis",
-    "mcp:build:index": "tsx mcp/scripts/build-index.ts",
-    "mcp:build": "tsc -p mcp/tsconfig.json && pnpm mcp:build:index",
-    "mcp:start": "node dist/mcp/index.js",
-    "mcp:dev": "tsx mcp/src/index.ts"
-  },
   "bin": {
     "chat-x-mcp": "dist/mcp/index.js"
   },
@@ -68,7 +50,6 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@blueking/chat-helper": "workspace:*",
     "@types/katex": "^0.16.7",
     "@types/lodash": "^4.17.23",
     "@types/markdown-it": "^14.1.2",
@@ -97,6 +78,24 @@
     "vite-bundle-analyzer": "^1.3.2",
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
-    "vue-tsc": "^3.1.4"
+    "vue-tsc": "^3.1.4",
+    "@blueking/chat-helper": "0.0.10-dev.1"
+  },
+  "scripts": {
+    "dev": "vite --config vite.config.ts",
+    "dts": "vue-tsc --project tsconfig.dts.json",
+    "build": "vitest && vite --config vite.config.ts build && pnpm dts",
+    "preview": "vite --config vite.config.ts build --mode preview && pnpm dts",
+    "lint:script": "eslint . --ext .vue,.ts --fix",
+    "lint:style": "stylelint \"**/*.{scss,css,vue}\" --fix",
+    "lint:all": "pnpm lint:script && pnpm lint:style",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "wiki:dev": "vitepress dev wikis",
+    "wiki:build": "vitepress build wikis",
+    "mcp:build:index": "tsx mcp/scripts/build-index.ts",
+    "mcp:build": "tsc -p mcp/tsconfig.json && pnpm mcp:build:index",
+    "mcp:start": "node dist/mcp/index.js",
+    "mcp:dev": "tsx mcp/src/index.ts"
   }
 }