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

package/README.md

@@ -49,9 +49,9 @@ yarn add @blueking/chat-x
     <ChatContainer
       :messages="messages"
       :on-agent-action="handleAgentAction"
+      :menu-sources="menuSources"
       :on-send-message="handleSendMessage"
       :on-stop-sending="handleStopSending"
-      :prompts="prompts"
       :shortcuts="shortcuts"
       @update:model-value="val => (userInput = val)"
     />
@@ -64,6 +64,7 @@ yarn add @blueking/chat-x
     ChatContainer,
     MessageRole,
     MessageStatus,
+    type IInputMenuItem,
     type IToolBtn,
     type Message,
     type Shortcut,
@@ -73,7 +74,11 @@ yarn add @blueking/chat-x
 
   const messages = deepRef<Message[]>([]);
   const userInput = shallowRef<string | TagSchema>('');
-  const prompts = shallowRef(['帮我写一段代码', '解释这段报错', '总结这篇文档']);
+  // 输入框菜单统一数据源：按 type 分发到 "/"、"@"、"\" 与左下角 + 号
+  const menuSources = shallowRef<IInputMenuItem[]>([
+    { id: 'prompt-code', name: '写代码', type: 'prompt', content: '帮我写一段代码' },
+    { id: 'kb-ops', name: '运维知识库', type: 'knowledgebase' },
+  ]);
   const shortcuts = shallowRef<Shortcut[]>([
     { id: 'ask', name: '问问小鲸', description: '向 AI 助手提问' },
     { id: 'code-review', name: '代码审查', description: '让 AI 审查你的代码' },
@@ -366,8 +371,9 @@ import type {
   InputContent,
   UploadFile,
   ImageItem,
-  IAiSlashMenuItem,
-  IAiSlashGroupItem,
+  IInputMenuItem,
+  MenuItemType,
+  MenuTrigger,
 } from '@blueking/chat-x';
 ```
 
@@ -378,8 +384,8 @@ import {
   MessageRole,
   MessageStatus,
   MessageContentType,
-  CONST_MESSAGE_TOOLS, // AI 消息默认工具：复制、引用、重新生成、分享
-  CONST_USER_MESSAGE_TOOLS, // 用户消息默认工具：复制、引用、编辑、删除
+  CONST_MESSAGE_TOOLS, // AI 消息默认工具：复制、重新生成、分享
+  CONST_USER_MESSAGE_TOOLS, // 用户消息默认工具：复制、编辑、删除
   CONST_UPDATE_TOOLS, // 更新工具：点赞、不满意、删除
 } from '@blueking/chat-x';
 ```
@@ -406,8 +412,9 @@ ChatContainer                          ← 一站式对话布局
 ├── ShortcutBtns                       ← 快捷指令引导
 ├── ShortcutRender                     ← 快捷指令表单
 ├── ChatInput                          ← 输入区
-│   ├── AiSlashEditor                  ← 富文本编辑器（/ @ 触发）
-│   └── InputAttachment                ← 文件附件
+│   ├── InputMenuPanel                 ← 统一菜单（/ @ \ 与 + 号共用）
+│   ├── AiSlashInput                   ← 富文本编辑区（触发符识别 + 资源标签）
+│   └── InputAttachment                ← 底部工具栏（+ 号 / 快捷指令 / 模型 / 发送）
 └── SelectionFooter                    ← 多选操作栏
 ```
 

package/dist/ag-ui/types/contents.d.ts

@@ -4,6 +4,8 @@ export interface BinaryInputContent {
     filename?: string;
     id?: string;
     mimeType: string;
+    /** 上传接口返回的 path，用于文件引用、下载与预览 */
+    outputId?: string;
     /** 文件字节数；发送时由原始 File 写入，用于消息态附件卡片展示大小 */
     size?: number;
     type: MessageContentType.Binary;

package/dist/ag-ui/types/messages.d.ts

@@ -1,4 +1,4 @@
-import type { OldShortcut, Shortcut } from '../../types';
+import type { OldShortcut, Shortcut, TagSchema } from '../../types';
 import type { MessageContentType, MessageRole, MessageStatus } from './constants';
 import type { ContentMap, InputContent } from './contents';
 import type { AIFileInfo } from './file';
@@ -25,6 +25,11 @@ export interface BaseMessage<T extends MessageType, C = string> {
     uid?: string;
     property?: {
         artifacts?: AIFileInfo[];
+        /**
+         * 发送时输入框的富文本文档。content 仍是纯文本（不改后端契约），
+         * 有这份文档时用户消息会把 @ 选中的资源原样还原成标签，编辑回填也不会丢标签。
+         */
+        docSchema?: TagSchema;
         extra?: {
             cite: {
                 data: {

package/dist/common/constants.d.ts

@@ -23,6 +23,8 @@ export declare const SELECTION_Z_INDEX: number;
  * 消息工具
  */
 export declare const CONST_MESSAGE_TOOLS: IToolBtn[];
+/** 设计稿标注：用户消息正文最高显示 200px，超出后折叠并展示「显示更多」 */
+export declare const CONST_USER_MESSAGE_MAX_HEIGHT = 200;
 export declare const CONST_USER_MESSAGE_TOOLS: IToolBtn[];
 /**
  * 更新工具

package/dist/components/ai-buttons/add-menu-btn/add-menu-btn.vue.d.ts

@@ -0,0 +1,24 @@
+import type { AITippyProps } from '../../../types';
+import 'tippy.js/dist/tippy.css';
+export type AddMenuBtnProps = {
+    /** 聚合菜单是否处于展开态 */
+    active?: boolean;
+    tippyOptions?: AITippyProps;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<AddMenuBtnProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    toggle: () => any;
+}, string, import("vue").PublicProps, Readonly<AddMenuBtnProps> & Readonly<{
+    onToggle?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/chat-content/collapsible-content/collapsible-content.vue.d.ts

@@ -0,0 +1,28 @@
+type __VLS_Props = {
+    /** 折叠态下内容区的最大高度，超出才出现展开按钮 */
+    maxHeight?: number;
+};
+type __VLS_ModelProps = {
+    /** 展开态可由外部控制，便于「全部展开」这类批量操作 */
+    'expanded'?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:expanded": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:expanded"?: ((value: boolean) => any) | undefined;
+}>, {
+    maxHeight: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/chat-content/file-content/upload-file-item.vue.d.ts

@@ -2,11 +2,14 @@ import type { UploadFile } from '../../../types';
 type __VLS_Props = {
     file: Partial<UploadFile>;
     readonly?: boolean;
+    previewable?: boolean;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    delete: () => any;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    delete: () => void;
+    preview: () => void;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onDelete?: (() => any) | undefined;
+    onPreview?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/chat-content/file-content/upload-image-item.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_Props = {
     hasError?: boolean;
     name?: string;
     readonly?: boolean;
+    previewable?: boolean;
     src?: string;
     status?: UploadStatus;
     variant?: UploadFileVariant;

package/dist/components/chat-content/flow-agent-content/use-flow-node-actions.d.ts

@@ -30,7 +30,7 @@ export interface FlowNodeActionVM {
  * 操作列表，组件层只需遍历渲染，显隐与点击行为均收敛于此，便于复用、单测与扩展。
  */
 export declare const useFlowNodeActions: (options: {
-    /** 隐藏重试 / 跳过等交互式 resume 操作（分享态、侧栏执行情况面板等只读场景，仅保留「详情」查看入口） */
+    /** 隐藏重试 / 跳过等交互式 resume 操作（分享态只读，仅保留「详情」查看入口） */
     hideResumeActions?: Ref<boolean>;
     /** resume 回调（与第三方审批取消同一回调，按 payload.operation 分流） */
     onInterruptResume: Ref<OnInterruptResume | undefined>;

package/dist/components/chat-input/ai-slash-input/ai-slash-input.vue.d.ts

@@ -1,17 +1,19 @@
 import { type KeyboardPayload } from '../../../edix';
-import type { IAiSlashMenuItem, ISkillListItem } from '../../../types/editor';
 import type { TagSchema } from '../../../types/input';
-import 'tippy.js/dist/tippy.css';
+import type { IInputMenuItem, MenuTrigger } from '../../../types/input-menu';
 type __VLS_Props = {
     modelValue: string | TagSchema;
     placeholder?: string;
-    prompts?: string[];
-    resources?: IAiSlashMenuItem[];
-    skills?: ISkillListItem[];
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    appendMention: (item: IInputMenuItem) => void;
     cleanup: () => void;
+    closeMenu: () => void;
+    consumeTriggerText: () => [number, number];
     focus: () => void;
+    insertMenuItem: (item: IInputMenuItem) => void;
+    openPlusMenu: () => void;
+    replaceAll: (value: string) => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     keydown: (event: KeyboardEvent & KeyboardPayload) => any;
     "update:modelValue": (value: ({
@@ -22,10 +24,16 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
             readonly label: string;
             readonly value: string;
             readonly type: string;
+            readonly icon: string;
+            readonly description: string;
         };
         type: "tag";
-    })[][], selectedResourceList: IAiSlashMenuItem[]) => any;
+    })[][]) => any;
     upload: (files: File[]) => any;
+    menuChange: (payload: {
+        keyword: string;
+        trigger: MenuTrigger | null;
+    }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onKeydown?: ((event: KeyboardEvent & KeyboardPayload) => any) | undefined;
     "onUpdate:modelValue"?: ((value: ({
@@ -36,15 +44,18 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
             readonly label: string;
             readonly value: string;
             readonly type: string;
+            readonly icon: string;
+            readonly description: string;
         };
         type: "tag";
-    })[][], selectedResourceList: IAiSlashMenuItem[]) => any) | undefined;
+    })[][]) => any) | undefined;
     onUpload?: ((files: File[]) => any) | undefined;
+    onMenuChange?: ((payload: {
+        keyword: string;
+        trigger: MenuTrigger | null;
+    }) => any) | undefined;
 }>, {
     placeholder: string;
-    prompts: string[];
-    skills: ISkillListItem[];
-    resources: IAiSlashMenuItem[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/chat-input/ai-slash-input/command.d.ts

@@ -1,7 +1,10 @@
 import type { EditorCommand } from '../../../edix';
 import type { Position } from '../../../edix/doc/types';
-import type { IAiSlashMenuItem, ISkillListItem } from '../../../types/editor';
+import type { IInputMenuItem } from '../../../types/input-menu';
 export declare const DeleteTag: EditorCommand<[Position, Position]>;
-export declare const InsertTag: EditorCommand<[Position, IAiSlashMenuItem]>;
+/**
+ * 插入菜单选项对应的 void 标签节点。
+ * value 取 item.id：序列化给后端时 skill 走 `/${value}`，因此业务方需保证 skill 的 id 为后端可识别的编码。
+ */
+export declare const InsertMenuTag: EditorCommand<[Position, IInputMenuItem]>;
 export declare const InsertText: EditorCommand<[Position, string]>;
-export declare const InsertSkillTag: EditorCommand<[Position, ISkillListItem]>;

package/dist/components/chat-input/ai-slash-input/constants.d.ts

@@ -10,6 +10,8 @@ export declare const tagSchema: import("../../..").DocSchema<({
         readonly label: string;
         readonly value: string;
         readonly type: string;
+        readonly icon: string;
+        readonly description: string;
     };
     type: "tag";
 })[][]>;

package/dist/components/chat-input/ai-slash-input/use-menu-trigger.d.ts

@@ -0,0 +1,17 @@
+import type { MenuTrigger } from '../../../types/input-menu';
+/**
+ * 输入框菜单的触发状态机。
+ *
+ * 字符触发（`@` `/` `\`）的过滤词是「触发符到光标」之间的文本，选中后连触发符一起被替换；
+ * `plus` 触发没有触发符，过滤词是「唤起时的光标位置到当前光标」之间的文本，选中后只替换这段文本。
+ * 两者统一暴露为 `keyword` + `consumeLength`，上层插入逻辑只有一条代码路径。
+ */
+export declare const useMenuTrigger: () => {
+    trigger: import("vue").ShallowRef<MenuTrigger | null, MenuTrigger | null>;
+    keyword: import("vue").ShallowRef<string, string>;
+    activateChar: (char: Exclude<MenuTrigger, "plus">) => void;
+    activatePlus: () => void;
+    close: () => void;
+    sync: () => void;
+    getConsumeLength: () => number;
+};

package/dist/components/chat-input/build-default-placeholder.d.ts

@@ -1,7 +1,13 @@
 export interface BuildDefaultPlaceholderOptions {
-    hasPrompts: boolean;
-    hasResources: boolean;
-    hasSkills: boolean;
+    /** 是否有 `@` 可唤出的资源（知识库、会话产物） */
+    hasAtMenu: boolean;
+    /** 是否有 `\` 可唤出的 Prompt */
+    hasPromptMenu: boolean;
+    /** 是否有 `/` 可唤出的能力（Skill、工具、MCP） */
+    hasSlashMenu: boolean;
     isEn: boolean;
 }
+/**
+ * 设计稿标注：智能体没有对应的资源或配置时，不显示对应的提示文案。
+ */
 export declare function buildDefaultPlaceholder(options: BuildDefaultPlaceholderOptions): string;

package/dist/components/chat-input/chat-input.vue.d.ts

@@ -1,16 +1,22 @@
 import { type Interrupt, type InterruptResume, type UserMessage, MessageContentType, MessageStatus } from '../../ag-ui/types';
-import { type AITippyProps, type IAiSlashMenuItem, type ISkillListItem, type Shortcut, type TagSchema, type UploadFile, UploadStatus } from '../../types';
+import { type AITippyProps, type IInputMenuItem, type Shortcut, type TagSchema, type UploadFile, UploadStatus } from '../../types';
+import type { AIFileInfo } from '../../ag-ui/types/file';
 import type { IModelOption } from './model-selector';
 export type ChatInputEmits = {
     (e: 'selectShortcut', shortcut: Shortcut): void;
     (e: 'deleteShortcut'): void;
-    (e: 'update:modelValue', value: string | TagSchema, selectedResourceList: IAiSlashMenuItem[]): void;
+    (e: 'deleteFile', file: Partial<UploadFile>): void;
+    (e: 'update:modelValue', value: string | TagSchema, selectedResourceList: IInputMenuItem[]): void;
     (e: 'modelChange', model: IModelOption): void;
 };
 export type ChatInputProps = {
     accept?: string;
     defaultUploadFiles?: UploadFile[];
     inputMaxHeight?: number;
+    /** 菜单每个分组默认展示的条数，超出折叠为「更多 +N」 */
+    menuGroupItemLimit?: number;
+    /** 统一的菜单数据源：`@` `/` `\` 与左下角 + 号共用，按 type 分发到不同触发方式 */
+    menuSources?: IInputMenuItem[];
     messageStatus?: MessageStatus;
     models?: IModelOption[];
     modelValue: string | TagSchema;
@@ -21,12 +27,9 @@ export type ChatInputProps = {
     onStopSending?: () => Promise<void>;
     onUpload?: (files: File[]) => Promise<ChatInputUploadResult | ChatInputUploadResult[]>;
     placeholder?: string;
-    prompts?: string[];
-    resources?: IAiSlashMenuItem[];
     sendDisabledTip?: string;
     shortcutId?: string;
     shortcuts?: Shortcut[];
-    skills?: ISkillListItem[];
     supportUpload?: boolean;
     tippyOptions?: AITippyProps;
 };
@@ -34,6 +37,7 @@ export type ChatInputUploadResult = {
     download_url?: string;
     error?: string;
     id?: string;
+    path?: string;
     status?: 'failed' | 'success';
 };
 type __VLS_Props = ChatInputProps;
@@ -42,12 +46,13 @@ type __VLS_ModelProps = {
     'selectedModel'?: string;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_14: {
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_14: {}, __VLS_23: {
     files: {
         data?: string | undefined;
         filename?: string | undefined;
         id?: string | undefined;
         mimeType?: string | undefined;
+        outputId?: string | undefined;
         size?: number | undefined;
         type?: MessageContentType.Binary | undefined;
         url?: string | undefined;
@@ -65,28 +70,30 @@ declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_14: {
         } | undefined;
         status?: UploadStatus | undefined;
     }[];
-}, __VLS_51: {}, __VLS_75: {
+}, __VLS_61: {}, __VLS_85: {
     models: IModelOption[] | undefined;
     selectedModel: string | undefined;
-}, __VLS_85: {};
+}, __VLS_95: {};
 type __VLS_Slots = {} & {
     top?: (props: typeof __VLS_1) => any;
 } & {
     interrupt?: (props: typeof __VLS_3) => any;
 } & {
-    'input-header'?: (props: typeof __VLS_5) => any;
+    'input-header'?: (props: typeof __VLS_14) => any;
 } & {
-    files?: (props: typeof __VLS_14) => any;
+    files?: (props: typeof __VLS_23) => any;
 } & {
-    attachment?: (props: typeof __VLS_51) => any;
+    attachment?: (props: typeof __VLS_61) => any;
 } & {
-    'model-selector'?: (props: typeof __VLS_75) => any;
+    'model-selector'?: (props: typeof __VLS_85) => any;
 } & {
-    'send-icon'?: (props: typeof __VLS_85) => any;
+    'send-icon'?: (props: typeof __VLS_95) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void;
+    insertMention: (item: IInputMenuItem) => void;
     triggerSendMessage: () => Promise<void>;
+    uploadedArtifacts: import("vue").ComputedRef<AIFileInfo[]>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:cite": (value: string) => any;
     "update:selectedModel": (value: string | undefined) => any;
@@ -99,10 +106,13 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
             readonly label: string;
             readonly value: string;
             readonly type: string;
+            readonly icon: string;
+            readonly description: string;
         };
         type: "tag";
-    })[][], selectedResourceList: IAiSlashMenuItem[]) => any;
+    })[][], selectedResourceList: IInputMenuItem[]) => any;
     selectShortcut: (shortcut: Shortcut) => any;
+    deleteFile: (file: Partial<UploadFile>) => any;
     deleteShortcut: () => any;
     modelChange: (model: IModelOption) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
@@ -114,20 +124,22 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
             readonly label: string;
             readonly value: string;
             readonly type: string;
+            readonly icon: string;
+            readonly description: string;
         };
         type: "tag";
-    })[][], selectedResourceList: IAiSlashMenuItem[]) => any) | undefined;
+    })[][], selectedResourceList: IInputMenuItem[]) => any) | undefined;
     onSelectShortcut?: ((shortcut: Shortcut) => any) | undefined;
+    onDeleteFile?: ((file: Partial<UploadFile>) => any) | undefined;
     onDeleteShortcut?: (() => any) | undefined;
     onModelChange?: ((model: IModelOption) => any) | undefined;
     "onUpdate:cite"?: ((value: string) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | undefined) => any) | undefined;
 }>, {
     accept: string;
-    prompts: string[];
-    skills: ISkillListItem[];
-    resources: IAiSlashMenuItem[];
     inputMaxHeight: number;
+    menuGroupItemLimit: number;
+    menuSources: IInputMenuItem[];
     supportUpload: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/chat-input/input-menu/constants.d.ts

@@ -0,0 +1,60 @@
+import type { lang } from '../../../lang/lang';
+import type { MenuItemType, MenuTrigger } from '../../../types/input-menu';
+/** 分组的静态定义：一个分组可聚合多个语义相近的 type */
+export interface IMenuGroupDef {
+    key: string;
+    /** 文案 key，渲染时经 t() 转换 */
+    name: keyof typeof lang;
+    types: MenuItemType[];
+}
+export declare const MENU_GROUP_DEFS: {
+    add: {
+        key: string;
+        name: "添加";
+        types: "file"[];
+    };
+    skill: {
+        key: string;
+        name: "Skill";
+        types: "skill"[];
+    };
+    mcp: {
+        key: string;
+        name: "MCP";
+        types: "mcp"[];
+    };
+    tool: {
+        key: string;
+        name: "工具";
+        types: "tool"[];
+    };
+    knowledgebase: {
+        key: string;
+        name: "知识库";
+        types: ("doc" | "knowledgebase")[];
+    };
+    artifact: {
+        key: string;
+        name: "会话产物";
+        types: "artifact"[];
+    };
+    prompt: {
+        key: string;
+        name: "Prompt";
+        types: "prompt"[];
+    };
+};
+export type MenuGroupKey = keyof typeof MENU_GROUP_DEFS;
+/** 触发方式 → 分组渲染顺序 */
+export declare const TRIGGER_GROUP_KEYS: Record<MenuTrigger, MenuGroupKey[]>;
+/** 需要在下方画分隔线的分组（设计稿：+ 菜单「添加」组与其余资源之间有分隔线） */
+export declare const DIVIDED_GROUP_KEYS: MenuGroupKey[];
+/** 分组默认最多展示的条数，超出折叠为「更多 +N」 */
+export declare const DEFAULT_GROUP_ITEM_LIMIT = 4;
+/** 字符触发符与菜单的对应关系 */
+export declare const CHAR_TRIGGERS: readonly ["@", "/", "\\"];
+/**
+ * 取类型的展示名（文案 key，渲染时经 t() 转换）。
+ * 菜单分组标题与标签气泡标题共用，保证两处文案永远一致。
+ */
+export declare const getMenuTypeLabel: (type: string) => "" | keyof typeof lang;

package/dist/components/chat-input/input-menu/index.d.ts

@@ -0,0 +1,4 @@
+export { CHAR_TRIGGERS, DEFAULT_GROUP_ITEM_LIMIT, MENU_GROUP_DEFS, TRIGGER_GROUP_KEYS } from './constants';
+export type { MenuGroupKey } from './constants';
+export { default as InputMenuPanel } from './input-menu-panel.vue';
+export { useInputMenu } from './use-input-menu';

package/dist/components/chat-input/input-menu/input-menu-option.vue.d.ts

@@ -0,0 +1,14 @@
+import type { IInputMenuItem } from '../../../types/input-menu';
+import 'tippy.js/dist/tippy.css';
+type __VLS_Props = {
+    /** 键盘导航选中态 */
+    active?: boolean;
+    item: IInputMenuItem;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: (item: IInputMenuItem) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: IInputMenuItem) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-input/input-menu/input-menu-panel.vue.d.ts

@@ -0,0 +1,17 @@
+import type { IInputMenuGroup, IInputMenuItem } from '../../../types/input-menu';
+type __VLS_Props = {
+    /** 当前可见且可选中的条目，顺序与面板一致 */
+    flatItems: IInputMenuItem[];
+    groups: IInputMenuGroup[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: (item: IInputMenuItem) => any;
+    close: () => any;
+    toggleGroup: (key: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: IInputMenuItem) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onToggleGroup?: ((key: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-input/input-menu/use-input-menu.d.ts

@@ -0,0 +1,22 @@
+import { type ComputedRef, type Ref } from 'vue';
+import type { IInputMenuGroup, IInputMenuItem, MenuTrigger } from '../../../types/input-menu';
+import type { MenuGroupKey } from './constants';
+/**
+ * 输入框菜单的纯数据逻辑（与 UI 解耦，可独立单测）：
+ * 按触发方式筛选类型 → 按关键字过滤 → 分组 → 应用折叠阈值 → 扁平化供键盘导航。
+ */
+export declare const useInputMenu: (params: {
+    /** 每个分组默认展示的条数上限 */
+    groupItemLimit: ComputedRef<number> | Ref<number>;
+    /** 过滤关键字（触发符之后用户输入的文本） */
+    keyword: ComputedRef<string> | Ref<string>;
+    /** 全部可选项 */
+    sources: ComputedRef<IInputMenuItem[]> | Ref<IInputMenuItem[]>;
+    /** 当前触发方式，为 null 表示菜单未激活 */
+    trigger: ComputedRef<MenuTrigger | null> | Ref<MenuTrigger | null>;
+}) => {
+    groups: ComputedRef<IInputMenuGroup[]>;
+    flatItems: ComputedRef<IInputMenuItem[]>;
+    hasContent: ComputedRef<boolean>;
+    toggleGroup: (key: MenuGroupKey) => void;
+};

package/dist/components/chat-input/model-selector/types.d.ts

@@ -6,6 +6,7 @@ export interface IModelCapability {
     theme?: ModelCapabilityTheme;
 }
 /** 模型选项（贴合后端模型接口结构） */
+import type { Component } from 'vue';
 export interface IModelOption {
     /** 基础模型标识，如 deepseek */
     base_model?: string;
@@ -13,8 +14,8 @@ export interface IModelOption {
     description?: string;
     /** 是否禁用（前端扩展字段，后端无此字段时默认不禁用） */
     disabled?: boolean;
-    /** 模型图标地址 */
-    icon?: string;
+    /** 模型图标：URL 字符串或 Vue 组件 */
+    icon?: Component | string;
     /** 模型主键 id */
     id: number;
     /** 模型编码 */

package/dist/components/chat-message/message-container/message-container.vue.d.ts

@@ -22,8 +22,8 @@ export type MessageContainerProps = {
     onInterruptResume?: OnInterruptResume;
     onUserAction?: UserActionCallback;
     renderMode?: RenderMode;
-    userMessageTools?: IToolBtn[];
     updateTools?: IToolBtn[];
+    userMessageTools?: IToolBtn[];
 } & {
     onUserInputConfirm?: (message: Message, content: UserMessage['content'], docSchema: TagSchema) => Promise<void>;
     onUserShortcutConfirm?: (message: Message, formModel: Record<string, unknown>) => Promise<void>;

package/dist/components/chat-message/user-message/user-message.vue.d.ts

@@ -12,8 +12,8 @@ interface UserMessageProps extends UserMessageActionsProps {
     createdAt?: UserMessage['createdAt'];
     id?: UserMessage['id'];
     messageId?: UserMessage['messageId'];
-    name?: UserMessage['name'];
     messageTools?: IToolBtn[];
+    name?: UserMessage['name'];
     onAction?: MessageToolsProps['onAction'];
     property?: UserMessage['property'];
     role?: UserMessage['role'];