@blueking/chat-x 0.0.51-beta.5 → 0.0.52-dev.1

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-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 变量生效。
+useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>、menuSources?: ComputedRef<IInputMenuItem[]>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload、timezone 与 menuSources； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。
 
 ### 关联组件
 - **chat-container** — 根容器调用 useGlobalConfig 注入 supportUpload
@@ -14,7 +14,7 @@ useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、suppo
 
 > **分类**：composable
 
-在聊天容器根组件与子组件之间通过 Vue `provide` / `inject` 共享**全局展示相关配置**（当前包括字号主题档位 `size`、是否支持上传 `supportUpload`、消息时间时区 `timezone`）。与 Teleport 插槽 ID 无关。
+在聊天容器根组件与子组件之间通过 Vue `provide` / `inject` 共享**全局展示相关配置**（当前包括字号主题档位 `size`、是否支持上传 `supportUpload`、消息时间时区 `timezone`、输入框菜单数据源 `menuSources`）。与 Teleport 插槽 ID 无关。
 
 > 字号主题主要通过 `ChatContainer` 根节点的 `data-ai-size` 与 CSS 变量（`--ai-font-size` 等）生效；`GlobalConfig.size` 供后代在逻辑层读取当前档位，样式层无需逐组件传参。
 
@@ -27,8 +27,9 @@ ChatContainer（根）
   │     size: computed(() => props.size ?? 'small'),
   │     supportUpload: computed(() => props.supportUpload ?? false),
   │     timezone: computed(() => props.timezone),
+  │     menuSources: resolvedMenuSources,
   │   })
-  │     └── provide(GLOBAL_CONFIG_TOKEN, { size, supportUpload, timezone })
+  │     └── provide(GLOBAL_CONFIG_TOKEN, { size, supportUpload, timezone, menuSources })
   │
   └── MessageContainer → … → UserMessage / MessageTime 等
 
@@ -94,12 +95,15 @@ export type GlobalConfig = {
   size?: ComputedRef<AiSizeMode>;
   supportUpload: ComputedRef<boolean>;
   timezone?: ComputedRef<string | undefined>;
+  /** 输入框菜单数据源；消息编辑态的内嵌输入框据此渲染 @ / \ 与 + 号菜单 */
+  menuSources?: ComputedRef<IInputMenuItem[]>;
 };
 
 export function useGlobalConfig(options: GlobalConfig): {
   size?: ComputedRef<AiSizeMode>;
   supportUpload: ComputedRef<boolean>;
   timezone?: ComputedRef<string | undefined>;
+  menuSources?: ComputedRef<IInputMenuItem[]>;
 };
 
 export function injectGlobalConfig(): GlobalConfig | undefined;
@@ -117,7 +121,9 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 | --------------- | ------------------------------------------------------------------------ |
 | `size`          | 可选。字号主题档位 `normal`（14px）/ `small`（12px），与 `ChatContainer.size` 对齐 |
 | `supportUpload` | 是否支持上传，与根容器 `ChatContainer` 的 `supportUpload` 等展示策略对齐 |
+| `menuSources`   | 可选。输入框菜单数据源，供消息编辑态的内嵌 `ChatInput` 使用 |
 | `timezone`      | 可选。消息时间展示所用的 IANA 时区名，与 `ChatContainer.timezone` 对齐；未配置时 `MessageTime` 按浏览器时区展示 |
+| `menuSources`   | 可选。输入框菜单数据源，与 `ChatInput.menuSources` 同源（`ChatContainer` 传入的是补齐会话产物后的结果）；[UserMessage](../components/message/user-message) 编辑态据此渲染菜单，未配置时编辑态无菜单 |
 
 ### `useGlobalConfig(options)`
 
@@ -145,6 +151,7 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size`、`supportUpload` 与 `timezone`
+- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `size`、`supportUpload`、`timezone` 与 `menuSources`
+- [UserMessage](../components/message/user-message) — 编辑态读取 `supportUpload` 与 `menuSources`
 - [MessageTime](../components/feedback/message-time) — 读取 `timezone` 展示消息时间
 - [主题配置](../theme/theme) — `data-ai-size` 与 CSS 变量说明

package/dist/mcp/generated/docs/use-input-mention.md

@@ -0,0 +1,119 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+useInputMentionProvider 由持有输入框的容器（ChatContainer）提供 insertMention， useInputMentionConsumer 在任意后代取出；无 Provider（只读 / 分享态）时返回 undefined，调用方据此隐藏「引用」入口。 消息区文件卡片与侧栏产物面板即用它把文件以标签形式追加进输入框。 源码位置：src/composables/use-input-mention.ts。
+
+### 关联组件
+- **chat-container** — 根容器提供 insertMention，内部转发给 ChatInput 实例
+- **chat-input** — 实际执行插入的组件，expose insertMention
+- **file-artifact-panel** — 侧栏产物面板据此展示「引用」按钮
+- **assistant-message** — 消息内文件卡片据此展示「引用」按钮
+
+---
+<!-- FULL DOC -->
+
+# useInputMention 资源插入输入框
+
+> **分类**：composable
+
+把「把某个资源 `@` 进输入框」这件事从组件层级里解耦出来：消息区的文件卡片、侧栏的产物面板可能嵌套得很深，逐层透传输入框实例既啰嗦又容易漏。
+
+## 工作原理
+
+```
+ChatContainer（根）
+  ├── useInputMentionProvider({
+  │     insertMention: item => chatInputRef.value?.insertMention?.(item),
+  │   })
+  │     └── provide(INPUT_MENTION_TOKEN, context)
+  │
+  ├── ChatInput（ref="chatInputRef"）
+  │     └── expose insertMention → AiSlashInput.appendMention（追加到文档末尾）
+  │
+  └── MessageContainer → … → ArtifactFileCard / FileArtifactPanel
+        └── useInputMentionConsumer() → InputMentionContext | undefined
+              └── 有值才渲染「引用」按钮
+```
+
+无 Provider 时 `useInputMentionConsumer()` 返回 `undefined`，因此只读 / 分享态（没有输入框）自动不显示引用入口，不需要额外开关。
+
+## 消费方用法
+
+```vue
+<template>
+  <span
+    v-if="inputMention"
+    v-tippy="{ content: t('引用') }"
+    @click.stop="handleCite"
+  >
+    <CiteIcon />
+  </span>
+</template>
+
+<script setup lang="ts">
+  import { toArtifactMenuItem, useInputMentionConsumer } from '@blueking/chat-x';
+
+  const props = defineProps<{ file: AIFileInfo }>();
+
+  // 无输入框上下文时为 undefined，据此隐藏入口
+  const inputMention = useInputMentionConsumer();
+
+  const handleCite = () => {
+    inputMention?.insertMention(toArtifactMenuItem(props.file));
+  };
+</script>
+```
+
+::: warning id 必须与菜单一致
+把文件转成菜单条目时统一走 [`toArtifactMenuItem`](/utils/#会话产物收集)：`id` 不一致会导致 `@` 菜单的去重与已插入标签的匹配同时失效（同一个文件既能重复插入、又无法从候选中剔除）。
+:::
+
+## 自建容器用法
+
+不使用 [ChatContainer](/components/setup/chat-container)、自行组合 `MessageContainer` + `ChatInput` 时，需要自己提供上下文：
+
+```vue
+<script setup lang="ts">
+  import { useTemplateRef } from 'vue';
+  import { ChatInput, useInputMentionProvider } from '@blueking/chat-x';
+
+  const chatInputRef = useTemplateRef<InstanceType<typeof ChatInput>>('chatInputRef');
+
+  useInputMentionProvider({
+    insertMention: item => chatInputRef.value?.insertMention?.(item),
+  });
+</script>
+```
+
+## API
+
+```typescript
+export const INPUT_MENTION_TOKEN: unique symbol;
+
+export type InputMentionContext = {
+  /** 把一个条目以标签形式追加到输入框，效果等同于用户通过 `@` 菜单选中它 */
+  insertMention: (item: IInputMenuItem) => void;
+};
+
+export function useInputMentionProvider(context: InputMentionContext): InputMentionContext;
+
+export function useInputMentionConsumer(): InputMentionContext | undefined;
+```
+
+| 函数                        | 说明                                                                   |
+| --------------------------- | ---------------------------------------------------------------------- |
+| `useInputMentionProvider`   | 在祖先 `setup` 中调用，`provide` 上下文并原样返回，便于就地复用         |
+| `useInputMentionConsumer`   | 在任意后代 `setup` 中调用，无 Provider 时返回 `undefined`               |
+
+## 注意事项
+
+1. **插入位置不依赖光标**：底层走 `AiSlashInput.appendMention`，标签追加到文档末尾——外部调用时编辑器通常没有焦点，依赖光标会插错位置。
+2. **插入的资源可能不在 `menuSources` 里**：`ChatInput` 的 `update:modelValue` 第二参数只回传能在 `menuSources` 中反查到的条目。`ChatContainer` 会自动收集消息里的会话产物，所以经容器使用时产物标签能被反查到。
+3. **必须在 `setup` 中调用**：与 Vue `provide` / `inject` 的要求一致。
+
+## 关联组件
+
+- [ChatContainer](../components/setup/chat-container) — 默认的 Provider
+- [ChatInput](../components/input/chat-input) — `insertMention` 的实际执行者
+- [FileArtifactPanel](../components/message/file-artifact-panel) — 侧栏产物面板的引用入口
+- [Utils 工具函数](../utils/) — `collectMessageArtifacts` / `toArtifactMenuItem`

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

@@ -1,10 +1,11 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-useMenuKeydown 接收 items、menuRef、onSelect，在 window 捕获阶段监听 keydown；菜单不可见（offsetParent 为空）或列表为空时不响应。 维护 activeIndex，处理 ArrowUp/ArrowDown 循环与 Enter 选中，并 scrollIntoView 当前 .is-active 项。 AiSlashMenu、AiPromptList（ChatInput 子模块）内部使用。
+useMenuKeydown 接收 items、menuRef、onSelect，在 window 捕获阶段监听 keydown；菜单不可见（offsetParent 为空）或列表为空时不响应。 维护 activeIndex，处理 ArrowUp/ArrowDown 循环与 Enter 选中，并 scrollIntoView 当前 .is-active 项。 InputMenuPanel（输入框统一菜单）与 ModelSelectorPanel（模型下拉）内部使用。
 
 ### 关联组件
-- **chat-input** — AiSlashMenu / AiPromptList 键盘导航
+- **input-menu-panel** — 输入框菜单的键盘导航
+- **model-selector** — 模型下拉的键盘导航
 
 ---
 <!-- FULL DOC -->
@@ -94,25 +95,23 @@ scrollToActive()：nextTick → menuRef.querySelector('.is-active')?.scrollIntoV
 </style>
 ```
 
-## 在 AiSlashInput 内部的实际用法
+## 库内部的实际用法
 
-`useMenuKeydown` 被 `AiSlashMenu`（`@` 资源菜单）和 `AiPromptList`（`/` 提示词列表）内部使用：
+`useMenuKeydown` 被 [InputMenuPanel](/components/input/input-menu-panel)（输入框统一菜单）与 [ModelSelector](/components/input/model-selector) 的下拉面板内部使用：
 
 ```typescript
-// AiPromptList 中
-const promptListRef = useTemplateRef<HTMLElement>('promptListRef');
-const { activeIndex } = useMenuKeydown<string>({
-  items: computed(() => props.prompts), // ComputedRef 也可传入
-  onSelect: props.onSelect,
-  menuRef: promptListRef,
+// InputMenuPanel 中：items 为跨分组扁平化后的可选条目
+const panelRef = useTemplateRef<HTMLElement>('panelRef');
+const flatItems = computed(() => props.flatItems);
+const { activeIndex } = useMenuKeydown<IInputMenuItem>({
+  items: flatItems, // ComputedRef 也可传入
+  onSelect: item => emit('select', item),
+  menuRef: panelRef,
 });
 
-// AiSlashMenu 中
-const menuRef = useTemplateRef<HTMLElement>('menuRef');
-const { activeIndex } = useMenuKeydown<IAiSlashMenuItem>({
-  items: sortedResourceList,
-  onSelect: props.onSelect,
-  menuRef,
+// 结果集变化后旧的高亮下标已无意义，回到首项
+watch(flatItems, () => {
+  activeIndex.value = 0;
 });
 ```
 

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

@@ -122,17 +122,14 @@ const isExecutionMessage = (m: Message): boolean => {
 
 ## sessionArtifacts 会话级文件产物
 
-`sessionArtifacts` 拍平当前会话所有 `AssistantMessage.property.artifacts`，供 `ChatContainer` 侧栏「文件产物」Tab 聚合预览。以 **`outputId`** 为会话内唯一键去重（同 `outputId` 视为同一文件），保留最后一次出现的文件信息，列表顺序与「最后一次出现」的相对顺序一致：
+`sessionArtifacts` 收集当前会话具有 `outputId` 的助手产物与用户上传附件，供 `ChatContainer` 侧栏「文件产物」Tab 聚合预览。以 **`outputId`** 为会话内唯一键去重（同 `outputId` 视为同一文件），保留最后一次出现的文件信息，列表顺序与「最后一次出现」的相对顺序一致：
 
 ```typescript
 const sessionArtifacts = computed(() => {
   // delete + set：同 key 覆盖内容，并把该项挪到 Map 末尾，保证「最后出现」顺序
   const byOutputId = new Map();
   for (const message of messages.value) {
-    if (message.role !== MessageRole.Assistant) continue;
-    const artifacts = message.property?.artifacts;
-    if (!artifacts?.length) continue;
-    for (const file of artifacts) {
+    for (const file of getMessageArtifacts(message)) {
       if (byOutputId.has(file.outputId)) {
         byOutputId.delete(file.outputId);
       }
@@ -217,7 +214,7 @@ const {
 | ---------------- | ----------------------------- | --------------------------------------------------------------------------- |
 | messageGroups    | `Ref<MessageGroup[]>`         | 完整消息分组列表                                                            |
 | executionGroups  | `ComputedRef<MessageGroup[]>` | 仅包含执行类消息的分组（工具调用 + FlowAgent），自动提取 `userMessageTitle` |
-| sessionArtifacts | `ComputedRef<SessionArtifact[]>` | 拍平会话所有 AssistantMessage 文件产物，按 `outputId` 去重（保留最后一次） |
+| sessionArtifacts | `ComputedRef<SessionArtifact[]>` | 收集助手产物与具有 `outputId` 的上传附件，按 `outputId` 去重（保留最后一次） |
 | pendingApprovalCount | `ComputedRef<number>`      | 当前消息中待审批 AI Dev 审批中断的数量                                      |
 | pendingApprovalTipText | `ComputedRef<string>`    | 待审批阻塞发送提示文案；无待审批时为空字符串                                |
 | isShareMode      | `ShallowRef<boolean>`         | 是否处于分享模式                                                            |

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

@@ -1,9 +1,11 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染用户消息：纯文本（非 Markdown）、键值引用、二进制附件与编辑态 ChatInput / ShortcutRender； 工具栏含 copy / cite / edit / delete。源码位置：src/components/chat-message/user-message/user-message.vue。
+渲染用户消息：纯文本（非 Markdown）、键值引用、二进制附件与编辑态 ChatInput / ShortcutRender； 正文经 CollapsibleContent 限高 200px，property.docSchema 含标签时改用 MentionText 还原资源标签； 工具栏含 copy / edit / delete。源码位置：src/components/chat-message/user-message/user-message.vue。
 
 ### 关联组件
+- **mention-text** — 文档含标签时用它还原已选资源
+- **collapsible-content** — 正文超过 200px 时折叠
 - **message-render** — 由 MessageRender 在 role 为 user 时创建
 - **message-tools** — 消息工具栏交互与状态由 MessageTools 体系承载
 - **message-time** — createdAt 经工具栏 prepend 插槽展示
@@ -41,13 +43,15 @@
 │     .ai-user-message-binary-files → FileContent（readonly=true，每个文件独立渲染）
 │
 ├── .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 中每个文本片段一个实例）
+│   └── CollapsibleContent（maxHeight = CONST_USER_MESSAGE_MAX_HEIGHT，200px）
+│         v-if: cite 为数组   → KeyValueContent（title + key/value 列表）
+│         v-else-if: 文档含标签 → MentionText（还原 @ 选中的资源）
+│         v-else-if: content   → TextContent × N（textParts 中每个文本片段一个实例）
 │
 └── MessageTools（.ai-user-message-tools）
       v-if: messageToolsStatus !== 'hidden'
       visibility: hidden（默认）→ visible（:hover 时）
-      tools: [copy, cite, edit, delete]，updateTools: []
+      tools: [copy, edit, delete]，updateTools: []
       #prepend slot → MessageTime（createdAt，工具图标左侧）
 ```
 
@@ -64,13 +68,26 @@
 │     @submit(formModel) → onShortcutConfirm(formModel) + isEdit=false
 │
 └── ChatInput（v-else，带自定义 #send-icon slot）
-      v-model: editContent（取 textParts[0]，即第一个文本片段）
+      v-model: editContent（有富文本文档时用文档回填，否则取 textParts[0]）
       defaultUploadFiles: binaryFiles
+      menuSources: injectGlobalConfig().menuSources
       #send-icon slot → .user-edit-footer
             Button "取消" → isEdit=false
             Button primary "发送" → chatInputRef.triggerSendMessage() + isEdit=false
 ```
 
+## 资源标签回显与正文折叠
+
+**标签回显**：`property.docSchema` 是发送时输入框的富文本文档。**只有文档里真的含标签节点时**才走 [MentionText](/components/rendering/mention-text) 结构化渲染，纯文本文档仍走 `TextContent`——历史消息与第三方消息的表现因此保持不变。`content` 始终是纯文本，后端契约不变。
+
+**附件标签不重复展示**：`ChatInput` 发送时会把待发送附件补成 `artifact` 标签写进文档，本组件在渲染与编辑回填前会剥掉 `value` 命中当前附件的那些标签（`outputId` 与 `id` 都参与匹配，历史消息经 chat-helper 转换后只剩 `id`），同一文件只由 `FileContent` 卡片承载。整行标签被剥掉后不留空行，用户手输的空行照常保留；`@` 选中的其它资源、以及没有附件承载的 `artifact` 标签都照常回显。
+
+编辑态同样以 `docSchema` 回填，否则改完这条消息已选资源会退化成纯文本；因此业务侧在 `onInputConfirm` 里要把新的 `docSchema` 一起写回。
+
+**正文折叠**：正文外层套 [CollapsibleContent](/components/rendering/collapsible-content)，超过 `CONST_USER_MESSAGE_MAX_HEIGHT`（200px）时折叠并展示「显示更多 / 收起」。
+
+**编辑态自动聚焦**：点击 `edit` 后编辑态输入框才开始渲染，组件在 `nextTick` 后调用 `focus()`，光标落到已有内容末尾。
+
 ## 基础用法
 
 `content` 为字符串时，通过 `TextContent` 以**纯文本**插值渲染（`{{ content }}`），**不**走 Markdown。
@@ -95,13 +112,13 @@
   };
 
   const handleAction = async (tool: IToolBtn) => {
-    // copy / edit 有内置行为；cite / delete 需业务侧处理
+    // copy / edit 有内置行为；delete 需业务侧处理
     console.log('工具操作:', tool.id);
   };
 </script>
 ```
 
-> **工具栏**：悬停时显示「复制」「引用」「编辑」「删除」（CSS `visibility`，始终占位）。
+> **工具栏**：悬停时显示「复制」「编辑」「删除」（CSS `visibility`，始终占位）。
 
 ## 多媒体消息
 
@@ -252,8 +269,10 @@
 **`editContent` 的初始化逻辑**（仅文本部分，二进制文件通过 `defaultUploadFiles` 恢复）：
 
 ```
-textParts 有值  → editContent = textParts[0]（取第一个文本片段）
-binaryFiles 有值 → 进入编辑模式（editContent 可为空）
+文档含标签      → editContent = property.docSchema（保留已选资源）
+否则 textParts 有值 → editContent = textParts[0]（取第一个文本片段）
+binaryFiles 有值   → 进入编辑模式（editContent 可为空）
+进入编辑态后       → nextTick 后自动 focus，光标落在内容末尾
 ```
 
 `textParts` 由 `content` 统一计算：`string` 转为单元素数组，`InputContent[]` 则过滤出 `type: 'text'` 且非空的项并映射为 `string[]`。
@@ -288,7 +307,7 @@ binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 
   const handleAction = async (tool: IToolBtn) => {
     // edit → 组件内切编辑态；copy → 组件内复制
-    // cite / delete → 无内置行为，业务侧处理（如删除会话消息）
+    // delete → 无内置行为，业务侧处理（如删除会话消息）
     console.log('工具:', tool.id);
   };
 
@@ -311,10 +330,11 @@ binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 | 工具 ID  | 名称 | 内置行为                                     |
 | -------- | ---- | -------------------------------------------- |
 | `copy`   | 复制 | 字符串直接复制；数组 `JSON.stringify` 后复制 |
-| `cite`   | 引用 | 无内置行为，需通过 `onAction` 外部处理       |
-| `edit`   | 编辑 | 切换 `isEdit=true`，进入编辑模式             |
+| `edit`   | 编辑 | 切换 `isEdit=true`，进入编辑模式并自动聚焦   |
 | `delete` | 删除 | 无内置行为，需通过 `onAction` 外部处理       |
 
+> `cite`（引用）已从内置列表移除，后续不再支持；需要类似能力时通过 `messageTools` 自行追加按钮并在 `onAction` 中处理。
+
 可通过 `messageTools` 按 id 覆盖/追加，`{ id: 'edit', hidden: true }` 可隐藏内置项。
 
 ```vue
@@ -329,9 +349,9 @@ binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 />
 ```
 
-## supportUpload 透传
+## 全局配置透传
 
-编辑态 `ChatInput` 的上传能力来自 `injectGlobalConfig().supportUpload`（通常由 `ChatContainer` 的 `supportUpload` prop 注册）。自定义 `#message` 插槽时须把同一配置链路保留，否则编辑态会与主输入区不一致。
+编辑态 `ChatInput` 的上传能力与菜单数据源都来自 `injectGlobalConfig()`——`supportUpload` 与 `menuSources`（通常由 `ChatContainer` 注册）。自定义 `#message` 插槽时须把同一配置链路保留，否则编辑态会与主输入区不一致（菜单为空、无法上传）。
 
 ```vue
 <template>
@@ -363,10 +383,10 @@ binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 | ------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
 | content            | `string \| InputContent[]`                                                                 | 消息内容，字符串或含 text/binary 的数组                                   |
 | createdAt          | `number \| string`                                                                         | 消息创建时间，经 `MessageTools` 的 `#prepend` 插槽交给 `MessageTime` 渲染在工具图标左侧；无值时不展示 |
-| property           | `{ extra?: MessageExtra; artifacts?: AIFileInfo[] }`                                       | 附加属性；本组件消费 `extra.cite` / `shortcut` / `context`                |
+| property           | `{ docSchema?: TagSchema; extra?: MessageExtra; artifacts?: AIFileInfo[] }`                                       | 附加属性；本组件消费 `docSchema` 与 `extra.cite` / `extra.shortcut` / `extra.context`  |
 | messageTools       | `IToolBtn[]`                                                                               | 自定义用户消息工具组；按 id 与 `CONST_USER_MESSAGE_TOOLS` 合并，`{ id, hidden: true }` 可隐藏 |
 | messageToolsStatus | `MessageToolsStatus`                                                                       | 工具按钮状态，`disabled` 禁用、`hidden` 从 DOM 移除                       |
-| onAction           | `MessageToolsProps['onAction']`                                                            | 工具回调；`copy`/`edit` 有内置行为，`cite`/`delete` 需外部处理            |
+| onAction           | `MessageToolsProps['onAction']`                                                            | 工具回调；`copy`/`edit` 有内置行为，`delete` 需外部处理                   |
 | onInputConfirm     | `(content: UserMessage['content'], docSchema: TagSchema) => Promise<void>`                 | 普通消息编辑确认回调                                                      |
 | onShortcutConfirm  | `(formModel: Record<string, unknown>) => Promise<void>`                                    | 快捷指令消息编辑确认回调                                                  |
 | tippyOptions       | `Partial<Omit<TippyOptions, 'getReferenceClientRect' \| 'triggerTarget'>>`                 | 自定义工具栏 Tippy 配置，透传给内部 `MessageTools`                        |
@@ -377,7 +397,7 @@ binaryFiles 有值 → 进入编辑模式（editContent 可为空）
 
 ### 全局配置依赖
 
-编辑态 `ChatInput` 通过 `injectGlobalConfig()` 读取 `supportUpload`。祖先需已 `useGlobalConfig()`（通常由 `ChatContainer` 注册）。
+编辑态 `ChatInput` 通过 `injectGlobalConfig()` 读取 `supportUpload` 与 `menuSources`（缺省为空数组，即编辑态无菜单）。祖先需已 `useGlobalConfig()`（通常由 `ChatContainer` 注册）。
 
 ## 类型定义
 
@@ -424,6 +444,8 @@ type MessageExtra = {
 ## 关联组件
 
 - [MessageRender](/components/message/message-render) — user 角色由其实例化
+- [MentionText](/components/rendering/mention-text) — 含标签文档的回显
+- [CollapsibleContent](/components/rendering/collapsible-content) — 正文 200px 折叠
 - [MessageTools](/components/feedback/message-tools) — 工具栏交互
 - [MessageTime](/components/feedback/message-time) — 工具栏左侧的消息时间
 - [MessageContainer](/components/setup/message-container) — 列表与多选容器