@blueking/chat-x 2.4.1 → 3.0.0-beta.2

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

@@ -200,7 +200,7 @@ AI 可在一次回复中发起多个工具调用，组件依次渲染：
 
 ### MCP 工具调用
 
-`function.type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，`ToolCallRender` 头部显示为「调用 MCP {mcpName} / {name}」：
+`function.function_type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，`ToolCallRender` 头部显示为「调用 MCP {mcpName} / {name}」：
 
 ```vue
 <script setup lang="ts">
@@ -209,7 +209,7 @@ AI 可在一次回复中发起多个工具调用，组件依次渲染：
       id: 'call_mcp_1',
       type: 'function',
       function: {
-        type: 'mcp', // 调用类型，缺省时有 mcpName 也会兼容判定为 MCP
+        function_type: 'mcp', // 调用类型，缺省时有 mcpName 也会兼容判定为 MCP
         name: 'query_database',
         arguments: '{"sql": "SELECT * FROM users LIMIT 10"}',
         description: '执行数据库查询',
@@ -482,6 +482,7 @@ type FunctionCall = {
   arguments: string; // JSON 字符串格式的参数
   description?: string; // 函数描述
   mcpName?: string; // MCP 服务名（存在时标题显示 "调用 MCP"）
+  function_type?: 'function' | 'mcp' | 'skill'; // 调用类型，决定头部前缀；不传时有 mcpName 按 MCP 判定
 };
 
 // 工具执行结果

package/dist/mcp/generated/docs/chat-container.md

@@ -550,7 +550,7 @@ ai-chat-container（:data-ai-size="size"）
 
 ## 分享模式
 
-点击消息工具栏的「分享」按钮后进入分享模式，底部出现 `SelectionFooter` 操作栏：
+点击消息工具栏的「分享」按钮后进入分享模式，并默认勾选当前轮次；底部出现 `SelectionFooter` 操作栏：
 
 ```vue
 <template>
@@ -618,7 +618,7 @@ ai-chat-container（:data-ai-size="size"）
 **分享流程**：
 
 1. 用户点击消息工具栏中的「分享」按钮（或任意 `triggerSelection: true` 的自定义按钮）
-2. 进入多选模式，用户勾选要分享的消息
+2. 进入多选模式，并默认勾选当前轮次（用户问题 + 对应回复）；`enterShareMode()` 进入时不预选
 3. 底部 `SelectionFooter` 提供全选、取消、确认操作
 4. 确认后触发 `confirmShare` 事件，携带选中的消息列表与触发按钮对象（`source`）
 
@@ -630,7 +630,7 @@ ai-chat-container（:data-ai-size="size"）
 
 **2. 资源引用入口**：容器通过 [useInputMention](/composables/use-input-mention) 提供 `insertMention`，消息区的文件卡片与侧栏产物面板因此能直接把文件「@ 进输入框」，无需逐层透传输入框实例。没有输入框的场景（`Share` 只读态）自动不显示引用按钮。
 
-**3. 编辑态菜单下发**：`menuSources` 经 [useGlobalConfig](/composables/use-global-config) 注入，用户消息进入编辑态时就地渲染的 `ChatInput` 也能拿到同一份数据源。`supportUpload` 同样下发，编辑态输入框也会出现内置「文件」项。
+**3. 编辑态菜单与上传下发**：`menuSources` 经 [useGlobalConfig](/composables/use-global-config) 注入，用户消息进入编辑态时就地渲染的 `ChatInput` 也能拿到同一份数据源。`supportUpload` 同样下发，编辑态输入框也会出现内置「文件」项。主输入框的 `onUpload` 与 `deleteFile` 一并注入，编辑态新选文件会走同一套 upload / DELETE，无需再向 `UserMessage` 透传。
 
 ```vue
 <template>
@@ -804,7 +804,7 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 | addCustomTab    | `(tab: CustomTab) => void`  | 添加自定义 Tab |
 | removeCustomTab | `(tabName: string) => void` | 移除自定义 Tab |
 | selectCustomTab | `(tab: CustomTab) => void`  | 切换到指定 Tab |
-| enterShareMode  | `() => void`                | 手动进入分享多选模式 |
+| enterShareMode  | `() => void`                | 手动进入分享多选模式（不预选消息） |
 | exitShareMode   | `() => void`                | 退出分享多选模式，并清空已选消息 |
 
 ## 渲染模式

package/dist/mcp/generated/docs/chat-input.md

@@ -44,7 +44,7 @@ ai-chat-input-container（padding: 0 16px 16px）
                 └── slot#send-icon（默认：发送 / 停止图标）
 ```
 
-> `slot#attachment` 只替换快捷指令区，`AddMenuBtn` 在其外部，使用该插槽不会移除 + 号。`slot#send-icon` 只替换图标，点击逻辑与按钮样式仍由组件控制。
+> `slot#attachment` 只替换快捷指令区，`AddMenuBtn` 在其外部，使用该插槽不会移除 + 号。`slot#send-icon` 替换发送区；未传入时仍用默认发送 / 停止图标。自定义该插槽时需自行处理禁用，作用域参数 `sendDisabledTip` 为上传中 / 失败等拦截文案。
 
 ## 基础用法
 
@@ -527,7 +527,7 @@ const defaultFiles: UploadFile[] = [
 | files          | `{ files: Partial<UploadFile>[] }`                               | 文件预览区                                               |
 | attachment     | -                                                                | 底部快捷指令区，`AddMenuBtn` 在其左侧，不受此插槽影响    |
 | model-selector | `{ models: IModelOption[]; selectedModel: string \| undefined }` | 发送按钮左侧模型选择区，默认渲染 `ModelSelector`         |
-| send-icon      | -                                                                | 发送按钮内图标，点击逻辑与样式仍由组件控制               |
+| send-icon      | `{ sendDisabledTip?: string }`                                   | 替换发送区；自定义时需自行处理禁用，拦截文案见 `sendDisabledTip` |
 
 ### Expose
 
@@ -537,7 +537,8 @@ const defaultFiles: UploadFile[] = [
 | ------------------ | --------------------------------- | ------------------------------------------------ |
 | focus              | `() => void`                      | 聚焦编辑器并把光标置于末尾                       |
 | insertMention      | `(item: IInputMenuItem) => void`  | 把条目以标签形式追加到文档末尾（不依赖当前光标） |
-| triggerSendMessage | `() => void`                      | 手动触发发送逻辑                                 |
+| getUploadFiles     | `() => Partial<UploadFile>[]`     | 当前待发送附件快照（编辑态取消时据此清理本次新文件） |
+| triggerSendMessage | `() => Promise<boolean>`          | 手动触发发送；真正发出返回 `true`，上传中/失败拦截返回 `false` |
 | uploadedArtifacts  | `AIFileInfo[]`                    | 已上传且带 `outputId` 的附件列表（只读）         |
 
 ## 键盘快捷键

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

@@ -227,7 +227,7 @@ type FunctionCall = {
   description?: string;
   mcpName?: string;
   // 决定 ToolcallRender 头部前缀（调用工具 / 调用 MCP / 读取 Skill）
-  type?: FunctionCallType;
+  function_type?: FunctionCallType;
 };
 
 // 示例

package/dist/mcp/generated/docs/toolcall-render.md

@@ -104,20 +104,20 @@ isPending = !isSuccess && !isError; // 其余（含 pending / streaming / stop /
 
 ## 调用类型前缀
 
-非进行中态的前缀由 `function.type` 决定；进行中态工具 / MCP 显示「正在调用」，Skill 显示「正在读取」：
+非进行中态的前缀由 `function.function_type` 决定；进行中态工具 / MCP 显示「正在调用」，Skill 显示「正在读取」：
 
-| `function.type`          | 前缀        | 说明                                     |
+| `function.function_type` | 前缀        | 说明                                     |
 | ------------------------ | ----------- | ---------------------------------------- |
 | `'function'` / 不传      | 调用工具    | 普通函数调用                             |
 | `'mcp'`                  | 调用 MCP    | MCP 调用，通常同时带 `mcpName`           |
 | `'skill'`                | 读取 Skill  | Skill 读取                               |
 
 ```typescript
-const callType = fn?.type ?? (fn?.mcpName ? 'mcp' : 'function');
+const callType = fn?.function_type ?? (fn?.mcpName ? 'mcp' : 'function');
 ```
 
-- **旧数据兼容**：未下发 `type` 时，有 `mcpName` 仍按 MCP 判定，历史消息展示不变
-- **`type` 优先**：显式 `type: 'function'` 不会被 `mcpName` 覆盖回 MCP，但标题仍是 `{mcpName} / {name}`
+- **旧数据兼容**：未下发 `function_type` 时，有 `mcpName` 仍按 MCP 判定，历史消息展示不变
+- **`function_type` 优先**：显式 `function_type: 'function'` 不会被 `mcpName` 覆盖回 MCP，但标题仍是 `{mcpName} / {name}`
 
 **三种前缀对比**
 
@@ -194,14 +194,14 @@ const toolCallWithDuration: ToolCall = {
 
 ## MCP 调用
 
-`function.type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，前缀为「调用 MCP」，标题格式变为 `{mcpName} / {functionName}`：
+`function.function_type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，前缀为「调用 MCP」，标题格式变为 `{mcpName} / {functionName}`：
 
 ```typescript
 const mcpToolCall: ToolCall = {
   id: 'call_mcp_1',
   type: 'function',
   function: {
-    type: 'mcp', // ← 前缀显示「调用 MCP」；缺省时有 mcpName 也会兼容判定为 MCP
+    function_type: 'mcp', // ← 前缀显示「调用 MCP」；缺省时有 mcpName 也会兼容判定为 MCP
     name: 'query_table',
     arguments: JSON.stringify({ table: 'events', limit: 50 }),
     description: '通过 MCP 协议查询蓝鲸数据平台中的事件数据',
@@ -329,8 +329,8 @@ type FunctionCall = {
   name: string; // 函数名；为空时标题 fallback 为 toolCall.id
   arguments: string; // 调用参数（通常为 JSON 字符串）
   description?: string; // 工具描述；为空时"描述"区块保留但内容为空白
-  mcpName?: string; // MCP 服务名；有值时标题格式变为 "{mcpName} / {name}"，缺省 type 时兼容判定为 MCP
-  type?: FunctionCallType; // 调用类型，决定头部前缀；不传按 mcpName 兼容判定
+  mcpName?: string; // MCP 服务名；有值时标题格式变为 "{mcpName} / {name}"，缺省 function_type 时兼容判定为 MCP
+  function_type?: FunctionCallType; // 调用类型，决定头部前缀；不传按 mcpName 兼容判定
 };
 
 // ToolMessage —— 工具返回消息

package/dist/mcp/generated/docs/use-global-config.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>、menuSources?: ComputedRef<IInputMenuItem[]>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload、timezone 与 menuSources； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。
+useGlobalConfig 接收 GlobalConfig（含 size、supportUpload、timezone、menuSources、onUpload、onDeleteFile），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload、timezone、menuSources 以及主输入框同源的 onUpload / onDeleteFile； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。
 
 ### 关联组件
 - **chat-container** — 根容器调用 useGlobalConfig 注入 supportUpload
@@ -97,6 +97,10 @@ export type GlobalConfig = {
   timezone?: ComputedRef<string | undefined>;
   /** 输入框菜单数据源；消息编辑态的内嵌输入框据此渲染 @ / \ 与 + 号菜单 */
   menuSources?: ComputedRef<IInputMenuItem[]>;
+  /** 编辑态内嵌输入框复用主输入框的上传实现 */
+  onUpload?: (files: File[]) => Promise<ChatInputUploadResult | ChatInputUploadResult[]>;
+  /** 取消编辑态草稿里本次新选的附件；与主输入框 `@delete-file` 同源 */
+  onDeleteFile?: (file: Partial<UploadFile>) => void;
 };
 
 export function useGlobalConfig(options: GlobalConfig): {
@@ -104,6 +108,8 @@ export function useGlobalConfig(options: GlobalConfig): {
   supportUpload: ComputedRef<boolean>;
   timezone?: ComputedRef<string | undefined>;
   menuSources?: ComputedRef<IInputMenuItem[]>;
+  onUpload?: GlobalConfig['onUpload'];
+  onDeleteFile?: GlobalConfig['onDeleteFile'];
 };
 
 export function injectGlobalConfig(): GlobalConfig | undefined;
@@ -121,9 +127,10 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 | --------------- | ------------------------------------------------------------------------ |
 | `size`          | 可选。字号主题档位 `normal`（14px）/ `small`（12px），与 `ChatContainer.size` 对齐 |
 | `supportUpload` | 是否支持上传，与根容器 `ChatContainer` 的 `supportUpload` 等展示策略对齐 |
-| `menuSources`   | 可选。输入框菜单数据源，供消息编辑态的内嵌 `ChatInput` 使用 |
-| `timezone`      | 可选。消息时间展示所用的 IANA 时区名，与 `ChatContainer.timezone` 对齐；未配置时 `MessageTime` 按浏览器时区展示 |
 | `menuSources`   | 可选。输入框菜单数据源，与 `ChatInput.menuSources` 同源（`ChatContainer` 传入的是补齐会话产物后的结果）；[UserMessage](../components/message/user-message) 编辑态据此渲染菜单，未配置时编辑态无菜单 |
+| `timezone`      | 可选。消息时间展示所用的 IANA 时区名，与 `ChatContainer.timezone` 对齐；未配置时 `MessageTime` 按浏览器时区展示 |
+| `onUpload`      | 可选。编辑态内嵌 `ChatInput` 复用主输入框的上传回调，类型与 `ChatInput.onUpload` 一致 |
+| `onDeleteFile`  | 可选。编辑态取消/删除本次新选附件时调用，与主输入框 `@delete-file` 同源 |
 
 ### `useGlobalConfig(options)`
 
@@ -132,6 +139,8 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 | `options.size`          | 可选。字号主题档位，建议使用 `computed(() => props.size ?? 'small')` 与根 props 同步 |
 | `options.supportUpload` | 是否支持上传，建议使用 `computed(() => props.supportUpload ?? false)` 与根 props 同步 |
 | `options.timezone`      | 可选。消息时间时区，建议使用 `computed(() => props.timezone)` 与根 props 同步；不设默认值，交由 `MessageTime` 回退浏览器时区 |
+| `options.onUpload`      | 可选。建议传入根容器已有的 `onUpload` prop，供编辑态复用 |
+| `options.onDeleteFile`  | 可选。建议转发根容器 `deleteFile` 事件，供编辑态清理本次新文件 |
 
 - 调用后立即 `provide(GLOBAL_CONFIG_TOKEN, options)`。
 - 必须在具有组件实例上下文的 `setup` 中调用（与 Vue `provide` 要求一致）。
@@ -151,7 +160,7 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size`、`supportUpload`、`timezone` 与 `menuSources`
-- [UserMessage](../components/message/user-message) — 编辑态读取 `supportUpload` 与 `menuSources`
+- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size`、`supportUpload`、`timezone`、`menuSources` 以及 `onUpload` / `onDeleteFile`
+- [UserMessage](../components/message/user-message) — 编辑态读取 `supportUpload`、`menuSources`、`onUpload` 与 `onDeleteFile`
 - [MessageTime](../components/feedback/message-time) — 读取 `timezone` 展示消息时间
 - [主题配置](../theme/theme) — `data-ai-size` 与 CSS 变量说明

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

@@ -72,8 +72,9 @@
       defaultUploadFiles: binaryFiles
       menuSources: injectGlobalConfig().menuSources
       #send-icon slot → .user-edit-footer
-            Button "取消" → isEdit=false
-            Button primary "发送" → chatInputRef.triggerSendMessage() + isEdit=false
+            Button "取消" → 清理本次新上传文件 + isEdit=false
+            Button primary "发送" → 有 sendDisabledTip 时禁用并提示；否则 triggerSendMessage()，仅真正发出时 isEdit=false
+            onUpload / @delete-file 来自 injectGlobalConfig()（与主输入框同源）
 ```
 
 ## 资源标签回显与正文折叠
@@ -351,7 +352,9 @@ binaryFiles 有值   → 进入编辑模式（editContent 可为空）
 
 ## 全局配置透传
 
-编辑态 `ChatInput` 的上传能力与菜单数据源都来自 `injectGlobalConfig()`——`supportUpload` 与 `menuSources`（通常由 `ChatContainer` 注册）。自定义 `#message` 插槽时须把同一配置链路保留，否则编辑态会与主输入区不一致（菜单为空、无法上传）。
+编辑态 `ChatInput` 的上传能力与菜单数据源都来自 `injectGlobalConfig()`——`supportUpload`、`menuSources`、`onUpload` 与 `onDeleteFile`（通常由 `ChatContainer` 注册）。自定义 `#message` 插槽时须把同一配置链路保留，否则编辑态会与主输入区不一致（菜单为空、无法调用 upload 接口）。
+
+删除原消息回填附件（无本地 `File`）只影响即将重发的草稿，不立刻 DELETE 远端；删除本次新选文件或点「取消」时，才对带 `File` 的附件调用 `onDeleteFile`。上传未完成或存在失败项时 `triggerSendMessage` 返回 `false`，保持编辑态；`#send-icon` 的 `sendDisabledTip` 会禁用「发送」并展示拦截文案。成功发送不调用 `onDeleteFile`。
 
 ```vue
 <template>
@@ -397,7 +400,7 @@ binaryFiles 有值   → 进入编辑模式（editContent 可为空）
 
 ### 全局配置依赖
 
-编辑态 `ChatInput` 通过 `injectGlobalConfig()` 读取 `supportUpload` 与 `menuSources`（缺省为空数组，即编辑态无菜单）。祖先需已 `useGlobalConfig()`（通常由 `ChatContainer` 注册）。
+编辑态 `ChatInput` 通过 `injectGlobalConfig()` 读取 `supportUpload`、`menuSources`、`onUpload` 与 `onDeleteFile`（`menuSources` 缺省为空数组，即编辑态无菜单）。祖先需已 `useGlobalConfig()`（通常由 `ChatContainer` 注册）。
 
 ## 类型定义
 

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-09-21T11:36:57.667Z",
+  "generatedAt": "2026-09-23T07:00:56.590Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -1881,8 +1881,8 @@
       "name": "useGlobalConfig",
       "slug": "use-global-config",
       "kind": "composable",
-      "description": "在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传、消息时间时区、输入框菜单数据源）。",
-      "aiSummary": "useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>、menuSources?: ComputedRef<IInputMenuItem[]>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload、timezone 与 menuSources； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。",
+      "description": "在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传、消息时间时区、输入框菜单数据源、编辑态上传/删除回调）。",
+      "aiSummary": "useGlobalConfig 接收 GlobalConfig（含 size、supportUpload、timezone、menuSources、onUpload、onDeleteFile），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload、timezone、menuSources 以及主输入框同源的 onUpload / onDeleteFile； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。",
       "relatedComponents": [
         {
           "slug": "chat-container",

package/package.json

@@ -1,26 +1,8 @@
 {
   "name": "@blueking/chat-x",
-  "version": "2.4.1",
+  "version": "3.0.0-beta.2",
   "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"
   },
@@ -69,7 +51,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",
@@ -98,6 +79,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": "3.0.0-beta.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"
   }
-}
+}

package/skills/blueking-chat-x/references/components/assistant-message.md

@@ -196,7 +196,7 @@ AI 可在一次回复中发起多个工具调用，组件依次渲染：
 
 ### MCP 工具调用
 
-`function.type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，`ToolCallRender` 头部显示为「调用 MCP {mcpName} / {name}」：
+`function.function_type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，`ToolCallRender` 头部显示为「调用 MCP {mcpName} / {name}」：
 
 ```vue
 <script setup lang="ts">
@@ -205,7 +205,7 @@ AI 可在一次回复中发起多个工具调用，组件依次渲染：
       id: 'call_mcp_1',
       type: 'function',
       function: {
-        type: 'mcp', // 调用类型，缺省时有 mcpName 也会兼容判定为 MCP
+        function_type: 'mcp', // 调用类型，缺省时有 mcpName 也会兼容判定为 MCP
         name: 'query_database',
         arguments: '{"sql": "SELECT * FROM users LIMIT 10"}',
         description: '执行数据库查询',
@@ -478,6 +478,7 @@ type FunctionCall = {
   arguments: string; // JSON 字符串格式的参数
   description?: string; // 函数描述
   mcpName?: string; // MCP 服务名（存在时标题显示 "调用 MCP"）
+  function_type?: 'function' | 'mcp' | 'skill'; // 调用类型，决定头部前缀；不传时有 mcpName 按 MCP 判定
 };
 
 // 工具执行结果

package/skills/blueking-chat-x/references/components/toolcall-render.md

@@ -101,20 +101,20 @@ isPending = !isSuccess && !isError; // 其余（含 pending / streaming / stop /
 
 ## 调用类型前缀
 
-非进行中态的前缀由 `function.type` 决定；进行中态工具 / MCP 显示「正在调用」，Skill 显示「正在读取」：
+非进行中态的前缀由 `function.function_type` 决定；进行中态工具 / MCP 显示「正在调用」，Skill 显示「正在读取」：
 
-| `function.type`          | 前缀        | 说明                                     |
+| `function.function_type` | 前缀        | 说明                                     |
 | ------------------------ | ----------- | ---------------------------------------- |
 | `'function'` / 不传      | 调用工具    | 普通函数调用                             |
 | `'mcp'`                  | 调用 MCP    | MCP 调用，通常同时带 `mcpName`           |
 | `'skill'`                | 读取 Skill  | Skill 读取                               |
 
 ```typescript
-const callType = fn?.type ?? (fn?.mcpName ? 'mcp' : 'function');
+const callType = fn?.function_type ?? (fn?.mcpName ? 'mcp' : 'function');
 ```
 
-- **旧数据兼容**：未下发 `type` 时，有 `mcpName` 仍按 MCP 判定，历史消息展示不变
-- **`type` 优先**：显式 `type: 'function'` 不会被 `mcpName` 覆盖回 MCP，但标题仍是 `{mcpName} / {name}`
+- **旧数据兼容**：未下发 `function_type` 时，有 `mcpName` 仍按 MCP 判定，历史消息展示不变
+- **`function_type` 优先**：显式 `function_type: 'function'` 不会被 `mcpName` 覆盖回 MCP，但标题仍是 `{mcpName} / {name}`
 
 **三种前缀对比**
 
@@ -191,14 +191,14 @@ const toolCallWithDuration: ToolCall = {
 
 ## MCP 调用
 
-`function.type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，前缀为「调用 MCP」，标题格式变为 `{mcpName} / {functionName}`：
+`function.function_type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，前缀为「调用 MCP」，标题格式变为 `{mcpName} / {functionName}`：
 
 ```typescript
 const mcpToolCall: ToolCall = {
   id: 'call_mcp_1',
   type: 'function',
   function: {
-    type: 'mcp', // ← 前缀显示「调用 MCP」；缺省时有 mcpName 也会兼容判定为 MCP
+    function_type: 'mcp', // ← 前缀显示「调用 MCP」；缺省时有 mcpName 也会兼容判定为 MCP
     name: 'query_table',
     arguments: JSON.stringify({ table: 'events', limit: 50 }),
     description: '通过 MCP 协议查询蓝鲸数据平台中的事件数据',
@@ -326,8 +326,8 @@ type FunctionCall = {
   name: string; // 函数名；为空时标题 fallback 为 toolCall.id
   arguments: string; // 调用参数（通常为 JSON 字符串）
   description?: string; // 工具描述；为空时"描述"区块保留但内容为空白
-  mcpName?: string; // MCP 服务名；有值时标题格式变为 "{mcpName} / {name}"，缺省 type 时兼容判定为 MCP
-  type?: FunctionCallType; // 调用类型，决定头部前缀；不传按 mcpName 兼容判定
+  mcpName?: string; // MCP 服务名；有值时标题格式变为 "{mcpName} / {name}"，缺省 function_type 时兼容判定为 MCP
+  function_type?: FunctionCallType; // 调用类型，决定头部前缀；不传按 mcpName 兼容判定
 };
 
 // ToolMessage —— 工具返回消息

package/skills/blueking-chat-x/references/types/messages.md

@@ -224,7 +224,7 @@ type FunctionCall = {
   description?: string;
   mcpName?: string;
   // 决定 ToolcallRender 头部前缀（调用工具 / 调用 MCP / 读取 Skill）
-  type?: FunctionCallType;
+  function_type?: FunctionCallType;
 };
 
 // 示例