@ibiz-template-plugin/ai-chat 0.0.111 → 0.0.113

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

@@ -197,6 +197,10 @@ export declare class AiChatController {
      * 选中知识库
      */
     selectionKnowledgeBases: Signal<string[]>;
+    /**
+     * 选中项目
+     */
+    selectionProject: string | undefined;
     /**
      * 当前可选知识库
      */
@@ -527,12 +531,13 @@ export declare class AiChatController {
      * 重置对话（清空当前对话、查询历史）
      * @returns
      */
-    resetTopic(): Promise<boolean>;
+    resetTopicMessage(): Promise<boolean>;
     /**
      * 清空对话
+     * @param {boolean} [isConfirm=true] 是否需要确认提示，外部直接调用时弹出，内部（重置）调用时跳过
      * @returns
      */
-    clearTopic(): Promise<boolean>;
+    clearTopicMessage(isConfirm?: boolean): Promise<boolean>;
     /**
      * 新增素材资源
      *
@@ -607,6 +612,18 @@ export declare class AiChatController {
      * @returns
      */
     searchAIAgent(query: string): Promise<AIAgent[]>;
+    /**
+     * @description 搜索项目
+     * @param {string} [file_path='']
+     * @param {string} [pattern='']
+     * @returns {*}  {Promise<{ id: string; label: string; isLeaf: boolean }[]>}
+     * @memberof AiChatController
+     */
+    searchProject(file_path?: string, pattern?: string): Promise<{
+        id: string;
+        label: string;
+        isLeaf: boolean;
+    }[]>;
     /**
      * 设置选中知识库
      * @param ids

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

@@ -1,6 +1,7 @@
 import { Signal } from '@preact/signals';
 import { ChatTopic } from '../../entity';
-import { ITopic, ITopicOptions, IResourceOptions, IChatController } from '../../interface';
+import { ITopic, ITopicOptions, IResourceOptions, IChatController, IGroupItem, IScopeItem, ITopicGroupNode } from '../../interface';
+import { AiChatController } from '../ai-chat/ai-chat.controller';
 
 /**
  * ai话题控制器
@@ -51,6 +52,14 @@ export declare class AiTopicController {
      * @type {Signal<boolean>}
      */
     readonly isTempChat: Signal<boolean>;
+    /**
+     * 是否处于多选模式
+     */
+    readonly isSelectMode: Signal<boolean>;
+    /**
+     * 多选模式下已选中的话题id集合
+     */
+    readonly selectedTopicIds: Signal<Set<string>>;
     /**
      * 当前话题配置备份
      *
@@ -90,6 +99,31 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     compWrapperId: string;
+    /**
+     * @description 工作模式，默认值，会话数据以列表显示; WORKSPACE：工作区，会话数据分为域（scope）、会话分组分层显示
+     * @type {('DEFAULT' | 'WORKSPACE')}
+     * @memberof AiTopicController
+     */
+    workMode: 'DEFAULT' | 'WORKSPACE';
+    /**
+     * @description 业务域列表（WORKSPACE 工作模式使用）
+     * @type {IScopeItem[]}
+     * @memberof AiTopicController
+     */
+    scopeList: IScopeItem[];
+    /**
+     * @description 用户自定义分组清单（WORKSPACE 工作模式使用）
+     * @type {Signal<IGroupItem[]>}
+     * @memberof AiTopicController
+     */
+    readonly groups: Signal<IGroupItem[]>;
+    /**
+     * @description 分组存储服务实例（'aigroups'，与会话数据 'aitopics' 区分）
+     * @private
+     * @type {(IConfigService | undefined)}
+     * @memberof AiTopicController
+     */
+    private groupConfig;
     /**
      * Creates an instance of AiTopicController.
      * @author tony001
@@ -97,6 +131,15 @@ export declare class AiTopicController {
      * @param {IChatController} chat
      */
     constructor(chat: IChatController);
+    /**
+     * @description 判断话题是否正在与AI会话中
+     * @author tony001
+     * @date 2026-09-28 10:09:00
+     * @param {string} topicId 话题标识
+     * @returns {*}  {boolean}
+     * @memberof AiTopicController
+     */
+    isTopicGenerating(topicId: string): boolean;
     /**
      * 设置激活话题
      * @param topic 话题数据
@@ -106,7 +149,7 @@ export declare class AiTopicController {
      * 注入组件外层容器id
      * @param compWrapperId
      */
-    injectCompWrapperId(compWrapperId: string): void;
+    injectBasicResources(compWrapperId: string, workMode: 'DEFAULT' | 'WORKSPACE', scopeList?: IScopeItem[]): void;
     /**
      * 注入资源选项
      * @param resourceOptions
@@ -144,6 +187,23 @@ export declare class AiTopicController {
      * @param topicid 话题标识
      */
     updateTopicChatByID(topicid: string, args: Record<string, any>): Promise<void>;
+    /**
+     * @description 构建话题远程 ui_meta 数据
+     * @private
+     * @param {ChatTopic} topic 话题数据
+     * @param {Record<string, any>} [args] 需合并进aiChat的附加数据
+     * @returns {*}  {Record<string, any>}
+     * @memberof AiTopicController
+     */
+    private buildTopicUiMeta;
+    /**
+     * @description 更新话题远程会话的 ui_meta 数据（存在真实id直接更新；否则基于sessionid查询后更新）
+     * @private
+     * @param {ChatTopic} topic 话题数据
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    private updateTopicRemoteMeta;
     /**
      * 删除话题
      *
@@ -153,10 +213,10 @@ export declare class AiTopicController {
      * @param {object} context
      * @param {object} params
      * @param {ITopic} data
-     * @param {MouseEvent} event
+     * @param {MouseEvent} _event
      * @return {*}  {Promise<void>}
      */
-    removeTopic(options: ITopicOptions, context: object, params: object, data: ITopic, event: MouseEvent): Promise<void>;
+    removeTopic(options: ITopicOptions, context: object, params: object, data: ITopic, _event: MouseEvent): Promise<void>;
     /**
      * 删除远程会话数据
      * 存在真实id，则删除远程session数据；不存在真实id，先基于sessionid查询，如果存在则删除，不存在视为删除成功
@@ -191,14 +251,18 @@ export declare class AiTopicController {
      * @date 2025-03-18 18:03:49
      * @return {*}  {Promise<void>}
      */
-    newTopic(topicid: string, args: Record<string, any>): Promise<void>;
+    newTopic(topicid: string, args: Record<string, any>, extra?: {
+        scope?: string | number;
+        groupid?: string;
+    }): Promise<void>;
     /**
      * 清空话题
      * - 当前激活项不清空
+     * @param {boolean} [clearGroups=false] 是否同时清空自定义分组数据（WORKSPACE 工作模式）
      * @return {*}  {Promise<void>}
      * @memberof AiTopicController
      */
-    clearTopic(): Promise<void>;
+    clearTopic(clearGroups?: boolean): Promise<void>;
     /**
      * 清空远程会话数据(排除指定会话)
      * 激活会话存在会话标识时，清空其余会话；不存在时视为成功
@@ -207,6 +271,28 @@ export declare class AiTopicController {
      * @return {*}  {Promise<boolean>}
      */
     private clearRemoteSession;
+    /**
+     * 进入多选模式
+     *
+     * @param {string} [topicId] 默认选中的话题id，未传则仅进入多选模式
+     */
+    enterSelectMode(topicId?: string): void;
+    /**
+     * 退出多选模式并清空选中
+     */
+    exitSelectMode(): void;
+    /**
+     * 切换话题选中状态（多选模式）
+     *
+     * @param {string} id 话题id
+     */
+    toggleTopicSelected(id: string): void;
+    /**
+     * 获取多选模式下已选中的话题
+     *
+     * @return {*}  {ChatTopic[]}
+     */
+    private getSelectedTopics;
     /**
      * 更新话题标题
      * @param topicId
@@ -246,9 +332,11 @@ export declare class AiTopicController {
     switchTopicSidebarCollapse(): void;
     /**
      * 全局新建会话
+     * @param scope 业务域标识（WORKSPACE 工作模式）
+     * @param groupid 自定义分组标识（WORKSPACE 工作模式）
      * @returns
      */
-    globalNewTopic(): void;
+    globalNewTopic(scope?: string | number, groupid?: string): void;
     /**
      * 进入临时会话
      */
@@ -267,4 +355,144 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     private handleAction;
+    /**
+     * @description 批量收集话题真实id，话题存在真实id直接使用；否则基于sessionid查询，查不到则忽略该话题
+     * @private
+     * @param {ChatTopic[]} topics 话题列表
+     * @returns {*}  {Promise<string[]>} 真实id列表
+     * @memberof AiTopicController
+     */
+    private resolveTopicRealIds;
+    /**
+     * @description 批量删除会话
+     * @private
+     * @param {ChatTopic[]} selectedTopics
+     * @returns {*}  {Promise<boolean>}
+     * @memberof AiTopicController
+     */
+    private batchDeleteRemoteSession;
+    /**
+     * @description 批量置顶，将所有选中话题统一置为置顶状态并持久化，完成后退出多选模式
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    batchPinTop(): Promise<void>;
+    /**
+     * @description 批量取消置顶，将所有选中话题统一置为未置顶状态并持久化，完成后退出多选模式
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    batchUnPinTop(): Promise<void>;
+    /**
+     * @description 批量删除，删除前统一走一次 beforeDelete 校验，完成后退出多选模式
+     * @param {MouseEvent} [_event]
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    batchDeleteTopics(_event?: MouseEvent): Promise<void>;
+    /**
+     * @description 批量删除话题内核：删除前统一走一次 beforeDelete 校验，真删存储数据并同步界面
+     * @private
+     * @param {ChatTopic[]} targetTopics 待删除话题
+     * @param {string} [confirmTitle] 删除确认标题，默认为批量删除文案
+     * @param {string} [confirmDescription] 删除确认描述，默认为批量删除文案
+     * @returns {*}  {Promise<boolean>} 是否删除成功
+     * @memberof AiTopicController
+     */
+    private deleteTopicsCore;
+    /**
+     * @description 获取分组存储服务实例（'aigroups'，与会话数据 'aitopics' 区分）
+     * @private
+     * @param {ITopicOptions} options 话题配置
+     * @returns {*}  {IConfigService}
+     * @memberof AiTopicController
+     */
+    private getGroupConfig;
+    /**
+     * @description 加载用户自定义分组数据
+     * @param {ITopicOptions} options 话题配置
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    fetchGroups(options: ITopicOptions): Promise<void>;
+    /**
+     * @description 保存用户自定义分组数据
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    private saveGroups;
+    /**
+     * @description 计算分组树（WORKSPACE 工作模式）：业务域第一层，自定义分组第二层，其后为话题
+     * @param {string} [query] 快速搜索关键词
+     * @returns {*}  {ITopicGroupNode[]}
+     * @memberof AiTopicController
+     */
+    computeGroupTree(query?: string): ITopicGroupNode[];
+    /**
+     * @description 判断话题是否属于无分类（无scope、scope为空或scope不在scopeList中）
+     * @private
+     * @param {ChatTopic} topic 话题数据
+     * @returns {*}  {boolean}
+     * @memberof AiTopicController
+     */
+    private isUnclassifiedTopic;
+    /**
+     * @description 新增用户自定义分组
+     * @param {(string | number)} [scopeid] 所属业务域标识，不传表示无分类域（存储为NONE_SCOPE_ID标记）
+     * @returns {*}  {Promise<IGroupItem | undefined>} 成功返回新建分组数据，持久化失败返回undefined
+     * @memberof AiTopicController
+     */
+    addGroup(scopeid?: string | number): Promise<IGroupItem | undefined>;
+    /**
+     * @description 重命名用户自定义分组
+     * @param {string} groupid 分组标识
+     * @param {string} text 新分组名称
+     * @returns {*}  {Promise<IGroupItem | undefined>} 成功返回更新后的分组数据，分组不存在、名称为空、未变化或持久化失败返回undefined
+     * @memberof AiTopicController
+     */
+    renameGroup(groupid: string, text: string): Promise<IGroupItem | undefined>;
+    /**
+     * @description 切换用户自定义分组折叠状态（持久化）
+     * @param {string} groupid 分组标识
+     * @returns {*}  {Promise<void>}
+     * @memberof AiTopicController
+     */
+    toggleGroupCollapse(groupid: string): Promise<void>;
+    /**
+     * @description 删除业务域：真删该域下所有分组和会话数据；不传scopeid表示删除无分类域
+     * @param {(string | number)} [scopeid] 业务域标识
+     * @returns {*}  {Promise<boolean>} 是否删除成功
+     * @memberof AiTopicController
+     */
+    removeScope(scopeid?: string | number): Promise<boolean>;
+    /**
+     * @description 删除用户自定义分组：真删该分组下所有会话数据
+     * @param {string} groupid 分组标识
+     * @returns {*}  {Promise<boolean>} 是否删除成功
+     * @memberof AiTopicController
+     */
+    removeGroup(groupid: string): Promise<boolean>;
+    /**
+     * @description 移动话题至指定业务域或自定义分组（拖拽），并持久化
+     * @param {string} topicid 话题标识
+     * @param {(string | number)} [scope] 目标业务域标识，无分类节点传 undefined 清除归属
+     * @param {string} [groupid] 目标自定义分组标识
+     * @returns {*}  {Promise<boolean>} 是否移动成功（归属未变化视为成功）
+     * @memberof AiTopicController
+     */
+    moveTopic(topicid: string, scope?: string | number, groupid?: string): Promise<boolean>;
+    /**
+     * @description 基于归一化字符串还原scopeList中的原始scope标识（dataset取值为字符串）
+     * @private
+     * @param {(string | number)} scopeid 归一化后的业务域标识
+     * @returns {*}  {(string | number)}
+     * @memberof AiTopicController
+     */
+    private getOriginScopeId;
+    /**
+     * @description 获取聊天控制器
+     * @returns {*}  {(AiChatController | undefined)}
+     * @memberof AiTopicController
+     */
+    getAiChat(): AiChatController | undefined;
 }

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

@@ -54,6 +54,15 @@ export declare abstract class ChatBaseController implements IChatController {
      * @memberof ChatBaseController
      */
     get aiChat(): AiChatController | undefined;
+    /**
+     * @description 基于话题id获取对应聊天控制器
+     * @author tony001
+     * @date 2026-09-28 10:09:00
+     * @param {string} topicId
+     * @returns {*}  {(AiChatController | undefined)}
+     * @memberof ChatBaseController
+     */
+    getAiChatControllerByTopicId(topicId: string): AiChatController | undefined;
     /**
      * @description 话题map
      * @author tony001
@@ -148,4 +157,14 @@ export declare abstract class ChatBaseController implements IChatController {
      * @memberof ChatBaseController
      */
     close(): void;
+    /**
+     * @description 组件失活事件
+     * @memberof ChatBaseController
+     */
+    onDeactivated(): void;
+    /**
+     * @description 组件激活事件
+     * @memberof ChatBaseController
+     */
+    onActivated(): void;
 }

package/dist/types/entity/chart-topic/chart-topic.d.ts

@@ -25,5 +25,7 @@ export declare class ChatTopic implements ITopic {
     get isShow(): boolean;
     get disableStorage(): boolean;
     get captionComputed(): boolean;
+    get scope(): ITopic['scope'];
+    get groupid(): ITopic['groupid'];
     constructor(data: ITopic);
 }

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

@@ -50,3 +50,7 @@ export { TotalTokensSvg } from './statistics/total-tokens-svg';
 export { InputTokensSvg } from './statistics/input-tokens-svg';
 export { OutputTokensSvg } from './statistics/output-tokens-svg';
 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 { SolidDownSvg } from './solid-down-svg';

package/dist/types/icons/list-checkbox-svg.d.ts

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

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

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

package/dist/types/icons/solid-down-svg.d.ts

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

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

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

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

@@ -27,4 +27,11 @@ export interface IChatController {
      * @memberof IChatController
      */
     switchAiChatController(topic: ChatTopic): void;
+    /**
+     * @description 基于话题id获取对应聊天控制器
+     * @param {string} topicId
+     * @returns {*}  {(AiChatController | undefined)}
+     * @memberof IChatController
+     */
+    getAiChatControllerByTopicId(topicId: string): AiChatController | undefined;
 }

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

@@ -8,6 +8,7 @@ import { IKnowledgeBase } from '../i-knowledge-base/i-knowledge-base';
 import { ISpeechRecognition } from '../i-speech-recognition/i-speech-recognition';
 import { Locale } from '../../locale';
 import { IConfirmUtil, IMessageUtil, INotificationUtil } from '../util';
+import { IProject } from '../i-project/i-project';
 
 /**
  * 聊天数据
@@ -222,6 +223,12 @@ export interface IChatOptions extends IChat {
      * @type {boolean}
      */
     enableKnowledgeBaseSelect: boolean;
+    /**
+     * @description 是否启用AI项目功能
+     * @type {boolean}
+     * @memberof IChatOptions
+     */
+    enableAIProject: boolean;
     /**
      * 话题标题计算模式
      *
@@ -307,7 +314,7 @@ export interface IChatOptions extends IChat {
      * @param {IChatMessage[]} question 提问历史内容(包含当前提问)
      * @return {*}  {Promise<boolean>} 等待回答，用于显示 loading 并获取最终成功与否
      */
-    question(aiChat: AiChatController, context: object, params: object, otherParams: object, question: IChatMessage[], sessionid: string, srfaiagent: string | undefined, srfmode: string | undefined, srfscope: string | undefined, srfaiknowledgebases: string | undefined, srfaiagentconfig: IAIAgentConfig | undefined, appendcurdata: object | undefined, srfmcpservers: string | undefined, srfsessionmeta: object | undefined): Promise<boolean>;
+    question(aiChat: AiChatController, context: object, params: object, otherParams: object, question: IChatMessage[], sessionid: string, srfaiagent: string | undefined, srfmode: string | undefined, srfscope: string | undefined, srfaiknowledgebases: string | undefined, srfaiagentconfig: IAIAgentConfig | undefined, appendcurdata: object | undefined, srfmcpservers: string | undefined, srfsessionmeta: object | undefined, srfproject: string | undefined): Promise<boolean>;
     /**
      * 中断消息
      * @param aiChat
@@ -387,6 +394,17 @@ export interface IChatOptions extends IChat {
         query?: string;
         knowledgebases?: string;
     }) => Promise<IKnowledgeBase[]>;
+    /**
+     * @description 查询项目
+     * @memberof IChatOptions
+     */
+    fetchProject?: (context: object, params: object, other: {
+        srfaiagent: string;
+        sessionid: string;
+        pattern: string;
+        file_path: string;
+        max_depth: number;
+    }) => Promise<IProject[]>;
     /**
      * 文件上传配置
      *

package/dist/types/interface/i-project/i-project.d.ts

@@ -0,0 +1,14 @@
+export interface IProject {
+    /**
+     * 项目名称
+     */
+    name: string;
+    /**
+     * 项目类型
+     */
+    type: string;
+    /**
+     * 子项目
+     */
+    children?: IProject[];
+}

package/dist/types/interface/i-remote-resource/i-remote-resource.d.ts

@@ -28,6 +28,12 @@ export interface IRemoteSession {
      * @description 会话元数据
      */
     ui_meta: string;
+    /**
+     * @description 作用域
+     * @type {string}
+     * @memberof IRemoteSession
+     */
+    scope: string;
 }
 /**
  * @description 远程消息接口

package/dist/types/interface/i-resource-options/i-resource-options.d.ts

@@ -56,6 +56,27 @@ export interface IResourceOptions {
      * @param excludeSessionID 排除会话的会话id
      */
     clearAllSession(excludeSessionID: string): Promise<boolean>;
+    /**
+     * @description 批量删除会话
+     * @param {string[]} realIDs 会话真实id集合
+     * @returns {*}  {Promise<boolean>}
+     * @memberof IResourceOptions
+     */
+    batchDeleteSession(realIDs: string[]): Promise<boolean>;
+    /**
+     * @description 批量置顶会话
+     * @param {string[]} realIDs 会话真实id集合
+     * @returns {*}  {Promise<boolean>}
+     * @memberof IResourceOptions
+     */
+    batchTopSession(realIDs: string[]): Promise<boolean>;
+    /**
+     * @description 批量取消置顶会话
+     * @param {string[]} realIDs 会话真实id集合
+     * @returns {*}  {Promise<boolean>}
+     * @memberof IResourceOptions
+     */
+    batchUnTopSession(realIDs: string[]): Promise<boolean>;
     /**
      * 清空指定会话的所有消息
      * @param realID