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

package/skills/blueking-chat-x/references/components/execution-summary.md

@@ -0,0 +1,150 @@
+# ExecutionSummary 执行摘要
+
+> 能力域：Agent 能力 ｜ 导入：`import { ExecutionSummary } from '@blueking/chat-x'` ｜ since 1.0.0
+
+按消息流提取执行摘要，支持关键词定位和消息渲染。 通过 useExecutionPanelProvider 提供 EXECUTION_PANEL_TOKEN，面板内消息按只读呈现， FlowAgent 失败节点在面板内不展示重试/跳过，只保留详情。 源码位置：src/components/execution-summary/execution-summary.vue。
+
+**关联**：message-render（摘要列表内渲染消息内容）、highlight-keyword（搜索关键词注入与高亮）、chat-container（常与侧栏「执行情况」Tab 组合）
+
+---
+
+# ExecutionSummary 执行摘要
+## 源码事实
+
+- **源码位置**：`src/components/execution-summary/execution-summary.vue`
+- **能力域**：Agent 能力
+- **能力说明**：按消息流提取执行摘要，支持关键词定位和消息渲染。
+
+> **能力域**：Agent 能力
+
+执行摘要面板组件，以时间线形式展示对话中的工具调用和 FlowAgent 活动记录。支持关键词搜索过滤和点击定位到对话中的消息位置。
+
+通常不需要直接使用，`ChatContainer` 会在侧边栏的「执行情况」Tab 中自动渲染。
+
+## 核心能力
+
+- **时间线布局**：每组消息按时间节点排列，带连接线
+- **关键词搜索**：实时过滤匹配的执行记录
+- **对话定位**：hover 显示「在对话中定位」按钮，点击滚动到对应消息
+- **空状态处理**：无数据或搜索无结果时显示空状态提示
+- **面板上下文（只读呈现）**：组件 setup 时通过 `useExecutionPanelProvider()` 提供 `EXECUTION_PANEL_TOKEN`，供内部消息组件识别「当前处于侧栏面板内」并隐藏交互操作。目前 `FlowAgentContent` 据此不展示节点「重试 / 跳过」，只保留「详情」
+
+## 基础用法
+
+```vue
+<template>
+  <ExecutionSummary
+    :message-groups="executionGroups"
+    @locate-message-group="handleLocate"
+    @update-keyword="handleUpdateKeyword"
+  />
+</template>
+
+<script setup lang="ts">
+  import { ExecutionSummary, type MessageGroup } from '@blueking/chat-x';
+
+  const handleLocate = (uid: string, group: MessageGroup) => {
+    const dom = document.getElementById(uid);
+    dom?.scrollIntoView({ behavior: 'smooth' });
+  };
+
+  const handleUpdateKeyword = (keyword: string) => {
+    console.log('搜索关键词:', keyword);
+  };
+</script>
+```
+
+**渲染效果**（包含搜索过滤和定位功能，hover 消息组可看到「在对话中定位」按钮）
+
+## 组件结构
+
+```
+ai-execution-summary
+├── ai-execution-summary-header（仅 messageGroups 非空时渲染）
+│   └── Input（关键词搜索框，clearable）
+└── ai-execution-summary-content
+    ├── 有数据时：
+    │   └── content-item × N（时间线节点）
+    │       ├── timeline-dot（时间节点圆点）
+    │       ├── content-item-time（格式化时间）
+    │       ├── content-item-locate（hover 显示定位按钮）
+    │       ├── content-item-messages（MessageRender × N）
+    │       └── timeline-line（连接线，最后一项不显示）
+    └── 无数据时：
+        └── Exception（scene="part"）+「暂无数据」/「搜索结果为空」文案（有关键词时附带「清空搜索」）
+```
+
+## 空状态
+
+当 `messageGroups` 为空数组时，**不渲染搜索 header**，内容区整块展示空态（bkui `Exception` +「暂无数据」；若仍有搜索关键词则为「搜索结果为空」并提供「清空搜索」）：
+
+## 与 ChatContainer 配合
+
+`ChatContainer` 通过 `useMessageGroup` 计算 `executionGroups`（仅包含工具调用和 FlowAgent 消息），并传给 `ExecutionSummary`：
+
+```vue
+<!-- ChatContainer 内部 -->
+<ExecutionSummary
+  :message-groups="executionGroups"
+  @locate-message-group="handleLocateMessageGroup"
+  @update-keyword="handleUpdateKeyword"
+/>
+```
+
+## 面板内的消息按只读呈现
+
+面板与对话流复用同一套渲染链路（`MessageRender` → `ContentRender` → 具体内容组件），但面板定位是「回看执行过程」，不承载操作。为此组件在 setup 阶段 provide 面板上下文：
+
+```typescript
+// 源码：src/composables/use-common.ts（内部上下文，未从包入口导出）
+import { useExecutionPanelProvider } from '../../composables/use-common';
+
+// 面板身份在组件树中恒定，provide 常量 true 即可，无需响应式
+useExecutionPanelProvider();
+```
+
+内容组件用 `useExecutionPanelInject()` 读取（缺省 `false`，即对话流内）。当前的差异：
+
+| 内容 | 对话流内 | 侧栏「执行情况」面板内 |
+| ---- | -------- | ---------------------- |
+| FlowAgent 失败节点「重试 / 跳过」 | 展示（依赖 `retryable` / `skippable`） | **不展示** |
+| FlowAgent 节点「详情」 | 展示 | 展示 |
+
+新增内容组件若也需要区分这两种场景，同样注入 `useExecutionPanelInject()` 即可，不必扩展 props。`EXECUTION_PANEL_TOKEN` 与这两个函数同属 `use-common.ts` 的内部上下文，未从 `@blueking/chat-x` 包入口导出，仅供库内组件使用。详见 [FlowAgentContent](/components/agent/flow-agent-content)。
+
+## API
+
+### Props
+
+| 属性名        | 类型             | 必填 | 说明             |
+| ------------- | ---------------- | ---- | ---------------- |
+| messageGroups | `MessageGroup[]` | ✓    | 执行摘要消息分组 |
+
+### Events
+
+| 事件名             | 参数                                  | 说明                     |
+| ------------------ | ------------------------------------- | ------------------------ |
+| locateMessageGroup | `(uid: string, group: MessageGroup)` | 点击「在对话中定位」按钮，参数为消息组 `MessageGroup.uid` |
+| updateKeyword      | `(keyword: string)`                   | 搜索关键词变更           |
+
+## 类型定义
+
+```typescript
+import { type MessageGroup } from '@blueking/chat-x';
+
+interface MessageGroup {
+  uid: string;
+  type: MessageRole;
+  messages: Message[];
+  checked: boolean;
+  isHover: boolean;
+  pause?: boolean;
+  startTime?: number;
+}
+```
+
+## 关联组件
+
+- [MessageRender](/components/message/message-render) — 摘要内消息渲染
+- [HighlightKeyword](/components/helper/highlight-keyword) — 搜索高亮
+- [ChatContainer](/components/setup/chat-container) — 侧栏挂载场景

package/skills/blueking-chat-x/references/components/file-artifact-panel.md

@@ -0,0 +1,307 @@
+# FileArtifactPanel 文件产物预览
+
+> 能力域：消息系统 ｜ 未从包入口导出：内部组件，请通过上层组件使用 ｜ since 0.0.20
+
+汇总当前会话所有 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。
+
+**关联**：assistant-message（文件产物来源于 AssistantMessage.property.artifacts）、chat-container（面板挂载在侧栏「文件产物」Tab（固定、不可关闭），并通过 onArtifactClick 异步取链）、execution-summary（同为 ChatContainer 侧栏 Tab 面板，交互形态一致）、message-loading（ArtifactPreviewHost 取链 / 拉取正文过程使用 MessageLoading）、mention-tag（引用后文件以资源标签形态进入输入框）
+
+---
+
+# FileArtifactPanel 文件产物预览
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue`
+- **能力域**：消息系统
+- **能力说明**：汇总当前会话全部文件产物；左侧列表搜索与选中，右侧预览委托内部 `ArtifactPreviewHost`。
+
+> **导出说明**：内部侧栏面板组件，**通常不直接使用**；由 `ChatContainer` 在「文件产物」Tab 内自动挂载。预览加载与渲染为同目录下 `artifact-preview/` 内部实现，不单独导出。
+
+点击 AI 回复中的[文件卡片](/components/message/assistant-message)后，`ChatContainer` 侧栏会弹出固定的「文件产物」Tab，聚合展示当前会话**所有** `AssistantMessage` 的文件产物（按 `outputId` 去重），并命中被点击的文件进行预览。
+
+面板左侧为可搜索的文件列表，右侧为预览区。通常不需要直接使用，由 `ChatContainer` 在侧栏内自动渲染。
+
+## 核心能力
+
+- **会话级聚合**：拍平当前会话所有 `AssistantMessage.property.artifacts`，以 `outputId` 去重后统一在一个列表内展示
+- **唯一命中**：以 `outputId` 作为会话内唯一键（同 `outputId` 视为同一文件）；文件名可能重复，不可作唯一键
+- **关键词搜索**：按文件名实时过滤列表
+- **整块空态**：`artifacts` 为空时不渲染列表与预览区，整块展示 bkui `Exception`「暂无数据」（Tab 常驻，无数据也可正常打开侧栏）
+- **异步取链**：`AIFileInfo` 本身不含 `url` / `previewUrl`，通过 `ChatContainer` 的 `onArtifactClick` 按 `outputId` 获取 `download_url` / `preview_url`（不做 URL 缓存，每次重新取链；同文件进行中的请求并发去重）
+- **引用到输入框**：预览头提供「引用」按钮（位于下载左侧），点击后该文件以资源标签形态进入输入框
+- **职责拆分**：
+  - **面板本身**：列表、搜索、预览头（文件名 / 图标 / 复制 / 引用 / 下载）
+  - **`ArtifactPreviewHost`**：按策略加载正文或预览 URL，分派到对应 renderer；展示 loading / empty / error（含重试）
+- **未传 `onArtifactClick`**：下载按钮隐藏，预览区展示无数据
+
+## 基础用法
+
+面板**未从包入口导出**，业务侧请走下方「业务接入」；下列示例仅用于文档站 / 本地调试（与 `ExecutionSummary` 文档站写法一致：相对路径引入 + 自行挂 Provider）。
+
+```vue
+<template>
+  <div style="height: 480px; border: 1px solid #dcdee5; border-radius: 8px; overflow: hidden;">
+    <FileArtifactPanel
+      :active-id="activeArtifactId"
+      :artifacts="sessionArtifacts"
+      @select="handleSelect"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { shallowRef } from 'vue'
+  import { useArtifactPreviewProvider } from '@blueking/chat-x'
+  import type { AIFileInfo, SessionArtifact } from '@blueking/chat-x'
+  // 内部组件：仅文档 / 调试；业务请用 ChatContainer 自动挂载
+  import FileArtifactPanel from './message-artifacts/file-artifact-panel.vue'
+
+  const sessionArtifacts: SessionArtifact[] = [
+    { name: '周报.html', outputId: 'a-html', size: 10240, type: 'html' },
+    { name: '说明.md', outputId: 'a-md', size: 8192, type: 'md' },
+    { name: '纪要.txt', outputId: 'a-txt', size: 4096, type: 'txt' },
+    { name: '配置.json', outputId: 'a-json', size: 2048, type: 'json' },
+    { name: '立项.pdf', outputId: 'a-pdf', size: 204800, type: 'pdf' },
+  ]
+
+  useArtifactPreviewProvider({
+    getOnArtifactClick: () => async file => {
+      // 文本类返回可 fetch 的 download_url；iframe 类返回 preview_url
+      const res = await api.getArtifactUrls(file.outputId)
+      return { download_url: res.download_url, preview_url: res.preview_url }
+    },
+    onOpen: () => {},
+  })
+
+  const activeArtifactId = shallowRef(sessionArtifacts[0].outputId)
+  const handleSelect = (id: string) => {
+    activeArtifactId.value = id
+  }
+</script>
+```
+
+**渲染效果**（点击左侧列表切换类型；文本类直渲染，PDF 走 iframe。Mock 取链约 600ms）
+
+## 业务接入（ChatContainer）
+
+日常用法是给容器传 `messages`（含 `property.artifacts`）与 `onArtifactClick`，点击文件卡片即可打开侧栏面板：
+
+```vue
+<template>
+  <ChatContainer
+    v-model="input"
+    :messages="messages"
+    :on-artifact-click="onArtifactClick"
+    @send-message="handleSend"
+  />
+</template>
+
+<script setup lang="ts">
+  import { ref, shallowRef } from 'vue'
+  import {
+    ChatContainer,
+    MessageRole,
+    MessageStatus,
+    type AIFileInfo,
+    type Message,
+  } from '@blueking/chat-x'
+
+  const input = ref('')
+  const messages = shallowRef<Message[]>([
+    {
+      id: 'u1',
+      messageId: 'u1',
+      role: MessageRole.User,
+      status: MessageStatus.Complete,
+      content: '整理本周评审材料',
+    },
+    {
+      id: 'a1',
+      messageId: 'a1',
+      uid: 'assistant-uid-1',
+      role: MessageRole.Assistant,
+      status: MessageStatus.Complete,
+      content: '已生成评审材料，点击卡片可在侧栏预览：',
+      property: {
+        artifacts: [
+          { name: '周报.html', outputId: 'a-html', size: 10240, type: 'html' },
+          { name: '说明.md', outputId: 'a-md', size: 8192, type: 'md' },
+          { name: '配置.json', outputId: 'a-json', size: 2048, type: 'json' },
+          { name: '立项.pdf', outputId: 'a-pdf', size: 204800, type: 'pdf' },
+        ] satisfies AIFileInfo[],
+      },
+    },
+  ])
+
+  const onArtifactClick = async (file: AIFileInfo) => {
+    const res = await api.getArtifactUrls(file.outputId)
+    return {
+      download_url: res.download_url,
+      preview_url: res.preview_url,
+    }
+  }
+
+  const handleSend = () => {
+    /* ... */
+  }
+</script>
+```
+
+## 触发链路
+
+```
+ArtifactFileCard（点击文件卡片）
+  └─ useArtifactPreviewConsumer().openPreview({ file })
+       └─ useArtifactPreviewProvider（ChatContainer 内）
+            ├─ 记录命中文件 activeArtifactId = file.outputId
+            └─ onOpen → addCustomTab('file-artifact') 展开并选中侧栏 Tab
+                 └─ FileArtifactPanel
+                      ├─ 列表 @select → setActiveArtifactId(outputId)
+                      ├─ 下载 → resolveArtifactUrls + triggerArtifactDownload
+                      └─ ArtifactPreviewHost
+                           ├─ useArtifactPreviewLoader（策略 + fetch / 取链，防竞态）
+                           └─ HtmlPreview | MarkdownPreview | TxtPreview | UrlIframePreview
+
+容器初始化
+  └─ ensureCustomTab('file-artifact') 常驻挂上（不展开侧栏）；因 order:-1 排在首位，
+     未主动切换过 Tab 时会成为默认选中面板；无产物时由面板展示整块空态
+```
+
+- 文件卡片通过 `useArtifactPreviewConsumer` 注入预览上下文，无 Provider 时卡片不可点击（兜底 `undefined`）
+- `ChatContainer` 通过 `useArtifactPreviewProvider` 提供上下文，并把「打开侧栏 Tab」这一副作用以 `onOpen` 注入，保持 composable 职责单一
+- 侧栏「文件产物」Tab 固定不可关闭，`order: -1` 排在「执行情况」之前；**常驻不随产物有无增删**，无产物时由面板展示整块空态
+
+## 引用到输入框
+
+预览头与消息区文件卡片都提供「引用」入口（设计稿中位于下载左侧），点击后文件以资源标签形态追加进输入框，等价于用户在 `@` 菜单里选中它：
+
+```
+预览头 / 文件卡片「引用」
+  └─ useInputMentionConsumer()?.insertMention(toArtifactMenuItem(file))
+       └─ ChatContainer 提供的 insertMention
+            └─ ChatInput.insertMention → AiSlashInput.appendMention（追加到文档末尾）
+```
+
+- **入口显隐**：`useInputMentionConsumer()` 为 `undefined`（没有输入框，如 `Share` 只读态）时不渲染引用按钮，无需额外开关
+- **id 一致性**：统一走 [`toArtifactMenuItem`](/utils/#会话产物收集) 生成菜单条目，与 `@` 菜单里自动收集的产物同源；id 不一致会导致去重与已插入标签匹配同时失效
+- **消息区文件卡片**：`ArtifactFileCard` 右侧操作区 hover 时显示，引用在下载左侧
+
+## 唯一键规则
+
+会话内以 **`outputId`** 作为文件产物唯一键：
+
+- 同一 `outputId` 在多条消息中出现时，聚合列表去重并保留最后一次出现的文件信息
+- `activeId`、列表 `:key`、`select` 事件参数均使用 `outputId`
+- 文件名可能重复，**不可**作为唯一键
+
+## 预览机制
+
+预览分两步：先由 `resolveFileKind(type, name)`（`src/utils/file-type.ts`）把扩展名归入六个**分类**，再由 `getArtifactPreviewStrategy` 查表得到 **加载方式** 与 **渲染器**。面板与 Host 都不写死具体扩展名分支，后台新增文件类型时只需在分类表里补一行。
+
+| 分类 | 覆盖扩展名 | load | 取链字段 | renderer |
+| ---- | ---------- | ---- | -------- | -------- |
+| `code` | `py` `js` `mjs` `cjs` `ts` `tsx` `jsx` `vue` `go` `rs` `rb` `java` `kt` `swift` `c` `h` `cpp` `hpp` `cs` `php` `lua` `r` `scala` `dart` `sh` `bash` `zsh` `ps1` `sql` `css` `scss` `less` `json` `jsonc` `yaml` `yml` `toml` `ini` `cfg` `conf` `env` `xml` `tex` `Dockerfile` `Makefile` `gitignore` `dockerignore` `editorconfig` | `text_from_download` | `download_url` → `fetch` 正文 | `CodePreview`（highlight.js 高亮） |
+| `markdown` | `md` `markdown` | `text_from_download` | 同上 | `MarkdownPreview`（`MarkdownContent`） |
+| `html` | `html` `htm` | `text_from_download` | 同上 | `HtmlPreview`（`<iframe srcdoc>`） |
+| `text` | `txt` `rst` | `text_from_download` | 同上 | `TxtPreview`（`<pre>`） |
+| `image` | `png` `jpg` `jpeg` `svg` | `preview_url` | `preview_url` | `ImagePreview`（`<img>`，`object-fit: contain`） |
+| `binary` | `pdf` `docx` `xlsx` `xlsm` `xls` `pptx` `csv` `tsv`，以及**所有未登记的扩展名** | `preview_url` | `preview_url` | `UrlIframePreview`（`<iframe src>`，一般为后台转好的 PDF） |
+
+关于类型解析：
+
+- `AIFileInfo.type` 为**扩展名字符串**（如 `'pdf'` / `'py'`）或无扩展名的文件名（如 `'Dockerfile'`），大小写不敏感
+- `type` 缺省时回退 `name` 推断；`报告.final.xlsx` 取 `xlsx`，`.gitignore` 取 `gitignore`
+- `md` 为后台扩展名别名，与 `markdown` 等价，共用 Markdown 直渲染
+- 未登记的扩展名一律落入 `binary` 走后台预览，前端不会因为新类型报错
+
+`CodePreview` 的语言由扩展名映射到 highlight.js（`vue → xml`、`tsx → typescript`、`env / cfg / conf → ini` 等，其余交给 hljs 自身别名表，识别不了则按 `plaintext` 转义输出）。单文件超过 300KB 时跳过高亮直接转义，避免同步解析阻塞主线程。
+
+### 加载态
+
+| status | 表现 |
+| ------ | ---- |
+| `loading` | 预览区 [MessageLoading](/components/helper/message-loading) |
+| `ready` | 对应 renderer 渲染 |
+| `empty` | 「暂无可预览的文件」（无文件 / 未传 `onArtifactClick` / 缺所需 URL） |
+| `error` | 「预览加载失败」+ 重试按钮 |
+
+### 重载与取链约定
+
+- **重载键**：`ArtifactPreviewHost` 以 `` `${outputId}:${type}` `` 监听文件变化；`outputId` 或 `type` 任一变化会重新 `load()`，仅改文件名等其它字段不会
+- **取链**：`resolveArtifactUrls(file)` 每次重新调用 `onArtifactClick`；同文件进行中的请求会复用（并发去重）
+- **重试**：错误态点击重试再次走 `load()`，重新取链并加载
+- **竞态**：切换文件时 `useArtifactPreviewLoader` 用 `loadSeq` + `AbortController` 中断上一次 `fetch`，避免过期结果覆盖最新内容
+
+下载图标仍由面板用 bkui `Loading` spin 单独表达。
+
+## 内部结构（不导出）
+
+```
+message-artifacts/
+├── file-artifact-panel.vue          # 列表 + 下载头 + 挂载 Host
+└── artifact-preview/
+    ├── artifact-preview-host.vue    # 状态机 UI + 分派 renderer
+    ├── preview-strategy.ts          # getArtifactPreviewStrategy（分类 → 策略查表）
+    ├── use-artifact-preview-loader.ts
+    └── renderers/
+        ├── code-preview.vue
+        ├── html-preview.vue
+        ├── image-preview.vue
+        ├── markdown-preview.vue
+        ├── txt-preview.vue
+        └── url-iframe-preview.vue
+```
+
+分类表与扩展名归一化在 `src/utils/file-type.ts`（导出 `AIFileKind` / `resolveFileKind` / `normalizeFileExtension`），与[文件图标](/components/helper/file-icon)共用同一份解析入口。
+
+## API
+
+### Props
+
+| 属性名    | 类型                | 必填 | 说明                                   |
+| --------- | ------------------- | ---- | -------------------------------------- |
+| activeId  | `string`            | ✓    | 当前命中的文件 `outputId`              |
+| artifacts | `SessionArtifact[]` | ✓    | 当前会话全部文件产物（已按 `outputId` 去重） |
+
+### Events
+
+| 事件名 | 参数              | 说明                       |
+| ------ | ----------------- | -------------------------- |
+| select | `(id: string)`    | 列表内切换选中文件，参数为文件 `outputId` |
+
+### Slots / Expose
+
+无。
+
+## 类型定义
+
+```typescript
+import type { AIFileInfo, SessionArtifact } from '@blueking/chat-x';
+
+// 会话级文件产物：拍平去重后即为 AIFileInfo
+type SessionArtifact = AIFileInfo;
+
+type AIFileInfo = {
+  name: string;
+  outputId: string;
+  size: number;
+  /** 扩展名（如 'pdf' / 'py'）或无扩展名文件名（如 'Dockerfile'），大小写不敏感 */
+  type: string;
+};
+```
+
+> **破坏性变更**：原 `AIFileType` 枚举已移除，`AIFileInfo.type` 改为 `string`。此前写 `type: AIFileType.Pdf` 的代码改为 `type: 'pdf'` 即可；枚举成员的值与新字符串一一对应，运行时数据无需迁移。
+
+## 关联 Composable
+
+预览**命中与取链**由 [useArtifactPreview](/composables/use-artifact-preview) 提供（Provider / Consumer + `ARTIFACT_PREVIEW_TOKEN`）。**正文加载与渲染**由内部 `useArtifactPreviewLoader` + `ArtifactPreviewHost` 完成，不在该 composable 内。**引用到输入框**由 [useInputMention](/composables/use-input-mention) 提供。
+
+## 关联组件
+
+- [AssistantMessage](/components/message/assistant-message) — 文件产物来源（`property.artifacts`）
+- [ChatContainer](/components/setup/chat-container) — 侧栏「文件产物」Tab 挂载场景，提供 `onArtifactClick`
+- [MessageLoading](/components/helper/message-loading) — Host 预览区异步加载态
+- [ExecutionSummary](/components/agent/execution-summary) — 同为侧栏 Tab 面板
+- [MentionTag](/components/rendering/mention-tag) — 引用后在输入框内的标签形态
+- [useInputMention](/composables/use-input-mention) — 引用入口的上下文来源