@ibiz-template-plugin/ai-chat 0.0.116 → 0.0.118

package/dist/types/interface/i-file-system-options/i-file-system-options.d.ts

@@ -1,6 +1,10 @@
 import { IFileItem } from '../i-file-item/i-file-item';
 
-interface IFileSystemParams {
+/**
+ * @description 查询文件列表参数
+ * @interface IFileSystemListParams
+ */
+interface IFileSystemListParams {
     sessionid: string;
     srfaiagent?: string;
     srfscope?: string;
@@ -9,28 +13,132 @@ interface IFileSystemParams {
     file_path?: string;
     only_dirs?: boolean;
 }
+/**
+ * @description 上传文件参数
+ * @interface IFileSystemUploadParams
+ */
 interface IFileSystemUploadParams {
     sessionid: string;
     file_path: string;
     srfaiagent?: string;
     srfscope?: string;
 }
+/**
+ * @description 新建目录参数
+ * @interface IFileSystemCreateParams
+ */
+interface IFileSystemCreateParams {
+    sessionid: string;
+    file_path: string;
+    srfaiagent?: string;
+    srfscope?: string;
+    create_parents?: boolean;
+    timeout?: number;
+}
+/**
+ * @description 新建文件参数
+ * @interface IFileSystemWriteParams
+ */
+interface IFileSystemWriteParams {
+    sessionid: string;
+    file_path: string;
+    content: string;
+    srfaiagent?: string;
+    srfscope?: string;
+    append?: boolean;
+    timeout?: number;
+}
+/**
+ * @description 移动文件参数
+ * @interface IFileSystemMoveParams
+ */
+interface IFileSystemMoveParams {
+    sessionid: string;
+    src: string;
+    dst: string;
+    srfaiagent?: string;
+    srfscope?: string;
+    overwrite?: boolean;
+    create_parents?: boolean;
+    timeout?: number;
+}
+/**
+ * @description 删除文件参数
+ * @interface IFileSystemDeleteParams
+ */
+interface IFileSystemDeleteParams {
+    sessionid: string;
+    file_path: string;
+    srfaiagent?: string;
+    srfscope?: string;
+    recursive?: boolean;
+    timeout?: number;
+}
+/**
+ * @description 读取文件参数
+ * @interface IFileSystemReadParams
+ */
+interface IFileSystemReadParams {
+    sessionid: string;
+    file_path: string;
+    srfaiagent?: string;
+    srfscope?: string;
+    offset?: number;
+    length?: number;
+    binary?: boolean;
+    timeout?: number;
+}
+/**
+ * @description 文件操作结果对象
+ * @interface IFileSystemResult
+ */
+interface IFileSystemResult {
+    ok: boolean;
+    action: 'MKDIR' | 'WRITE' | 'MOVE' | 'DELETE' | 'READ';
+    path: string;
+    transport: 'native' | 'command';
+    content?: string;
+    content_length?: number;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
 /**
  * @description 文件系统操作参数
  * @export
  * @interface IFileSystemOptions
  */
 export interface IFileSystemOptions {
+    /**
+     * @description 文件预览模式,默认值为DEFAULT
+     * @type {('DEFAULT' | 'CUSTOM')}
+     * @memberof IFileSystemOptions
+     */
+    filePreviewMode?: 'DEFAULT' | 'CUSTOM';
+    /**
+     * @description 获取自定义文件预览url
+     * @param {object} ctx
+     * @param {object} param
+     * @param {{ id: string; name: string; folder: string }} file
+     * @returns {*}  {Promise<string>}
+     * @memberof IFileSystemOptions
+     */
+    getCustomFilePreviewUrl?(ctx: object, param: object, file: {
+        id: string;
+        name: string;
+        folder: string;
+    }): Promise<string>;
     /**
      * @description 获取文件清单
      * @memberof IFileSystemOptions
      */
-    getFileList: (context: object, params: object, other: IFileSystemParams) => Promise<IFileItem | undefined>;
+    getFileList: (ctx: object, param: object, other: IFileSystemListParams) => Promise<IFileItem | undefined>;
     /**
      * @description 上传文件
      * @memberof IFileSystemOptions
      */
-    uploadFile: (context: object, params: object, other: IFileSystemUploadParams) => Promise<{
+    uploadFile: (ctx: object, param: object, other: IFileSystemUploadParams) => Promise<{
         id: string;
         name: string;
         folder: string;
@@ -57,5 +165,50 @@ export interface IFileSystemOptions {
      * @memberof IFileSystemOptions
      */
     getImgContent(ctx: object, param: object, id: string, type: string, cat: string): Promise<string>;
+    /**
+     * @description 新建文件夹
+     * @param {object} ctx
+     * @param {object} param
+     * @param {IFileSystemCreateParams} other
+     * @returns {*}  {Promise<IFileSystemResult>}
+     * @memberof IFileSystemOptions
+     */
+    createFolder(ctx: object, param: object, other: IFileSystemCreateParams): Promise<IFileSystemResult>;
+    /**
+     * @description 新建文件
+     * @param {object} ctx
+     * @param {object} param
+     * @param {IFileSystemWriteParams} other
+     * @returns {*}  {Promise<IFileSystemResult>}
+     * @memberof IFileSystemOptions
+     */
+    createFile(ctx: object, param: object, other: IFileSystemWriteParams): Promise<IFileSystemResult>;
+    /**
+     * @description 移动文件夹/文件，包含文件夹/文件重命名均调用此接口
+     * @param {object} ctx
+     * @param {object} param
+     * @param {IFileSystemMoveParams} other
+     * @returns {*}  {Promise<IFileSystemResult>}
+     * @memberof IFileSystemOptions
+     */
+    move(ctx: object, param: object, other: IFileSystemMoveParams): Promise<IFileSystemResult>;
+    /**
+     * @description 删除文件夹/文件
+     * @param {object} ctx
+     * @param {object} param
+     * @param {IFileSystemDeleteParams} other
+     * @returns {*}  {Promise<IFileSystemResult>}
+     * @memberof IFileSystemOptions
+     */
+    delete(ctx: object, param: object, other: IFileSystemDeleteParams): Promise<IFileSystemResult>;
+    /**
+     * @description 读文件内容
+     * @param {object} ctx
+     * @param {object} param
+     * @param {IFileSystemReadParams} other
+     * @returns {*}  {Promise<IFileSystemResult>}
+     * @memberof IFileSystemOptions
+     */
+    readFile(ctx: object, param: object, other: IFileSystemReadParams): Promise<IFileSystemResult>;
 }
 export {};

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

@@ -34,6 +34,12 @@ export interface IRemoteSession {
      * @memberof IRemoteSession
      */
     scope: string;
+    /**
+     * @description 智能体标识
+     * @type {string}
+     * @memberof IRemoteSession
+     */
+    context_code_name: string;
 }
 /**
  * @description 远程消息接口

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

@@ -0,0 +1,51 @@
+import { NodeConfig } from '@tiptap/core';
+
+/**
+ * @description TipTap扩展节点类型
+ * @export
+ * @enum {number}
+ */
+export declare enum TipTapNodeType {
+    FILE = "file"
+}
+/**
+ * @description TipTap拖拽数据
+ * @export
+ * @interface ITipTapDropData
+ */
+export interface ITipTapDropData {
+    /**
+     * @description 拖拽类型
+     * @type {TipTapNodeType}
+     * @memberof ITipTapDropData
+     */
+    type: TipTapNodeType;
+    /**
+     * @description 数据标识
+     * @type {string}
+     * @memberof ITipTapDropData
+     */
+    id: string;
+    /**
+     * @description 数据标题
+     * @type {string}
+     * @memberof ITipTapDropData
+     */
+    label: string;
+}
+/**
+ * 扩展的节点配置：在 Tiptap NodeConfig 基础上增加清洗相关配置
+ */
+export interface TipTapNodeConfig extends NodeConfig {
+    /**
+     * @description 节点在 getHTML() 输出中的表示
+     * @param el 该节点对应的 DOM 元素
+     * @returns 指定的html字符串
+     */
+    getHTML?: (el: Element) => string;
+    /**
+     * @description 用于定位该节点 DOM 的选择器
+     * 不传时默认使用 [data-type="节点名"]
+     */
+    htmlSelector?: string;
+}

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

@@ -4,6 +4,27 @@ import { IConfigService } from '../i-config-service/i-config-service';
 /**
  * @description 业务域数据
  * @export
+ * @interface IScopeOption
+ */
+export interface IScopeOption {
+    /**
+     * @description 值
+     * @type {(string | number)}
+     * @memberof IScopeOption
+     */
+    id: string | number;
+    /**
+     * @description 文本
+     * @type {string}
+     * @memberof IScopeOption
+     */
+    text: string;
+}
+/**
+ * @description 业务域项数据
+ * @author tony001
+ * @date 2026-10-20 14:10:18
+ * @export
  * @interface IScopeItem
  */
 export interface IScopeItem {
@@ -14,11 +35,17 @@ export interface IScopeItem {
      */
     id: string | number;
     /**
-     * @description 文本
-     * @type {string}
+     * @description 是否显示
+     * @type {boolean}
      * @memberof IScopeItem
      */
-    text: string;
+    visible: boolean;
+    /**
+     * @description 是否置顶
+     * @type {boolean}
+     * @memberof IScopeItem
+     */
+    istop: boolean;
 }
 /**
  * 会话分组数据
@@ -71,6 +98,18 @@ export interface ITopicGroupNode {
      * 显示文本
      */
     text: string;
+    /**
+     * @description 域节点是否显示（无存储记录默认 true），显隐由 UI 层控制
+     * @type {boolean}
+     * @memberof ITopicGroupNode
+     */
+    visible: boolean;
+    /**
+     * @description 域节点是否置顶（无存储记录默认 false）
+     * @type {boolean}
+     * @memberof ITopicGroupNode
+     */
+    istop: boolean;
     /**
      * 自定义分组子节点
      */
@@ -189,6 +228,12 @@ export interface ITopic {
      * @memberof ITopic
      */
     groupid?: string;
+    /**
+     * @description 绑定智能体标识
+     * @type {string}
+     * @memberof ITopic
+     */
+    context_code_name?: string;
     /**
      * 上下文
      *
@@ -235,10 +280,10 @@ export interface ITopicOptions extends ITopic {
     disableSelectScope?: boolean;
     /**
      * @description 域列表，当工作模式为WORKSPACE时必填
-     * @type {IScopeItem[]}
+     * @type {IScopeOption[]}
      * @memberof ITopicOptions
      */
-    scopeList?: IScopeItem[];
+    scopeList?: IScopeOption[];
     /**
      * @description 删除之前提示
      * @param {string} title

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

@@ -3,7 +3,7 @@ export type { IChat, IChatOptions } from './i-chat-options/i-chat-options';
 export type { IMessageItemProvider } from './i-message-item-provider/i-message-item-provider';
 export type { IPortalAsyncAction } from './i-portal-async-action/i-portal-async-action';
 export type { IChatToolbarItem } from './i-chat-toolbar-item/i-chat-toolbar-item';
-export type { ITopic, ITopicOptions, IScopeItem, IGroupItem, ITopicGroupNode, } from './i-topic-options/i-topic-options';
+export type { ITopic, ITopicOptions, IScopeOption, IScopeItem, IGroupItem, ITopicGroupNode, } from './i-topic-options/i-topic-options';
 export type { IContainerOptions } from './i-container-options/i-container-options';
 export type { IChatThink } from './i-chat-think/i-chat-think';
 export type { IMaterial } from './i-material/i-material';
@@ -27,4 +27,5 @@ export type { IActionPanelContentProps, TActionPanelComponent, } from './i-actio
 export type { ISpeechRecognition } from './i-speech-recognition/i-speech-recognition';
 export type { IFile, IFileItem, IFileItemParams, IFileUploadPrams, } from './i-file-item/i-file-item';
 export type { IFileSystemOptions } from './i-file-system-options/i-file-system-options';
+export { TipTapNodeType, type ITipTapDropData, type TipTapNodeConfig, } from './i-tiptap/i-tiptap';
 export * from './deep-research';

package/dist/types/locale/en/index.d.ts

@@ -36,6 +36,7 @@ export declare const EN: {
     thinkThrough: string;
     stopThinking: string;
     thinking: string;
+    waitingReply: string;
     requestTimeout: string;
     unsupportedMessageType: string;
     me: string;
@@ -71,6 +72,8 @@ export declare const EN: {
     backfill: string;
     pinTop: string;
     unpin: string;
+    showHide: string;
+    batchManageScope: string;
     rename: string;
     deleteTopic: string;
     jumpMainView: string;
@@ -83,6 +86,7 @@ export declare const EN: {
     newCreateConversation: string;
     searchTopics: string;
     noTopic: string;
+    noScope: string;
     clearSession: string;
     clearSessionConfirmTip: string;
     clearSessionWithGroupConfirmTip: string;
@@ -91,8 +95,10 @@ export declare const EN: {
     batchDeleteConversation: string;
     batchDeleteSession: string;
     batchDeleteConversationConfirmTip: string;
-    multiSelect: string;
+    batchManage: string;
+    batchManageConversation: string;
     selectedCount: string;
+    selectedScopeCount: string;
     cancelMultiSelect: string;
     unclassifiedTopic: string;
     newGroup: string;
@@ -159,4 +165,15 @@ export declare const EN: {
     size: string;
     type: string;
     folder: string;
+    move: string;
+    new: string;
+    newFile: string;
+    newFolder: string;
+    folderName: string;
+    cannotEmpty: string;
+    moveToNone: string;
+    moveToSelf: string;
+    moveToDescendant: string;
+    moveToSameParent: string;
+    fileAlreadyExists: string;
 };

package/dist/types/locale/zh-CN/index.d.ts

@@ -36,6 +36,7 @@ export declare const ZH_CN: {
     thinkThrough: string;
     stopThinking: string;
     thinking: string;
+    waitingReply: string;
     requestTimeout: string;
     unsupportedMessageType: string;
     me: string;
@@ -71,6 +72,8 @@ export declare const ZH_CN: {
     backfill: string;
     pinTop: string;
     unpin: string;
+    showHide: string;
+    batchManageScope: string;
     rename: string;
     deleteTopic: string;
     jumpMainView: string;
@@ -83,6 +86,7 @@ export declare const ZH_CN: {
     newCreateConversation: string;
     searchTopics: string;
     noTopic: string;
+    noScope: string;
     clearSession: string;
     clearSessionConfirmTip: string;
     clearSessionWithGroupConfirmTip: string;
@@ -91,8 +95,10 @@ export declare const ZH_CN: {
     batchDeleteConversation: string;
     batchDeleteSession: string;
     batchDeleteConversationConfirmTip: string;
-    multiSelect: string;
+    batchManage: string;
+    batchManageConversation: string;
     selectedCount: string;
+    selectedScopeCount: string;
     cancelMultiSelect: string;
     unclassifiedTopic: string;
     newGroup: string;
@@ -159,4 +165,15 @@ export declare const ZH_CN: {
     size: string;
     type: string;
     folder: string;
+    move: string;
+    new: string;
+    newFile: string;
+    newFolder: string;
+    folderName: string;
+    cannotEmpty: string;
+    moveToNone: string;
+    moveToSelf: string;
+    moveToDescendant: string;
+    moveToSameParent: string;
+    fileAlreadyExists: string;
 };

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

@@ -12,3 +12,4 @@ export { ChatStepParser } from './util/chat-step-parser';
 export { ChatUIActionParser } from './util/chat-ui-action-parser';
 export { ContentProtector } from './util/content-protector';
 export { TextUtil } from './util/util';
+export { FileIcon, FolderIcon } from './util/system-file';

package/dist/types/utils/util/system-file.d.ts

@@ -0,0 +1,12 @@
+import { FunctionComponent } from 'preact';
+import { folder } from '../../icons/system-file';
+
+export { folder as FolderIcon };
+/**
+ * 通用渲染组件：直接传入文件名渲染对应图标
+ *
+ * 用法：<FileIcon fileName="report.csv" />
+ */
+export declare const FileIcon: FunctionComponent<{
+    fileName: string;
+}>;

package/dist/types/utils/util/util.d.ts

@@ -67,7 +67,8 @@ export declare function md2html(md: string): string;
  *
  * 支持嵌套 Map（{key=value}）、List（[a, b]）结构；true/false/null 还原为对应类型；
  * 纯数字还原为 number，但前导零（如 000000）视为原始字符串；
- * 值本身为合法 JSON 时（如 avatar=[{"name":"xx"}]）优先按 JSON 解析。
+ * 值本身为合法 JSON 时（如 avatar=[{"name":"xx"}]）优先按 JSON 解析；
+ * 值内包含成对 {...} 片段或英文逗号时做容错（整体保留在值中），避免结构错位丢数据。
  *
  * @param str - 待转换的原始字符串
  * @returns 解析后的 JavaScript 对象，格式非法时返回空对象

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibiz-template-plugin/ai-chat",
-  "version": "0.0.116",
+  "version": "0.0.118",
   "description": "iBiz AI交互框插件",
   "type": "module",
   "main": "dist/index.es.js",
@@ -29,7 +29,7 @@
     "publish:local": "npm run build && npm publish --access public --registry=http://172.16.240.221:8081/repository/local/"
   },
   "dependencies": {
-    "@ibiz-template-plugin/ibiz-file-previewer": "^0.0.26",
+    "@ibiz-template-plugin/ibiz-file-previewer": "^0.0.27",
     "@ibiz-template/scss-utils": "^0.0.2",
     "@preact/signals": "^1.2.1",
     "@tiptap/core": "^3.11.1",

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

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

package/dist/types/components/chat-messages/use-virtual-list.d.ts

@@ -1,156 +0,0 @@
-import { RefObject } from 'preact';
-import { ReadonlySignal, Signal } from '@preact/signals';
-
-/**
- * 虚拟列表项
- *
- * @author zpc
- * @date 2026-09-20
- */
-export interface VirtualItem {
-    /**
-     * 数据源中的实际索引
-     *
-     * @type {number}
-     */
-    index: number;
-    /**
-     * 稳定 key（如 messageid），用于测量缓存
-     *
-     * @type {string}
-     */
-    key: string;
-    /**
-     * 该项在列表中的 top 偏移（累计高度）
-     *
-     * @type {number}
-     */
-    start: number;
-    /**
-     * 当前高度（实测或预估）
-     *
-     * @type {number}
-     */
-    size: number;
-    /**
-     * 绑定到项包裹元素的 ref，用于 ResizeObserver 实测高度
-     *
-     * @type {(el: HTMLElement | null) => void}
-     */
-    measureRef: (el: HTMLElement | null) => void;
-}
-export interface UseVirtualListOptions {
-    /**
-     * 总条数
-     *
-     * @type {number}
-     */
-    count: number;
-    /**
-     * 根据索引返回稳定 key（用于按 key 缓存实测高度，避免前插/删除时按下标错位）
-     *
-     * @type {(index: number) => string}
-     */
-    getItemKey: (index: number) => string;
-    /**
-     * 未渲染项的预估高度
-     *
-     * @type {(index: number) => number}
-     */
-    estimateSize: (index: number) => number;
-    /**
-     * 可视区上下各多渲染的条数
-     *
-     * @type {number}
-     */
-    overscan?: number;
-}
-export interface UseVirtualListResult {
-    /**
-     * 挂到滚动容器上的 ref
-     *
-     * @type {RefObject<HTMLDivElement>}
-     */
-    containerRef: RefObject<HTMLDivElement>;
-    /**
-     * 当前可视区内的虚拟项
-     *
-     * @type {VirtualItem[]}
-     */
-    virtualItems: VirtualItem[];
-    /**
-     * 整个列表的总高度（spacer 高度）
-     *
-     * @type {number}
-     */
-    totalSize: number;
-    /**
-     * 每项起始偏移的前缀和（长度 count + 1，最后一项为总高度）
-     *
-     * @type {number[]}
-     */
-    offsets: number[];
-    /**
-     * 取某下标的起始偏移（供滚动锚定使用）
-     *
-     * @type {(index: number) => number}
-     */
-    getOffset: (index: number) => number;
-    /**
-     * @description 恢复滚动条位置
-     * @memberof UseVirtualListResult
-     */
-    restoreScrollPosition: () => void;
-    /**
-     * 响应式总高度：依赖测量版本号（实测高度回填）与条数，供自定义滚动条订阅
-     *
-     * @type {ReadonlySignal<number>}
-     */
-    totalSizeSignal: ReadonlySignal<number>;
-    /**
-     * 容器 scrollTop 信号（供自定义滚动条计算 thumb 位置）
-     *
-     * @type {Signal<number>}
-     */
-    scrollTopSignal: Signal<number>;
-    /**
-     * 容器可视高度信号
-     *
-     * @type {Signal<number>}
-     */
-    clientHeightSignal: Signal<number>;
-    /**
-     * 自定义滚动条拖动状态：拖动中跳过头部前插的 scrollTop 补偿，由滚动条按指针比例重映射接管
-     *
-     * @type {Signal<boolean>}
-     */
-    isDragging: Signal<boolean>;
-    /**
-     * 程序化设置滚动位置：同步 scrollTop 信号 + 直接写容器 scrollTop（clamp 到当前可滚动范围）
-     *
-     * @type {(top: number) => void}
-     */
-    setScrollTop: (top: number) => void;
-}
-/**
- * 动态高度虚拟列表 Hook
- *
- * ## 核心思想
- * 消息列表里每条消息高度都不同（markdown、代码块、图片、折叠、流式增长），
- * 若全部渲染 DOM 节点会随消息数线性增长导致卡顿。本 Hook 只渲染「视口内 + overscan」的消息：
- * - 用一条 `height: totalSize` 的 spacer div 撑起可滚动总高度；
- * - 每条消息用 `position:absolute + transform:translateY(start)` 定位到对应偏移；
- * - 已渲染项用 ResizeObserver 实测真实高度，未渲染项用 `estimateSize` 预估占位。
- *
- * ## 为什么按 key 缓存而非按下标
- * 消息会「头部前插」（加载历史）和「删除」，导致已有消息的数组下标整体平移。
- * 若按下标缓存实测高度，前插后所有测量值会错位。因此用 `getItemKey`（messageid）作为测量缓存的键。
- *
- * ## 数据流
- * scrollTop / clientHeight / measureVersion 三个信号变化 → useMemo 重算 offsets（前缀和）
- * → 二分查找可视区间 → 产出 virtualItems → 组件只渲染这些项。
- *
- * @author zpc
- * @date 2026-09-20
- */
-export declare const useVirtualList: (options: UseVirtualListOptions) => UseVirtualListResult;