@next-bricks/ai-portal 0.70.0 → 0.70.2

package/dist-types/action-buttons/index.d.ts

@@ -13,11 +13,20 @@ export interface ActionButtonsProps {
     activeKey?: string | null;
 }
 /**
- * 构件 `ai-portal.action-buttons`
+ * 动作按钮组，支持选中状态切换，用于聊天框的功能入口。
+ *
+ * @description 动作按钮组，支持选中状态切换，用于聊天框的功能入口。
+ * @category ai-portal
  */
 export declare class ActionButtons extends ReactNextElement implements ActionButtonsProps {
     #private;
+    /**
+     * 按钮列表配置，每项包含文本、唯一键值及可选图标
+     */
     accessor items: ActionItem[] | undefined;
+    /**
+     * 当前选中按钮的键值，选中后显示删除图标，再次点击可取消选中
+     */
     accessor activeKey: string | null | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/activity-timeline/index.d.ts

@@ -7,10 +7,19 @@ export interface ActivityTimelineProps {
     chatUrlTemplate?: string;
 }
 /**
- * 构件 `ai-portal.activity-timeline`
+ * 活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。
+ *
+ * @description 活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。
+ * @category ai-portal
  */
 export declare class ActivityTimeline extends ReactNextElement implements ActivityTimelineProps {
+    /**
+     * 活动记录列表
+     */
     accessor list: Activity[] | undefined;
+    /**
+     * 跳转到对话详情页的 URL 模板，支持 {conversation_id} 等活动记录字段插值
+     */
     accessor chatUrlTemplate: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/ai-agents/index.d.ts

@@ -15,10 +15,19 @@ export interface Agent {
     tags?: string[];
 }
 /**
- * 构件 `ai-portal.ai-agents`
+ * AI Agents 卡片列表，展示可用的 AI 智能体，支持点击跳转到对应详情页。
+ *
+ * @description AI Agents 卡片列表，展示可用的 AI 智能体，支持点击跳转到对应详情页。
+ * @category ai-portal
  */
 export declare class AIAgents extends ReactNextElement implements AIAgentsProps {
+    /**
+     * AI Agent 列表数据
+     */
     accessor list: Agent[] | undefined;
+    /**
+     * 跳转到 Agent 详情页的 URL 模板，支持 {name} 等 Agent 字段插值
+     */
     accessor urlTemplate: string | undefined;
     /** @deprecated */
     accessor withContainer: boolean;

package/dist-types/ai-employees/index.d.ts

@@ -15,12 +15,27 @@ export interface Employee {
     avatar?: string;
 }
 /**
- * 构件 `ai-portal.ai-employees`
+ * AI 数字人卡片列表，按行业和角色分组展示，支持 Tab 切换行业和点击跳转。
+ *
+ * @description AI 数字人卡片列表，按行业和角色分组展示，支持 Tab 切换行业和点击跳转。
+ * @category ai-portal
  */
 export declare class AIEmployees extends ReactNextElement implements AIEmployeesProps {
+    /**
+     * 数字人列表数据
+     */
     accessor list: Employee[] | undefined;
+    /**
+     * 行业列表，用于指定 Tab 的顺序，未在此列表中的行业将按出现顺序附加在末尾
+     */
     accessor industries: string[] | undefined;
+    /**
+     * 跳转到数字人详情页的 URL 模板，支持 {name} 等数字人字段插值
+     */
     accessor urlTemplate: string | undefined;
+    /**
+     * 行业 Tab 栏吸顶时距顶部的距离（px），不设置则不吸顶
+     */
     accessor stickyTop: number | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/blank-state/index.d.ts

@@ -7,10 +7,19 @@ export interface BlankStateProps {
 }
 export type BlankStateIllustration = "goals" | "activities" | "collaboration-spaces" | "serviceflows";
 /**
- * 构件 `ai-portal.blank-state`
+ * 空状态展示组件，提供预置插画和描述文字，并支持通过默认插槽插入自定义内容。
+ *
+ * @description 空状态展示组件，提供预置插画和描述文字，并支持通过默认插槽插入自定义内容。
+ * @category ai-portal
  */
 export declare class BlankState extends ReactNextElement implements BlankStateProps {
+    /**
+     * 插画类型，可选 "goals"、"activities"、"collaboration-spaces"、"serviceflows"，默认使用 activities 插画
+     */
     accessor illustration: BlankStateIllustration | undefined;
+    /**
+     * 描述文字
+     */
     accessor description: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/chat-input/index.d.ts

@@ -29,23 +29,59 @@ export interface ChatInputMapEvents {
     onTerminate: "terminate";
 }
 /**
- * 小型聊天输入框，用于对话等页面
+ * 小型聊天输入框，用于对话等页面，支持命令联想、@提及数字人、文件上传及终止任务等功能。
+ *
+ * @description 小型聊天输入框，用于对话等页面，支持命令联想、@提及数字人、文件上传及终止任务等功能。
+ * @category ai-portal
  */
 export declare class ChatInput extends ReactNextElement implements ChatInputProps {
     #private;
+    /**
+     * 输入框占位文字
+     */
     accessor placeholder: string | undefined;
+    /**
+     * 是否自动聚焦
+     */
     accessor autoFocus: boolean | undefined;
+    /**
+     * 是否禁用发送按钮，通常在 AI 正在处理时设为 true
+     */
     accessor submitDisabled: boolean | undefined;
+    /**
+     * 是否显示终止任务按钮，需与 submitDisabled 配合使用
+     */
     accessor supportsTerminate: boolean | undefined;
+    /**
+     * 是否正在终止任务，为 true 时显示加载状态
+     */
     accessor terminating: boolean | undefined;
+    /**
+     * 是否在输入框为空时自动淡出，通过 CSS 属性选择器控制样式
+     */
     accessor autoFade: boolean | undefined;
+    /**
+     * 文件上传配置
+     */
     accessor uploadOptions: UploadOptions | undefined;
+    /**
+     * 可 @ 提及的数字人列表
+     */
     accessor aiEmployees: AIEmployee[] | undefined;
+    /**
+     * 命令列表，支持通过 / 或搜索触发联想
+     */
     accessor commands: Command[] | undefined;
     /**
+     * 命令/提及联想弹出层的显示位置
+     *
      * @default "bottom"
      */
     accessor suggestionsPlacement: "top" | "bottom" | undefined;
+    /**
+     * 设置输入框的值并聚焦
+     * @param value 要设置的文本内容
+     */
     setValue(value: string): void;
     render(): React.JSX.Element;
 }

package/dist-types/chat-panel/index.d.ts

@@ -17,33 +17,75 @@ export interface ChatPanelProps {
     maskClosable?: boolean;
 }
 /**
- * 弹出式对话面板。
+ * 弹出式 AI 对话面板，以模态框形式展示对话界面，支持与 AI 助手进行多轮对话。
+ *
+ * @description 弹出式 AI 对话面板，以模态框形式展示对话界面，支持与 AI 助手进行多轮对话。
+ * @category ai-portal
  */
 export declare class ChatPanel extends ReactNextElement implements ChatPanelProps {
     #private;
+    /**
+     * 面板标题
+     */
     accessor panelTitle: string | undefined;
+    /**
+     * 预设数字人 ID，对话提交时会携带该 ID
+     */
     accessor aiEmployeeId: string | undefined;
+    /**
+     * 预设命令载荷，对话提交时会携带该命令
+     */
     accessor cmd: CommandPayload | undefined;
+    /**
+     * 面板宽度
+     */
     accessor width: string | number | undefined;
+    /**
+     * 面板高度
+     */
     accessor height: string | number | undefined;
+    /**
+     * 输入框占位文字
+     */
     accessor placeholder: string | undefined;
+    /**
+     * 文件上传配置
+     */
     accessor uploadOptions: UploadOptions | undefined;
     /**
-     * Show help messages when no conversation exists.
+     * 无对话时显示的帮助内容配置
      */
     accessor help: {
         useBrick: UseBrickConf;
     } | undefined;
     /**
-     * Whether to close the panel when clicking the mask.
+     * 是否点击遮罩关闭面板
      *
      * @default false
      */
     accessor maskClosable: boolean | undefined;
+    /**
+     * 打开对话面板
+     */
     open(): void;
+    /**
+     * 关闭对话面板
+     */
     close(): void;
+    /**
+     * 设置输入框的内容
+     * @param content 要设置的文本内容
+     */
     setInputValue(content: string): void;
+    /**
+     * 直接发送一条消息
+     * @param payload 消息载荷，包含文本内容及可选的文件、命令等
+     */
     send(payload: ChatPayload): void;
+    /**
+     * 在面板中显示文件预览
+     * @param file 要预览的文件信息
+     */
     showFile(file: FileInfo): void;
     render(): React.JSX.Element;
 }

package/dist-types/chat-stream/index.d.ts

@@ -27,10 +27,16 @@ export interface ConversationDetail {
     projectId?: string;
 }
 /**
- * 构件 `ai-portal.chat-stream`
+ * AI 对话流视图，以聊天气泡形式展示对话过程，支持文件上传、命令联想、回放及用户反馈等功能。
+ *
+ * @description AI 对话流视图，以聊天气泡形式展示对话过程，支持文件上传、命令联想、回放及用户反馈等功能。
+ * @category ai-portal
  */
 export declare class ChatStream extends ReactNextElement implements ChatStreamProps {
     #private;
+    /**
+     * 对话 ID
+     */
     accessor conversationId: string | undefined;
     /** 初始请求数据。仅初始设置有效。 */
     accessor initialRequest: RequestStore | undefined | null;
@@ -42,23 +48,78 @@ export declare class ChatStream extends ReactNextElement implements ChatStreamPr
      * @default 2
      */
     accessor replayDelay: number | undefined;
+    /**
+     * 功能开关配置，键为功能名，值为是否启用
+     */
     accessor supports: Record<string, boolean> | undefined;
+    /**
+     * 是否显示 Human-in-the-loop 操作按钮
+     */
     accessor showHumanActions: boolean | undefined;
+    /**
+     * 是否显示反馈按钮
+     */
     accessor showFeedback: boolean | undefined;
+    /**
+     * 是否在任务失败时也显示反馈按钮
+     */
     accessor showFeedbackAfterFailed: boolean | undefined;
+    /**
+     * 是否在查看生成视图时显示反馈按钮
+     */
     accessor showFeedbackOnView: boolean | undefined;
+    /**
+     * 是否显示切换到画布视图的按钮
+     */
     accessor showUiSwitch: boolean | undefined;
+    /**
+     * 是否隐藏 Mermaid 图表渲染，通过 CSS 属性选择器控制样式
+     */
     accessor hideMermaid: boolean | undefined;
+    /**
+     * 生成视图预览页的 URL 模板，支持 {viewId} 等字段插值
+     */
     accessor previewUrlTemplate: string | undefined;
+    /**
+     * 示例场景列表，用于在空对话时展示快速入口
+     */
     accessor showCases: ShowCaseType[] | undefined;
+    /**
+     * 示例项目列表，用于展示可参考的已有项目
+     */
     accessor exampleProjects: ExampleProject[] | undefined;
+    /**
+     * "试一试"跳转 URL
+     */
     accessor tryItOutUrl: string | undefined;
+    /**
+     * 可 @ 提及的数字人列表
+     */
     accessor aiEmployees: AIEmployee[] | undefined;
+    /**
+     * 命令列表，支持通过 / 或搜索触发联想
+     */
     accessor commands: Command[] | undefined;
+    /**
+     * 文件上传配置
+     */
     accessor uploadOptions: UploadOptions | undefined;
+    /**
+     * 通知组件任务已恢复，用于继续中断的对话
+     */
     resumed(): void;
+    /**
+     * 通知组件反馈提交成功
+     */
     feedbackSubmitDone(): void;
+    /**
+     * 通知组件反馈提交失败
+     */
     feedbackSubmitFailed(): void;
+    /**
+     * 通知组件查看视图的反馈处理完成
+     * @param viewId 对应的视图 ID
+     */
     feedbackOnViewDone(viewId: string): void;
     render(): React.JSX.Element;
 }

package/dist-types/cruise-canvas/index.d.ts

@@ -30,10 +30,16 @@ export interface ConversationDetail {
     projectId?: string;
 }
 /**
- * 构件 `ai-portal.cruise-canvas`
+ * AI 任务执行画布，以节点图形式展示任务的执行过程，支持任务回放、反馈及 UI 切换等功能。
+ *
+ * @description AI 任务执行画布，以节点图形式展示任务的执行过程，支持任务回放、反馈及 UI 切换等功能。
+ * @category ai-portal
  */
 export declare class CruiseCanvas extends ReactNextElement implements CruiseCanvasProps {
     #private;
+    /**
+     * 对话 ID
+     */
     accessor conversationId: string | undefined;
     /** 初始请求数据。仅初始设置有效。 */
     accessor initialRequest: RequestStore | undefined | null;
@@ -45,26 +51,90 @@ export declare class CruiseCanvas extends ReactNextElement implements CruiseCanv
      * @default 2
      */
     accessor replayDelay: number | undefined;
+    /**
+     * 功能开关配置，键为功能名，值为是否启用
+     */
     accessor supports: Record<string, boolean> | undefined;
+    /**
+     * 是否显示隐藏的 Job 节点
+     */
     accessor showHiddenJobs: boolean | undefined;
+    /**
+     * 是否显示 Human-in-the-loop 操作按钮
+     */
     accessor showHumanActions: boolean | undefined;
+    /**
+     * 是否显示反馈按钮
+     */
     accessor showFeedback: boolean | undefined;
+    /**
+     * 是否在任务失败时也显示反馈按钮
+     */
     accessor showFeedbackAfterFailed: boolean | undefined;
+    /**
+     * 是否在查看生成视图时显示反馈按钮
+     */
     accessor showFeedbackOnView: boolean | undefined;
+    /**
+     * 是否显示切换到对话流视图的按钮
+     */
     accessor showUiSwitch: boolean | undefined;
+    /**
+     * 是否隐藏 Mermaid 图表渲染，通过 CSS 属性选择器控制样式
+     */
     accessor hideMermaid: boolean | undefined;
+    /**
+     * 是否显示 JSX 编辑器按钮
+     */
     accessor showJsxEditor: boolean | undefined;
+    /**
+     * 生成视图预览页的 URL 模板，支持 {viewId} 等字段插值
+     */
     accessor previewUrlTemplate: string | undefined;
+    /**
+     * 示例场景列表，用于在空对话时展示快速入口
+     */
     accessor showCases: ShowCaseType[] | undefined;
+    /**
+     * 示例项目列表，用于展示可参考的已有项目
+     */
     accessor exampleProjects: ExampleProject[] | undefined;
+    /**
+     * "试一试"跳转 URL
+     */
     accessor tryItOutUrl: string | undefined;
+    /**
+     * 是否将任务说明独立展示，而非内联在节点中
+     */
     accessor separateInstructions: boolean | undefined;
+    /**
+     * 可 @ 提及的数字人列表
+     */
     accessor aiEmployees: AIEmployee[] | undefined;
+    /**
+     * 命令列表，支持通过 / 或搜索触发联想
+     */
     accessor commands: Command[] | undefined;
+    /**
+     * 文件上传配置
+     */
     accessor uploadOptions: UploadOptions | undefined;
+    /**
+     * 通知组件任务已恢复，用于继续中断的对话
+     */
     resumed(): void;
+    /**
+     * 通知组件反馈提交成功
+     */
     feedbackSubmitDone(): void;
+    /**
+     * 通知组件反馈提交失败
+     */
     feedbackSubmitFailed(): void;
+    /**
+     * 通知组件查看视图的反馈处理完成
+     * @param viewId 对应的视图 ID
+     */
     feedbackOnViewDone(viewId: string): void;
     render(): React.JSX.Element;
 }

package/dist-types/dropdown-select/index.d.ts

@@ -21,7 +21,9 @@ export interface DropdownOptions {
     [key: string]: unknown;
 }
 /**
- * 构件 `ai-portal.dropdown-select`
+ * 下拉选择器，提供选项列表供用户选择，支持搜索过滤功能。
+ *
+ * @category interact-basic
  */
 export declare class DropdownSelect extends ReactNextElement implements DropdownSelectProps {
     #private;

package/dist-types/elevo-card/index.d.ts

@@ -13,7 +13,11 @@ export type IconWithColor = GeneralIconProps & {
     color?: string;
 };
 /**
- * 构件 `ai-portal.elevo-card`
+ * Elevo 风格的卡片组件，支持图标或图片头像、标题、描述、操作按钮及底部插槽。
+ *
+ * @category display-component
+ * @slot actions - 卡片右上角操作区域
+ * @slot footer - 卡片底部操作区域
  */
 export declare class ElevoCard extends ReactNextElement implements ElevoCardProps {
     accessor cardTitle: string | undefined;

package/dist-types/elevo-logo/index.d.ts

@@ -2,7 +2,9 @@ import React from "react";
 import { ReactNextElement } from "@next-core/react-element";
 import "@next-core/theme";
 /**
- * 构件 `ai-portal.elevo-logo`
+ * Elevo 品牌 Logo 图片组件，固定展示 Elevo logo（95×28px）。
+ *
+ * @category display-component
  */
 export declare class ElevoLogo extends ReactNextElement {
     render(): React.JSX.Element;

package/dist-types/elevo-sidebar/index.d.ts

@@ -28,7 +28,9 @@ export interface ElevoSidebarProps {
 }
 export type { ActionClickDetail, Project, ProjectActionClickDetail };
 /**
- * 构件 `ai-portal.elevo-sidebar`
+ * Elevo AI 侧边栏，包含 Logo 导航、新建对话、历史记录、项目列表及个人账户操作，支持折叠和抽屉两种行为模式。
+ *
+ * @category layout-component
  */
 export declare class ElevoSidebar extends ReactNextElement implements ElevoSidebarProps {
     #private;
@@ -52,13 +54,28 @@ export declare class ElevoSidebar extends ReactNextElement implements ElevoSideb
     accessor scope: "default" | "space" | undefined;
     accessor spaceNav: SpaceNavProps | undefined;
     /**
-     * @param delay Delay in milliseconds before pulling the latest chat history.
+     * 延迟一段时间后拉取最新对话历史
+     * @param delay 拉取前的等待时长（毫秒），用于等待任务标题生成完成
      */
     pullHistory(delay: number): void;
+    /** 展开侧边栏（behavior 为 drawer 时有效） */
     open(): void;
+    /** 折叠侧边栏（behavior 为 drawer 时有效） */
     close(): void;
+    /**
+     * 从历史列表中移除指定项目及其对话
+     * @param projectId 要移除的项目 instanceId
+     */
     removeProject(projectId: string): void;
+    /**
+     * 向项目列表中追加一个新项目
+     * @param project 要追加的项目对象
+     */
     addProject(project: Project): void;
+    /**
+     * 将指定对话标记为已移入项目，从历史列表中隐藏
+     * @param conversationId 要移动的对话 ID
+     */
     moveConversation(conversationId: string): void;
     render(): React.JSX.Element;
 }

package/dist-types/flow-tabs/index.d.ts

@@ -10,7 +10,11 @@ export interface Tab {
     label: string;
 }
 /**
- * 构件 `ai-portal.flow-tabs`
+ * 流程标签页组件，提供带背景画布动效的标签导航，支持工具栏插槽和默认内容插槽。
+ *
+ * @category navigate
+ * @slot toolbar - 标签栏右侧工具栏区域
+ * @slot default - 标签页内容区域
  */
 export declare class FlowTabs extends ReactNextElement implements FlowTabsProps {
     #private;

package/dist-types/gantt-chart/index.d.ts

@@ -7,7 +7,9 @@ export interface GanttChartProps {
     nodes?: GanttNode[];
 }
 /**
- * 构件 `ai-portal.gantt-chart`
+ * 甘特图组件，以树状层级结构展示任务节点及其时间条，支持折叠展开和全屏操作。
+ *
+ * @category chart
  */
 export declare class GanttChart extends ReactNextElement implements GanttChartProps {
     #private;

package/dist-types/goal-card-list/index.d.ts

@@ -8,13 +8,20 @@ export interface GoalCardListProps {
     activeKey?: string;
 }
 /**
- * 构件 `ai-portal.goal-card-list`
+ * 目标卡片列表，以分层卡片形式展示目标项，支持内联编辑标题、状态切换、新建对话及追加子目标。
+ *
+ * @category display-component
  */
 export declare class GoalCardList extends ReactNextElement implements GoalCardListProps {
     #private;
     accessor goalList: GoalItem[] | undefined;
     accessor cardStyle: React.CSSProperties | undefined;
     accessor activeKey: string | undefined;
+    /**
+     * 将待定子目标提交为正式目标项
+     * @param pendingId 待定子目标的临时 instanceId
+     * @param newItem 创建完成后的真实目标数据
+     */
     appendChildDone(pendingId: string, newItem: GoalItem): void;
     render(): React.JSX.Element;
 }

package/dist-types/home-container/index.d.ts

@@ -5,7 +5,10 @@ export interface HomeContainerProps {
     sticky?: boolean;
 }
 /**
- * 构件 `ai-portal.home-container`
+ * AI Portal 首页容器，通过 sticky 属性控制顶部吸附行为，内容通过默认插槽传入。
+ *
+ * @category layout-component
+ * @slot default - 页面内容区域
  */
 export declare class HomeContainer extends ReactNextElement implements HomeContainerProps {
     accessor sticky: boolean | undefined;

package/dist-types/icon-button/index.d.ts

@@ -13,7 +13,10 @@ export interface IconButtonProps {
 }
 export type IconButtonVariant = "default" | "light" | "mini" | "mini-light" | "bordered";
 /**
- * 构件 `ai-portal.icon-button`
+ * 图标按钮，支持多种视觉变体、禁用状态、Tooltip 提示及文字插槽。
+ *
+ * @category interact-basic
+ * @slot default - 图标旁边的文字内容（可选）
  */
 export declare class IconButton extends ReactNextElement implements IconButtonProps {
     accessor icon: (GeneralIconProps & HTMLAttributes<GeneralIcon>) | undefined;

package/dist-types/mcp-tools/index.d.ts

@@ -18,7 +18,9 @@ export interface McpServer {
     name: string;
 }
 /**
- * 构件 `ai-portal.mcp-tools`
+ * MCP 工具列表组件，按服务分组展示工具信息，支持按平台分类过滤和吸顶标签栏。
+ *
+ * @category display-component
  */
 export declare class McpTools extends ReactNextElement implements McpToolsProps {
     accessor list: McpTool[] | undefined;

package/dist-types/page-container/index.d.ts

@@ -15,14 +15,21 @@ export interface Breadcrumb {
 /**
  * 构件 `ai-portal.page-container`
  *
+ * 页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。
+ *
  * @slot - 内容
  * @slot toolbar - 工具栏
  */
 export declare class PageContainer extends ReactNextElement implements PageContainerProps {
+    /** 页面标题，同时会调用 applyPageTitle 更新浏览器标签页标题 */
     accessor pageTitle: string | undefined;
+    /** 面包屑导航配置，每项包含 text 和 url */
     accessor breadcrumbs: Breadcrumb[] | undefined;
+    /** 内容区域宽度模式，通过 CSS attribute selector 控制样式，不触发重新渲染 */
     accessor size: "medium" | "small" | "full" | undefined;
+    /** 页面变体，通过 CSS attribute selector 控制样式，不触发重新渲染 */
     accessor variant: "default" | "form" | undefined;
+    /** 是否固定头部（含面包屑和标题）到页面顶部 */
     accessor sticky: boolean | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/preview-container/index.d.ts

@@ -7,10 +7,14 @@ export interface PreviewContainerProps {
 }
 /**
  * 构件 `ai-portal.preview-container`
+ *
+ * TSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。
  */
 export declare class PreviewContainer extends ReactNextElement implements PreviewContainerProps {
     #private;
+    /** TSX 源码字符串，将被解析并渲染为页面视图 */
     accessor source: string | undefined;
+    /** 渲染上下文中可访问的 URL，传入后可在视图内通过路由相关 API 使用 */
     accessor url: string | undefined;
     render(): React.JSX.Element;
 }