@blueking/chat-x 0.0.42 → 0.0.43

package/dist/lang/lang.d.ts

@@ -43,6 +43,7 @@ export declare const lang: {
     readonly 失败: "Failed";
     readonly 挂起: "Pending";
     readonly 待执行: "To Be Executed";
+    readonly 跳过: "Skipped";
     readonly 详情: "Details";
     readonly 节点: "Node";
     readonly 节点配置: "Node Config";
@@ -97,5 +98,7 @@ export declare const lang: {
     readonly 清空搜索: "Clear Search";
     readonly 搜索结果为空: "Search Result is Empty";
     readonly 有效证据: "Valid Evidence";
+    readonly 全屏: "Full Screen";
+    readonly 退出全屏: "Exit Full Screen";
 };
-export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool:" | "Calling..." | "Call Success" | "Call Failed" | "Tell us your thoughts" | "What makes you satisfied?" | "What makes you dissatisfied?" | "Return Content" | "Edit" | "Deep Thinking" | "Loading image..." | "Failed to load image" | "Thinking..." | "Thinking Completed" | "Thinking Failed" | "Copy Success" | "Copy Failed" | "Return to bottom" | "Stop generating" | "Stopping" | "Duration" | "Parameters" | "Description" | "Execution Status" | "Running" | "Success" | "Failed" | "Pending" | "To Be Executed" | "Details" | "Node" | "Node Config" | "Node Output" | "Basic Info" | "Flow Template" | "Node Name" | "Step Name" | "Execution Plan" | "Optional" | "Failure Handler" | "Timeout Control" | "Yes" | "No" | "Input Params" | "Output Params" | "Param Name" | "Param Value" | "Name" | "Structured Output" | "Manual Skip" | "No Data" | "Call MCP:" | "More" | "Searching" | "Search Completed" | "Upload File" | "Requesting..." | "Cancel satisfied" | "Cancel dissatisfied" | "Confirm delete this answer?" | "This operation cannot be undone. Please proceed with caution!" | "Preview" | "Zoom Out" | "Zoom In" | "Rotate" | "Download" | "Sorry, image loading failed. Please try reloading." | "Reset" | "Reload" | "W" | "H" | "Upload Image" | "Search keyword" | "Select date" | "Locate in Chat" | "Select All" | "Confirm" | "Upload Image, up to 3 images supported, max 2.4MB each" | "Hello, I am BlueKing AI Bot" | "Clear Search" | "Search Result is Empty" | "Valid Evidence" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "检索中" | "检索完成" | "上传文件" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据";
+export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool:" | "Calling..." | "Call Success" | "Call Failed" | "Tell us your thoughts" | "What makes you satisfied?" | "What makes you dissatisfied?" | "Return Content" | "Edit" | "Deep Thinking" | "Loading image..." | "Failed to load image" | "Thinking..." | "Thinking Completed" | "Thinking Failed" | "Copy Success" | "Copy Failed" | "Return to bottom" | "Stop generating" | "Stopping" | "Duration" | "Parameters" | "Description" | "Execution Status" | "Running" | "Success" | "Failed" | "Pending" | "To Be Executed" | "Skipped" | "Details" | "Node" | "Node Config" | "Node Output" | "Basic Info" | "Flow Template" | "Node Name" | "Step Name" | "Execution Plan" | "Optional" | "Failure Handler" | "Timeout Control" | "Yes" | "No" | "Input Params" | "Output Params" | "Param Name" | "Param Value" | "Name" | "Structured Output" | "Manual Skip" | "No Data" | "Call MCP:" | "More" | "Searching" | "Search Completed" | "Upload File" | "Requesting..." | "Cancel satisfied" | "Cancel dissatisfied" | "Confirm delete this answer?" | "This operation cannot be undone. Please proceed with caution!" | "Preview" | "Zoom Out" | "Zoom In" | "Rotate" | "Download" | "Sorry, image loading failed. Please try reloading." | "Reset" | "Reload" | "W" | "H" | "Upload Image" | "Search keyword" | "Select date" | "Locate in Chat" | "Select All" | "Confirm" | "Upload Image, up to 3 images supported, max 2.4MB each" | "Hello, I am BlueKing AI Bot" | "Clear Search" | "Search Result is Empty" | "Valid Evidence" | "Full Screen" | "Exit Full Screen" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "跳过" | "详情" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "检索中" | "检索完成" | "上传文件" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏";

package/dist/mcp/generated/docs/chat-container.md

@@ -25,6 +25,7 @@ ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息
 - **消息分组**：内置 `useMessageGroup` 自动处理消息分组、Tool 合并、Loading 注入
 - **输入区状态推导**：传给 `MessageContainer` 与 `ChatInput` 的 `messageStatus` 为内部计算值 `inputStatus`：当分组中存在 id 为 `LOADING_MESSAGE_ID`（`'__loading__'`，由 `useMessageGroup` 注入的占位 Loading 消息）时，对内使用 `MessageStatus.Fetching`；否则使用外部传入的 `messageStatus`。用于在「已发用户消息、尚未流式」阶段与流式中一致地展示停止能力，并避免输入区重复发送
 - **执行摘要**：侧边栏展示工具调用 / FlowAgent 执行记录，支持关键词搜索和对话定位
+- **侧栏全屏**：Tab 栏右侧提供全屏/退出全屏按钮，基于 `useFullScreen` 将侧栏区域（`.ai-full-screen-wrapper`）以浏览器原生全屏展示；全屏时 Tippy 的 `appendTo` 自动切换为全屏容器，避免 tooltip 被遮挡
 - **自定义 Tab**：通过 `useCustomTabProvider` 支持动态添加自定义 Tab（如节点详情）
 - **分享模式**：内置消息多选分享流程，选中用户消息后确认分享
 - **渲染模式注入**：`renderMode` 会通过内部 Provider 下传给后代内容组件；例如 FlowAgent 节点在 `Share` 模式下隐藏耗时和「详情」入口
@@ -37,12 +38,14 @@ ai-chat-container
 ├── Loading（chatLoading 时）
 └── ResizeLayout
     ├── aside（侧边栏）
-    │   ├── Tab 标签页
-    │   │   ├── 执行情况（默认 Tab）
-    │   │   └── 自定义 Tab × N（可关闭；标签可由 `getSideTabRenderComponent` 自定义）
-    │   ├── ExecutionSummary（执行情况 Tab 内容）
-    │   ├── 自定义 Tab 组件（`getSideRenderComponent` 优先，否则 `data.component`；可向子组件注入 #locateButton）
-    │   └── collapse-button（折叠按钮）
+    │   ├── .ai-full-screen-wrapper（全屏目标容器，ref=fullScreenRef）
+    │   │   ├── Tab 标签页
+    │   │   │   ├── 执行情况（默认 Tab）
+    │   │   │   ├── 自定义 Tab × N（可关闭；标签可由 `getSideTabRenderComponent` 自定义）
+    │   │   │   └── #setting 插槽 → 全屏/退出全屏 ToolBtn（FullScreenIcon / UnFullScreenIcon）
+    │   │   ├── ExecutionSummary（执行情况 Tab 内容）
+    │   │   └── 自定义 Tab 组件（`getSideRenderComponent` 优先，否则 `data.component`；可向子组件注入 #locateButton）
+    │   └── collapse-button（折叠按钮，CollapsedIcon；折叠时图标旋转，hover 高亮 #3a84ff）
     └── main（主内容区）
         ├── MessageContainer（有消息时）
         │   └── 消息列表 + 工具栏
@@ -138,13 +141,25 @@ ai-chat-container
 
 侧边栏放置方向通过 `placement` 控制：
 
-| `placement` | 侧边栏位置   | 折叠按钮位置 |
-| ----------- | ------------ | ------------ |
-| `left`      | 左侧（默认） | 主区域左边缘 |
-| `right`     | 右侧         | 主区域右边缘 |
+| `placement` | 侧边栏位置   | 折叠按钮位置 | 折叠图标旋转 |
+| ----------- | ------------ | ------------ | ------------ |
+| `left`      | 左侧（默认） | 主区域左边缘 | 折叠时旋转 180° |
+| `right`     | 右侧         | 主区域右边缘 | 默认旋转 180°，折叠时恢复 0° |
+
+> 折叠按钮仅展示 `CollapsedIcon`（不再显示「执行情况」文案），通过图标旋转方向指示展开/折叠状态。
 
 **placement 对比**（左右两种布局）
 
+## 侧栏全屏
+
+当侧栏 Tab 区域可见时，Tab 栏右侧（`#setting` 插槽）内置全屏切换按钮：
+
+- 点击 **全屏** 图标：调用 `useFullScreen(fullScreenRef).enter()`，将 `.ai-full-screen-wrapper` 进入浏览器原生全屏
+- 点击 **退出全屏** 图标：调用 `exit()` 退出；用户按 ESC 退出时 `isFullScreen` 也会自动同步
+- 全屏状态下，侧栏内 `v-overflow-tips` 的 `appendTo` 会指向全屏容器，避免 tooltip 挂载到 `document.body` 后被全屏层遮挡
+
+该能力由内部 `useFullScreen` composable 提供，详见 [useFullScreen](../../composables/use-full-screen.md)。
+
 ## 自定义 Tab
 
 通过 `ref` 获取组件实例后，使用 `addCustomTab` / `removeCustomTab` 动态管理侧边栏 Tab。若 **`executionGroups` 变为空且搜索词已清空**，容器会清空自定义 Tab 状态（与侧栏执行数据联动，见上文「侧边栏与执行摘要」）。
@@ -486,4 +501,6 @@ interface Shortcut {
 - [ChatInput](./chat-input.md) — 输入与快捷指令
 - [ShortcutRender](./shortcut-render.md) — 快捷指令表单
 - [ExecutionSummary](./execution-summary.md) — 执行摘要侧栏
-- [SelectionFooter](../atomic/selection-footer.md) — 多选操作栏
+- [SelectionFooter](../atomic/selection-footer.md) — 多选操作栏
+- [ToolBtn](../atomic/tool-btn.md) — 侧栏全屏按钮（自定义插槽）
+- [useFullScreen](../../composables/use-full-screen.md) — 侧栏全屏控制

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

@@ -358,9 +358,9 @@ const CONST_UPDATE_TOOLS = [
 import { MessageToolsStatus, type IToolBtn } from '@blueking/chat-x';
 
 interface IToolBtn {
-  id: string; // 工具唯一标识；与 ToolIconsMap 匹配时显示内置图标，否则显示 name 文本
-  name: string; // 工具名称，无对应图标时显示；也用作 tooltip fallback
-  description: string; // tooltip 文本
+  id?: keyof typeof ToolIconsMap; // 工具唯一标识；与 ToolIconsMap 匹配时显示内置图标，否则显示 name 文本
+  name?: string; // 工具名称，无对应图标时显示；也用作 tooltip fallback
+  description?: string; // tooltip 文本
 }
 
 enum MessageToolsStatus {

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

@@ -25,8 +25,9 @@ div.ai-tool-btn（v-tippy，flex，min-width: 20px，height: 20px，border-radiu
   disabled=true → .is-disabled（color: #979ba5; cursor: not-allowed）
   :not(.is-disabled):hover → color: #4d4f56; background: #eaebf0
   │
-  ├── [id in ToolIconsMap] → <component :is="ToolIconsMap[id]" />（SVG 图标，font-size: 16px 控制大小）
-  └── [id not in ToolIconsMap] → <div>{{ name }}</div>（文本回退，XSS 安全）
+  └── <slot>（默认内容，可完全自定义）
+        ├── [id && id in ToolIconsMap] → <component :is="ToolIconsMap[id]" />（SVG 图标）
+        └── [其他] → <div>{{ name }}</div>（文本回退，XSS 安全）
 
 Tippy：content=description, theme='ai-chat-box', disabled=true 时 onShow 返回 false 不显示
 click 事件：disabled=true 时被 JS 拦截，不触发 emit
@@ -51,7 +52,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 | `activeLike`   | 点赞（实心）   | 激活态填充图标           |
 | `activeUnLike` | 不满意（实心） | 激活态填充图标           |
 
-> `id` 不在上表时，组件渲染 `<div>{{ name }}</div>` 作为文本回退。此时 `id` 的 TypeScript 类型会报错（`keyof typeof ToolIconsMap`），建议优先使用预置 ID。
+> 未传入 `id`、或 `id` 不在上表时，组件渲染 `<div>{{ name }}</div>` 作为文本回退。也可通过默认插槽完全自定义按钮内容（如全屏图标），此时可不传 `id`。
 
 ## 基础用法
 
@@ -187,7 +188,31 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 
 ## 未知 ID 的文本回退
 
-`id` 不在 `ToolIconsMap` 时渲染 `name` 文本，适用于自定义扩展场景（注意 TypeScript 会报类型错误）：
+`id` 不在 `ToolIconsMap` 时渲染 `name` 文本，适用于自定义扩展场景：
+
+## 自定义插槽内容
+
+通过默认插槽可完全替换内置图标/文本，适用于预置 `ToolIconsMap` 未覆盖的图标场景（如侧栏全屏按钮）：
+
+```vue
+<template>
+  <ToolBtn
+    description="全屏"
+    :tippy-options="{ content: '全屏' }"
+    @click="handleFullScreen"
+  >
+    <FullScreenIcon />
+  </ToolBtn>
+</template>
+
+<script setup lang="ts">
+  import { ToolBtn, FullScreenIcon } from '@blueking/chat-x';
+
+  const handleFullScreen = () => {
+    // 进入全屏逻辑
+  };
+</script>
+```
 
 ## API
 
@@ -195,7 +220,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 
 | 属性名       | 类型                                                                       | 必填 | 默认值 | 说明                                                                                                               |
 | ------------ | -------------------------------------------------------------------------- | ---- | ------ | ------------------------------------------------------------------------------------------------------------------ |
-| id           | `keyof typeof ToolIconsMap`                                                | 是   | —      | 按钮标识；在 `ToolIconsMap` 中时渲染对应 SVG 图标，否则渲染 `name` 文本                                            |
+| id           | `keyof typeof ToolIconsMap`                                                | 否   | —      | 按钮标识；在 `ToolIconsMap` 中时渲染对应 SVG 图标，否则渲染 `name` 文本；使用插槽自定义内容时可省略                  |
 | name         | `string`                                                                   | 否   | —      | 按钮名称；`id` 无对应图标时作为文本内容渲染                                                                        |
 | description  | `string`                                                                   | 否   | —      | Tippy tooltip 内容；`disabled=true` 时不显示 tooltip                                                               |
 | active       | `boolean`                                                                  | 否   | —      | 激活态；`true` 时追加 `.is-active`（字色由 `id` 决定：`like`/`activeLike` 为蓝色 `#3a84ff`，其他为红色 `#E71818`） |
@@ -208,12 +233,18 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 | ------ | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | click  | `(data: IToolBtn & { active?: boolean; disabled?: boolean }, event: MouseEvent)` | 点击时触发；`data` 为组件当前全量 props（含 `active`/`disabled`）；`disabled=true` 时不触发 |
 
+### Slots
+
+| 插槽名  | 说明                                                                                       |
+| ------- | ------------------------------------------------------------------------------------------ |
+| default | 按钮内容；传入时替换默认的图标/文本渲染逻辑，常用于自定义 SVG 图标（如全屏、退出全屏按钮） |
+
 ## 类型定义
 
 ```typescript
 // 来自 @blueking/chat-x 导出
 interface IToolBtn {
-  id: keyof typeof ToolIconsMap; // 限定为预置 ID
+  id?: keyof typeof ToolIconsMap; // 预置 ID；省略时走 name 文本或插槽
   name?: string;
   description?: string;
 }

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

@@ -0,0 +1,114 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+useFullScreen 将目标元素（或 document.documentElement）以浏览器原生全屏展示。 模块加载时一次性嗅探 requestFullscreen / webkitRequestFullscreen，返回 isSupported、只读 isFullScreen 与 enter/exit/toggle。 监听 fullscreenchange 同步 ESC 等外部退出；ChatContainer 侧栏全屏按钮使用此 composable。
+
+### 关联组件
+- **chat-container** — 侧栏 .ai-full-screen-wrapper 全屏切换
+- **tool-btn** — 全屏按钮通过插槽渲染 FullScreenIcon
+
+---
+<!-- FULL DOC -->
+
+# useFullScreen 全屏控制
+
+> **分类**：composable
+
+基于浏览器原生 Fullscreen API 的全屏控制组合式函数。模块加载时一次性嗅探标准 API 与 `webkit` 前缀（兼容旧版 Safari），在组件作用域销毁时自动移除事件监听。
+
+## 工作原理
+
+```
+useFullScreen(target?)
+  │
+  ├── resolveFullscreenApi()（模块级，仅执行一次）
+  │     requestFullscreen / webkitRequestFullscreen
+  │
+  ├── isSupported = !!fullscreenApi
+  ├── isFullScreen（readonly shallowRef，与浏览器真实状态同步）
+  │
+  ├── enter()  → target.requestFullscreen()
+  ├── exit()   → document.exitFullscreen()
+  ├── toggle() → isFullScreen ? exit() : enter()
+  │
+  └── document.addEventListener(fullscreenchange, syncState)
+        syncState：指定 target 时，仅当 fullscreenElement === target 视为全屏
+        onScopeDispose 时移除监听
+```
+
+> **注意**：`enter()` 可能因缺少用户手势等原因被浏览器拒绝，内部会静默捕获异常，避免未处理的 Promise rejection。
+
+## 基础用法
+
+```vue
+<template>
+  <div>
+    <div ref="panelRef" class="demo-panel">
+      <p>可全屏展示的面板内容</p>
+    </div>
+    <button :disabled="!isSupported" @click="enter">进入全屏</button>
+    <button :disabled="!isFullScreen" @click="exit">退出全屏</button>
+    <span>当前状态：{{ isFullScreen ? '全屏' : '窗口' }}</span>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useTemplateRef } from 'vue';
+  import { useFullScreen } from '@blueking/chat-x';
+
+  const panelRef = useTemplateRef<HTMLElement>('panelRef');
+  const { isSupported, isFullScreen, enter, exit } = useFullScreen(panelRef);
+</script>
+```
+
+## 在 ChatContainer 中的使用
+
+`ChatContainer` 将侧栏包裹在 `.ai-full-screen-wrapper` 中，通过 `useFullScreen(fullScreenRef)` 控制侧栏全屏；Tab 栏 `#setting` 插槽内的 `ToolBtn` 使用自定义插槽渲染 `FullScreenIcon` / `UnFullScreenIcon`。
+
+详见 [ChatContainer 侧栏全屏](../components/molecular/chat-container.md#侧栏全屏)。
+
+## API
+
+### 参数
+
+| 参数名 | 类型 | 默认值 | 说明 |
+| ------ | ---- | ------ | ---- |
+| target | `MaybeRef<HTMLElement \| null>` | — | 需要全屏的目标元素；省略时回退到 `document.documentElement` |
+
+### 返回值
+
+| 属性名 | 类型 | 说明 |
+| ------ | ---- | ---- |
+| isSupported | `boolean` | 当前环境是否支持 Fullscreen API（SSR 或不支持时为 `false`） |
+| isFullScreen | `Readonly<ShallowRef<boolean>>` | 只读响应式全屏状态；与浏览器真实状态同步（含 ESC 退出） |
+| enter | `() => Promise<void>` | 进入全屏；已全屏或不受支持时无操作 |
+| exit | `() => Promise<void>` | 退出全屏；当前无全屏元素时无操作 |
+| toggle | `() => void` | 切换全屏状态 |
+
+## 类型定义
+
+```typescript
+import { useFullScreen } from '@blueking/chat-x';
+import type { MaybeRef, Readonly, ShallowRef } from 'vue';
+
+type UseFullScreenReturn = {
+  isSupported: boolean;
+  isFullScreen: Readonly<ShallowRef<boolean>>;
+  enter: () => Promise<void>;
+  exit: () => Promise<void>;
+  toggle: () => void;
+};
+
+// 调用签名
+declare function useFullScreen(target?: MaybeRef<HTMLElement | null>): UseFullScreenReturn;
+```
+
+## 使用场景
+
+- `ChatContainer` 侧栏执行情况 / 自定义 Tab 区域全屏查看
+- 任意需要将局部 DOM 区域以浏览器原生全屏展示的交互面板
+
+## 关联组件
+
+- [ChatContainer](../components/molecular/chat-container.md) — 内置侧栏全屏按钮
+- [ToolBtn](../components/atomic/tool-btn.md) — 全屏按钮自定义插槽

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-06-04T03:38:32.650Z",
+  "generatedAt": "2026-06-08T08:12:22.821Z",
   "domains": {
     "message": {
       "label": "消息展示",
@@ -1054,6 +1054,24 @@
       ],
       "docFile": "docs/use-custom-tab.md"
     },
+    {
+      "name": "useFullScreen",
+      "slug": "use-full-screen",
+      "category": "composable",
+      "description": "基于浏览器原生 Fullscreen API 的全屏控制组合式函数，自动嗅探标准与 WebKit 前缀，状态与 ESC 退出保持同步。",
+      "aiSummary": "useFullScreen 将目标元素（或 document.documentElement）以浏览器原生全屏展示。 模块加载时一次性嗅探 requestFullscreen / webkitRequestFullscreen，返回 isSupported、只读 isFullScreen 与 enter/exit/toggle。 监听 fullscreenchange 同步 ESC 等外部退出；ChatContainer 侧栏全屏按钮使用此 composable。",
+      "relatedComponents": [
+        {
+          "slug": "chat-container",
+          "relation": "侧栏 .ai-full-screen-wrapper 全屏切换"
+        },
+        {
+          "slug": "tool-btn",
+          "relation": "全屏按钮通过插槽渲染 FullScreenIcon"
+        }
+      ],
+      "docFile": "docs/use-full-screen.md"
+    },
     {
       "name": "useGlobalConfig",
       "slug": "use-global-config",

package/dist/types/tool.d.ts

@@ -7,6 +7,6 @@ export declare enum MessageToolsStatus {
 export type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'placement' | 'zIndex'>>;
 export interface IToolBtn {
     description?: string;
-    id: keyof typeof ToolIconsMap;
+    id?: keyof typeof ToolIconsMap;
     name?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.42",
+  "version": "0.0.43",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
   "bin": {
@@ -78,7 +78,7 @@
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
     "vue-tsc": "^3.1.4",
-    "@blueking/chat-helper": "0.0.8"
+    "@blueking/chat-helper": "0.0.9"
   },
   "scripts": {
     "dev": "vite --config vite.config.ts",