one-design-next 0.0.122 → 0.0.124

package/dist/_genui-inline-ref.d.ts

@@ -7,5 +7,5 @@
 export declare const SKILL_CATEGORY_ICON = "astroid";
 /** skill / 未标明的 invocation 通道 → 技能品类 icon；其它 kind 回退 data.icon */
 export declare function resolveInvocationCategoryIcon(kind?: string, fallback?: string): string | undefined;
-/** mention 按 kind 给品类 icon；未知 kind 回退 data.icon */
+/** mention 按 kind 给品类 icon。`mention` 是 @ 文件引用，不画 icon，格式看文件名后缀。 */
 export declare function resolveMentionCategoryIcon(kind?: string, fallback?: string): string | undefined;

package/dist/_genui-inline-ref.js

@@ -14,9 +14,10 @@ export function resolveInvocationCategoryIcon(kind, fallback) {
   return fallback;
 }
 
-/** mention 按 kind 给品类 icon；未知 kind 回退 data.icon */
+/** mention 按 kind 给品类 icon。`mention` 是 @ 文件引用，不画 icon，格式看文件名后缀。 */
 export function resolveMentionCategoryIcon(kind, fallback) {
   if (kind === 'file') return 'file-text';
-  if (kind === 'user' || kind === 'mention') return 'user';
+  if (kind === 'user') return 'user';
+  if (kind === 'mention') return undefined;
   return fallback;
 }

package/dist/_genui-types.d.ts

@@ -131,10 +131,10 @@ export interface ChipData {
     label: string;
     icon?: string;
     /**
-     * 'invocation' = `/` 或 Skill 按钮；'mention' = `@`（预留）。
+     * 'invocation' = `/` 或 Skill 按钮；'mention' = `@`；'slot' = 提示词槽位。
      * 其他值归 invocation。
      */
-    kind?: 'invocation' | 'mention' | (string & NonNullable<unknown>);
+    kind?: 'invocation' | 'mention' | 'slot' | (string & NonNullable<unknown>);
     state?: InlineRefState;
     payload?: Record<string, unknown>;
     /**
@@ -222,6 +222,8 @@ export declare const ComposerSegmentType: {
     readonly Text: "text";
     readonly Invocation: "invocation";
     readonly Mention: "mention";
+    /** 提示词模板槽位。空槽保留名称，填过的带 value */
+    readonly Slot: "slot";
     /** 派生的 skill 提示文本；发送时按结构谓词追加，见 `ComposerHintSegment` */
     readonly Hint: "hint";
 };
@@ -238,6 +240,17 @@ export interface ComposerMentionSegment {
     type: typeof ComposerSegmentType.Mention;
     data: MentionData;
 }
+/** 提示词槽位。`name` 是空槽上的名称，`value` 是填入的字，空字符串表示还没填。 */
+export interface SlotData {
+    id: string;
+    name: string;
+    value: string;
+    templateId?: string;
+}
+export interface ComposerSlotSegment {
+    type: typeof ComposerSegmentType.Slot;
+    data: SlotData;
+}
 /**
  * 派生的 skill 提示段：**不是用户输入的内容**，而是「最后一个 skill chip + 其后
  * 无内容 + hint 未关闭」这一结构谓词成立时，由 Composer 在发送瞬间追加的模板
@@ -254,11 +267,15 @@ export interface ComposerHintSegment {
 export interface HintData {
     text: string;
 }
-export type ComposerSegment = ComposerTextSegment | ComposerInvocationSegment | ComposerMentionSegment | ComposerHintSegment;
+export type ComposerSegment = ComposerTextSegment | ComposerInvocationSegment | ComposerMentionSegment | ComposerSlotSegment | ComposerHintSegment;
 /** `onSend(segments, meta?)` 第二参数：非正文的附加数据。 */
 export interface SendMeta {
     attachments?: Attachment[];
-    webSearch?: boolean;
+    /**
+     * 推理模式。只有工具栏放了 `mode` 时才会带上。
+     * `fast` 是快速，`featured` 是精选。
+     */
+    mode?: 'fast' | 'featured';
 }
 export type AgentEvent = {
     kind: 'thinking';

package/dist/_genui-types.js

@@ -48,12 +48,16 @@ export var ComposerSegmentType = {
   Text: 'text',
   Invocation: 'invocation',
   Mention: 'mention',
+  /** 提示词模板槽位。空槽保留名称，填过的带 value */
+  Slot: 'slot',
   /** 派生的 skill 提示文本；发送时按结构谓词追加，见 `ComposerHintSegment` */
   Hint: 'hint'
 };
 // 同名 type 供 `seg.type === ComposerSegmentType.Invocation` 收窄，与 const 对象并存。
 // eslint-disable-next-line @typescript-eslint/no-redeclare -- 有意的 const + type 同名
 
+/** 提示词槽位。`name` 是空槽上的名称，`value` 是填入的字，空字符串表示还没填。 */
+
 /**
  * 派生的 skill 提示段：**不是用户输入的内容**，而是「最后一个 skill chip + 其后
  * 无内容 + hint 未关闭」这一结构谓词成立时，由 Composer 在发送瞬间追加的模板

package/dist/composer/editor.d.ts

@@ -18,6 +18,7 @@
  */
 import React from 'react';
 import type { ChipData } from '../_genui-types';
+import { type ComposerSkillHint } from './segments';
 /** Composer editor 触发态对外信号——告诉父组件该弹浮层选 skill 了。 */
 export interface ComposerEditorTriggerInfo {
     /** 触发字符（@ 或 /） */
@@ -72,6 +73,16 @@ export interface ComposerEditorProps {
     defaultValue?: string;
     /** 值变化回调；参数是 raw string，含 marker。 */
     onChange?: (value: string) => void;
+    /**
+     * 灰字（skill hint）命中状态变化回调：
+     *   - 灰字出现（最后一个 chip 命中结构谓词）→ 传入命中的 chip / 文案
+     *   - 灰字消失（后面有内容 / chip 被删 / hint 已关闭）→ 传入 null
+     *
+     * 只在状态**真的变化**时抛一次；与灰字渲染共用同一份判定（先落 DOM 再抛，
+     * 不会各自算一套）。判定成立但灰字被临时摘掉（IME 合成期）时不跟着抖。
+     * 挂载时会先同步一次当前状态（空内容即 null），业务侧不必自己猜初始值。
+     */
+    onSkillHintChange?: (hint: ComposerSkillHint | null) => void;
     /** 与 defaultValue / 首次受控 value 配套，把 marker 还原成 chip。 */
     defaultChips?: ChipData[];
     placeholder?: string;

package/dist/composer/editor.js

@@ -279,11 +279,13 @@ export var COMPOSER_EDITOR_HEIGHT_CAP_EXIT_PX = contentHeightForRows(9);
 var measureFitsInlineWidth = function measureFitsInlineWidth(el) {
   var computed = window.getComputedStyle(el);
   var inlineInset = Number.parseFloat(computed.getPropertyValue('--odn-composer-editor-inline-inset'));
+  var inlineInsetEnd = Number.parseFloat(computed.getPropertyValue('--odn-composer-editor-inline-inset-end'));
   // 非 lite 变体没有这个变量：这里不做中间区判定，一律视为放得下。
   if (!Number.isFinite(inlineInset) || inlineInset <= 0) return true;
+  var endInset = Number.isFinite(inlineInsetEnd) && inlineInsetEnd > 0 ? inlineInsetEnd : inlineInset;
   var viewport = el.closest('[data-odn-scroll-area-viewport]');
   var containerWidth = viewport instanceof HTMLElement ? viewport.clientWidth : el.clientWidth;
-  var inlineContentWidth = containerWidth - inlineInset * 2;
+  var inlineContentWidth = containerWidth - inlineInset - endInset;
   if (inlineContentWidth <= 0) return true;
 
   // 逐个文本节点取 rect：Range 覆盖整棵子树时拿到的是行容器（block）的宽度，
@@ -326,6 +328,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     defaultValue = _ref$defaultValue === void 0 ? '' : _ref$defaultValue,
     defaultChips = _ref.defaultChips,
     onChange = _ref.onChange,
+    onSkillHintChange = _ref.onSkillHintChange,
     placeholder = _ref.placeholder,
     autoSize = _ref.autoSize,
     onPressEnter = _ref.onPressEnter,
@@ -353,6 +356,9 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   var isComposingRef = useRef(false);
   var onTriggerChangeRef = useRef(onTriggerChange);
   onTriggerChangeRef.current = onTriggerChange;
+  /** 灰字状态回调走 ref：调用方常传内联函数，不能让 fireChange / 挂载同步因此反复重建 */
+  var onSkillHintChangeRef = useRef(onSkillHintChange);
+  onSkillHintChangeRef.current = onSkillHintChange;
   var isControlled = valueProp !== undefined;
   var minRows = (_autoSize$minRows = autoSize === null || autoSize === void 0 ? void 0 : autoSize.minRows) !== null && _autoSize$minRows !== void 0 ? _autoSize$minRows : 1;
   var maxRows = autoSize === null || autoSize === void 0 ? void 0 : autoSize.maxRows;
@@ -587,6 +593,33 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     }
   }, [removeHintNode]);
 
+  /* 灰字状态的**上一帧快照**：回调只在真的变化时抛一次。
+   * fireChange 每次输入都会跑，不去重的话业务侧会被同一条状态反复冲刷。
+   * `undefined` = 还没抛过（与「抛过 null」区分），保证挂载时一定会同步一次。 */
+  var lastSkillHintRef = useRef(undefined);
+
+  /**
+   * 把「灰字当前状态」通知给业务方（与 syncHintNode 同一份 target，保证同源）。
+   *
+   * 只在 chipId / refId / 文案任一变化时抛：同一条状态在连续输入里会算很多次。
+   */
+  var notifySkillHint = useCallback(function (target, chips) {
+    var _chips$find, _onSkillHintChangeRef;
+    var next = target ? {
+      chipId: target.chipId,
+      text: target.text,
+      refId: (_chips$find = chips.find(function (chip) {
+        return chip.id === target.chipId;
+      })) === null || _chips$find === void 0 ? void 0 : _chips$find.refId
+    } : null;
+    var prev = lastSkillHintRef.current;
+    if (prev !== undefined && (prev === null || prev === void 0 ? void 0 : prev.chipId) === (next === null || next === void 0 ? void 0 : next.chipId) && (prev === null || prev === void 0 ? void 0 : prev.text) === (next === null || next === void 0 ? void 0 : next.text) && (prev === null || prev === void 0 ? void 0 : prev.refId) === (next === null || next === void 0 ? void 0 : next.refId)) {
+      return;
+    }
+    lastSkillHintRef.current = next;
+    (_onSkillHintChangeRef = onSkillHintChangeRef.current) === null || _onSkillHintChangeRef === void 0 || _onSkillHintChangeRef.call(onSkillHintChangeRef, next);
+  }, []);
+
   /** 把 caret 直接落到 hint 之前（= chip 右侧）；没有 hint 时不动。 */
   var placeCaretBeforeHint = useCallback(function () {
     var el = editorRef.current;
@@ -606,6 +639,10 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   var pullCaretBeforeHint = useCallback(function () {
     var el = editorRef.current;
     var sel = window.getSelection();
+    var active = document.activeElement;
+    if (active instanceof HTMLElement && active.hasAttribute('data-odn-composer-slot-input')) {
+      return;
+    }
     if (!el || !sel || sel.rangeCount !== 1 || !sel.isCollapsed) return;
     if (!el.contains(sel.anchorNode)) return;
     if (!normalizeCollapsedCaretBeforeHint(sel.getRangeAt(0), el)) return;
@@ -627,7 +664,12 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
      * 否则「chip 被删」时残留的 hint 文本会让 placeholder 判定与 lite 升格
      * 判定晚一拍。 */
     closeChipHintsRef.current(resolveHintClosedChipIds(raw, chips));
-    syncHintNode(resolveHintTarget(raw, getChipsRef.current()));
+    /* 关闭会改写 chips 快照，谓词必须用关闭后的快照重新取；
+     * 渲染（syncHintNode）与对外回调（notifySkillHint）共用这一份 target，
+     * 业务拿到的是「这一刻灰字该不该在」的同一份判定，不会各算一套。 */
+    var hintChips = getChipsRef.current();
+    var hintTarget = resolveHintTarget(raw, hintChips);
+    syncHintNode(hintTarget);
     var showPlaceholder = shouldShowPlaceholder(el);
     if (forceNonEmptyOnceRef.current && showPlaceholder) {
       setEmpty(false);
@@ -640,7 +682,23 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     scheduleControlledSync();
     // editor.height 锁定时 RO 不触发，主动同步一次，确保升格判定能拿到 scrollHeight
     syncHeight();
-  }, [onChange, pullCaretBeforeHint, scheduleControlledSync, shouldShowPlaceholder, syncHeight, syncHintNode]);
+    /* 对外回调放在所有内部状态更新之后：业务在里面同步 setState 甚至
+     * updateChipData 都不会插进「DOM 已落、caret / 高度还没收尾」的中间态。 */
+    notifySkillHint(hintTarget, hintChips);
+  }, [notifySkillHint, onChange, pullCaretBeforeHint, scheduleControlledSync, shouldShowPlaceholder, syncHeight, syncHintNode]);
+
+  /* 挂载时同步一次灰字状态。
+   *
+   * 带 chips 的草稿恢复已经在挂载的 layout effect 里走 fireChange 抛过一次，
+   * 这里兜的是「空内容 / 只有纯文本挂载」——否则业务侧上一轮留下的状态没人复位。
+   * 放在 passive effect：晚于 chips 还原，且 notifySkillHint 自带去重，
+   * 与 fireChange 那一次重复时不会再抛。 */
+  useEffect(function () {
+    var el = editorRef.current;
+    if (!el) return;
+    var hintChips = getChipsRef.current();
+    notifySkillHint(resolveHintTarget(getPlainText(el), hintChips), hintChips);
+  }, [notifySkillHint]);
 
   /* ─────────────────────────────────────
    * chip 管理
@@ -785,6 +843,10 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
           onTriggerChange === null || onTriggerChange === void 0 || onTriggerChange(null);
         }
         onChange === null || onChange === void 0 || onChange('');
+        /* 这条路不走 fireChange（清空不是「内容变化」链路的一环），
+         * 灰字状态要在这里手动同步，否则业务侧会一直以为灰字还显示着。
+         * 位置放在 onChange 之后，与 fireChange 的「先 onChange 再灰字」一致。 */
+        notifySkillHint(null, []);
       },
       insertChip: function insertChip(data) {
         var el = editorRef.current;
@@ -881,7 +943,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
         return editorRef.current;
       }
     };
-  }, [onChange, _insertChip, insertSerializedAtRange, requestScrollCaretIntoView, removeChip, resetChips, onTriggerChange, getChips, updateChipData, getChipHost]);
+  }, [onChange, _insertChip, insertSerializedAtRange, notifySkillHint, requestScrollCaretIntoView, removeChip, resetChips, onTriggerChange, getChips, updateChipData, getChipHost]);
 
   /* ─────────────────────────────────────
    * 监听 selection 变化：方向键 / 鼠标点击移位都要重算 trigger
@@ -1037,6 +1099,8 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
       }
       removeHintNode();
       resetChips();
+      /* 同 clear()：外部改写 value 不走 fireChange，灰字状态在这里手动同步 */
+      notifySkillHint(null, []);
       setEmpty(shouldShowPlaceholder(el));
       if (triggerRef.current) {
         var _onTriggerChangeRef$c;
@@ -1045,7 +1109,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
       }
       syncHeight();
     }
-  }, [controlledSyncTick, valueProp, isControlled, resetChips, shouldShowPlaceholder, syncHeight]);
+  }, [controlledSyncTick, valueProp, isControlled, notifySkillHint, resetChips, shouldShowPlaceholder, syncHeight]);
 
   /* ─────────────────────────────────────
    * 输入事件
@@ -1434,6 +1498,14 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     return /*#__PURE__*/createPortal( /*#__PURE__*/React.createElement(ComposerInlineRef, {
       data: chip.data,
       active: paramEditChipId === chip.data.id,
+      disabled: disabled,
+      onSlotChange: chip.data.kind === 'slot' ? function (value) {
+        return updateChipData(chip.data.id, {
+          payload: _objectSpread(_objectSpread({}, chip.data.payload), {}, {
+            value: value
+          })
+        });
+      } : undefined,
       onClick: onInlineRefClick && chipHasEditableParams(chip.data) ? function (anchor) {
         return onInlineRefClick(chip.data.id, anchor);
       } : undefined

package/dist/composer/hooks/useChipManager.js

@@ -25,6 +25,7 @@ function createChipHost(data) {
   host.dataset.mentionId = data.id;
   host.contentEditable = 'false';
   host.setAttribute('data-odn-composer-chip-host', '');
+  if (data.kind) host.dataset.chipKind = data.kind;
   return host;
 }
 function createCaretAnchorAtBoundary(parent, offset) {

package/dist/composer/index.d.ts

@@ -3,11 +3,17 @@ import type { Attachment, ChipData, ComposerSegment, SendMeta, SkillItem } from
 import type { IconName } from '../icon';
 import { type SkillSlotProps } from '../skill-slot';
 import { type ComposerInsertOptions, type ComposerInsertPart, type ComposerInsertResult } from './insert';
+import { type ComposerMentionItem } from './mention';
 import type { ComposerParamPanelContext } from './param-panel';
+import { type ComposerSkillHint } from './segments';
 import './style';
 export type { ComposerInsertOptions, ComposerInsertPart, ComposerInsertResult, } from './insert';
+export type { ComposerMentionItem } from './mention';
 export type { ComposerParamPanelContext } from './param-panel';
-export type ComposerTool = 'attachment' | 'webSearch' | 'skill';
+export type { ComposerHintTarget, ComposerSkillHint } from './segments';
+export type ComposerTool = 'attachment' | 'skill';
+/** 快速 / 精选。不是工具按钮，`showMode` 为 true 才出现在发送键左侧。 */
+export type ComposerMode = 'fast' | 'featured';
 export type ComposerVariant = 'full' | 'lite';
 export type SubmitType = 'enter' | 'shiftEnter';
 /**
@@ -18,7 +24,7 @@ export type SubmitType = 'enter' | 'shiftEnter';
  * - 整个配置对象不传（key 不存在于 `toolConfigs`）时使用内置默认值。
  * - 仅传 `tooltip`（不传 icon / label）时：保留默认图标与文案，只覆盖说明。
  * - 传了配置对象且 icon / label 均未设置、也未传 tooltip 时（`{}`），兜底显示工具英文名
- *   （如 "attachment" / "webSearch" / "skill"）作为 label，无图标，
+ *   （如 "attachment" / "skill"）作为 label，无图标，
  *   方便开发者一眼看出配置遗漏。
  */
 export interface ComposerToolConfig {
@@ -65,6 +71,7 @@ export interface ComposerRef {
      * - `skill` 走与菜单插入相同的 chip 结构（含 `hint` / `initialState`）；
      *   `initialState: 'pending'` 且提供 `renderParamPanel` 时自动打开参数面板
      *   （`focus: false` 的后台预填不打开）。
+     * - `slot` 是提示词槽位：`name` 显示在空槽上，`value` 是已填的字。
      * - `chip` 是逃生舱：mention / 自定义 kind / 已存草稿都可以直接传。
      * - chip id 与编辑器已有 chip 冲突时自动换新 id，以返回的 `chipIds` 为准。
      * - 受控 `value` 场景请在 onChange 内回写，与手动输入一致（否则一帧后会被
@@ -105,11 +112,27 @@ export interface ComposerProps {
     defaultChips?: ChipData[];
     /** 输入框值变化回调。第二参是当前 chip 快照，旧调用方忽略即可。 */
     onChange?: (value: string, chips?: ChipData[]) => void;
+    /**
+     * 技能灰字（`SkillItem.hint`）的出现 / 消失回调。
+     *
+     * 入参与输入框里那行灰字共用**同一份判定**（`resolveHintTarget`）：命中时给
+     * `{ chipId, text, refId }`，消失时给 `null`。因此业务不需要自己解析
+     * value / chips，也不会出现「库里觉得有、业务觉得没有」的分歧。
+     *
+     * 语义要点：
+     * - 只在状态真的变化时抛一次，同一条状态不会因为连续输入重复抛；
+     * - 判定成立但灰字被临时摘掉（IME 合成期避开候选串）时不跟着抖；
+     * - 挂载时先同步一次当前状态（首屏没有灰字即 `null`），便于业务复位上一轮状态；
+     * - 灰字一次性：收起后即使把内容删回空串也不会再抛命中；
+     * - 卸载不会再补一次 `null`：需要清理时由业务在自己的卸载路径处理；
+     * - 与 `hint`（底部快捷键提示开关）无关。
+     */
+    onSkillHintChange?: (hint: ComposerSkillHint | null) => void;
     /**
      * 发送回调。
      *
      * `segments`：有序内容 IR，业务按数组顺序自定义拼后端。
-     * `meta`：附件 / 联网搜索等非正文数据；为空时不传。
+     * `meta`：附件等非正文数据；为空时不传。
      *
      * **派生 `hint` 段**：当最后一个 chip 是带 `SkillItem.hint` 的 skill、其后
      * 一个字符都没有（空格 / 换行都算内容）、且这颗 chip 的 hint 还没关闭时，
@@ -159,7 +182,7 @@ export interface ComposerProps {
     variant?: ComposerVariant;
     /**
      * 左下工具按钮集合（按数组顺序展示）。传入空数组即不渲染任何左下按钮。
-     * @default ['attachment', 'webSearch', 'skill']
+     * @default ['attachment', 'skill']
      */
     tools?: ComposerTool[];
     /**
@@ -173,7 +196,6 @@ export interface ComposerProps {
     /**
      * 各工具按钮的自定义配置（icon / label / tooltip）。按 `ComposerTool` 类型做 key：
      * - `attachment`：附件按钮
-     * - `webSearch`：联网按钮
      * - `skill`：技能按钮
      *
      * **语义约定**：
@@ -188,7 +210,6 @@ export interface ComposerProps {
      * ```tsx
      * toolConfigs={{
      *   attachment: { tooltip: '上传材料，补充上下文' }, // 只改说明
-     *   webSearch: { label: '搜索' },                   // 仅文字
      *   skill: { icon: 'command' },                      // 仅图标
      * }}
      * ```
@@ -200,6 +221,38 @@ export interface ComposerProps {
      * 菜单宽高由 Composer 按输入框与视口计算，不经本袋覆盖。
      */
     skillSlotProps?: ComposerSkillSlotProps;
+    /**
+     * 为 false 时正文里的 `/` 不打开技能菜单。技能按钮不受影响。
+     * @default true
+     */
+    slash?: boolean;
+    /**
+     * `@` 引用名单。不传则不响应 `@`。
+     * 选中时 `onSelect` 返回 `false` 不插入。块被删掉时调用 `onRemove`。
+     */
+    mentionProps?: {
+        items: ComposerMentionItem[];
+        onSelect?: (item: ComposerMentionItem) => boolean | void;
+        onRemove?: (mention: {
+            id: string;
+            refId?: string;
+            label: string;
+        }) => void;
+    };
+    /**
+     * 是否显示快速 / 精选。它贴在发送键左侧，不属于 `tools`。
+     * @default false
+     */
+    showMode?: boolean;
+    /**
+     * 当前推理模式。只在 `showMode` 时显示，并随发送放进 `SendMeta.mode`。
+     * 不传时组件自己记，默认精选。
+     */
+    mode?: ComposerMode;
+    /** 非受控时的初始模式。@default 'featured' */
+    defaultMode?: ComposerMode;
+    /** 用户改选快速 / 精选时调用 */
+    onModeChange?: (mode: ComposerMode) => void;
     /**
      * 提交模式：
      * - `'enter'`（默认）：Enter 发送，Shift+Enter 换行
@@ -289,7 +342,7 @@ export interface ComposerProps {
     /**
      * 工具栏按钮被点击时触发。
      *
-     * - `tool`：被点击的工具类型（`'attachment'` / `'webSearch'` / `'skill'`）。
+     * - `tool`：被点击的工具类型（`'attachment'` / `'skill'`）。
      * - 对于 `'skill'`：在 skill 弹窗打开时触发（而非选中某个 skill 时）。
      * - 此回调为纯通知性质，不影响组件内部行为（若需阻止，请使用 `disabled` 等控制）。
      */