@blueking/chat-x 0.0.48-beta.1 → 0.0.49-beta.2

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-07-27T02:31:49.169Z",
+  "generatedAt": "2026-08-06T04:13:41.238Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -14,6 +14,7 @@
       "components": [
         "activity-message",
         "assistant-message",
+        "file-artifact-panel",
         "info-message",
         "loading-message",
         "message-render",
@@ -361,8 +362,8 @@
       "name": "UserQuestionCard 用户问题中断",
       "slug": "user-question-card",
       "kind": "component",
-      "description": "渲染 UserQuestion 中断的待回答面板，支持单选、多选、Others 与跳过。",
-      "aiSummary": "渲染 UserQuestion 中断的待回答面板，支持单选、多选、Others 与跳过。 源码位置：src/components/chat-message/interrupt-message/user-question/user-question-card.vue。",
+      "description": "渲染 UserQuestion 中断的待回答面板；一次一题分页切换，支持单选/多选、Others、跳过与已完成进度。",
+      "aiSummary": "渲染 UserQuestion 中断的待回答面板：一次只展示一题，标题栏提供题号切换， Footer 展示已完成进度；支持单选自动跳下一题、多选/Others、完成与跳过。 源码位置：src/components/chat-message/interrupt-message/user-question/user-question-card.vue。",
       "relatedComponents": [
         {
           "slug": "interrupt-message",
@@ -1063,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",
@@ -1074,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",
@@ -1088,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（按 outputId 去重），支持关键词搜索、列表选中与下载； 预览区委托 ArtifactPreviewHost：按类型走 text_from_download（html / markdown / md / txt / json） 或 preview_url_iframe（其余类型）；download_url / preview_url 经 onArtifactClick 异步获取（TTL 缓存，重试 force）； 预览重载键为 outputId:type；常规 resolveArtifactUrls 只传 file。 源码位置：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",
@@ -1189,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",
@@ -1212,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",
@@ -1226,6 +1270,10 @@
         {
           "slug": "message-container",
           "relation": "嵌入列表时由 MessageContainer 管理分组与多选"
+        },
+        {
+          "slug": "chat-input",
+          "relation": "编辑态普通消息使用 ChatInput"
         }
       ],
       "docFile": "docs/user-message.md",
@@ -1533,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（值为 outputId），openPreview 命中文件并触发 onOpen 打开侧栏 Tab； 并通过 getOnArtifactClick 封装 resolveArtifactUrls（TTL 8 分钟缓存；常规只传 file，force 可强制刷新，并发去重）； useArtifactPreviewConsumer 在后代注入同一套 API。SessionArtifact 即 AIFileInfo，会话内以 outputId 为唯一键。 正文加载与分类型渲染不在本 composable，由 FileArtifactPanel 内 ArtifactPreviewHost 完成（重载键 outputId:type）。 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",
@@ -1596,7 +1666,7 @@
       "slug": "use-custom-tab",
       "kind": "composable",
       "description": "Provider/Consumer 模式的自定义 Tab 管理，用于 `ChatContainer` 侧边栏的 Tab 动态管理。Provider 在 `ChatContainer` 中创建，Consumer 在任意后代组件中注入使用。",
-      "aiSummary": "useCustomTabProvider 返回 tabs、selectedTab、isCollapse 及 add/remove/selectCustomTab，并通过 provide 共享；可选 onTabChange 在切换时拉取数据。 useCustomTabConsumer 在后代注入同一套 API，常用于侧栏动态节点详情等。EXECUTION_TAB_NAME 标识默认「执行情况」Tab。 ChatContainer 侧栏集成 Provider 与 Tab UI。",
+      "aiSummary": "useCustomTabProvider 返回 tabs、selectedTab、isCollapse 及 add/ensure/remove/selectCustomTab，并通过 provide 共享；可选 onTabChange 在切换时拉取数据。 ensureCustomTab 只挂载/合并元信息，不展开侧栏、不切换选中；addCustomTab 会展开并选中。 useCustomTabConsumer 在后代注入同一套 API，常用于侧栏动态节点详情等。EXECUTION_TAB_NAME 标识默认「执行情况」Tab。 ChatContainer 侧栏集成 Provider 与 Tab UI。",
       "relatedComponents": [
         {
           "slug": "chat-container",
@@ -1717,7 +1787,7 @@
       "slug": "constants",
       "kind": "type",
       "description": "`@blueking/chat-x` 导出的常量和枚举类型。",
-      "aiSummary": "汇总 MessageRole、MessageStatus（含 Fetching 请求中）、MessageContentType、MessageToolsStatus、MessageState、Z-Index 与 CONST_MESSAGE_TOOLS 等导出常量。 用于构造消息、配置 MessageContainer 工具栏与输入态，以及层级与默认快捷指令。与类型 messages 配套使用。",
+      "aiSummary": "汇总 MessageRole、MessageStatus（含 Fetching 请求中、Complete/Completed 完成态兼容）、MessageContentType、MessageToolsStatus、MessageState、Z-Index 与 CONST_MESSAGE_TOOLS 等导出常量。 用于构造消息、配置 MessageContainer 工具栏与输入态，以及层级与默认快捷指令。与类型 messages 配套使用。",
       "relatedComponents": [
         {
           "slug": "message-tools",

package/package.json

@@ -1,26 +1,8 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.48-beta.1",
+  "version": "0.0.49-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"
   },
@@ -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.12-beta.14"
+  },
+  "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"
   }
 }