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

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ToolMessage 展示工具（Function Call）执行返回，内部用 DescPanel 将 JSON 解析为 key-value 或纯文本。通常不单独使用： ToolcallRender 在 toolCall.toolMessage 有值时内联渲染；独立 role 为 tool 的消息由 MessageRender 统一渲染。核心关注 content 与 error。
+渲染工具返回内容，JSON 场景交给 DescPanel 展示。 源码位置：src/components/chat-message/tool-message/tool-message.vue。
 
 ### 关联组件
 - **assistant-message** — 结果常作为 assistant 消息中 toolCall.toolMessage 内联展示
@@ -12,8 +12,13 @@ ToolMessage 展示工具（Function Call）执行返回，内部用 DescPanel
 <!-- FULL DOC -->
 
 # ToolMessage 工具消息
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：消息展示
+- **源码位置**：`src/components/chat-message/tool-message/tool-message.vue`
+- **能力域**：消息系统
+- **能力说明**：渲染工具返回内容，JSON 场景交给 DescPanel 展示。
+
+> **能力域**：消息系统
 
 工具（Function Call）执行结果展示组件。内部通过 `DescPanel` 渲染，标题固定为"返回内容"，支持将 JSON 自动解析为 key-value 列表。
 
@@ -212,6 +217,6 @@ interface ToolMessage {
 
 ## 关联组件
 
-- [AssistantMessage](./assistant-message.md) — toolCall.toolMessage 内联场景
-- [MessageRender](./message-render.md) — 独立 tool 消息派发
-- [DescPanel](../atomic/desc-panel.md) — 返回内容面板
+- [AssistantMessage](/components/message/assistant-message) — toolCall.toolMessage 内联场景
+- [MessageRender](/components/message/message-render) — 独立 tool 消息派发
+- [DescPanel](/components/rendering/desc-panel) — 返回内容面板

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ToolcallRender 折叠展示一次工具/MCP 调用：头部显示名称、状态色、耗时与 MCP 标识，展开区展示参数与返回。 内部组合 DescPanel 与 HighlightKeyword；可在详情底部内联 ToolMessage 结果。
+渲染 assistant toolCalls，展示工具调用状态、参数和结果。 源码位置：src/components/tool-call/toolcall-render/toolcall-render.vue。
 
 ### 关联组件
 - **desc-panel** — 详情区展示参数与描述文本
@@ -12,8 +12,13 @@ ToolcallRender 折叠展示一次工具/MCP 调用：头部显示名称、状态
 <!-- FULL DOC -->
 
 # ToolcallRender 工具调用渲染器
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：工具与反馈
+- **源码位置**：`src/components/tool-call/toolcall-render/toolcall-render.vue`
+- **能力域**：Agent 能力
+- **能力说明**：渲染 assistant toolCalls，展示工具调用状态、参数和结果。
+
+> **能力域**：Agent 能力
 
 展示 AI 调用外部工具/函数过程与结果的渲染组件。由**可折叠头部**和**详情面板**组成，根据 `status` 自动切换颜色和状态文案，支持 MCP 调用识别和内联结果展示。
 
@@ -294,6 +299,6 @@ interface ToolMessage {
 
 ## 关联组件
 
-- [DescPanel](../atomic/desc-panel.md) — 描述与参数面板
-- [HighlightKeyword](../atomic/highlight-keyword.md) — 标题高亮
-- [ToolMessage](./tool-message.md) — 内联工具返回
+- [DescPanel](/components/rendering/desc-panel) — 描述与参数面板
+- [HighlightKeyword](/components/helper/highlight-keyword) — 标题高亮
+- [ToolMessage](/components/message/tool-message) — 内联工具返回

package/dist/mcp/generated/docs/use-animation-text.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuration、easing），返回 chunks 与 animationStyle。 监听文本变化：前缀追加则增量拆分为新 chunk 并触发动画，否则重置为单 chunk，适合流式输出逐段淡入。 全局样式已含 ai-markdown-fade-in。AnimationText 原子组件内部封装同一逻辑。
+useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuration、easing），返回 chunks 与 animationStyle。 监听文本变化：前缀追加则增量拆分为新 chunk 并触发动画，否则重置为单 chunk，适合流式输出逐段淡入。 全局样式已含 ai-markdown-fade-in。AnimationText 组件内部封装同一逻辑。
 
 ### 关联组件
 - **animation-text** — 封装 chunks 与样式渲染
@@ -126,7 +126,7 @@ useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuratio
 </script>
 ```
 
-> 详见 [AnimationText 组件文档](/components/atomic/animation-text)。
+> 详见 [AnimationText 组件文档](/components/rendering/animation-text)。
 
 ## API
 
@@ -194,5 +194,5 @@ function useAnimationText(
 
 ## 关联组件
 
-- [AnimationText](../components/atomic/animation-text.md) — 默认封装组件
-- [MarkdownContent](../components/atomic/markdown-content.md) — 富文本流式展示场景。
+- [AnimationText](../components/rendering/animation-text) — 默认封装组件
+- [MarkdownContent](../components/rendering/markdown-content) — 富文本流式展示场景。

package/dist/mcp/generated/docs/use-clipboard.md

@@ -201,6 +201,6 @@ export const useClipboard = () => {
 
 ## 关联组件
 
-- [CodeContent](../components/atomic/code-content.md) — 代码块复制
-- [MessageContainer](../components/molecular/message-container.md) — 助手消息复制
-- [UserMessage](../components/molecular/user-message.md) — 用户消息复制
+- [CodeContent](../components/rendering/code-content) — 代码块复制
+- [MessageContainer](../components/setup/message-container) — 助手消息复制
+- [UserMessage](../components/message/user-message) — 用户消息复制

package/dist/mcp/generated/docs/use-command-selection.md

@@ -148,4 +148,4 @@ export const useCommandSelection = () => {
 
 ## 关联组件
 
-- [ChatInput](../components/molecular/chat-input.md) — AiSlashInput 子模块使用
+- [ChatInput](../components/input/chat-input) — AiSlashInput 子模块使用

package/dist/mcp/generated/docs/use-custom-tab.md

@@ -124,4 +124,4 @@ interface CustomTab<T = Record<string, unknown>> {
 
 ## 关联组件
 
-- [ChatContainer](../components/molecular/chat-container.md) — 侧栏 Tab 与自定义面板
+- [ChatContainer](../components/setup/chat-container) — 侧栏 Tab 与自定义面板

package/dist/mcp/generated/docs/use-flow-node-actions.md

@@ -0,0 +1,124 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeActions(task, node)。 失败节点按 retryable/skippable 展示重试/跳过，详情恒在末尾；点击 resume 时不传 interrupt。
+
+### 关联组件
+- **flow-agent-content** — FlowAgentContent 内部消费，驱动节点行尾按钮组渲染
+
+---
+<!-- FULL DOC -->
+
+# useFlowNodeActions 节点行尾操作
+
+> **分类**：composable
+
+将 FlowAgent 节点行尾的「详情（打开侧栏）」与「重试 / 跳过（回传 Agent resume）」聚合为统一的声明式操作列表。`FlowAgentContent` 只需遍历 `getNodeActions` 返回值渲染按钮，显隐与点击行为均收敛于此 composable。
+
+源码：`src/components/chat-content/flow-agent-content/use-flow-node-actions.ts`
+
+## 函数签名
+
+```typescript
+function useFlowNodeActions(options: {
+  /** resume 回调（与第三方审批取消同一回调，按 payload.operation 分流） */
+  onInterruptResume: Ref<OnInterruptResume | undefined>;
+  /** 打开节点详情侧栏（复用 useFlowTab 的能力） */
+  openNodeDetail: (task: BkFlowTask, node: BkFlowNode) => void;
+}): {
+  getNodeActions: (task: FlowTaskVM, node: FlowNodeVM) => FlowNodeActionVM[];
+};
+```
+
+## 返回值：FlowNodeActionVM
+
+```typescript
+type FlowNodeActionId =
+  | 'detail'
+  | InterruptResumeOperation.FlowNodeRetry
+  | InterruptResumeOperation.FlowNodeSkip;
+
+interface FlowNodeActionVM {
+  icon: Component;
+  id: FlowNodeActionId;
+  label: string;
+  run: () => void;
+}
+```
+
+| 字段    | 说明                           |
+| ------- | ------------------------------ |
+| `icon`  | 按钮图标组件                   |
+| `id`    | 唯一标识，用于 `v-for` key     |
+| `label` | 国际化文案                     |
+| `run`   | 点击执行（详情或 resume）      |
+
+## 操作显隐规则
+
+| 操作 | `id`               | 显隐条件                                   | 点击行为                                      |
+| ---- | ------------------ | ------------------------------------------ | --------------------------------------------- |
+| 重试 | `flow_node_retry`  | `convergedState === 'failed'` 且 `retryable` | 调用 `onInterruptResume`，**不传** `interrupt` |
+| 跳过 | `flow_node_skip`   | `convergedState === 'failed'` 且 `skippable` | 同上                                          |
+| 详情 | `detail`           | 始终（Share 模式由上层组件隐藏整组）       | 调用 `openNodeDetail(task.raw, node.raw)`     |
+
+展示顺序：重试 → 跳过 → 详情。
+
+## resume 负载格式
+
+```typescript
+// 重试
+onInterruptResume?.({
+  operation: InterruptResumeOperation.FlowNodeRetry,
+  payload: { node_id: node.id, task_id: task.task_id },
+});
+
+// 跳过
+onInterruptResume?.({
+  operation: InterruptResumeOperation.FlowNodeSkip,
+  payload: { node_id: node.id, task_id: task.task_id },
+});
+```
+
+## 使用示例
+
+`FlowAgentContent` 内部用法（业务侧通常通过 `MessageRender` 传入 `onInterruptResume`，无需直接调用本 composable）：
+
+```typescript
+import { toRef } from 'vue';
+import { useFlowNodeActions } from '@blueking/chat-x';
+// 或相对路径：'./use-flow-node-actions'
+
+const { getNodeActions } = useFlowNodeActions({
+  onInterruptResume: toRef(props, 'onInterruptResume'),
+  openNodeDetail,
+});
+
+// 模板中
+// v-for="action in getNodeActions(task, node)" :key="action.id"
+// @click.stop="action.run()"
+```
+
+## 扩展新操作
+
+在 `RESUME_ACTION_DEFS` 注册表中追加一项即可，需声明 `visible` 与 `operation` 枚举：
+
+```typescript
+const RESUME_ACTION_DEFS: FlowNodeResumeActionDef[] = [
+  // 现有：重试、跳过
+  {
+    icon: MyIcon,
+    id: InterruptResumeOperation.MyNewOp, // 需先在 InterruptResumeOperation 扩展
+    label: () => t('新操作'),
+    visible: node => /* 自定义显隐 */,
+  },
+];
+```
+
+同时在 `interrupt.ts` 扩展 `InterruptResumeOperation` 与 `FlowNodeResume` 联合类型。
+
+## 关联文档
+
+- [FlowAgentContent 执行内容](/components/agent/flow-agent-content) — 消费方组件
+- [中断类型 Interrupt](/types/interrupt) — `InterruptResumeOperation`、`FlowNodeResume`、`OnInterruptResume`
+- [ActivityMessage 活动消息](/components/message/activity-message) — `onInterruptResume` 透传链路
+- [MessageRender 消息渲染器](/components/message/message-render) — 顶层透传入口

package/dist/mcp/generated/docs/use-full-screen.md

@@ -65,7 +65,7 @@ useFullScreen(target?)
 
 `ChatContainer` 将侧栏包裹在 `.ai-full-screen-wrapper` 中，通过 `useFullScreen(fullScreenRef)` 控制侧栏全屏；Tab 栏 `#setting` 插槽内的 `ToolBtn` 使用自定义插槽渲染 `FullScreenIcon` / `UnFullScreenIcon`。
 
-详见 [ChatContainer 侧栏全屏](../components/molecular/chat-container.md#侧栏全屏)。
+详见 [ChatContainer 侧栏全屏](../components/setup/chat-container.md#侧栏全屏)。
 
 ## API
 
@@ -110,5 +110,5 @@ declare function useFullScreen(target?: MaybeRef<HTMLElement | null>): UseFullSc
 
 ## 关联组件
 
-- [ChatContainer](../components/molecular/chat-container.md) — 内置侧栏全屏按钮
-- [ToolBtn](../components/atomic/tool-btn.md) — 全屏按钮自定义插槽
+- [ChatContainer](../components/setup/chat-container.md) — 内置侧栏全屏按钮
+- [ToolBtn](../components/feedback/tool-btn.md) — 全屏按钮自定义插槽

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

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

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

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

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

@@ -23,10 +23,13 @@ useMessageGroup 接收 keyword、messages、selectedUserMessages，通过 watchE
 function useMessageGroup(options: {
   keyword?: ShallowRef<string>;
   messages: ComputedRef<Message[]>;
+  renderMode?: MaybeRef<RenderMode>;
   selectedUserMessages: Ref<Message[] | undefined>;
 }): {
   messageGroups: Ref<MessageGroup[]>;
   executionGroups: ComputedRef<MessageGroup[]>;
+  pendingApprovalCount: ComputedRef<number>;
+  pendingApprovalTipText: ComputedRef<string>;
   isShareMode: ShallowRef<boolean>;
   isAllSelected: ComputedRef<boolean>;
   onToggleShareAll: (isAllSelected: boolean) => void;
@@ -57,7 +60,7 @@ role=user  role=tool     其他 role
  成组           后 continue
 
 ④ 遍历结束后将剩余 assistantMessages 推入 list
-⑤ 末尾为 user 消息 → 追加 Loading 消息组
+⑤ 末尾为 user 消息 → 追加 Loading 消息组（`renderMode` 为 `Share` 时不追加）
 ```
 
 注入的占位 Loading 消息使用固定 id：`LOADING_MESSAGE_ID`（`'__loading__'`，定义于 `common/constants`）。`ChatContainer` 据此判断是否在「请求中」阶段，并向 `ChatInput` / `MessageContainer` 下传 `MessageStatus.Fetching`，与流式中的停止、防重复发送行为对齐。
@@ -113,6 +116,24 @@ 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` 提供完整的分享模式支持：
@@ -142,12 +163,21 @@ const keyword = shallowRef('');
 const messages = computed(() => props.messages);
 const selectedUserMessages = deepRef<Message[]>([]);
 
-const { messageGroups, executionGroups, isShareMode, isAllSelected, onToggleShareAll, onCancelShare, onConfirmShare } =
-  useMessageGroup({
-    keyword,
-    messages,
-    selectedUserMessages,
-  });
+const {
+  messageGroups,
+  executionGroups,
+  pendingApprovalCount,
+  pendingApprovalTipText,
+  isShareMode,
+  isAllSelected,
+  onToggleShareAll,
+  onCancelShare,
+  onConfirmShare,
+} = useMessageGroup({
+  keyword,
+  messages,
+  selectedUserMessages,
+});
 ```
 
 ## 返回值说明
@@ -156,6 +186,8 @@ const { messageGroups, executionGroups, isShareMode, isAllSelected, onToggleShar
 | ---------------- | ----------------------------- | --------------------------------------------------------------------------- |
 | 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`  | 切换全选                                                                    |
@@ -181,6 +213,6 @@ interface MessageGroup {
 
 ## 关联组件
 
-- [ChatContainer](../components/molecular/chat-container.md) — 调用 useMessageGroup 并下传分组
-- [MessageContainer](../components/molecular/message-container.md) — 渲染 messageGroups
-- [ExecutionSummary](../components/molecular/execution-summary.md) — 消费 executionGroups
+- [ChatContainer](../components/setup/chat-container) — 调用 useMessageGroup 并下传分组
+- [MessageContainer](../components/setup/message-container) — 渲染 messageGroups
+- [ExecutionSummary](../components/agent/execution-summary) — 消费 executionGroups

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

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

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

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

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

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