@blueking/chat-x 0.0.45-beta.5 → 0.0.45-beta.7

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

@@ -1,7 +1,7 @@
 <!-- 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（含 supportUpload: ComputedRef<boolean>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig； UserMessage 等通过 injectGlobalConfig 读取 supportUpload。
 
 ### 关联组件
 - **chat-container** — 根容器调用 useGlobalConfig 注入 supportUpload
@@ -13,20 +13,14 @@ useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、suppo
 
 > **分类**：composable
 
-在聊天容器根组件与子组件之间通过 Vue `provide` / `inject` 共享**全局展示相关配置**（当前包括字号主题档位 `size`、是否支持上传 `supportUpload`）。与 Teleport 插槽 ID 无关。
-
-> 字号主题主要通过 `ChatContainer` 根节点的 `data-ai-size` 与 CSS 变量（`--ai-font-size` 等）生效；`GlobalConfig.size` 供后代在逻辑层读取当前档位，样式层无需逐组件传参。
+在聊天容器根组件与子组件之间通过 Vue `provide` / `inject` 共享**全局展示相关配置**（当前主要为是否支持上传 `supportUpload`）。与 Teleport 插槽 ID 无关。
 
 ## 工作原理
 
 ```
 ChatContainer（根）
-  ├── :data-ai-size="size"（CSS 变量作用域）
-  ├── useGlobalConfig({
-  │     size: computed(() => props.size ?? 'small'),
-  │     supportUpload: computed(() => props.supportUpload ?? false),
-  │   })
-  │     └── provide(GLOBAL_CONFIG_TOKEN, { size, supportUpload })
+  ├── useGlobalConfig({ supportUpload: computed(() => props.supportUpload ?? false) })
+  │     └── provide(GLOBAL_CONFIG_TOKEN, { supportUpload })
   │
   └── MessageContainer → … → UserMessage 等
 
@@ -49,12 +43,10 @@ UserMessage（后代）
   import { useGlobalConfig } from '@blueking/chat-x';
 
   const props = defineProps<{
-    size?: 'normal' | 'small';
     supportUpload?: boolean;
   }>();
 
   useGlobalConfig({
-    size: computed(() => props.size ?? 'small'),
     supportUpload: computed(() => props.supportUpload ?? false),
   });
 </script>
@@ -83,15 +75,11 @@ import type { ComputedRef } from 'vue';
 
 export const GLOBAL_CONFIG_TOKEN: unique symbol;
 
-export type AiSizeMode = 'normal' | 'small';
-
 export type GlobalConfig = {
-  size?: ComputedRef<AiSizeMode>;
   supportUpload: ComputedRef<boolean>;
 };
 
 export function useGlobalConfig(options: GlobalConfig): {
-  size?: ComputedRef<AiSizeMode>;
   supportUpload: ComputedRef<boolean>;
 };
 
@@ -108,14 +96,12 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 
 | 字段            | 说明                                                                     |
 | --------------- | ------------------------------------------------------------------------ |
-| `size`          | 可选。字号主题档位 `normal`（14px）/ `small`（12px），与 `ChatContainer.size` 对齐 |
 | `supportUpload` | 是否支持上传，与根容器 `ChatContainer` 的 `supportUpload` 等展示策略对齐 |
 
 ### `useGlobalConfig(options)`
 
 | 参数                    | 说明                                                                                  |
 | ----------------------- | ------------------------------------------------------------------------------------- |
-| `options.size`          | 可选。字号主题档位，建议使用 `computed(() => props.size ?? 'small')` 与根 props 同步 |
 | `options.supportUpload` | 是否支持上传，建议使用 `computed(() => props.supportUpload ?? false)` 与根 props 同步 |
 
 - 调用后立即 `provide(GLOBAL_CONFIG_TOKEN, options)`。
@@ -136,5 +122,4 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size` 与 `supportUpload`
-- [主题配置](../theme/theme) — `data-ai-size` 与 CSS 变量说明
+- [ChatContainer](../components/molecular/chat-container.md) — 调用 `useGlobalConfig` 注入 `supportUpload`

package/dist/mcp/generated/docs/use-menu-keydown.md

@@ -161,4 +161,4 @@ useMenuKeydown<T>(props: {
 
 ## 关联组件
 
-- [ChatInput](../components/input/chat-input) — `@` 菜单与 `/` 提示词列表
+- [ChatInput](../components/molecular/chat-input.md) — `@` 菜单与 `/` 提示词列表

package/dist/mcp/generated/docs/use-message-group.md

@@ -27,8 +27,6 @@ function useMessageGroup(options: {
 }): {
   messageGroups: Ref<MessageGroup[]>;
   executionGroups: ComputedRef<MessageGroup[]>;
-  pendingApprovalCount: ComputedRef<number>;
-  pendingApprovalTipText: ComputedRef<string>;
   isShareMode: ShallowRef<boolean>;
   isAllSelected: ComputedRef<boolean>;
   onToggleShareAll: (isAllSelected: boolean) => void;
@@ -115,24 +113,6 @@ const isExecutionMessage = (m: Message): boolean => {
 | toolCall   | `function.name`、`mcpName`、`description`、`arguments`、`id` |
 | flow_agent | 各任务 `task_name`、各节点 `name`                             |
 
-## 待审批统计
-
-`useMessageGroup` 会统计消息列表中处于待审批状态的 AI Dev 审批中断：
-
-```typescript
-const pendingApprovalStatusSet = new Set([APPROVAL_STATUS.PENDING, APPROVAL_STATUS.DRAFT]);
-```
-
-当 `MessageRole.Interrupt` 消息的 `content.outcome.type === 'interrupt'`，且其中断项满足 `reason === InterruptReason.AIDevToolApproval`、`metadata.ticket.status` 为 `pending` 或 `draft` 时，计入 `pendingApprovalCount`。
-
-`pendingApprovalTipText` 根据数量生成输入区提示文案：
-
-```typescript
-'当前会话有 {count} 个待审批单，如需继续，请先取消审批'
-```
-
-`ChatContainer` 会消费该返回值，向 `ChatInput` 传入 `sendDisabledTip` 并在输入区上方展示提示，从而阻止继续发送。
-
 ## 分享模式
 
 `useMessageGroup` 提供完整的分享模式支持：
@@ -162,21 +142,12 @@ const keyword = shallowRef('');
 const messages = computed(() => props.messages);
 const selectedUserMessages = deepRef<Message[]>([]);
 
-const {
-  messageGroups,
-  executionGroups,
-  pendingApprovalCount,
-  pendingApprovalTipText,
-  isShareMode,
-  isAllSelected,
-  onToggleShareAll,
-  onCancelShare,
-  onConfirmShare,
-} = useMessageGroup({
-  keyword,
-  messages,
-  selectedUserMessages,
-});
+const { messageGroups, executionGroups, isShareMode, isAllSelected, onToggleShareAll, onCancelShare, onConfirmShare } =
+  useMessageGroup({
+    keyword,
+    messages,
+    selectedUserMessages,
+  });
 ```
 
 ## 返回值说明
@@ -185,8 +156,6 @@ const {
 | ---------------- | ----------------------------- | --------------------------------------------------------------------------- |
 | messageGroups    | `Ref<MessageGroup[]>`         | 完整消息分组列表                                                            |
 | executionGroups  | `ComputedRef<MessageGroup[]>` | 仅包含执行类消息的分组（工具调用 + FlowAgent），自动提取 `userMessageTitle` |
-| pendingApprovalCount | `ComputedRef<number>`      | 当前消息中待审批 AI Dev 审批中断的数量                                      |
-| pendingApprovalTipText | `ComputedRef<string>`    | 待审批阻塞发送提示文案；无待审批时为空字符串                                |
 | isShareMode      | `ShallowRef<boolean>`         | 是否处于分享模式                                                            |
 | isAllSelected    | `ComputedRef<boolean>`        | 所有用户消息组是否全部选中                                                  |
 | onToggleShareAll | `(checked: boolean) => void`  | 切换全选                                                                    |
@@ -212,6 +181,6 @@ interface MessageGroup {
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 调用 useMessageGroup 并下传分组
-- [MessageContainer](../components/setup/message-container) — 渲染 messageGroups
-- [ExecutionSummary](../components/agent/execution-summary) — 消费 executionGroups
+- [ChatContainer](../components/molecular/chat-container.md) — 调用 useMessageGroup 并下传分组
+- [MessageContainer](../components/molecular/message-container.md) — 渲染 messageGroups
+- [ExecutionSummary](../components/molecular/execution-summary.md) — 消费 executionGroups

package/dist/mcp/generated/docs/use-observer-visible-list.md

@@ -186,4 +186,4 @@ function useObserverVisibleList<T>(
 
 ## 关联组件
 
-- [ShortcutBtns](../components/input/shortcut-btns.md) — 快捷指令条与「更多」
+- [ShortcutBtns](../components/atomic/shortcut-btns.md) — 快捷指令条与「更多」

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-用户反馈弹层，提交踩/反馈原因。 源码位置：src/components/message-tools/user-feedback/user-feedback.vue。
+UserFeedback 在点赞或踩之后展示原因收集面板：多选预设标签、补充说明与异步加载原因列表（骨架屏）。 由 MessageTools 在 like/unlike 流程中挂载，提交后向父级回传原因列表与备注。
 
 ### 关联组件
 - **message-tools** — 点赞/踩操作触发并收集反馈
@@ -10,13 +10,8 @@
 <!-- FULL DOC -->
 
 # MessageUserFeedback 用户反馈
-## 源码事实
 
-- **源码位置**：`src/components/message-tools/user-feedback/user-feedback.vue`
-- **能力域**：工具与反馈
-- **能力说明**：用户反馈弹层，提交踩/反馈原因。
-
-> **能力域**：工具与反馈
+> **层级**：分子组件 · **功能域**：工具与反馈
 
 AI 消息点赞/踩后收集用户具体反馈原因的弹出面板。支持多选预设原因标签、补充文字说明（textarea）、异步加载原因列表（骨架屏）。
 
@@ -231,4 +226,4 @@ loading=false，展示原因标签列表
 
 ## 关联组件
 
-- [MessageTools](/components/feedback/message-tools) — 点赞/踩入口与反馈联动
+- [MessageTools](./message-tools.md) — 点赞/踩入口与反馈联动

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染用户消息，支持文本、键值、Markdown、引用、文件和编辑态输入。 源码位置：src/components/chat-message/user-message/user-message.vue。
+UserMessage 渲染右对齐用户消息，支持文本、附件、文本/结构化引用、快捷指令与内联编辑。需处理 onAction、onInputConfirm、 onShortcutConfirm 等回调；messageToolsStatus 控制工具栏。由 MessageRender 在 user 角色下使用，常与多选联动。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 user 时创建
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # UserMessage 用户消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/user-message/user-message.vue`
-- **能力域**：消息系统
-- **能力说明**：渲染用户消息，支持文本、键值、Markdown、引用、文件和编辑态输入。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 用户消息展示组件，右对齐显示用户发送的消息内容。支持纯文本、多媒体（图片/文件）、文本引用、结构化引用、快捷指令等多种内容形式，以及消息的内联编辑功能。
 
@@ -39,7 +34,7 @@
 │
 ├── .ai-user-message-content（气泡：bg #e1ecff，padding 8×12，border-radius 4px）
 │     v-if: cite 为数组 → KeyValueContent（title + key/value 列表）
-│     v-else-if: content  → MarkdownContent × N（每个 text 项一个实例）
+│     v-else-if: content  → TextContent × N（textParts 中每个文本片段一个实例）
 │
 └── MessageTools（.ai-user-message-tools）
       v-if: messageToolsStatus !== 'hidden'
@@ -58,7 +53,7 @@
 │     @submit(formModel) → onShortcutConfirm(formModel) + isEdit=false
 │
 └── ChatInput（v-else，带自定义 #send-icon slot）
-      v-model: editContent（仅含文本内容，数组时取第一个 text 项）
+      v-model: editContent（取 textParts[0]，即第一个文本片段）
       defaultUploadFiles: binaryFiles
       #send-icon slot → .user-edit-footer
             Button "取消" → isEdit=false
@@ -67,7 +62,7 @@
 
 ## 基础用法
 
-`content` 为字符串时，通过 `MarkdownContent` 渲染（支持 Markdown 语法）。
+`content` 为字符串时，通过 `TextContent` 渲染（内部使用 `MarkdownContent`，支持 Markdown 语法）。
 
 ```vue
 <template>
@@ -97,7 +92,7 @@
 - **图片文件**（`binaryImageFiles`）：判断 `url` 存在或 `mimeType` / `file.type` 以 `image/` 开头的文件，统一放入一个 `FileContent`（`readonly=true`）中渲染，支持点击缩略图全屏预览
 - **非图片文件**（`binaryNonImageFiles`）：每个文件单独渲染在 `FileContent`（`readonly=true`）中
 
-`text` 项按顺序各渲染一个 `MarkdownContent`。
+`text` 项经 `textParts` 计算属性统一为 `string[]`，按顺序各渲染一个 `TextContent`。
 
 ```vue
 <script setup lang="ts">
@@ -228,12 +223,12 @@
 **`editContent` 的初始化逻辑**（仅文本部分，二进制文件通过 `defaultUploadFiles` 恢复）：
 
 ```
-content 为 string     → editContent = content
-textContent 为 string → editContent = textContent
-textContent 为 array  → editContent = textContent[0]?.text（取第一个文本项）
-binaryFiles 有值      → 进入编辑模式（editContent 可为空）
+textParts 有值  → editContent = textParts[0]（取第一个文本片段）
+binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 ```
 
+`textParts` 由 `content` 统一计算：`string` 转为单元素数组，`InputContent[]` 则过滤出 `type: 'text'` 且非空的项并映射为 `string[]`。
+
 ```vue
 <template>
   <UserMessage
@@ -351,6 +346,6 @@ interface MessageExtra {
 
 ## 关联组件
 
-- [MessageRender](/components/message/message-render) — user 角色由其实例化
-- [MessageTools](/components/feedback/message-tools) — 工具栏交互
-- [MessageContainer](/components/setup/message-container) — 列表与多选容器
+- [MessageRender](./message-render.md) — user 角色由其实例化
+- [MessageTools](./message-tools.md) — 工具栏交互
+- [MessageContainer](./message-container.md) — 列表与多选容器