@blueking/chat-x 0.0.49-beta.7 → 0.0.49-beta.9

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

@@ -1,10 +1,11 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size 与 supportUpload； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。
+useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload 与 timezone； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。
 
 ### 关联组件
 - **chat-container** — 根容器调用 useGlobalConfig 注入 supportUpload
+- **message-time** — 消息时间组件读取 timezone
 
 ---
 <!-- FULL DOC -->
@@ -13,7 +14,7 @@ useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、suppo
 
 > **分类**：composable
 
-在聊天容器根组件与子组件之间通过 Vue `provide` / `inject` 共享**全局展示相关配置**（当前包括字号主题档位 `size`、是否支持上传 `supportUpload`）。与 Teleport 插槽 ID 无关。
+在聊天容器根组件与子组件之间通过 Vue `provide` / `inject` 共享**全局展示相关配置**（当前包括字号主题档位 `size`、是否支持上传 `supportUpload`、消息时间时区 `timezone`）。与 Teleport 插槽 ID 无关。
 
 > 字号主题主要通过 `ChatContainer` 根节点的 `data-ai-size` 与 CSS 变量（`--ai-font-size` 等）生效；`GlobalConfig.size` 供后代在逻辑层读取当前档位，样式层无需逐组件传参。
 
@@ -25,10 +26,11 @@ ChatContainer（根）
   ├── useGlobalConfig({
   │     size: computed(() => props.size ?? 'small'),
   │     supportUpload: computed(() => props.supportUpload ?? false),
+  │     timezone: computed(() => props.timezone),
   │   })
-  │     └── provide(GLOBAL_CONFIG_TOKEN, { size, supportUpload })
+  │     └── provide(GLOBAL_CONFIG_TOKEN, { size, supportUpload, timezone })
   │
-  └── MessageContainer → … → UserMessage 等
+  └── MessageContainer → … → UserMessage / MessageTime 等
 
 UserMessage（后代）
   ├── injectGlobalConfig()
@@ -51,11 +53,14 @@ UserMessage（后代）
   const props = defineProps<{
     size?: 'normal' | 'small';
     supportUpload?: boolean;
+    timezone?: string;
   }>();
 
   useGlobalConfig({
     size: computed(() => props.size ?? 'small'),
     supportUpload: computed(() => props.supportUpload ?? false),
+    // 无默认值：未配置时由 MessageTime 回退到浏览器时区
+    timezone: computed(() => props.timezone),
   });
 </script>
 ```
@@ -88,11 +93,13 @@ export type AiSizeMode = 'normal' | 'small';
 export type GlobalConfig = {
   size?: ComputedRef<AiSizeMode>;
   supportUpload: ComputedRef<boolean>;
+  timezone?: ComputedRef<string | undefined>;
 };
 
 export function useGlobalConfig(options: GlobalConfig): {
   size?: ComputedRef<AiSizeMode>;
   supportUpload: ComputedRef<boolean>;
+  timezone?: ComputedRef<string | undefined>;
 };
 
 export function injectGlobalConfig(): GlobalConfig | undefined;
@@ -110,6 +117,7 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 | --------------- | ------------------------------------------------------------------------ |
 | `size`          | 可选。字号主题档位 `normal`（14px）/ `small`（12px），与 `ChatContainer.size` 对齐 |
 | `supportUpload` | 是否支持上传，与根容器 `ChatContainer` 的 `supportUpload` 等展示策略对齐 |
+| `timezone`      | 可选。消息时间展示所用的 IANA 时区名，与 `ChatContainer.timezone` 对齐；未配置时 `MessageTime` 按浏览器时区展示 |
 
 ### `useGlobalConfig(options)`
 
@@ -117,6 +125,7 @@ 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` 回退浏览器时区 |
 
 - 调用后立即 `provide(GLOBAL_CONFIG_TOKEN, options)`。
 - 必须在具有组件实例上下文的 `setup` 中调用（与 Vue `provide` 要求一致）。
@@ -136,5 +145,6 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size` 与 `supportUpload`
+- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size`、`supportUpload` 与 `timezone`
+- [MessageTime](../components/feedback/message-time) — 读取 `timezone` 展示消息时间
 - [主题配置](../theme/theme) — `data-ai-size` 与 CSS 变量说明

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

@@ -6,6 +6,7 @@
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 user 时创建
 - **message-tools** — 消息工具栏交互与状态由 MessageTools 体系承载
+- **message-time** — createdAt 经工具栏 prepend 插槽展示
 - **message-container** — 嵌入列表时由 MessageContainer 管理分组与多选
 - **chat-input** — 编辑态普通消息使用 ChatInput
 
@@ -47,8 +48,11 @@
       v-if: messageToolsStatus !== 'hidden'
       visibility: hidden（默认）→ visible（:hover 时）
       tools: [copy, cite, edit, delete]，updateTools: []
+      #prepend slot → MessageTime（createdAt，工具图标左侧）
 ```
 
+> **时间随工具栏显隐**：时间位于工具栏内，与工具按钮共用 `visibility` 控制，因此同样在悬停消息时才可见。
+
 **编辑模式**（点击 `edit` 按钮后 `isEdit=true`）
 
 ```
@@ -356,6 +360,7 @@ binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 | 属性名             | 类型                                                                                       | 说明                                                                      |
 | ------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
 | content            | `string \| InputContent[]`                                                                 | 消息内容，字符串或含 text/binary 的数组                                   |
+| createdAt          | `number \| string`                                                                         | 消息创建时间，经 `MessageTools` 的 `#prepend` 插槽交给 `MessageTime` 渲染在工具图标左侧；无值时不展示 |
 | property           | `{ extra?: MessageExtra; artifacts?: AIFileInfo[] }`                                       | 附加属性；本组件消费 `extra.cite` / `shortcut` / `context`                |
 | messageToolsStatus | `MessageToolsStatus`                                                                       | 工具按钮状态，`disabled` 禁用、`hidden` 从 DOM 移除                       |
 | onAction           | `MessageToolsProps['onAction']`                                                            | 工具回调；`copy`/`edit` 有内置行为，`cite`/`delete` 需外部处理            |
@@ -417,4 +422,5 @@ type MessageExtra = {
 
 - [MessageRender](/components/message/message-render) — user 角色由其实例化
 - [MessageTools](/components/feedback/message-tools) — 工具栏交互
+- [MessageTime](/components/feedback/message-time) — 工具栏左侧的消息时间
 - [MessageContainer](/components/setup/message-container) — 列表与多选容器

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-08-11T09:05:16.821Z",
+  "generatedAt": "2026-08-17T11:24:59.221Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -83,6 +83,7 @@
       "label": "工具与反馈",
       "components": [
         "delete-tool",
+        "message-time",
         "message-tools",
         "scroll-btn",
         "tool-btn",
@@ -98,6 +99,7 @@
       "components": [
         "activity-layout",
         "ai-loading",
+        "file-icon",
         "highlight-keyword",
         "message-loading",
         "questions-container",
@@ -433,12 +435,35 @@
       "docFile": "docs/delete-tool.md",
       "domain": "feedback"
     },
+    {
+      "name": "MessageTime 消息时间",
+      "slug": "message-time",
+      "kind": "component",
+      "description": "按「今天 / 昨天 / 今年内 / 跨年」四档格式展示消息创建时间。",
+      "aiSummary": "按 createdAt 展示消息时间，四档格式：今天 `12:00`、昨天 `昨天 12:00`、今年内更早 `3-12 12:00`、非今年 `2025-3-12 12:00`； 时区取 props.timezone，未传时回退 injectGlobalConfig().timezone（由 ChatContainer 的 timezone prop 注入），都没有则用浏览器时区； 无值或非法时间不渲染任何 DOM。通常通过 MessageTools 的 prepend / append 插槽使用。 源码位置：src/components/message-tools/message-time/message-time.vue。",
+      "relatedComponents": [
+        {
+          "slug": "message-tools",
+          "relation": "通过 prepend / append 插槽嵌入工具栏"
+        },
+        {
+          "slug": "user-message",
+          "relation": "用户消息在工具栏左侧展示时间"
+        },
+        {
+          "slug": "message-container",
+          "relation": "AI 消息组在工具栏右侧展示本轮回答时间"
+        }
+      ],
+      "docFile": "docs/message-time.md",
+      "domain": "feedback"
+    },
     {
       "name": "MessageTools 消息工具栏",
       "slug": "message-tools",
       "kind": "component",
       "description": "消息悬浮工具栏，组合复制、删除、反馈等工具按钮。",
-      "aiSummary": "消息悬浮工具栏，组合复制、删除、反馈等工具按钮。 源码位置：src/components/message-tools/message-tools.vue。",
+      "aiSummary": "消息悬浮工具栏，组合复制、删除、反馈等工具按钮；提供 prepend / append 两端插槽承载消息时间等附加内容。 源码位置：src/components/message-tools/message-tools.vue。",
       "relatedComponents": [
         {
           "slug": "tool-btn",
@@ -451,6 +476,10 @@
         {
           "slug": "delete-tool",
           "relation": "id 为 delete 时替换为带确认的删除按钮"
+        },
+        {
+          "slug": "message-time",
+          "relation": "通过 prepend / append 插槽嵌入消息时间"
         }
       ],
       "docFile": "docs/message-tools.md",
@@ -555,6 +584,25 @@
       "docFile": "docs/ai-loading.md",
       "domain": "helper"
     },
+    {
+      "name": "FileIcon 文件类型图标",
+      "slug": "file-icon",
+      "kind": "component",
+      "description": "按文件扩展名渲染对应类型图标，尺寸随外层 font-size 自适应。",
+      "aiSummary": "按扩展名渲染文件类型图标：内联 svg，尺寸用 1em 跟随外层 font-size； 扩展名解析走 normalizeFileExtension（优先 fileType，缺省回退 fileName，大小写不敏感， 支持 Dockerfile / .gitignore 这类无扩展名或点号开头的文件）；未登记类型返回 unknown 兜底图标。 源码位置：src/components/file-icon/file-icon.vue，图标注册表在 src/icons/file-icons.ts。",
+      "relatedComponents": [
+        {
+          "slug": "file-artifact-panel",
+          "relation": "文件产物列表与预览头使用该组件展示类型图标"
+        },
+        {
+          "slug": "assistant-message",
+          "relation": "消息内的文件产物卡片使用该组件"
+        }
+      ],
+      "docFile": "docs/file-icon.md",
+      "domain": "helper"
+    },
     {
       "name": "HighlightKeyword 关键词高亮",
       "slug": "highlight-keyword",
@@ -1115,7 +1163,7 @@
       "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 每次异步获取（无 URL 缓存，并发去重）； 预览重载键为 outputId:type；重试再次调用 load() 重新取链。 源码位置：src/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue。",
+      "aiSummary": "汇总当前会话所有 AssistantMessage 的 artifacts（按 outputId 去重），支持关键词搜索、列表选中与下载； 预览区委托 ArtifactPreviewHost：由 resolveFileKind 把扩展名归入 code / markdown / html / text / image / binary 六类， 前四类走 text_from_download 拉正文（code 交给 highlight.js 高亮），image / binary 走 preview_url； download_url / preview_url 经 onArtifactClick 每次异步获取（无 URL 缓存，并发去重）； 预览重载键为 outputId:type；重试再次调用 load() 重新取链。 源码位置：src/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue。",
       "relatedComponents": [
         {
           "slug": "assistant-message",
@@ -1267,6 +1315,10 @@
           "slug": "message-tools",
           "relation": "消息工具栏交互与状态由 MessageTools 体系承载"
         },
+        {
+          "slug": "message-time",
+          "relation": "createdAt 经工具栏 prepend 插槽展示"
+        },
         {
           "slug": "message-container",
           "relation": "嵌入列表时由 MessageContainer 管理分组与多选"
@@ -1711,12 +1763,16 @@
       "name": "useGlobalConfig",
       "slug": "use-global-config",
       "kind": "composable",
-      "description": "在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传等）。",
-      "aiSummary": "useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size 与 supportUpload； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。",
+      "description": "在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传、消息时间时区等）。",
+      "aiSummary": "useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload 与 timezone； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。",
       "relatedComponents": [
         {
           "slug": "chat-container",
           "relation": "根容器调用 useGlobalConfig 注入 supportUpload"
+        },
+        {
+          "slug": "message-time",
+          "relation": "消息时间组件读取 timezone"
         }
       ],
       "docFile": "docs/use-global-config.md"

package/dist/utils/file-type.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 文件分类：图标兜底与预览渲染策略的共同依据。
+ * - code：可交给 highlight.js 渲染的源码 / 配置文件
+ * - text：纯文本，直接按原文展示
+ * - binary：无法在前端直接解析，统一交由后端 preview_url 预览
+ */
+export type AIFileKind = 'binary' | 'code' | 'html' | 'image' | 'markdown' | 'text';
+/**
+ * 归一化文件类型标识：优先取后台下发的 type，缺省时回退文件名。
+ * 统一转小写并截取最后一段扩展名；无扩展名的文件（Dockerfile / Makefile）直接返回文件名本身。
+ */
+export declare const normalizeFileExtension: (type?: string, name?: string) => string;
+/** 解析文件分类；未登记的扩展名按 binary 兜底 */
+export declare const resolveFileKind: (type?: string, name?: string) => AIFileKind;

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from './file';
+export * from './file-type';
 export * from './markdown-completer';
 export { completeMarkdownSyntax } from './stream-markdown-completer';
 export * from './utils';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.49-beta.7",
+  "version": "0.0.49-beta.9",
   "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.19"
+    "@blueking/chat-helper": "0.0.12-beta.20"
   },
   "scripts": {
     "dev": "vite --config vite.config.ts",

package/dist/components/chat-message/assistant-message/message-artifacts/file-icon.d.ts

@@ -1,29 +0,0 @@
-import { AIFileType } from '../../../../ag-ui/types/file';
-/** 文件类型 → 图标映射；未命中类型兜底用文本图标 */
-export declare const FILE_ICON_MAP: {
-    readonly html: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-    readonly jpg: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-    readonly json: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-    readonly md: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-    readonly markdown: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-    readonly pdf: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-    readonly txt: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-        [key: string]: any;
-    }>;
-};
-/** 图标为共享 VNode，克隆后再渲染，避免同类型多处复用同一实例 */
-export declare const getFileIcon: (type: AIFileType) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
-    [key: string]: any;
-}>;