@blueking/chat-x 0.0.47-beta.4 → 0.0.49-beta.1

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-07-16T12:12:34.511Z",
+  "generatedAt": "2026-07-29T07:29:01.699Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -14,6 +14,7 @@
       "components": [
         "activity-message",
         "assistant-message",
+        "file-artifact-panel",
         "info-message",
         "loading-message",
         "message-render",
@@ -52,6 +53,7 @@
         "file-upload-btn",
         "input-attachment",
         "input-info-alert",
+        "model-selector",
         "selection-footer",
         "shortcut-btn",
         "shortcut-btns",
@@ -787,6 +789,10 @@
           "slug": "chat-container",
           "relation": "顶层聊天布局中作为输入区子组件"
         },
+        {
+          "slug": "model-selector",
+          "relation": "传入 models 后在发送按钮左侧默认展示模型选择器"
+        },
         {
           "slug": "cite-content",
           "relation": "消息引用区展示选中的上下文片段"
@@ -834,6 +840,25 @@
       "docFile": "docs/input-info-alert.md",
       "domain": "input"
     },
+    {
+      "name": "ModelSelector 模型选择器",
+      "slug": "model-selector",
+      "kind": "component",
+      "description": "聊天输入区的模型下拉选择器，支持搜索过滤、能力标签与键盘导航。",
+      "aiSummary": "聊天输入区的模型下拉选择器，支持搜索过滤、能力标签与键盘导航。 源码位置：src/components/chat-input/model-selector/model-selector.vue。",
+      "relatedComponents": [
+        {
+          "slug": "chat-input",
+          "relation": "传入 models 后在发送按钮左侧默认渲染"
+        },
+        {
+          "slug": "input-attachment",
+          "relation": "通过 before-send 插槽与发送按钮成组布局"
+        }
+      ],
+      "docFile": "docs/model-selector.md",
+      "domain": "input"
+    },
     {
       "name": "SelectionFooter 多选操作栏",
       "slug": "selection-footer",
@@ -1039,8 +1064,20 @@
           "relation": "由 MessageRender 在 role 为 activity 时创建"
         },
         {
-          "slug": "assistant-message",
-          "relation": "常与助手回复相邻，描述检索或执行背景"
+          "slug": "flow-agent-content",
+          "relation": "activityType 为 flow_agent 时渲染"
+        },
+        {
+          "slug": "knowledge-rag-content",
+          "relation": "activityType 为 knowledge_rag 时渲染"
+        },
+        {
+          "slug": "reference-doc-content",
+          "relation": "activityType 为 reference_document 时渲染"
+        },
+        {
+          "slug": "chat-container",
+          "relation": "uid / onInterruptResume / 侧栏 Tab 与 ChatContainer 联动"
         }
       ],
       "docFile": "docs/activity-message.md",
@@ -1050,8 +1087,8 @@
       "name": "AssistantMessage AI 助手消息",
       "slug": "assistant-message",
       "kind": "component",
-      "description": "渲染助手消息主体、工具调用与文件内容，默认插槽可覆盖正文渲染。",
-      "aiSummary": "渲染助手消息主体、工具调用与文件内容，默认插槽可覆盖正文渲染。 源码位置：src/components/chat-message/assistant-message/assistant-message.vue。",
+      "description": "渲染助手消息主体、工具调用与文件产物，默认插槽可覆盖正文渲染。",
+      "aiSummary": "渲染助手 Markdown 正文、ToolCallRender 工具调用列表，以及 property.artifacts 文件卡片； 默认插槽仅覆盖正文。源码位置：src/components/chat-message/assistant-message/assistant-message.vue。",
       "relatedComponents": [
         {
           "slug": "message-render",
@@ -1064,11 +1101,42 @@
         {
           "slug": "toolcall-render",
           "relation": "多条工具调用由 ToolcallRender 统一渲染"
+        },
+        {
+          "slug": "file-artifact-panel",
+          "relation": "property.artifacts 文件产物点击后在侧栏预览"
         }
       ],
       "docFile": "docs/assistant-message.md",
       "domain": "message"
     },
+    {
+      "name": "FileArtifactPanel 文件产物预览",
+      "slug": "file-artifact-panel",
+      "kind": "component",
+      "description": "汇总当前会话全部文件产物，支持搜索、选中与分类型预览，挂载在 ChatContainer 侧栏「文件产物」Tab。",
+      "aiSummary": "汇总当前会话所有 AssistantMessage 的 artifacts，支持关键词搜索、列表选中与下载； 预览区委托 ArtifactPreviewHost：按类型走 text_from_download（html / markdown / md / txt / json） 或 preview_url_iframe（其余类型）；download_url / preview_url 经 onArtifactClick 异步获取。 源码位置：src/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue。",
+      "relatedComponents": [
+        {
+          "slug": "assistant-message",
+          "relation": "文件产物来源于 AssistantMessage.property.artifacts"
+        },
+        {
+          "slug": "chat-container",
+          "relation": "面板挂载在侧栏「文件产物」Tab（固定、不可关闭），并通过 onArtifactClick 异步取链"
+        },
+        {
+          "slug": "execution-summary",
+          "relation": "同为 ChatContainer 侧栏 Tab 面板，交互形态一致"
+        },
+        {
+          "slug": "message-loading",
+          "relation": "ArtifactPreviewHost 取链 / 拉取正文过程使用 MessageLoading"
+        }
+      ],
+      "docFile": "docs/file-artifact-panel.md",
+      "domain": "message"
+    },
     {
       "name": "InfoMessage 信息消息",
       "slug": "info-message",
@@ -1165,8 +1233,8 @@
       "name": "ToolMessage 工具消息",
       "slug": "tool-message",
       "kind": "component",
-      "description": "渲染工具返回内容，JSON 场景交给 DescPanel 展示。",
-      "aiSummary": "渲染工具返回内容，JSON 场景交给 DescPanel 展示。 源码位置：src/components/chat-message/tool-message/tool-message.vue。",
+      "description": "渲染工具返回内容，JSON 场景交给 DescPanel + HighlightKeyword 展示。",
+      "aiSummary": "渲染工具返回内容；DescPanel 解析 JSON 为 key-value，嵌套值 JSON.stringify 后经 HighlightKeyword 展示。 源码位置：src/components/chat-message/tool-message/tool-message.vue。",
       "relatedComponents": [
         {
           "slug": "assistant-message",
@@ -1188,8 +1256,8 @@
       "name": "UserMessage 用户消息",
       "slug": "user-message",
       "kind": "component",
-      "description": "渲染用户消息，支持文本、键值、Markdown、引用、文件和编辑态输入。",
-      "aiSummary": "渲染用户消息，支持文本、键值、Markdown、引用、文件和编辑态输入。 源码位置：src/components/chat-message/user-message/user-message.vue。",
+      "description": "渲染用户消息，支持纯文本、键值引用、文件附件和编辑态输入。",
+      "aiSummary": "渲染用户消息：纯文本（非 Markdown）、键值引用、二进制附件与编辑态 ChatInput / ShortcutRender； 工具栏含 copy / cite / edit / delete。源码位置：src/components/chat-message/user-message/user-message.vue。",
       "relatedComponents": [
         {
           "slug": "message-render",
@@ -1202,6 +1270,10 @@
         {
           "slug": "message-container",
           "relation": "嵌入列表时由 MessageContainer 管理分组与多选"
+        },
+        {
+          "slug": "chat-input",
+          "relation": "编辑态普通消息使用 ChatInput"
         }
       ],
       "docFile": "docs/user-message.md",
@@ -1431,8 +1503,8 @@
       "name": "ChatContainer 聊天容器",
       "slug": "chat-container",
       "kind": "component",
-      "description": "完整对话容器，组合消息列表、输入区、快捷指令、执行摘要、分享选择和自定义 Tab。",
-      "aiSummary": "完整对话容器，组合消息列表、输入区、快捷指令、执行摘要、分享选择和自定义 Tab。 源码位置：src/components/chat-container/chat-container.vue。",
+      "description": "完整对话容器，组合消息列表、输入区、模型选择、快捷指令、执行摘要、分享选择和自定义 Tab。",
+      "aiSummary": "完整对话容器，组合消息列表、输入区、模型选择、快捷指令、执行摘要、分享选择和自定义 Tab。 透传 models / selectedModel；支持 welcomeTitle 与 #welcome。 源码位置：src/components/chat-container/chat-container.vue。",
       "relatedComponents": [
         {
           "slug": "message-container",
@@ -1442,6 +1514,10 @@
           "slug": "chat-input",
           "relation": "对话输入与快捷指令入口"
         },
+        {
+          "slug": "model-selector",
+          "relation": "透传 models / selectedModel，在输入区展示模型选择器"
+        },
         {
           "slug": "shortcut-render",
           "relation": "快捷指令表单浮层"
@@ -1505,6 +1581,28 @@
       ],
       "docFile": "docs/use-animation-text.md"
     },
+    {
+      "name": "useArtifactPreview",
+      "slug": "use-artifact-preview",
+      "kind": "composable",
+      "description": "Provider/Consumer 模式的文件产物预览状态管理，用于 ChatContainer 侧栏「文件产物」Tab 的命中与切换。 Provider 在 ChatContainer 中创建，Consumer 在深层文件卡片中注入使用。",
+      "aiSummary": "useArtifactPreviewProvider 维护 activeArtifactId，openPreview 命中文件并触发 onOpen 打开侧栏 Tab； 并通过 getOnArtifactClick 封装 resolveArtifactUrls（按 outputId 缓存 download_url / preview_url）； useArtifactPreviewConsumer 在后代注入同一套 API。buildArtifactId 用 messageUid#index#outputId 生成唯一 id。 正文加载与分类型渲染不在本 composable，由 FileArtifactPanel 内 ArtifactPreviewHost 完成。 FILE_ARTIFACT_TAB_NAME 标识固定「文件产物」Tab。",
+      "relatedComponents": [
+        {
+          "slug": "chat-container",
+          "relation": "Provider 主场景，聚合 sessionArtifacts 并挂载 FileArtifactPanel"
+        },
+        {
+          "slug": "file-artifact-panel",
+          "relation": "侧栏面板消费 activeArtifactId 与 setActiveArtifactId；预览加载在面板内 Host"
+        },
+        {
+          "slug": "assistant-message",
+          "relation": "文件产物来源 property.artifacts"
+        }
+      ],
+      "docFile": "docs/use-artifact-preview.md"
+    },
     {
       "name": "useClipboard",
       "slug": "use-clipboard",

package/dist/types/tool.d.ts

@@ -1,4 +1,5 @@
-import type { ToolIconsMap } from '../icons/tools';
+import type { Component, VNode } from 'vue';
+import type { ToolIcons } from '../icons/tools';
 import type { TippyOptions } from 'vue-tippy';
 export declare enum MessageToolsStatus {
     Disabled = "disabled",// 禁用
@@ -7,6 +8,9 @@ export declare enum MessageToolsStatus {
 export type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'placement' | 'zIndex'>>;
 export interface IToolBtn {
     description?: string;
-    id?: keyof typeof ToolIconsMap;
+    hidden?: boolean;
+    icon?: Component | VNode;
+    id?: (string & {}) | ToolIcons;
     name?: string;
+    triggerSelection?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.47-beta.4",
+  "version": "0.0.49-beta.1",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
   "bin": {
@@ -79,7 +79,7 @@
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
     "vue-tsc": "^3.1.4",
-    "@blueking/chat-helper": "0.0.12-beta.10"
+    "@blueking/chat-helper": "0.0.12-beta.11"
   },
   "scripts": {
     "dev": "vite --config vite.config.ts",