@ibiz-template-plugin/ai-chat 0.0.115 → 0.0.117

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

@@ -210,7 +210,6 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
     fitPanelToViewport(panel: AiActionPanelController): void;
     ns: Namespace;
     containerRef: import('preact').RefObject<HTMLDivElement>;
-    dragHandle: import('preact').RefObject<HTMLDivElement>;
     /**
      * 输入区容器（用于高度分隔条）
      */
@@ -237,13 +236,6 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
         minHeight: number;
         showMode: string;
     };
-    /**
-     * 是否禁止拖动
-     * - 拖拽边时应禁止拖动
-     * @type {boolean}
-     * @memberof ChatContainer
-     */
-    disabled: boolean;
     /**
      * 最小化是否在拖拽中
      * - 在拖拽时不应触发点击事件
@@ -255,13 +247,6 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 侧栏宽度拖动起始值(px)
      */
     sidebarDragStartWidth: number;
-    /**
-     * 拖拽容器边框时的方向标记（左右=宽、上下=高）
-     */
-    resizing: {
-        width: boolean;
-        height: boolean;
-    };
     /**
      * 输入区高度拖动起始值(px)
      */
@@ -290,6 +275,13 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * @type {ContainerContext}
      */
     containerContext: ContainerContext;
+    /**
+     * 同步 props 到容器上下文（引用仅在值变化时替换，保证消费者按需重渲染）
+     *
+     * @return {*}
+     * @memberof ChatContainer
+     */
+    syncContainerContext(): void;
     /**
      * 计算AI窗口样式
      *
@@ -326,18 +318,12 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * @memberof ChatContainer
      */
     snapToEdge(): void;
-    /**
-     * 注册对话框拖拽
-     *
-     * @memberof ChatContainer
-     */
-    registerDragDialog(): void;
     /**
      * 注册对话框边界拖拽
      *
      * @memberof ChatContainer
      */
-    registerDragDialogBorder(): void;
+    registerDrag(): void;
     /**
      * 处理全屏改变
      *
@@ -394,6 +380,24 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 右侧聊天区宽度
      */
     getRightWidth(): string;
+    /**
+     * @description 获取宽度
+     * @returns {*}  {{
+     *     centreMinWidth: number;
+     *     leftWidth: number;
+     *     rightWidth: number;
+     *     leftMinWidth: number;
+     *     rightMinWidth: number;
+     *   }}
+     * @memberof ChatContainer
+     */
+    getWidth(): {
+        centreMinWidth: number;
+        leftWidth: number;
+        rightWidth: number;
+        leftMinWidth: number;
+        rightMinWidth: number;
+    };
     /**
      * 侧栏宽度拖动开始
      */
@@ -407,13 +411,17 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      */
     handleSidebarResizeEnd: () => void;
     /**
-     * 将侧栏宽度校正到合理区间 [200, 容器宽度/2, 右侧最小宽]
+     * 将侧栏宽度校正到合理区间 [200, 容器宽度/3, 容器宽度-右侧最小宽]
      */
     clampSidebarWidth(width: number): number;
     /**
-     * 拖动容器左右边框时实时校正侧栏宽度
+     * @description 拖动容器左右边框时实时校正侧栏宽度
+     * - 中间宽度已到最小宽度时缩小对应边的侧边栏
+     * @param {('left' | 'right')} direction
+     * @param {number} width
+     * @memberof ChatContainer
      */
-    syncSidebarWidth: () => void;
+    syncSidebarWidth: (direction: "left" | "right", width: number) => void;
     /**
      * 拖动容器左右边框结束后提交侧栏宽度
      */

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

@@ -0,0 +1,18 @@
+import { FileSystemController } from '../../controller';
+
+interface ChatFilePreviewProps {
+    /**
+     * @description 文件路径
+     * @type {IFile}
+     * @memberof ChatFilePreviewProps
+     */
+    filePath?: string;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof ChatFilePreviewProps
+     */
+    controller: FileSystemController;
+}
+export declare const ChatFilePreview: (props: ChatFilePreviewProps) => import("preact").JSX.Element;
+export {};

package/dist/types/components/chat-group-topics/components/selected-mode-topic/selected-mode-topic.d.ts

@@ -0,0 +1,21 @@
+import { AiTopicController } from '../../../../controller';
+
+export interface SelectedModeTopicProps {
+    /**
+     * 话题控制器
+     *
+     * @author tony001
+     * @date 2025-02-20 17:02:49
+     * @type {AiTopicController}
+     */
+    controller: AiTopicController;
+    /**
+     * 进入多选模式时默认选中的话题id
+     */
+    defaultSelectedTopicId?: string;
+    /**
+     * 抽屉关闭回调（由 Drawer 自动注入）
+     */
+    onClose?: () => void;
+}
+export declare const SelectedModeTopic: (props: SelectedModeTopicProps) => import("preact").JSX.Element;

package/dist/types/components/chat-group-topics/components/show-hidden-setting/show-hidden-setting.d.ts

@@ -0,0 +1,17 @@
+import { AiTopicController } from '../../../../controller';
+
+export interface ShowHiddenSettingProps {
+    /**
+     * 话题控制器
+     *
+     * @author tony001
+     * @date 2025-02-20 17:02:49
+     * @type {AiTopicController}
+     */
+    controller: AiTopicController;
+    /**
+     * 抽屉关闭回调（由 Drawer 自动注入）
+     */
+    onClose?: () => void;
+}
+export declare const ShowHiddenSetting: (props: ShowHiddenSettingProps) => import("preact").JSX.Element;

package/dist/types/components/chat-group-topics/components/topic-batch-action/topic-batch-action.d.ts

@@ -0,0 +1,21 @@
+import { AiTopicController } from '../../../../controller';
+
+export interface TopicBatchActionProps {
+    /**
+     * 话题控制器
+     *
+     * @author tony001
+     * @date 2025-02-20 17:02:49
+     * @type {AiTopicController}
+     */
+    controller: AiTopicController;
+    /**
+     * 进入批量管理时默认选中的目录key
+     */
+    defaultSelectedScopeKey?: string;
+    /**
+     * 抽屉关闭回调（由 Drawer 自动注入）
+     */
+    onClose?: () => void;
+}
+export declare const TopicBatchAction: (props: TopicBatchActionProps) => import("preact").JSX.Element;

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

@@ -1,7 +1,7 @@
-import { AiChatController } from '../../controller';
+import { FileSystemController } from '../../controller';
 
 interface ChatNetDiskProps {
-    controller: AiChatController;
+    controller: FileSystemController;
 }
 export declare const ChatNetDisk: (props: ChatNetDiskProps) => import("preact").JSX.Element;
 export {};

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

@@ -1,12 +1,19 @@
 
 interface BreadcrumbProps {
     /**
-     * 当前路径（根 -> 当前层）
+     * 当前路径（非根 -> 当前层）
      */
     path: {
         id: string;
         label: string;
     }[];
+    /**
+     * 根节点
+     */
+    root?: {
+        id: string;
+        label: string;
+    };
     /**
      * 点击某一层跳转，-1 表示回到根
      */

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

@@ -0,0 +1,28 @@
+import { h } from 'preact';
+
+interface DrawerProps {
+    /** 抽屉内容组件（函数组件 / 类组件） */
+    content: any;
+    /** 传递给内容组件的参数（onClose 会被自动注入） */
+    contentProps?: Record<string, any>;
+    /** 弹出方向 */
+    placement?: 'left' | 'right' | 'top' | 'bottom';
+    /** 宽（左右）/ 高（上下），number(px) 或 字符串(如 '50%') */
+    size?: number | string;
+    /** 指定容器（DOM 元素），不传则默认 body */
+    container?: HTMLElement;
+    /** 关闭回调（由 DrawerManager 注入） */
+    onClose?: () => void;
+    /** 是否显示遮罩，默认 true */
+    mask?: boolean;
+    /** 是否显示右上角关闭按钮，默认 true */
+    showClose?: boolean;
+    /** 点击遮罩是否关闭，默认 true */
+    maskClosable?: boolean;
+    /** 外部扩展类名 */
+    className?: string;
+    /** 标题 */
+    title?: string;
+}
+export declare const Drawer: (props: DrawerProps) => h.JSX.Element;
+export {};

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

@@ -55,5 +55,15 @@ interface LazyListTreeProps {
      */
     draggable?: boolean;
 }
-export declare const LazyListTree: (props: LazyListTreeProps) => import("preact").JSX.Element;
+export interface LazyListTreeRef {
+    /**
+     * 重载节点
+     * @param node
+     * @returns
+     */
+    overloadNode: (node: LazyTreeNode) => Promise<void>;
+}
+export declare const LazyListTree: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<LazyListTreeProps> & {
+    ref?: import('preact').Ref<LazyListTreeRef> | undefined;
+}>;
 export {};

package/dist/types/components/common/lazy-tree/lazy-tree.d.ts

@@ -44,6 +44,12 @@ export interface LazyTreeNode {
      * 原始数据
      */
     data: Record<string, any>;
+    /**
+     * @description 根节点标识
+     * @type {string}
+     * @memberof LazyTreeNode
+     */
+    rootId: string;
 }
 interface LazyTreeProps {
     /**

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

@@ -65,6 +65,7 @@ export interface FlatChatContainerProps {
 interface FlatContainerContext {
     enableBackFill: boolean;
 }
+export declare const DEFAULT_FLAT_CONTAINER_CONTEXT: FlatContainerContext;
 export declare const FlatContainerContext: import('preact').Context<FlatContainerContext>;
 /**
  * 平铺聊天容器，无拖拽/缩放/全屏/最小化，铺满外部容器

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

@@ -26,6 +26,10 @@ export declare enum AIChatConst {
      * 操作区面板默认宽度(px)
      */
     ACTION_PANEL_DEFAULT_WIDTH = 380,
+    /**
+     * 话题侧边栏默认宽度(px)
+     */
+    TOPIC_SIDEBAR_DEFAULT_WIDTH = 200,
     /**
      * 数据库名称
      */

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

@@ -38,6 +38,10 @@ export declare class AiActionPanelController {
      * 内容组件额外参数
      */
     readonly params: Signal<Record<string, any> | undefined>;
+    /**
+     * 当前业务域key（渲染内容组件时作为key传入，不同业务域切换时强制重挂载）
+     */
+    readonly key: Signal<string>;
     /**
      * 组件外层容器id（用于宽度缓存隔离）
      */
@@ -50,9 +54,22 @@ export declare class AiActionPanelController {
      * @param {string} caption 标题
      * @param {TActionPanelComponent} component 内容组件
      * @param {Record<string, any>} [params] 额外参数（作为内容组件props传入）
+     * @param {string} [key] 业务域key（内容组件渲染key，不同业务域切换时强制重挂载）
+     * @memberof AiActionPanelController
+     */
+    open(caption: string, component: TActionPanelComponent, params?: Record<string, any>, key?: string): void;
+    /**
+     * 刷新面板内容（会话切换时调用）
+     * - 面板未打开时不做处理（下次 open 会生成全新参数）
+     * - 新旧 key 一致时跳过刷新（同一业务域无需重挂载）
+     * - params 中包含 controller 时替换为激活会话的控制器
+     * - 重置 key 强制内容组件重挂载并重新加载数据
+     *
+     * @param {string} [key] 业务域key（未传时生成 uuid 强制刷新）
+     * @param {unknown} [controller] 激活会话的聊天控制器
      * @memberof AiActionPanelController
      */
-    open(caption: string, component: TActionPanelComponent, params?: Record<string, any>): void;
+    refresh(key?: string, controller?: unknown): void;
     /**
      * 关闭操作区面板（收起动画由容器 CSS 过渡完成）
      *

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

@@ -1,9 +1,10 @@
 import { Signal } from '@preact/signals';
 import { QXEvent } from 'qx-util';
 import { AIAgent, ChatMessage, KnowledgeBase } from '../../entity';
-import { ITopic, IProject, IMaterial, IChatMessage, IChatOptions, IChatUIAction, IAIAgentConfig, IProjectParams, IChatSuggestion, IResourceOptions, IChatMessageUsage, ITopicOptions } from '../../interface';
+import { ITopic, IMaterial, IChatMessage, IChatOptions, IChatUIAction, IAIAgentConfig, IChatSuggestion, IResourceOptions, IChatMessageUsage, ITopicOptions } 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';
 
 /**
  * 聊天逻辑控制器
@@ -232,6 +233,12 @@ export declare class AiChatController {
      * @memberof AiChatController
      */
     inited: Signal<boolean>;
+    /**
+     * @description 系统文件控制器
+     * @type {FileSystemController}
+     * @memberof AiChatController
+     */
+    fileSystem: FileSystemController;
     /**
      * @description 增强提问配置
      * @type {Signal<{ enable: boolean; message: string }>}
@@ -392,6 +399,18 @@ export declare class AiChatController {
      * @memberof AiChatController
      */
     attachMessageAgentID(data: IChatMessage): void;
+    /**
+     * @description 新增等待回复消息（与后续流式推送共用同一消息标识，首条内容到达时原地更新该消息）
+     * @param {string} messageid 消息标识
+     * @memberof AiChatController
+     */
+    addWaitingMessage(messageid: string): void;
+    /**
+     * @description 移除等待回复状态：未收到任何内容则删除占位消息（中断、超时、无推送场景）；已有内容则仅清除等待标记
+     * @param {string} messageid 消息标识
+     * @memberof AiChatController
+     */
+    removeWaitingMessage(messageid: string): void;
     /**
      * @description 新增聊天记录
      * @param {IChatMessage} data
@@ -423,6 +442,13 @@ export declare class AiChatController {
      * @memberof AiChatController
      */
     updateMsgUsage(messageid: string, usage: IChatMessageUsage): void;
+    /**
+     * @description 基于消息ID更新消息的远程消息标识
+     * @param {string} messageid 本地消息ID
+     * @param {string} realmessageid 远程消息ID
+     * @memberof AiChatController
+     */
+    updateMsgRealMessageID(messageid: string, realmessageid: string): void;
     /**
      * 终止消息
      *
@@ -500,16 +526,23 @@ export declare class AiChatController {
      */
     backfill(message: IChatMessage): void;
     /**
-     *
-     * 删除指定消息，如果是用户提问的刷新调用的删除，则需要删除从问题开始到最后的所有记录
+     * @description 远程模式批量删除消息
+     * @param {IChatMessage[]} msgs 待删除的消息
+     * @return {*}  {Promise<void>}
+     * @memberof AiChatController
+     */
+    private deleteRemoteMessages;
+    /**
+     * @description 删除消息
      * @param {IChatMessage} message
-     * @param {boolean} [isuser=false]
+     * @return {*}  {Promise<void>}
      * @memberof AiChatController
      */
     deleteMessage(message: IChatMessage): Promise<void>;
     /**
-     * 刷新当前消息
-     *
+     * @description 刷新当前消息
+     * @param {IChatMessage} message
+     * @param {boolean} [isuser=false] 是否是用户消息刷新
      * @memberof AiChatController
      */
     refreshMessage(message: IChatMessage, isuser?: boolean): Promise<void>;
@@ -634,13 +667,6 @@ export declare class AiChatController {
      * @returns
      */
     searchAIAgent(query: string): Promise<AIAgent[]>;
-    /**
-     * @description 搜索项目
-     * @param {IProjectParams} params 查询参数
-     * @returns {*}  {Promise<IProject[]>}
-     * @memberof AiChatController
-     */
-    searchProject(params: IProjectParams): Promise<IProject[]>;
     /**
      * @description 设置选中项目目录
      * @param {(string | undefined)} id

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

@@ -1,6 +1,6 @@
 import { Signal } from '@preact/signals';
 import { ChatTopic } from '../../entity';
-import { ITopic, ITopicOptions, IResourceOptions, IChatController, IGroupItem, IScopeItem, ITopicGroupNode } from '../../interface';
+import { ITopic, ITopicOptions, IResourceOptions, IChatController, IGroupItem, IScopeOption, IScopeItem, ITopicGroupNode } from '../../interface';
 import { AiChatController } from '../ai-chat/ai-chat.controller';
 
 /**
@@ -113,16 +113,22 @@ export declare class AiTopicController {
     disableSelectScope: boolean;
     /**
      * @description 业务域列表（WORKSPACE 工作模式使用）
-     * @type {IScopeItem[]}
+     * @type {IScopeOption[]}
      * @memberof AiTopicController
      */
-    scopeList: IScopeItem[];
+    scopeList: IScopeOption[];
     /**
      * @description 用户自定义分组清单（WORKSPACE 工作模式使用）
      * @type {Signal<IGroupItem[]>}
      * @memberof AiTopicController
      */
     readonly groups: Signal<IGroupItem[]>;
+    /**
+     * @description 业务域界面数据清单（WORKSPACE 工作模式，存储于 'aiscopes'）
+     * @type {Signal<IScopeItem[]>}
+     * @memberof AiTopicController
+     */
+    readonly scopes: Signal<IScopeItem[]>;
     /**
      * @description 分组存储服务实例（'aigroups'，与会话数据 'aitopics' 区分）
      * @private
@@ -130,6 +136,13 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     private groupConfig;
+    /**
+     * @description 业务域存储服务实例（'aiscopes'，与会话数据 'aitopics' 区分）
+     * @private
+     * @type {(IConfigService | undefined)}
+     * @memberof AiTopicController
+     */
+    private scopeConfig;
     /**
      * Creates an instance of AiTopicController.
      * @author tony001
@@ -156,10 +169,10 @@ export declare class AiTopicController {
      * @param {string} compWrapperId
      * @param {('DEFAULT' | 'WORKSPACE')} workMode
      * @param {boolean} [disableSelectScope]
-     * @param {IScopeItem[]} [scopeList]
+     * @param {IScopeOption[]} [scopeList]
      * @memberof AiTopicController
      */
-    injectBasicResources(compWrapperId: string, workMode: 'DEFAULT' | 'WORKSPACE', disableSelectScope?: boolean, scopeList?: IScopeItem[]): void;
+    injectBasicResources(compWrapperId: string, workMode: 'DEFAULT' | 'WORKSPACE', disableSelectScope?: boolean, scopeList?: IScopeOption[]): void;
     /**
      * 注入资源选项
      * @param resourceOptions
@@ -317,6 +330,12 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     updateTopicConfig(options: ITopicOptions): Promise<void>;
+    /**
+     * @description 获取侧边栏默认宽度
+     * @returns {*}  {number}
+     * @memberof AiTopicController
+     */
+    getDefaultWidth(): number;
     /**
      * 计算话题侧边栏宽度
      */
@@ -431,6 +450,35 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     private saveGroups;
+    /**
+     * @description 获取业务域存储服务实例（'aiscopes'，与会话数据 'aitopics' 区分）
+     * @private
+     * @param {ITopicOptions} options 话题配置
+     * @returns {*}  {IConfigService}
+     * @memberof AiTopicController
+     */
+    private getScopeConfig;
+    /**
+     * @description 加载业务域界面数据
+     * @param {ITopicOptions} options 话题配置
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    fetchScopes(options: ITopicOptions): Promise<void>;
+    /**
+     * @description 保存业务域界面数据
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    private saveScopes;
+    /**
+     * @description 获取业务域界面数据，无存储记录时返回默认值（显示、不置顶）
+     * @private
+     * @param {(string | number)} scopeid 业务域标识
+     * @returns {*}  {IScopeItem}
+     * @memberof AiTopicController
+     */
+    private getScopeItemConfig;
     /**
      * @description 计算分组树（WORKSPACE 工作模式）：业务域第一层，自定义分组第二层，其后为话题
      * @param {string} [query] 快速搜索关键词
@@ -468,6 +516,28 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     toggleGroupCollapse(groupid: string): Promise<void>;
+    /**
+     * @description 更新业务域界面数据（visible/istop）并持久化，scopeid不传表示无分类节点；
+     * 归一化后与默认值一致（visible为true且istop为false）时移除存储记录，默认值数据不落存储
+     * @param {(string | number)} [scopeid] 业务域标识
+     * @param {Partial<Pick<IScopeItem, 'visible' | 'istop'>>} partial 更新数据
+     * @returns {*}  {Promise<IScopeItem | undefined>} 成功返回归一化后的数据，持久化失败返回undefined
+     * @memberof AiTopicController
+     */
+    updateScopeItem(scopeid: string | number | undefined, partial: Partial<Pick<IScopeItem, 'visible' | 'istop'>>): Promise<IScopeItem | undefined>;
+    /**
+     * @description 批量更新业务域界面数据（visible/istop），内部合并处理scopes数据，最终一次持久化；
+     * scopeid不传表示无分类节点，未传字段保留原值（缺省visible视为true、istop视为false），
+     * 归一化后与默认值一致（visible为true且istop为false）时移除存储记录，默认值数据不落存储
+     * @param {Array<{ scopeid: string | number | undefined; visible?: boolean; istop?: boolean }>} updates 更新数据集合
+     * @returns {*}  {Promise<boolean>} 是否全部更新成功
+     * @memberof AiTopicController
+     */
+    batchUpdateScopeItems(updates: Array<{
+        scopeid: string | number | undefined;
+        visible?: boolean;
+        istop?: boolean;
+    }>): Promise<boolean>;
     /**
      * @description 删除业务域：真删该域下所有分组和会话数据；不传scopeid表示删除无分类域
      * @param {(string | number)} [scopeid] 业务域标识
@@ -475,6 +545,14 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     removeScope(scopeid?: string | number): Promise<boolean>;
+    /**
+     * @description 批量删除业务域：一次性归集所有待删域的会话数据，统一走一次 beforeDelete
+     * 确认后真删（含域下分组和会话），域界面数据与分组数据各持久化一次；不传scopeid表示无分类域
+     * @param {Array<string | number | undefined>} scopeids 业务域标识集合
+     * @returns {*}  {Promise<boolean>} 是否删除成功（确认取消或持久化失败返回false）
+     * @memberof AiTopicController
+     */
+    batchRemoveScopes(scopeids: Array<string | number | undefined>): Promise<boolean>;
     /**
      * @description 删除用户自定义分组：真删该分组下所有会话数据
      * @param {string} groupid 分组标识