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

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

@@ -0,0 +1,102 @@
+import { RefObject } from 'preact';
+import { ReadonlySignal, Signal } from '@preact/signals';
+
+export interface ChatScrollbarProps {
+    /**
+     * 滚动容器 ref（与 useVirtualList 的 containerRef 同源）
+     *
+     * @type {RefObject<HTMLDivElement | null>}
+     */
+    containerRef: RefObject<HTMLDivElement | null>;
+    /**
+     * 容器 scrollTop 信号
+     *
+     * @type {Signal<number>}
+     */
+    scrollTop: Signal<number>;
+    /**
+     * 容器可视高度信号
+     *
+     * @type {Signal<number>}
+     */
+    clientHeight: Signal<number>;
+    /**
+     * 内容总高度信号（依赖实测高度回填）
+     *
+     * @type {ReadonlySignal<number>}
+     */
+    totalSize: ReadonlySignal<number>;
+    /**
+     * 程序化写滚动位置（同步信号 + 写容器 scrollTop）
+     *
+     * @type {(top: number) => void}
+     */
+    setScrollTop: (top: number) => void;
+    /**
+     * 拖动到顶部附近的通知（触发加载更早历史）
+     *
+     * 拖到顶部且前插补偿被跳过时，scrollTop 值可能不变导致浏览器不派发 scroll 事件，
+     * 因此不能只依赖 scroll 事件，需在此处直接通知
+     *
+     * @type {() => void}
+     */
+    onNearTop?: () => void;
+    /**
+     * 拖动状态回调（父组件转发给 useVirtualList 的 setIsDragging）
+     *
+     * @type {(dragging: boolean) => void}
+     */
+    onDragStateChange?: (dragging: boolean) => void;
+    /**
+     * thumb 最小高度，避免内容过长时不可抓取
+     *
+     * @type {number}
+     */
+    minThumbSize?: number;
+}
+/**
+ * 自定义虚拟滚动条
+ *
+ * ## 为什么不用原生滚动条
+ * 动态高度虚拟列表中未测量的项用预估高度占位，快速拖动原生滚动条时新项不断被实测，
+ * totalSize（scrollHeight）持续变化，原生 thumb 按比例重定位导致滚动条乱跳。
+ *
+ * ## 核心策略
+ * 隐藏原生滚动条绘制，保留原生 scrollTop 驱动内容（wheel/键盘/触摸不变），自绘 thumb：
+ * - 拖动期间 thumb 定位用指针比例（dragRatio），不依赖异步的 scroll 事件回读，无滞后抖动；
+ * - 拖动期间 totalSize 变化（测量回填/历史前插）时，按指针比例重映射 scrollTop，
+ *   thumb 始终钉在指针下方，内容坐标系在其下方重排。
+ *
+ * ## 与 useVirtualList 的数据流交联
+ * 本组件不持有滚动状态，全部通过 props 注入 useVirtualList 暴露的信号与回调，
+ * 二者是「显示层 ↔ 驱动层」的关系：
+ *
+ * ```
+ * useVirtualList                          ChatScrollbar
+ * ────────────                          ──────────────
+ * totalSizeSignal ─────────────────────► totalSize     （thumb 高度/比例）
+ * clientHeightSignal ──────────────────► clientHeight  （thumb 高度/比例）
+ * scrollTopSignal ─────────────────────► scrollTop     （非拖动期 thumb 位置）
+ * setScrollTop ◄──────────────────────── 拖动/翻页      （程序化写滚动位置）
+ * onDragStateChange ──► isDragging ──► 前插补偿跳过
+ * onNearTop ──────────────────────────► 加载更早历史
+ * ```
+ *
+ * 正向（useVirtualList → 本组件）：
+ * - 滚动/测量回填/历史前插 → totalSize、scrollTop 信号变化 → 本组件重渲染更新 thumb；
+ * - totalSizeSignal 是懒求值信号（只依赖测量版本号），滚动过程中零额外计算。
+ *
+ * 反向（本组件 → useVirtualList）：
+ * - 拖动/点击翻页 → setScrollTop：同步写 scrollTop 信号 + 写容器 DOM，
+ *   信号先行避免下一帧用旧值闪跳；虚拟列表据此重算可视区；
+ * - onDragStateChange → 虚拟列表的 isDragging 信号置 true：
+ *   拖动期间「头部前插补偿」被跳过（use-virtual-list.ts:373），
+ *   前插导致的 totalSize 变化改由本组件的重锚定 effect 按指针比例重映射 scrollTop 接管，
+ *   两端不会同时争抢滚动位置；
+ * - onNearTop：拖到顶部时直接通知父级加载历史——前插补偿被跳过后 scrollTop 可能不变，
+ *   浏览器不派发 scroll 事件，不能只依赖滚动事件触发加载。
+ *
+ * @author zpc
+ * @date 2026-10-12
+ */
+export declare const ChatScrollbar: (props: ChatScrollbarProps) => import("preact").JSX.Element | null;

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

@@ -107,6 +107,10 @@ export declare class AiChatController {
      * @type {Signal<boolean>}
      */
     readonly enableRecallConfigSetting: Signal<boolean>;
+    /**
+     * 是否显示项目选择组件（当前激活智能体的 flow_mode 为 SKILL 时才显示）
+     */
+    readonly enableChatProject: Signal<boolean>;
     /**
      * 是否允许切换AI代理
      */
@@ -286,6 +290,10 @@ export declare class AiChatController {
      * 初始化AI知识库
      */
     private initAIChatKnowledge;
+    /**
+     * 计算项目选择组件是否显示（当前激活智能体的 flow_mode 为 SKILL 时才显示）
+     */
+    private computeEnableChatProject;
     /**
      * 计算选中知识库
      */
@@ -345,7 +353,7 @@ export declare class AiChatController {
      */
     loadHistoryMore(): Promise<void>;
     /**
-     * 获取历史记录后续处理
+     * 获取历史记录后续处理(仅查询history接口时调用)
      */
     private afterFecthHistory;
     /**

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

@@ -105,6 +105,12 @@ export declare class AiTopicController {
      * @memberof AiTopicController
      */
     workMode: 'DEFAULT' | 'WORKSPACE';
+    /**
+     * @description 是否禁用选择业务域（WORKSPACE 工作模式使用）
+     * @type {boolean}
+     * @memberof AiTopicController
+     */
+    disableSelectScope: boolean;
     /**
      * @description 业务域列表（WORKSPACE 工作模式使用）
      * @type {IScopeItem[]}
@@ -146,10 +152,14 @@ export declare class AiTopicController {
      */
     setActivedTopic(topic: ChatTopic | undefined): void;
     /**
-     * 注入组件外层容器id
-     * @param compWrapperId
+     * @description 注入基础资源
+     * @param {string} compWrapperId
+     * @param {('DEFAULT' | 'WORKSPACE')} workMode
+     * @param {boolean} [disableSelectScope]
+     * @param {IScopeItem[]} [scopeList]
+     * @memberof AiTopicController
      */
-    injectBasicResources(compWrapperId: string, workMode: 'DEFAULT' | 'WORKSPACE', scopeList?: IScopeItem[]): void;
+    injectBasicResources(compWrapperId: string, workMode: 'DEFAULT' | 'WORKSPACE', disableSelectScope?: boolean, scopeList?: IScopeItem[]): void;
     /**
      * 注入资源选项
      * @param resourceOptions

package/dist/types/entity/ai-agent/ai-agent.d.ts

@@ -20,6 +20,7 @@ export declare class AIAgent implements IAIAgent {
     get maxchunks(): number | undefined;
     get chunkthreshold(): number | undefined;
     get chunkpageindex(): 0 | 1 | undefined;
+    get flow_mode(): 'SKILL' | 'DEFAULT' | 'DE' | 'HUB' | 'SCRIPT' | undefined;
     constructor(agent: IAIAgent, defaultConfig: {
         chunkrerank: 0 | 1 | 2;
         maxchunks?: number;

package/dist/types/icons/arrow-down.d.ts

@@ -1 +1,3 @@
-export declare const ArrowDown: () => import("preact").JSX.Element;
+export declare const ArrowDown: (props?: {
+    className?: string;
+}) => import("preact").JSX.Element;

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

@@ -53,4 +53,3 @@ 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/interface/i-ai-agent/i-ai-agent.d.ts

@@ -75,4 +75,10 @@ export interface IAIAgent {
      * 页面目录召回
      */
     chunkpageindex?: 0 | 1;
+    /**
+     * @description 智能体模式
+     * @type {('SKILL' | 'DEFAULT' | 'DE' | 'HUB' | 'SCRIPT')} 可执行SKILL模式 | 简单Prompt模式 | 工作流模式 | 分角色总线模式 | 脚本代码模式
+     * @memberof IAIAgent
+     */
+    flow_mode?: 'SKILL' | 'DEFAULT' | 'DE' | 'HUB' | 'SCRIPT';
 }

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

@@ -404,6 +404,7 @@ export interface IChatOptions extends IChat {
         pattern: string;
         file_path: string;
         max_depth: number;
+        only_dirs: boolean;
     }) => Promise<IProject[]>;
     /**
      * 文件上传配置

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

@@ -227,6 +227,12 @@ export interface ITopicOptions extends ITopic {
      * 工作模式，默认值，会话数据以列表显示; WORKSPACE：工作区，会话数据分为域（scope）、会话分组分层显示
      */
     workMode?: 'DEFAULT' | 'WORKSPACE';
+    /**
+     * @description 禁用选择业务域，仅WORKSPACE模式下生效，默认不禁用
+     * @type {boolean}
+     * @memberof ITopicOptions
+     */
+    disableSelectScope?: boolean;
     /**
      * @description 域列表，当工作模式为WORKSPACE时必填
      * @type {IScopeItem[]}

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

@@ -4,7 +4,7 @@ export declare const EN: {
     automatic: string;
     customize: string;
     default: string;
-    recallSettings: string;
+    settings: string;
     chunkRerank: string;
     chunkPageIndex: string;
     maxChunks: string;

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

@@ -4,7 +4,7 @@ export declare const ZH_CN: {
     automatic: string;
     customize: string;
     default: string;
-    recallSettings: string;
+    settings: string;
     chunkRerank: string;
     chunkPageIndex: string;
     maxChunks: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibiz-template-plugin/ai-chat",
-  "version": "0.0.113",
+  "version": "0.0.114",
   "description": "iBiz AI交互框插件",
   "type": "module",
   "main": "dist/index.es.js",

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

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