@ibiz-template-plugin/ai-chat 0.0.124 → 0.0.126

package/dist/types/components/chat-file-preview/chat-file-preview.d.ts

@@ -1,18 +1,41 @@
 import { FileSystemController } from '../../controller';
+import { IFile } from '../../interface';
 
 interface ChatFilePreviewProps {
     /**
-     * @description 文件路径
-     * @type {IFile}
+     * @description 传入资源类型，工作空间 | oss | skill
+     * @type {('workspace' | 'oss' | 'skill')}
      * @memberof ChatFilePreviewProps
      */
-    filePath?: string;
+    type: 'WORKSPACE' | 'OSS' | 'SKILL';
     /**
      * @description 系统文件控制器
      * @type {FileSystemController}
      * @memberof ChatFilePreviewProps
      */
     controller: FileSystemController;
+    /**
+     * @description skill文件信息，skill 类型文件预览必传
+     * @type {{ name: string; skill_id: string; filePath: string }}
+     * @memberof ChatFilePreviewProps
+     */
+    skillFile?: {
+        name: string;
+        skill_id: string;
+        filePath: string;
+    };
+    /**
+     * @description 文件路径，workspace类型必传
+     * @type {IFile}
+     * @memberof ChatFilePreviewProps
+     */
+    filePath?: string;
+    /**
+     * @description 文件对象，oss类型必传
+     * @type {IFile}
+     * @memberof ChatFilePreviewProps
+     */
+    ossFile?: IFile;
 }
 export declare const ChatFilePreview: (props: ChatFilePreviewProps) => import("preact").JSX.Element;
 export {};

package/dist/types/components/chat-message-item/chat-message-item.d.ts

@@ -26,6 +26,10 @@ export interface ChatMessageItemProps {
      * @type {VNode}
      * @memberof ChatMessageItemProps
      */
-    children: VNode;
+    children?: VNode;
+    /**
+     * 只读
+     */
+    readonly?: boolean;
 }
 export declare const ChatMessageItem: (props: ChatMessageItemProps) => h.JSX.Element;

package/dist/types/components/chat-message-item/error-message/error-message.d.ts

@@ -27,5 +27,9 @@ export interface ErrorMessageProps {
      * @memberof ErrorMessageProps
      */
     children: VNode;
+    /**
+     * 只读
+     */
+    readonly?: boolean;
 }
 export declare const ErrorMessage: (props: ErrorMessageProps) => import("preact").JSX.Element;

package/dist/types/components/chat-message-item/markdown-message/markdown-message.d.ts

@@ -34,5 +34,9 @@ export interface MarkdownMessageProps {
      * @memberof MarkdownMessageProps
      */
     children: VNode;
+    /**
+     * 只读
+     */
+    readonly?: boolean;
 }
 export declare const MarkdownMessage: (props: MarkdownMessageProps) => import("preact").JSX.Element;

package/dist/types/components/chat-message-item/user-message/user-message.d.ts

@@ -20,5 +20,9 @@ export interface UserMessageProps {
      * @memberof UserMessageProps
      */
     children: VNode;
+    /**
+     * 只读
+     */
+    readonly?: boolean;
 }
 export declare const UserMessage: (props: UserMessageProps) => import("preact").JSX.Element;

package/dist/types/components/chat-messages/chat-messages.d.ts

@@ -22,6 +22,10 @@ export interface ChatMessageProps {
      * 悬浮于消息区底部的插槽（如 footer 工具栏）
      */
     children?: ComponentChildren;
+    /**
+     * 只读
+     */
+    readonly?: boolean;
 }
 /**
  * 聊天消息列表组件

package/dist/types/components/chat-net-disk/chat-net-disk.d.ts

@@ -7,6 +7,10 @@ interface ChatNetDiskProps {
      * @memberof ChatNetDiskProps
      */
     controller: FileSystemController;
+    /**
+     * 默认展开id
+     */
+    defaultExpandId?: string;
 }
 export declare const ChatNetDisk: (props: ChatNetDiskProps) => import("preact").JSX.Element;
 export {};

package/dist/types/components/chat-output-files/chat-output-files.d.ts

@@ -0,0 +1,17 @@
+import { IChatOutPutFile } from '../../interface';
+import { AiChatController } from '../../controller';
+
+export type { ChatOutputFileAction } from './util';
+export interface ChatOutputFilesProps {
+    /**
+     * @description 消息输出文件列表
+     * @type {IChatOutPutFile[]}
+     * @memberof ChatOutputFilesProps
+     */
+    files: IChatOutPutFile[];
+    /**
+     * @description 聊天控制器
+     */
+    controller: AiChatController;
+}
+export declare const ChatOutputFiles: (props: ChatOutputFilesProps) => import("preact").JSX.Element | null;

package/dist/types/components/chat-output-files/deliverable-role-files/deliverable-role-files.d.ts

@@ -0,0 +1,18 @@
+import { IChatOutPutFile } from '../../../interface';
+import { ChatOutputFileActionHandler } from '../util';
+
+export interface DeliverableRoleFilesProps {
+    /**
+     * @description 交付物文件列表（仅 role=deliverable）
+     * @type {IChatOutPutFile[]}
+     * @memberof DeliverableRoleFilesProps
+     */
+    files: IChatOutPutFile[];
+    /**
+     * @description 文件行为上抛（预览/下载/跳转，具体实现由父组件处理）
+     * @type {ChatOutputFileActionHandler}
+     * @memberof DeliverableRoleFilesProps
+     */
+    onAction: ChatOutputFileActionHandler;
+}
+export declare const DeliverableRoleFiles: (props: DeliverableRoleFilesProps) => import("preact").JSX.Element | null;

package/dist/types/components/chat-output-files/evidence-role-files/evidence-role-files.d.ts

@@ -0,0 +1,18 @@
+import { IChatOutPutFile } from '../../../interface';
+import { ChatOutputFileActionHandler } from '../util';
+
+export interface EvidenceRoleFilesProps {
+    /**
+     * @description 佐证文件列表（仅 role=evidence）
+     * @type {IChatOutPutFile[]}
+     * @memberof EvidenceRoleFilesProps
+     */
+    files: IChatOutPutFile[];
+    /**
+     * @description 文件行为上抛（预览，具体实现由父组件处理）
+     * @type {ChatOutputFileActionHandler}
+     * @memberof EvidenceRoleFilesProps
+     */
+    onAction: ChatOutputFileActionHandler;
+}
+export declare const EvidenceRoleFiles: (props: EvidenceRoleFilesProps) => import("preact").JSX.Element | null;

package/dist/types/components/chat-output-files/util.d.ts

@@ -0,0 +1,29 @@
+import { IChatOutPutFile } from '../../interface';
+
+/**
+ * 输出文件行为
+ *
+ * @author tony001
+ * @date 2025-11-03 15:11:36
+ * @type {('preview' | 'download')}
+ */
+export type ChatOutputFileAction = 'preview' | 'download';
+/**
+ * 输出文件行为处理
+ *
+ * @author tony001
+ * @date 2025-11-03 15:11:52
+ */
+export type ChatOutputFileActionHandler = (action: ChatOutputFileAction, file: IChatOutPutFile, event: MouseEvent) => void;
+/**
+ * @description 格式化文件大小
+ * @param {number} bytes 字节数
+ * @return {*}  {string}
+ */
+export declare const formatFileSize: (bytes: number) => string;
+/**
+ * @description 提取文件后缀显示文本
+ * @param {string} name 文件名
+ * @return {*}  {string}
+ */
+export declare const getFileExt: (name: string) => string;

package/dist/types/components/common/actions/actions.d.ts

@@ -2,10 +2,12 @@ import { VNode } from 'preact';
 
 export interface IAction {
     id: string;
-    icon: VNode;
+    icon?: VNode;
     caption: string;
-    visible?: (data?: any) => boolean | boolean;
+    visible?: boolean | ((data?: any) => boolean);
+    disabled?: boolean | ((data?: any) => boolean);
     onClick?: (event: MouseEvent, data?: any) => void;
+    clickClose?: boolean;
 }
 interface ActionsProps {
     /**

package/dist/types/components/common/context-menu/context-menu.d.ts

@@ -1,7 +1,6 @@
 import { IAction } from '../actions/actions';
 
 export interface IContextMenuAction extends IAction {
-    clickClose?: boolean;
 }
 interface ContextMenuProps {
     /**

package/dist/types/components/common/lazy-level-list/lazy-level-list.d.ts

@@ -86,6 +86,10 @@ interface LazyLevelListProps {
      * @returns
      */
     filterNodeMethod?: (node: ITreeNode) => boolean;
+    /**
+     * 是否加载中
+     */
+    isLoading?: boolean;
 }
 export interface LazyLevelListRef {
     /**

package/dist/types/components/index.d.ts

@@ -3,3 +3,4 @@ export { FlatChatContainer } from './flat-chat-container/flat-chat-container';
 export { ChatActionPanel } from './chat-action-panel/chat-action-panel';
 export { SimpleChatContainer } from './simple-chat-container/simple-chat-container';
 export { ChatQuesition } from './chat-quesition/chat-quesition';
+export { ReadonlyChatContainer } from './readonly-chat-container/readonly-chat-container';

package/dist/types/components/popup/popup.d.ts

@@ -1,20 +1,24 @@
-import { VNode } from 'preact';
+import { ComponentChildren } from 'preact';
+import { IAction } from '../common/actions/actions';
 
 type Position = 'top' | 'bottom' | 'left' | 'right' | 'top-left';
-interface ActionItem {
-    id: string;
-    caption: string;
-    icon?: VNode;
+interface IActionItem extends IAction {
+    position?: Position;
+    children?: IActionItem[];
+    triggerMode?: 'click' | 'hover';
+    content?: ComponentChildren;
+    popupClassName?: string;
 }
-export declare const Popup: ({ triggerMode, children, actions, content, disabled, position, isOpen: isOpenProp, onToggleOpen, popupClassName, onAction, }: {
+export declare const Popup: ({ data, triggerMode, children, actions, content, disabled, position, isOpen: isOpenProp, onToggleOpen, popupClassName, onAction, }: {
     triggerMode: "click" | "hover";
-    children: import('preact').ComponentChildren;
-    actions?: ActionItem[];
-    content?: import('preact').ComponentChildren;
+    children: ComponentChildren;
+    actions?: IActionItem[];
+    content?: ComponentChildren;
     position?: Position;
     isOpen?: boolean;
     popupClassName?: string;
     disabled?: boolean;
+    data?: any;
     onToggleOpen?: (isOpen: boolean) => void;
     onAction?: (actionId: string, event: MouseEvent) => void;
 }) => import("preact").JSX.Element;

package/dist/types/components/readonly-chat-container/readonly-chat-container.d.ts

@@ -0,0 +1,29 @@
+import { Component } from 'preact';
+import { Namespace } from '../../utils';
+import { AiChatController } from '../../controller';
+
+export interface ReadonlyChatContainerProps {
+    /**
+     * @description 是否加载中
+     * @type {boolean}
+     * @memberof ReadonlyChatContainerProps
+     */
+    isLoading: boolean;
+    /**
+     * @description 聊天控制器
+     * @type {AiChatController}
+     * @memberof ReadonlyChatContainerProps
+     */
+    aiChat?: AiChatController;
+}
+/**
+ * 只读聊天容器
+ *
+ * @export
+ * @class ReadonlyChatContainer
+ * @extends {Component<ReadonlyChatContainerProps>}
+ */
+export declare class ReadonlyChatContainer extends Component<ReadonlyChatContainerProps> {
+    ns: Namespace;
+    render(): import("preact").JSX.Element;
+}

package/dist/types/controller/ai-action-panel/ai-action-panel.controller.d.ts

@@ -57,7 +57,7 @@ export declare class AiActionPanelController {
      * - params 中包含 controller 时替换为激活会话的控制器
      * - 重置 key 强制内容组件重挂载并重新加载数据
      *
-     * @param {string} [key] 业务域key（未传时生成 uuid 强制刷新）
+     * @param {string} [key] 业务域key（未传时刷新参数, 传递时强制重绘）
      * @param {unknown} [controller] 激活会话的聊天控制器
      * @memberof AiActionPanelController
      */

package/dist/types/controller/ai-chat/ai-chat.controller.d.ts

@@ -1,7 +1,7 @@
 import { Signal } from '@preact/signals';
 import { QXEvent } from 'qx-util';
 import { AIAgent, ChatMessage, KnowledgeBase } from '../../entity';
-import { ITopic, IMaterial, IChatMessage, IChatOptions, IChatUIAction, IAIAgentConfig, IChatSuggestion, IResourceOptions, IChatMessageUsage, ITopicOptions } from '../../interface';
+import { ITopic, IMaterial, IChatMessage, IChatOptions, IChatUIAction, IAIAgentConfig, IChatSuggestion, IResourceOptions, IChatMessageUsage, ITopicOptions, IChatOutPutFile } from '../../interface';
 import { AiTopicController } from '../ai-topic/ai-topic.controller';
 import { AiActionPanelController } from '../ai-action-panel/ai-action-panel.controller';
 import { FileSystemController } from '../file-system/file-system.controller';
@@ -442,6 +442,13 @@ export declare class AiChatController {
      * @memberof AiChatController
      */
     updateMsgUsage(messageid: string, usage: IChatMessageUsage): void;
+    /**
+     * @description 更新消息的输出文件列表
+     * @param {string} messageid 消息ID
+     * @param {IChatOutPutFile[]} files 消息输出文件列表
+     * @memberof AiChatController
+     */
+    updateMsgOutputFiles(messageid: string, files: IChatOutPutFile[]): void;
     /**
      * @description 基于消息ID更新消息的远程消息标识
      * @param {string} messageid 本地消息ID
@@ -705,6 +712,11 @@ export declare class AiChatController {
      * @returns
      */
     handlePredefinedClick(type: 'chunkview' | 'view' | 'action', url: string, message: IChatMessage, event: MouseEvent): Promise<void>;
+    /**
+     * 打开输出文件预览
+     * @param file
+     */
+    openOutputFilePreview(file: IChatOutPutFile): void;
     /**
      * 处理预定义视图跳转点击
      * @param url

package/dist/types/controller/chat/readonly-chat.controller.d.ts

@@ -0,0 +1,64 @@
+import { IContainerOptions } from '../../interface';
+import { AiChatController } from '../ai-chat/ai-chat.controller';
+import { ChatBaseController } from './chat-base.controller';
+
+/**
+ * @description 只读聊天控制器
+ * @export
+ * @class ReadonlyChatController
+ * @extends {ChatBaseController}
+ */
+export declare class ReadonlyChatController extends ChatBaseController {
+    /**
+     * @description 挂载容器
+     * @protected
+     * @type {HTMLElement}
+     * @memberof ReadonlyChatController
+     */
+    protected container?: HTMLElement;
+    /**
+     * @description 创建只读聊天
+     * @param {IContainerOptions} opts
+     * @returns {*}  {Promise<AiChatController>}
+     * @memberof ReadonlyChatController
+     */
+    create(opts: IContainerOptions): Promise<AiChatController>;
+    /**
+     * @description 创建容器，渲染loading状态
+     * @protected
+     * @param {IContainerOptions} opts
+     * @param {Record<string, any>} chatOptions
+     * @returns {*}  {void}
+     * @memberof ReadonlyChatController
+     */
+    protected setupContainer(_opts: IContainerOptions, _chatOptions: Record<string, any>): void;
+    /**
+     * @description 渲染正式聊天内容
+     * @protected
+     * @param {IContainerOptions} _opts
+     * @param {Record<string, any>} _chatOptions
+     * @param {AiChatController} aiChat
+     * @returns {*}  {void}
+     * @memberof ReadonlyChatController
+     */
+    protected renderChatContent(_opts: IContainerOptions, _chatOptions: Record<string, any>, aiChat: AiChatController): void;
+    /**
+     * @description 渲染切换聊天后的内容
+     * @protected
+     * @param {Record<string, any>} _opts
+     * @param {AiChatController} _aiChat
+     * @memberof ReadonlyChatController
+     */
+    protected renderSwitchedContent(_opts: Record<string, any>, _aiChat: AiChatController): void;
+    /**
+     * @description 关闭
+     * @memberof ReadonlyChatController
+     */
+    close(): void;
+}
+/**
+ * @description 创建只读聊天实例
+ * @export
+ * @returns {*}  {ReadonlyChatController}
+ */
+export declare function createReadonlyChat(): ReadonlyChatController;

package/dist/types/controller/file-system/file-system.controller.d.ts

@@ -1,4 +1,4 @@
-import { IFile, IFileItem, ITreeNode, IMessageUtil, IConfirmUtil, IFileItemParams, IFileUploadPrams, IFileSystemOptions, FileUploaderOptions } from '../../interface';
+import { IFile, IFileItem, ITreeNode, IMessageUtil, IConfirmUtil, IFileItemParams, IFileUploadPrams, IFileSystemOptions, FileUploaderOptions, IFileReadPrams, IFileSystemResult } from '../../interface';
 import { AiChatController } from '../ai-chat/ai-chat.controller';
 
 /**
@@ -9,7 +9,7 @@ import { AiChatController } from '../ai-chat/ai-chat.controller';
 export declare class FileSystemController {
     private opts;
     private uploader;
-    aiChat: AiChatController;
+    private aiChat;
     /**
      * Creates an instance of FileSystemController.
      * @param {IFileSystemOptions} opts
@@ -31,6 +31,13 @@ export declare class FileSystemController {
      * @memberof FileSystemController
      */
     private params;
+    /**
+     * @description 选中项目
+     * @readonly
+     * @type {(string | undefined)}
+     * @memberof FileSystemController
+     */
+    get activeAIProjectId(): string | undefined;
     /**
      * @description 消息
      * @readonly
@@ -76,10 +83,19 @@ export declare class FileSystemController {
     /**
      * @description 系统文件上传
      * @param {IFileUploadPrams} params
-     * @returns {*}  {(Promise<IFile | undefined>)}
+     * @returns {*}  {(Promise<(IFileSystemResult & { cat: string }) | undefined>)}
+     * @memberof FileSystemController
+     */
+    uploadSystemFile(params: IFileUploadPrams): Promise<(IFileSystemResult & {
+        cat: string;
+    }) | undefined>;
+    /**
+     * @description 读取系统文件
+     * @param {IFileReadPrams} params
+     * @returns {*}  {(Promise<IFileSystemResult | undefined>)}
      * @memberof FileSystemController
      */
-    uploadSystemFile(params: IFileUploadPrams): Promise<IFile | undefined>;
+    readSystemFile(params: IFileReadPrams): Promise<IFileSystemResult | undefined>;
     /**
      * @description 获取文件内容
      * @param {string} id

package/dist/types/controller/index.d.ts

@@ -7,3 +7,4 @@ export { FlatChatController, createFlatChat, } from './chat/flat-chat.controller
 export { drawerController } from './overlay';
 export { FileSystemController } from './file-system/file-system.controller';
 export { tipTapController } from './tiptap/tiptap.controller';
+export { createReadonlyChat, ReadonlyChatController, } from './chat/readonly-chat.controller';

package/dist/types/entity/chat-message/chat-message.d.ts

@@ -1,4 +1,4 @@
-import { IChatMessage, IChatThink, IChatMessageUsage } from '../../interface';
+import { IChatMessage, IChatThink, IChatMessageUsage, IChatOutPutFile } from '../../interface';
 
 /**
  * 消息实体
@@ -17,6 +17,7 @@ export declare class ChatMessage implements IChatMessage {
     chatuiactions: IChatMessage['chatuiactions'];
     think: IChatThink | undefined;
     usage: IChatMessageUsage | undefined;
+    files: IChatOutPutFile[] | undefined;
     /**
      * @description 是否为重新编辑状态，为重新编辑状态为true/不为重新编辑状态为false
      *

package/dist/types/hook/fullscreen.d.ts

@@ -0,0 +1,8 @@
+export declare const useFullscreen: (targetRef?: {
+    current: HTMLElement | null;
+}) => {
+    isFullscreen: boolean;
+    enter: () => Promise<boolean>;
+    exit: () => Promise<boolean>;
+    toggle: () => Promise<void>;
+};

package/dist/types/hook/index.d.ts

@@ -0,0 +1 @@
+export { useFullscreen } from './fullscreen';

package/dist/types/icons/download.d.ts

@@ -1 +1,2 @@
 export declare const DownLoadSvg: () => import("preact").JSX.Element;
+export declare const DownLoad2Svg: () => import("preact").JSX.Element;

package/dist/types/icons/index.d.ts

@@ -34,7 +34,7 @@ export { LikeSvg } from './like-svg';
 export { DislikeSvg } from './dislike-svg';
 export { TopSvg } from './top-svg';
 export { NoTopSvg } from './no-top-svg';
-export { DownLoadSvg } from './download';
+export { DownLoadSvg, DownLoad2Svg } from './download';
 export { WarningSvg } from './warning-svg';
 export { ImageSvg, ErrorSvg, ExpandSvg, EmptySvg, CopyingSvg, CopyPasteSvg, KnowledgeSvg, } from './tool-call-svg';
 export { FailSvg } from './fail-svg';

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
 
 export { ChatContainer, FlatChatContainer } from './components';
-export { chat, createFlatChat } from './controller';
+export { chat, createFlatChat, createReadonlyChat } from './controller';
 export type { IChatToolbarItem, IActionPanelContentProps, TActionPanelComponent, } from './interface';

package/dist/types/interface/i-chat-message/i-chat-message.d.ts

@@ -1,4 +1,5 @@
 import { IChatMessageUsage } from '../i-chat-message-usage/i-chat-message-usage';
+import { IChatOutPutFile } from '../i-chat-output-file/i-chat-output-file';
 import { IChatStep } from '../i-chat-step/i-chat-step';
 import { IChatSuggestion } from '../i-chat-suggestion/i-chat-suggestion';
 import { IChatThink } from '../i-chat-think/i-chat-think';
@@ -201,4 +202,10 @@ export interface IChatMessage {
      * @memberof IChatMessage
      */
     iswaiting?: boolean;
+    /**
+     * @description 聊天输出文件
+     * @type {IChatOutPutFile[]}
+     * @memberof IChatMessage
+     */
+    files?: IChatOutPutFile[];
 }

package/dist/types/interface/i-chat-output-file/i-chat-output-file.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @description 聊天输出文件接口
+ * @export
+ * @interface IChatOutPutFile
+ */
+export interface IChatOutPutFile {
+    /**
+     * @description 文件来源，智能体工作区 | 对象存储（OSS） | 技能目录（技能静态资产，如 SKILL.md / references / scripts / templates）
+     * @type {('skills_workspace' | 'oss' | 'skill')}
+     * @memberof IChatOutPutFile
+     */
+    source: 'skills_workspace' | 'oss' | 'skill';
+    /**
+     * @description 路径（工作区相对路径，OSS 的 folder/id，或技能目录内相对路径）
+     * @type {string}
+     * @memberof IChatOutPutFile
+     */
+    path: string;
+    /**
+     * @description 显示名称
+     * @type {string}
+     * @memberof IChatOutPutFile
+     */
+    name: string;
+    /**
+     * @description 角色，交付物（用户需要打开） | 佐证（仅支撑结论）
+     * @type {('deliverable' | 'evidence')}
+     * @memberof IChatOutPutFile
+     */
+    role: 'deliverable' | 'evidence';
+    /**
+     * @description 说明
+     * @type {string}
+     * @memberof IChatOutPutFile
+     */
+    description: string;
+    /**
+     * @description 大小（字节）
+     * @type {number}
+     * @memberof IChatOutPutFile
+     */
+    size?: number;
+    /**
+     * @description 下载地址（OSS）
+     * @type {string}
+     * @memberof IChatOutPutFile
+     */
+    url?: string;
+    /**
+     * @description 技能ID（技能目录内的文件才有）
+     * @type {string}
+     * @memberof IChatOutPutFile
+     */
+    skill_id?: string;
+}

package/dist/types/interface/i-chat-toolbar-item/i-chat-toolbar-item.d.ts

@@ -20,7 +20,7 @@ export interface IChatToolbarItem {
      *
      * @memberof IChatToolbarItem
      */
-    label?: string | VNode | ((h: Function) => VNode);
+    label?: string;
     /**
      * 提示信息
      *

package/dist/types/interface/i-file-item/i-file-item.d.ts

@@ -60,8 +60,23 @@ export interface IFileUploadPrams {
      */
     file_path: string;
 }
+export interface IFileReadPrams {
+    /**
+     * @description 文件路径
+     * @type {string}
+     * @memberof IFileReadPrams
+     */
+    file_path: string;
+    /**
+     * @description 技能id
+     * @type {string}
+     * @memberof IFileReadPrams
+     */
+    skill_id?: string;
+}
 export interface IFile {
-    id: string;
     name: string;
-    cat: string;
+    id?: string;
+    cat?: string;
+    content?: string;
 }