knight-ui 1.1.1 → 1.1.2

package/README.md

@@ -2212,9 +2212,24 @@ const messages = [
 | `userAvatar / assistantAvatar` | `string` | — | 头像 |
 | `userNickname / assistantNickname` | `string` | — | 昵称 |
 | `maxHeight` | `number` | — | 最大高度 |
+| `showThinking` | `boolean` | `true` | 是否显示"思考过程"块 |
+| `thinkingTitle` | `React.ReactNode` | `"思考过程"` | 思考块标题 |
+| `thinkingDefaultCollapsed` | `boolean` | `false` | 思考块默认是否收起 |
+| `thinkingBodyMaxHeight` | `number` | `320` | 思考正文最大高度(px)，超出内部滚动 |
 | `onCopy` | `(msg) => void` | — | 复制回调 |
 | `onRetry` | `(msg, index) => void` | — | 重试回调 |
 
+> **AIMessage 思考内容支持（assistant 专用）**：`thinkingContent?: React.ReactNode` 思考/推理内容（Markdown 字符串或节点），展示为消息上方可折叠的灰色思考块；`thinkingTokens?: number` 真实 token 数（缺省按 ~3.5 字符/token 估算）；`thinkingDurationMs?: number` 思考耗时(ms)，完整消息可传，流式思考期间由组件自动计时无需传入。
+> 流式阶段约定：仅思考时消息为 `{ role:"assistant", thinkingContent: 增量, status:"streaming" }`（正文留空、与 content 互斥增长）；结束后替换为带 `content`（与可选 `thinkingDurationMs`）的完整消息。
+>
+> ```tsx
+> <AIChatDialogue
+>   dataSource={[{ id: "2", role: "assistant", content: "回答正文",
+>     thinkingContent: "先分析…", thinkingTokens: 86, thinkingDurationMs: 12400 }]}
+>   thinkingTitle="思考过程"
+> />
+> ```
+
 ### Sidebar AI 侧栏
 
 ```tsx

package/component/ai/AIChatDialogue.d.ts

@@ -5,6 +5,13 @@ export interface AIMessage {
     id?: string | number;
     role: AIRole;
     content: React.ReactNode;
+    /** 思考/推理内容(assistant 专用)，展示为消息上方可折叠的思考块。
+     *  流式时模型先出 thinking 后出 content，二者分阶段增长 */
+    thinkingContent?: React.ReactNode;
+    /** 该条思考的真实 token 数；缺省时按字符数估算(与 agent 侧 /3.5 口径一致) */
+    thinkingTokens?: number;
+    /** 思考耗时(ms，完整消息)；流式思考期间由组件内部计时，无需传入 */
+    thinkingDurationMs?: number;
     avatar?: string;
     name?: string;
     time?: string;
@@ -13,9 +20,21 @@ export interface AIMessage {
 /**
  * AI 对话展示。
  */
-export declare class AIChatDialogue extends AbstractUI<AIChatDialogueProps, UIState> {
+export declare class AIChatDialogue extends AbstractUI<AIChatDialogueProps, AIChatDialogueState> {
     private listRef;
     private listEl;
+    /** 思考块折叠映射：key=消息 id(缺省退化为索引)，value=是否展开；缺 key 走默认规则 */
+    private foldThinking;
+    /** 思考正文元素缓存(供流式时内部滚到底) */
+    private thinkingBodyEls;
+    /** 各消息"开始流式思考"的锚点时刻(performance.now)，用于实时计时 */
+    private thinkAnchor;
+    /** 思考结束补记的耗时(ms)，key=消息 id(当 dataSource 最终消息未带 thinkingDurationMs 时兜底) */
+    private thinkFinalMs;
+    /** 实时计时的最新时刻：有任一消息在流式思考时由定时器驱动刷新 */
+    private thinkNow;
+    /** 刷新定时器 id(仅流式思考期间存在) */
+    private thinkTimer;
     constructor(props: AIChatDialogueProps);
     componentDidMount(): void;
     componentWillUnmount(): void;
@@ -23,6 +42,23 @@ export declare class AIChatDialogue extends AbstractUI<AIChatDialogueProps, UISt
     private onListWheel;
     private setListRef;
     private scrollToBottom;
+    private getMsgKey;
+    private isEmptyNode;
+    /** 思考显示开关：showThinking !== false 时显示思考块 */
+    private thinkingEnabled;
+    /** 是否正处于"只吐思考、还没出正文"的流式阶段 */
+    private isStreamingThinking;
+    /** 展开判定：用户显式折叠/展开优先；否则流式思考强制展开，静态态按 defaultCollapsed */
+    private isThinkingExpanded;
+    private thinkingTokensOf;
+    private setThinkingBodyRef;
+    private toggleThinking;
+    private autoScrollThinkingBody;
+    /** 思考时长文案：流式=锚点实时差；静态=thinkingDurationMs，其次组件内思考结束的补记值 */
+    private thinkingTimeText;
+    /** 维护"流式思考"计时：登记锚点、结束后补记耗时、起停刷新定时器 */
+    private syncThinkingClock;
+    private renderThinkingBlock;
     private renderAvatar;
     private renderActionBtn;
     protected OnRenderContent(): React.ReactElement;
@@ -37,8 +73,18 @@ export interface AIChatDialogueProps extends UIProps {
     showAvatar?: boolean;
     showNickname?: boolean;
     maxHeight?: number;
+    /** 是否显示"思考过程"块 @default true */
+    showThinking?: boolean;
+    /** 思考块标题 @default "思考过程" */
+    thinkingTitle?: React.ReactNode;
+    /** 思考块默认是否收起（折叠时仅显示头部） @default false */
+    thinkingDefaultCollapsed?: boolean;
+    /** 思考正文最大高度(px)，超出后内部滚动 @default 320 */
+    thinkingBodyMaxHeight?: number;
     emptyContent?: React.ReactNode;
     onCopy?: (msg: AIMessage) => void;
     onRetry?: (msg: AIMessage, index: number) => void;
 }
+interface AIChatDialogueState extends UIState {
+}
 export {};