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

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

@@ -1,6 +1,6 @@
 import { Component, JSX } from 'preact';
 import { Namespace } from '../../utils';
-import { AiChatController, AiTopicController } from '../../controller';
+import { AiActionPanelController, AiChatController, AiTopicController } from '../../controller';
 import { IAutoClose, IChatToolbarItem, IChatContainerOptions } from '../../interface';
 
 export interface ChatContainerProps {
@@ -101,6 +101,13 @@ export interface ChatContainerProps {
      * 是否加载中
      */
     isLoading: boolean;
+    /**
+     * 操作区面板控制器
+     *
+     * @type {AiActionPanelController}
+     * @memberof ChatContainerProps
+     */
+    actionPanel?: AiActionPanelController;
 }
 /**
  * 容器状态
@@ -152,6 +159,13 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 已绑定事件监听的聊天控制器实例（用于切换 aiChat 时重绑）
      */
     private listenedAIChat?;
+    /**
+     * @description 拖拽实例
+     * @private
+     * @type {(Interactable | undefined)}
+     * @memberof ChatContainer
+     */
+    private interactable;
     /**
      * 消息完成事件回调
      */
@@ -162,6 +176,38 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
     private onMinimizeChangeHandler;
     listener(): void;
     componentDidUpdate(): void;
+    /**
+     *
+     * 同步操作区面板状态（visible 边沿触发窗口宽度增减与位置适配，展开收起动画由 CSS 过渡完成）
+     *
+     * @memberof ChatContainer
+     */
+    syncPanelState(): void;
+    /**
+     * 打开操作区面板：窗口增宽面板占用（面板 + 分隔条），右边界不够时压缩面板宽度，仍不够则窗口左移补足
+     *
+     * @param {AiActionPanelController} panel
+     * @memberof ChatContainer
+     */
+    handlePanelOpen(panel: AiActionPanelController): void;
+    /**
+     * 关闭操作区面板：窗口宽度回落面板占用（面板 + 分隔条），并回退打开时的窗口左移量
+     *
+     * @memberof ChatContainer
+     */
+    handlePanelClose(): void;
+    /**
+     * 恢复面板打开期间为适配右边界所做的窗口左移量
+     */
+    restorePanelShift(): void;
+    /**
+     * 面板打开后适配屏幕右边界（全屏时窗口铺满屏幕无需适配）
+     * - 先压缩面板宽度（窗口总宽同步回落），仍溢出则窗口左移补足
+     *
+     * @param {AiActionPanelController} panel
+     * @memberof ChatContainer
+     */
+    fitPanelToViewport(panel: AiActionPanelController): void;
     ns: Namespace;
     containerRef: import('preact').RefObject<HTMLDivElement>;
     dragHandle: import('preact').RefObject<HTMLDivElement>;
@@ -176,16 +222,16 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      */
     data: {
         side: {
+            x: number;
             y: number;
-            height: number;
             width: number;
-            x: number;
+            height: number;
         };
         window: {
+            x: number;
             y: number;
             width: number;
             height: number;
-            x: number;
         };
         minWidth: number;
         minHeight: number;
@@ -224,6 +270,18 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 输入区高度拖动时其父容器高度(px)
      */
     inputDragContainerHeight: number;
+    /**
+     * 操作区面板上一帧显示状态（用于 componentDidUpdate 边沿检测）
+     */
+    private panelVisiblePrev;
+    /**
+     * 操作区面板打开导致的窗口左移量(px)，关闭面板时恢复（不持久化）
+     */
+    private panelShiftPx;
+    /**
+     * 操作区面板宽度拖动起始值(px)
+     */
+    private panelDragStartWidth;
     /**
      * 容器上下文
      *
@@ -249,6 +307,7 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
     };
     /**
      * 计算靠边模式样式
+     * - 贴右模式下面板打开时窗口整体左移，保证右边缘不超出屏幕
      *
      * @param {('left' | 'right')} side
      * @memberof ChatContainer
@@ -393,6 +452,24 @@ export declare class ChatContainer extends Component<ChatContainerProps, ChatCon
      * 提交拖动边框后的输入区高度（持久化到状态与本地缓存）
      */
     commitInputHeight: () => void;
+    /**
+     * 操作区面板宽度拖动开始
+     */
+    handlePanelResizeStart: () => void;
+    /**
+     * 操作区面板宽度拖动中
+     * - 向左拖：主内容区变窄、面板变宽；向右拖反之
+     */
+    handlePanelResizeMove: (delta: number) => void;
+    /**
+     * 操作区面板宽度拖动结束（持久化）
+     */
+    handlePanelResizeEnd: () => void;
+    /**
+     * 绘制右侧操作区（含分隔条）
+     * - DOM 常驻，宽度随 visible 切换由 CSS 过渡展开/收起
+     */
+    renderActionRegion(): JSX.Element | null;
     render(): JSX.Element;
 }
 export {};

package/dist/types/components/chat-editor/node/mention-node.d.ts

@@ -0,0 +1,3 @@
+import { Node } from '@tiptap/core';
+
+export declare const MentionNode: Node<any, any>;

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

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

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

@@ -0,0 +1,16 @@
+
+interface BreadcrumbProps {
+    /**
+     * 当前路径（根 -> 当前层）
+     */
+    path: {
+        id: string;
+        label: string;
+    }[];
+    /**
+     * 点击某一层跳转，-1 表示回到根
+     */
+    onJump: (index: number) => void;
+}
+export declare const Breadcrumb: (props: BreadcrumbProps) => import("preact").JSX.Element;
+export {};

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

@@ -0,0 +1,59 @@
+import { LazyTreeNode } from '../lazy-tree/lazy-tree';
+
+interface LazyListTreeProps {
+    /**
+     * 根节点数据
+     */
+    nodes: LazyTreeNode[];
+    /**
+     * 异步加载子节点方法
+     * 返回子节点数组
+     */
+    lazyLoad?: (node: LazyTreeNode) => Promise<LazyTreeNode[]>;
+    /**
+     * 节点选中回调
+     */
+    onNodeCheck?: (node: LazyTreeNode, checked: boolean) => void;
+    /**
+     * 节点点击回调
+     */
+    onNodeClick?: (node: LazyTreeNode, event: MouseEvent) => void;
+    /**
+     * 节点展开回调
+     */
+    onNodeExpand?: (node: LazyTreeNode, expanded: boolean) => void;
+    /**
+     * 路径变化回调，用于父组件同步面包屑
+     */
+    onPathChange?: (path: LazyTreeNode[]) => void;
+    /**
+     * 受控路径（根 -> 当前层），由父组件传入
+     */
+    path?: LazyTreeNode[];
+    /**
+     * 是否显示搜索框
+     */
+    showSearch?: boolean;
+    /**
+     * 默认选中keys
+     */
+    defaultCheckedKeys?: string[];
+    /**
+     * 高亮选中
+     */
+    highlight?: boolean;
+    /**
+     * 标识分隔符
+     */
+    separator?: string;
+    /**
+     * 过滤值
+     */
+    filter?: string;
+    /**
+     * 是否可拖拽
+     */
+    draggable?: boolean;
+}
+export declare const LazyListTree: (props: LazyListTreeProps) => import("preact").JSX.Element;
+export {};

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

@@ -40,8 +40,12 @@ export interface LazyTreeNode {
      * 自定义图标
      */
     icon?: string;
+    /**
+     * 原始数据
+     */
+    data: Record<string, any>;
 }
-export interface LazyTreeProps {
+interface LazyTreeProps {
     /**
      * 根节点数据
      */
@@ -63,6 +67,14 @@ export interface LazyTreeProps {
      * 节点展开回调
      */
     onNodeExpand?: (node: LazyTreeNode, expanded: boolean) => void;
+    /**
+     * 当前活动路径变化回调（用户最后点击/展开的路径）
+     */
+    onActivePathChange?: (path: LazyTreeNode[]) => void;
+    /**
+     * 当前激活路径
+     */
+    activePath?: LazyTreeNode[];
     /**
      * 是否显示搜索框
      */
@@ -75,6 +87,10 @@ export interface LazyTreeProps {
      * 高亮选中
      */
     highlight?: boolean;
+    /**
+     * 高亮选中父节点
+     */
+    highlightParent?: boolean;
     /**
      * 是否在点击节点的时候展开或者收缩节点
      */
@@ -83,6 +99,14 @@ export interface LazyTreeProps {
      * 标识分隔符
      */
     separator?: string;
+    /**
+     * 过滤值
+     */
+    filter?: string;
+    /**
+     * 是否可拖拽
+     */
+    draggable?: boolean;
 }
 /**
  * 懒加载树组件
@@ -90,3 +114,4 @@ export interface LazyTreeProps {
  * 具有懒加载、搜索、展开折叠等功能
  */
 export declare const LazyTree: (props: LazyTreeProps) => import("preact").JSX.Element;
+export {};

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

@@ -1,6 +1,7 @@
 import { Component, RefObject, JSX } from 'preact';
 import { Namespace } from '../../utils';
 import { AiChatController, AiTopicController } from '../../controller';
+import { AiActionPanelController } from '../../controller/ai-action-panel/ai-action-panel.controller';
 import { IChatToolbarItem, IExtensionOptions } from '../../interface';
 
 export interface FlatChatContainerProps {
@@ -54,6 +55,12 @@ export interface FlatChatContainerProps {
      * @memberof FlatChatContainerProps
      */
     extension?: IExtensionOptions;
+    /**
+     * @description 操作区面板控制器
+     * @type {AiActionPanelController}
+     * @memberof FlatChatContainerProps
+     */
+    actionPanel?: AiActionPanelController;
 }
 interface FlatContainerContext {
     enableBackFill: boolean;
@@ -92,6 +99,14 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * 输入区高度拖动时其父容器高度(px)
      */
     inputDragContainerHeight: number;
+    /**
+     * 操作区面板上一帧显示状态（用于 componentDidUpdate 边沿检测）
+     */
+    private panelVisiblePrev;
+    /**
+     * 操作区面板宽度拖动起始值(px)
+     */
+    private panelDragStartWidth;
     state: {
         mountedSlots: Record<string, boolean>;
         inputHeight: number | null;
@@ -116,6 +131,11 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * @memberof FlatChatContainer
      */
     componentDidUpdate(prevProps: FlatChatContainerProps): void;
+    /**
+     * @description 同步操作区面板状态（展开收起动画由 CSS 过渡完成）
+     * @memberof FlatChatContainer
+     */
+    syncPanelState(): void;
     /**
      * @description 异步挂载扩展插槽
      * @private
@@ -153,6 +173,19 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * 侧栏宽度拖动结束
      */
     handleSidebarResizeEnd: () => void;
+    /**
+     * 操作区面板宽度拖动开始
+     */
+    handlePanelResizeStart: () => void;
+    /**
+     * 操作区面板宽度拖动中
+     * - 向左拖：主内容区变窄、面板变宽；向右拖反之
+     */
+    handlePanelResizeMove: (delta: number) => void;
+    /**
+     * 操作区面板宽度拖动结束（持久化）
+     */
+    handlePanelResizeEnd: () => void;
     /**
      * @description 获取输入区高度缓存key
      * @returns {string}
@@ -189,6 +222,12 @@ export declare class FlatChatContainer extends Component<FlatChatContainerProps>
      * @memberof FlatChatContainer
      */
     renderHeader(): JSX.Element;
+    /**
+     * @description 绘制右侧操作区（含分隔条）
+     * - DOM 常驻，宽度随 visible 切换由 CSS 过渡展开/收起
+     * @memberof FlatChatContainer
+     */
+    renderActionRegion(): JSX.Element | null;
     render(): JSX.Element;
 }
 export {};

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

@@ -1,4 +1,5 @@
 export { ChatContainer } from './chat-container/chat-container';
 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';

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

@@ -18,6 +18,14 @@ export declare enum AIChatConst {
      * 聊天输入区高度缓存
      */
     INPUT_HEIGHT = "ai-chat-input-height",
+    /**
+     * 操作区面板宽度缓存
+     */
+    ACTION_PANEL_WIDTH = "ai-chat-action-panel-width",
+    /**
+     * 操作区面板默认宽度(px)
+     */
+    ACTION_PANEL_DEFAULT_WIDTH = 380,
     /**
      * 数据库名称
      */

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

@@ -0,0 +1,102 @@
+import { Signal } from '@preact/signals';
+import { TActionPanelComponent } from '../../interface';
+
+/**
+ * 将操作区面板宽度校正到合理区间 [最小宽度, 容器宽度/3]
+ *
+ * @param {number} width 目标宽度
+ * @param {number} containerWidth 容器整体宽度
+ * @returns {*} {number}
+ */
+export declare function clampPanelWidth(width: number, containerWidth: number): number;
+/**
+ * 操作区面板控制器
+ * - 面板为容器级单例，挂在 ChatBaseController 上，切话题不重建
+ * - 展开收起动画由容器 CSS 过渡完成，控制器不参与
+ *
+ * @export
+ * @class AiActionPanelController
+ */
+export declare class AiActionPanelController {
+    /**
+     * 面板是否显示
+     */
+    readonly visible: Signal<boolean>;
+    /**
+     * 面板当前宽度(px)
+     */
+    readonly width: Signal<number>;
+    /**
+     * 面板标题
+     */
+    readonly caption: Signal<string>;
+    /**
+     * 面板内容组件
+     */
+    readonly component: Signal<TActionPanelComponent | undefined>;
+    /**
+     * 内容组件额外参数
+     */
+    readonly params: Signal<Record<string, any> | undefined>;
+    /**
+     * 组件外层容器id（用于宽度缓存隔离）
+     */
+    private compWrapperId;
+    /**
+     * 打开操作区面板
+     * - 已打开时仅替换标题、内容组件与额外参数
+     * - 首次打开时从缓存恢复面板宽度（无缓存则沿用当前值）
+     *
+     * @param {string} caption 标题
+     * @param {TActionPanelComponent} component 内容组件
+     * @param {Record<string, any>} [params] 额外参数（作为内容组件props传入）
+     * @memberof AiActionPanelController
+     */
+    open(caption: string, component: TActionPanelComponent, params?: Record<string, any>): void;
+    /**
+     * 关闭操作区面板（收起动画由容器 CSS 过渡完成）
+     *
+     * @memberof AiActionPanelController
+     */
+    close(): void;
+    /**
+     * 更新面板宽度
+     *
+     * @param {number} px 宽度(px)
+     * @memberof AiActionPanelController
+     */
+    updateWidth(px: number): void;
+    /**
+     * 提交当前宽度（持久化）
+     *
+     * @memberof AiActionPanelController
+     */
+    commitWidth(): void;
+    /**
+     * 注入组件外层容器id
+     *
+     * @param {string} id
+     * @memberof AiActionPanelController
+     */
+    injectCompWrapperId(id: string): void;
+    /**
+     * 读取宽度缓存
+     *
+     * @returns {*} {(number | undefined)}
+     * @memberof AiActionPanelController
+     */
+    readWidthCache(): number | undefined;
+    /**
+     * 重置全部状态（整个聊天窗口关闭时调用）
+     *
+     * @memberof AiActionPanelController
+     */
+    reset(): void;
+    /**
+     * 获取宽度缓存key
+     *
+     * @returns {string}
+     * @memberof AiActionPanelController
+     */
+    private getCacheKey;
+}

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

@@ -1,8 +1,9 @@
 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, IProject, IMaterial, IChatMessage, IChatOptions, IChatUIAction, IAIAgentConfig, IProjectParams, IChatSuggestion, IResourceOptions, IChatMessageUsage, ITopicOptions } from '../../interface';
 import { AiTopicController } from '../ai-topic/ai-topic.controller';
+import { AiActionPanelController } from '../ai-action-panel/ai-action-panel.controller';
 
 /**
  * 聊天逻辑控制器
@@ -171,6 +172,10 @@ export declare class AiChatController {
      * 话题控制器
      */
     readonly aiTopic: AiTopicController | undefined;
+    /**
+     * 操作区面板控制器（容器级单例，由聊天总控制器注入）
+     */
+    readonly actionPanel: AiActionPanelController | undefined;
     /**
      * @description 聊天sessionid
      * @type {string}
@@ -204,7 +209,7 @@ export declare class AiChatController {
     /**
      * 选中项目
      */
-    selectionProject: string | undefined;
+    activeAIProjectId: string | undefined;
     /**
      * 当前可选知识库
      */
@@ -352,6 +357,15 @@ export declare class AiChatController {
      * 加载更早的历史消息（滚动到列表顶部时调用）
      */
     loadHistoryMore(): Promise<void>;
+    /**
+     * @description 尝试恢复会话（如果会话存在异步行为标识才恢复，没有则认为会话已经完成，不需要恢复）
+     * @author tony001
+     * @date 2026-10-14 18:10:07
+     * @private
+     * @returns {*}  {Promise<void>}
+     * @memberof AiChatController
+     */
+    private tryResumeChat;
     /**
      * 获取历史记录后续处理(仅查询history接口时调用)
      */
@@ -622,16 +636,17 @@ export declare class AiChatController {
     searchAIAgent(query: string): Promise<AIAgent[]>;
     /**
      * @description 搜索项目
-     * @param {string} [file_path='']
-     * @param {string} [pattern='']
-     * @returns {*}  {Promise<{ id: string; label: string; isLeaf: boolean }[]>}
+     * @param {IProjectParams} params 查询参数
+     * @returns {*}  {Promise<IProject[]>}
      * @memberof AiChatController
      */
-    searchProject(file_path?: string, pattern?: string): Promise<{
-        id: string;
-        label: string;
-        isLeaf: boolean;
-    }[]>;
+    searchProject(params: IProjectParams): Promise<IProject[]>;
+    /**
+     * @description 设置选中项目目录
+     * @param {(string | undefined)} id
+     * @memberof AiChatController
+     */
+    setActiveAIProjectID(id: string | undefined): void;
     /**
      * 设置选中知识库
      * @param ids

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

@@ -2,6 +2,7 @@ import { ChatTopic } from '../../entity';
 import { IChatController, IContainerOptions, IResourceOptions } from '../../interface';
 import { AiChatController } from '../ai-chat/ai-chat.controller';
 import { AiTopicController } from '../ai-topic/ai-topic.controller';
+import { AiActionPanelController } from '../ai-action-panel/ai-action-panel.controller';
 
 /**
  * @description 聊天总控制器基类
@@ -45,6 +46,12 @@ export declare abstract class ChatBaseController implements IChatController {
      * @memberof ChatBaseController
      */
     aiTopic: AiTopicController;
+    /**
+     * @description 操作区面板控制器（容器级单例，切话题不重建）
+     * @type {AiActionPanelController}
+     * @memberof ChatBaseController
+     */
+    actionPanel: AiActionPanelController;
     /**
      * @description 聊天控制器
      * @author tony001

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

@@ -1,5 +1,6 @@
 export { AiChatController } from './ai-chat/ai-chat.controller';
 export { AiTopicController } from './ai-topic/ai-topic.controller';
+export { AiActionPanelController } from './ai-action-panel/ai-action-panel.controller';
 export { AIMaterialFactory } from './ai-material/ai-material-factory';
 export { ModalChatController, chat } from './chat/modal-chat.controller';
 export { FlatChatController, createFlatChat, } from './chat/flat-chat.controller';

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

@@ -53,3 +53,5 @@ export { ToolCallCountSvg } from './statistics/tool-call-count-svg';
 export { ListCheckBoxSvg } from './list-checkbox-svg';
 export { UnTopSvg } from './untop-svg';
 export { PlusSvg } from './plus-svg';
+export { ProjectSvg } from './project-svg';
+export { WorlSpaceSvg } from './workspace-svg';

package/dist/types/icons/project-svg.d.ts

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

package/dist/types/icons/workspace-svg.d.ts

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

package/dist/types/index.d.ts

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

package/dist/types/interface/i-action-panel/i-action-panel.d.ts

@@ -0,0 +1,24 @@
+import { ComponentType } from 'preact';
+
+/**
+ * 操作区内容组件props约定
+ *
+ * @export
+ * @interface IActionPanelContentProps
+ */
+export interface IActionPanelContentProps {
+    /**
+     * 关闭当前操作区面板（内容组件自关闭能力）
+     */
+    closePanel: () => void;
+    /**
+     * 额外参数（openActionPanel 第三参原样展开传入）
+     */
+    [key: string]: any;
+}
+/**
+ * 操作区内容组件类型
+ * - 内容组件 props 为 IActionPanelContentProps（closePanel + 额外参数展开），
+ *   但具体组件可能声明自己的必传 props，故放宽为 any 以兼容
+ */
+export type TActionPanelComponent = ComponentType<any>;