@kweaver-ai/chatkit 0.1.15 → 0.1.17

package/dist/components/base/ChatKitBase.d.ts

@@ -18,6 +18,13 @@ export interface ChatKitBaseProps {
     token?: string;
     /** 刷新 token 的方法，由集成方传入 */
     refreshToken?: () => Promise<string>;
+    /**
+     * 初始用户问题。
+     *
+     * - 外层在挂载 Assistant / Copilot 等组件时传入
+     * - 当组件首次可见且当前没有任何消息时，会自动发送该问题并触发问答
+     */
+    initialQuestion?: string;
 }
 /**
  * ChatKitBase 组件的状态接口
@@ -56,6 +63,20 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      */
     private isInitializing;
     private hasInitialized;
+    /**
+     * 会话代数：用于区分「旧会话的流式更新」和「新会话」
+     * 每次清空/新建会话时自增，流式处理只在代数未变化时才继续写入 state
+     */
+    private conversationSeq;
+    /**
+     * 当前流式请求的 AbortController
+     * 子类在发起流式 fetch 时应设置该字段，便于在 handleStop / 新建会话时主动中断连接
+     */
+    protected currentStreamController?: AbortController;
+    /**
+     * 是否已经根据 initialQuestion 触发过一次自动发送
+     */
+    private hasSentInitialQuestion;
     /**
      * 流式响应时是否处于「按 chunk 批处理」中，避免同一 chunk 内多行事件触发多次 setState 导致 Maximum update depth exceeded
      */
@@ -85,6 +106,16 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * 仅在组件首次可见时调用，防止重复初始化
      */
     private initializeConversation;
+    /**
+     * 根据 props.initialQuestion 在合适的时机自动触发一次问答
+     *
+     * 触发条件：
+     * - 组件当前处于可见状态（visible !== false）
+     * - props.initialQuestion 为非空字符串
+     * - 当前还没有任何对话消息（messages.length === 0）
+     * - 仅触发一次（hasSentInitialQuestion 为 false）
+     */
+    private trySendInitialQuestion;
     /**
      * 获取开场白和预置问题 (抽象方法，由子类实现)
      * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口
@@ -227,6 +258,14 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @param consumeTime 耗时（毫秒），可选
      */
     protected appendJson2PlotBlock(messageId: string, chartData: ChartDataSchema, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一个 JSON2Plot 图表块的内容（用于流式工具 json2plot 的组装）
+     * 如果不存在 JSON2Plot 块，则在流式更新时创建一个新的图表块
+     * @param messageId 消息 ID
+     * @param chartData 最新的图表数据 Schema
+     * @param consumeTime 耗时（毫秒），可选
+     */
+    protected updateJson2PlotBlock(messageId: string, chartData: ChartDataSchema, consumeTime?: number): void;
     /**
      * 添加 AfSailor 工具类型的消息块
      * 该方法由子类调用，用于在消息中添加 AfSailor 查询结果
@@ -243,6 +282,14 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @param consumeTime 耗时（毫秒），可选
      */
     protected appendDatasourceFilterBlock(messageId: string, result: DatasourceFilterResult, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一个 DatasourceFilter 工具块的内容（用于流式工具 datasource_filter 的组装）
+     * 如果不存在 DatasourceFilter 块，则在流式更新时创建一个新的工具块
+     * @param messageId 消息 ID
+     * @param result 最新的 DatasourceFilterResult
+     * @param consumeTime 耗时（毫秒），可选
+     */
+    protected updateDatasourceFilterBlock(messageId: string, result: DatasourceFilterResult, consumeTime?: number): void;
     /**
      * 添加 DatasourceRerank 工具类型的消息块
      * 该方法由子类调用，用于在消息中添加 DatasourceRerank 查询结果，与 datasource_filter 处理方式一致
@@ -251,6 +298,14 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @param consumeTime 耗时（毫秒），可选
      */
     protected appendDatasourceRerankBlock(messageId: string, result: DatasourceRerankResult, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一个 DatasourceRerank 工具块的内容（用于流式工具 datasource_rerank 的组装）
+     * 如果不存在 DatasourceRerank 块，则在流式更新时创建一个新的工具块
+     * @param messageId 消息 ID
+     * @param result 最新的 DatasourceRerankResult
+     * @param consumeTime 耗时（毫秒），可选
+     */
+    protected updateDatasourceRerankBlock(messageId: string, result: DatasourceRerankResult, consumeTime?: number): void;
     /**
      * 添加默认工具类型的消息块
      * 用于那些没有单独渲染逻辑的通用工具

package/dist/components/base/assistant/AssistantBase.d.ts

@@ -46,7 +46,7 @@ export declare abstract class AssistantBase<P extends AssistantBaseProps = Assis
     /**
      * 处理新建对话
      */
-    handleNewChat: () => void;
+    handleNewChat: () => Promise<void>;
     /**
      * 处理加载指定会话
      */

package/dist/components/base/assistant/HistoryChunkPlaceholder.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface HistoryChunkPlaceholderProps {
+    /** 此占位块包含的消息条数，用于展示提示文案 */
+    messageCount: number;
+    /** 点击展开该历史段 */
+    onExpand: () => void;
+}
+/**
+ * 历史段占位块
+ * - 用于折叠更早的历史记录，减少真实 DOM 数量
+ */
+declare const HistoryChunkPlaceholder: React.FC<HistoryChunkPlaceholderProps>;
+export default HistoryChunkPlaceholder;

package/dist/components/base/assistant/InputArea.d.ts

@@ -8,8 +8,8 @@ interface InputAreaProps {
     value: string;
     /** 输入框值变化的回调 */
     onChange: (value: string) => void;
-    /** 发送消息的回调 */
-    onSend: () => void;
+    /** 发送消息的回调（支持异步） */
+    onSend: () => void | Promise<void>;
     /** 当前的应用上下文 */
     context?: ApplicationContext;
     /** 移除上下文的回调 */

package/dist/components/base/assistant/MessageShell.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface MessageShellProps {
+    messageId: string;
+    onHeightChange?: (messageId: string, height: number) => void;
+    className?: string;
+    children: React.ReactNode;
+}
+/**
+ * MessageShell
+ * - 包裹单条消息，负责通过 ResizeObserver 上报真实高度
+ * - 不关心消息内容与交互本身
+ */
+declare const MessageShell: React.FC<MessageShellProps>;
+export default MessageShell;

package/dist/components/base/assistant/hooks/useAnchoredMessageList.d.ts

@@ -0,0 +1,23 @@
+import type React from 'react';
+export interface ScrollAnchor {
+    messageId: string;
+    offset: number;
+}
+export interface UseAnchoredMessageListOptions {
+    /** 消息按从上到下的顺序排列，用于根据高度表计算偏移（仅包含当前真实渲染的消息 ID） */
+    getOrderedMessageIds: () => string[];
+    /** 是否启用锚点恢复（例如在不贴底时才启用） */
+    shouldUseAnchor?: () => boolean;
+}
+export interface UseAnchoredMessageListResult {
+    handleMessageHeightChange: (messageId: string, height: number) => void;
+    handleScroll: (e: React.UIEvent<HTMLDivElement>) => void;
+    registerScrollContainer: (el: HTMLDivElement | null) => void;
+    restoreScrollByAnchor: () => void;
+}
+/**
+ * 管理消息高度表与滚动锚点的 Hook
+ * - 使用 ResizeObserver 上报的高度增量，结合锚点信息，在高度变化或上方插入消息时做滚动修正
+ * - 内部使用 requestAnimationFrame 合并一帧内的多次高度变更，避免频繁 reflow
+ */
+export declare function useAnchoredMessageList(options: UseAnchoredMessageListOptions): UseAnchoredMessageListResult;

package/dist/components/dip/DIPBase.d.ts

@@ -189,6 +189,14 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         getWhitelistEntry(action: string, jsonPath: string): {
             postProcess?: (assistantMessage: AssistantMessage, content: any, messageId: string) => void;
         } | null;
+        /**
+         * 在流式结束后，将完整的 AssistantMessage 结构一次性应用到指定 ChatMessage：
+         * - 遍历 middle_answer.progress，按顺序调用 appendSkillOrLLMContentToMessage 组装所有工具和 LLM 内容块
+         * - 基于 message.ext 同步 messageContext（相关问题、耗时、Token 等），与历史会话逻辑保持一致
+         *
+         * 作为受保护方法暴露，便于子类在特殊场景下自定义流式结果的应用逻辑。
+         */
+        applyAssistantMessageFromStream(assistantMessage: AssistantMessage, messageId: string): void;
         /**
          * 从 Progress 对象中提取 Web 搜索查询
          * 根据 OpenAPI 规范，搜索数据在 answer.choices[0].message.tool_calls 中

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/chatkit",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "publishConfig": {
     "access": "public"
   },