@next-bricks/ai-portal 0.70.1 → 0.70.3

package/docs/notice-list.md

@@ -1,12 +1,38 @@
-构件 `ai-portal.notice-list`
+---
+tagName: ai-portal.notice-list
+displayName: WrappedAiPortalNoticeList
+description: 消息通知列表构件，用于展示消息列表，支持批量操作
+category: ""
+source: "@next-bricks/ai-portal"
+---
 
-消息通知列表构件，支持批量操作功能。
+# ai-portal.notice-list
+
+> 消息通知列表构件，用于展示消息列表，支持批量操作
+
+## Props
+
+| 属性        | 类型           | 必填 | 默认值 | 说明               |
+| ----------- | -------------- | ---- | ------ | ------------------ |
+| dataSource  | `NoticeItem[]` | 否   | -      | 消息数据列表       |
+| emptyText   | `string`       | 否   | -      | 空状态文案         |
+| urlTemplate | `string`       | 否   | -      | 详情链接           |
+| urlTarget   | `Target`       | 否   | -      | 详情链接目标       |
+| selectedIds | `string[]`     | 否   | -      | 选中的消息 ID 数组 |
+
+## Events
+
+| 事件            | detail                              | 说明               |
+| --------------- | ----------------------------------- | ------------------ |
+| notice.click    | `NoticeItem` — 消息项数据           | 消息项点击事件     |
+| mark.items.read | `NoticeItem[]` — 选中的消息 ID 数组 | 标记消息项已读事件 |
+| mark.all.read   | `void`                              | 全部已读事件       |
 
 ## Examples
 
-### Basic
+### 基础使用
 
-基础用法，展示消息列表。
+展示消息列表，支持批量选择和标记已读操作。
 
 ```yaml preview
 brick: ai-portal.notice-list
@@ -54,7 +80,7 @@ events:
         - "全部已读"
 ```
 
-### Empty State
+### 空状态
 
 空状态展示，可以自定义空状态文案。
 
@@ -64,3 +90,25 @@ properties:
   dataSource: []
   emptyText: "暂无新消息通知"
 ```
+
+### 带链接跳转
+
+配置 urlTemplate 使消息项点击后跳转到详情页。
+
+```yaml preview
+brick: ai-portal.notice-list
+properties:
+  urlTemplate: "/notices/{{id}}"
+  urlTarget: "_blank"
+  dataSource:
+    - id: "1"
+      type: "project"
+      isRead: false
+      title: "协作流【研发设计】已完成"
+      time: 1761207261887
+    - id: "2"
+      type: "account"
+      isRead: false
+      title: "您的账户资源配额即将达到限制"
+      time: 1761812267887
+```

package/docs/notice-list.react.md

@@ -0,0 +1,121 @@
+---
+tagName: ai-portal.notice-list
+displayName: WrappedAiPortalNoticeList
+description: 消息通知列表构件，用于展示消息列表，支持批量操作
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalNoticeList
+
+> 消息通知列表构件，用于展示消息列表，支持批量操作
+
+## 导入
+
+```tsx
+import { WrappedAiPortalNoticeList } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性        | 类型           | 必填 | 默认值 | 说明               |
+| ----------- | -------------- | ---- | ------ | ------------------ |
+| dataSource  | `NoticeItem[]` | 否   | -      | 消息数据列表       |
+| emptyText   | `string`       | 否   | -      | 空状态文案         |
+| urlTemplate | `string`       | 否   | -      | 详情链接           |
+| urlTarget   | `Target`       | 否   | -      | 详情链接目标       |
+| selectedIds | `string[]`     | 否   | -      | 选中的消息 ID 数组 |
+
+## Events
+
+| 事件            | detail                              | 说明               |
+| --------------- | ----------------------------------- | ------------------ |
+| onNoticeClick   | `NoticeItem` — 消息项数据           | 消息项点击事件     |
+| onMarkItemsRead | `NoticeItem[]` — 选中的消息 ID 数组 | 标记消息项已读事件 |
+| onMarkAllRead   | `void`                              | 全部已读事件       |
+
+## Examples
+
+### 基础使用
+
+展示消息列表，支持批量选择和标记已读操作。
+
+```tsx
+<WrappedAiPortalNoticeList
+  dataSource={[
+    {
+      id: "1",
+      type: "project",
+      isRead: true,
+      title: "协作流【研发设计】已完成",
+      time: 1761207261887,
+    },
+    {
+      id: "2",
+      type: "account",
+      isRead: true,
+      title: "您的账户资源配额即将达到限制",
+      time: 1761812267887,
+    },
+    {
+      id: "3",
+      type: "system",
+      isRead: false,
+      title: "服务通知：服务维护",
+      time: 1761818247887,
+    },
+    {
+      id: "4",
+      type: "space",
+      isRead: false,
+      title: "Luna 在项目【系统资源收集】中@了你",
+      time: 1761820851887,
+    },
+    {
+      id: "5",
+      type: "project",
+      isRead: false,
+      title: "协作流【设计规范】已完成",
+      time: 1761821891887,
+    },
+  ]}
+  onNoticeClick={(e) => console.log("消息点击:", e.detail)}
+  onMarkItemsRead={(e) => console.log("消息已读:", e.detail)}
+  onMarkAllRead={(e) => console.log("全部已读")}
+/>
+```
+
+### 空状态
+
+空状态展示，可以自定义空状态文案。
+
+```tsx
+<WrappedAiPortalNoticeList dataSource={[]} emptyText="暂无新消息通知" />
+```
+
+### 带链接跳转
+
+配置 urlTemplate 使消息项点击后跳转到详情页。
+
+```tsx
+<WrappedAiPortalNoticeList
+  urlTemplate="/notices/{{id}}"
+  urlTarget="_blank"
+  dataSource={[
+    {
+      id: "1",
+      type: "project",
+      isRead: false,
+      title: "协作流【研发设计】已完成",
+      time: 1761207261887,
+    },
+    {
+      id: "2",
+      type: "account",
+      isRead: false,
+      title: "您的账户资源配额即将达到限制",
+      time: 1761812267887,
+    },
+  ]}
+/>
+```

package/docs/page-container.md

@@ -1,11 +1,88 @@
-构件 `ai-portal.page-container`
+---
+tagName: ai-portal.page-container
+displayName: WrappedAiPortalPageContainer
+description: 页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.page-container
+
+> 页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。
+
+## Props
+
+| 属性        | 类型                            | 必填 | 默认值 | 说明                                                                   |
+| ----------- | ------------------------------- | ---- | ------ | ---------------------------------------------------------------------- |
+| pageTitle   | `string`                        | 否   | -      | 页面标题，同时会调用 applyPageTitle 更新浏览器标签页标题               |
+| breadcrumbs | `Breadcrumb[]`                  | 否   | -      | 面包屑导航配置，每项包含 text 和 url                                   |
+| size        | `"medium" \| "small" \| "full"` | 否   | -      | 内容区域宽度模式，通过 CSS attribute selector 控制样式，不触发重新渲染 |
+| variant     | `"default" \| "form"`           | 否   | -      | 页面变体，通过 CSS attribute selector 控制样式，不触发重新渲染         |
+| sticky      | `boolean`                       | 否   | -      | 是否固定头部（含面包屑和标题）到页面顶部                               |
+
+## Slots
+
+| 名称      | 说明   |
+| --------- | ------ |
+| (default) | 内容   |
+| toolbar   | 工具栏 |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+展示带页面标题和面包屑导航的页面容器。
+
+```yaml preview
+brick: ai-portal.page-container
+properties:
+  pageTitle: "页面标题"
+  breadcrumbs:
+    - text: "首页"
+      url: "/"
+    - text: "子页面"
+      url: "/sub"
+children:
+  - brick: div
+    properties:
+      textContent: "页面内容区域"
+```
+
+### 带工具栏
+
+在标题区右侧放置操作按钮。
+
+```yaml preview
+brick: ai-portal.page-container
+properties:
+  pageTitle: "资源管理"
+  breadcrumbs:
+    - text: "首页"
+      url: "/"
+children:
+  - brick: eo-button
+    slot: toolbar
+    properties:
+      type: primary
+      textContent: "新建"
+  - brick: div
+    properties:
+      textContent: "内容区域"
+```
+
+### 固定头部
+
+启用 sticky 将面包屑和标题区域固定在顶部。
 
 ```yaml preview
 brick: ai-portal.page-container
 properties:
-  textContent: Hello world
+  pageTitle: "固定头部示例"
+  sticky: true
+  size: medium
+  variant: default
+children:
+  - brick: div
+    properties:
+      textContent: "内容滚动时头部保持固定"
 ```

package/docs/page-container.react.md

@@ -0,0 +1,83 @@
+---
+tagName: ai-portal.page-container
+displayName: WrappedAiPortalPageContainer
+description: 页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalPageContainer
+
+> 页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalPageContainer } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性        | 类型                            | 必填 | 默认值 | 说明                                                                   |
+| ----------- | ------------------------------- | ---- | ------ | ---------------------------------------------------------------------- |
+| pageTitle   | `string`                        | 否   | -      | 页面标题，同时会调用 applyPageTitle 更新浏览器标签页标题               |
+| breadcrumbs | `Breadcrumb[]`                  | 否   | -      | 面包屑导航配置，每项包含 text 和 url                                   |
+| size        | `"medium" \| "small" \| "full"` | 否   | -      | 内容区域宽度模式，通过 CSS attribute selector 控制样式，不触发重新渲染 |
+| variant     | `"default" \| "form"`           | 否   | -      | 页面变体，通过 CSS attribute selector 控制样式，不触发重新渲染         |
+| sticky      | `boolean`                       | 否   | -      | 是否固定头部（含面包屑和标题）到页面顶部                               |
+
+## Slots
+
+| 名称      | 说明   |
+| --------- | ------ |
+| (default) | 内容   |
+| toolbar   | 工具栏 |
+
+## Examples
+
+### 基础使用
+
+展示带页面标题和面包屑导航的页面容器。
+
+```tsx
+<WrappedAiPortalPageContainer
+  pageTitle="页面标题"
+  breadcrumbs={[
+    { text: "首页", url: "/" },
+    { text: "子页面", url: "/sub" },
+  ]}
+>
+  <div>页面内容区域</div>
+</WrappedAiPortalPageContainer>
+```
+
+### 带工具栏
+
+在标题区右侧放置操作按钮。
+
+```tsx
+<WrappedAiPortalPageContainer
+  pageTitle="资源管理"
+  breadcrumbs={[{ text: "首页", url: "/" }]}
+>
+  <WrappedEoButton slot="toolbar" type="primary">
+    新建
+  </WrappedEoButton>
+  <div>内容区域</div>
+</WrappedAiPortalPageContainer>
+```
+
+### 固定头部
+
+启用 sticky 将面包屑和标题区域固定在顶部。
+
+```tsx
+<WrappedAiPortalPageContainer
+  pageTitle="固定头部示例"
+  sticky={true}
+  size="medium"
+  variant="default"
+>
+  <div>内容滚动时头部保持固定</div>
+</WrappedAiPortalPageContainer>
+```

package/docs/preview-container.md

@@ -1,8 +1,27 @@
-构件 `ai-portal.preview-container`
+---
+tagName: ai-portal.preview-container
+displayName: WrappedAiPortalPreviewContainer
+description: TSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.preview-container
+
+> TSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。
+
+## Props
+
+| 属性   | 类型     | 必填 | 默认值 | 说明                                                            |
+| ------ | -------- | ---- | ------ | --------------------------------------------------------------- |
+| source | `string` | 否   | -      | TSX 源码字符串，将被解析并渲染为页面视图                        |
+| url    | `string` | 否   | -      | 渲染上下文中可访问的 URL，传入后可在视图内通过路由相关 API 使用 |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+将 TSX 源码字符串解析并渲染为磁盘使用情况报告视图。
 
 ```yaml preview minHeight="600px"
 brick: ai-portal.preview-container
@@ -76,7 +95,6 @@ properties:
       <View title="磁盘使用情况">
         {RESPONSE.list.map((item) => (
           <Card title={item.ip}>
-            {/* 磁盘空间使用情况 */}
             <Plaintext>磁盘空间使用</Plaintext>
             <Table
               dataSource={{ list: item.disk_usage }}
@@ -92,8 +110,6 @@ properties:
               rowKey="device"
               pagination={false}
             />
-
-            {/* Inode 使用情况 */}
             <Plaintext>Inode 使用情况</Plaintext>
             <Table
               dataSource={{ list: item.inode_usage }}
@@ -103,37 +119,11 @@ properties:
                 { dataIndex: "total_inodes", key: "total_inodes", title: "Inode 总数" },
                 { dataIndex: "used_inodes", key: "used_inodes", title: "已用 Inode" },
                 { dataIndex: "free_inodes", key: "free_inodes", title: "空闲 Inode" },
-                {
-                  dataIndex: "percent", key: "percent", title: "使用率",
-                  render: (cell, record) => (
-                    // <Plaintext>{record.percent}%</Plaintext>
-                    `~${record.percent}`
-                  )
-                }
+                { dataIndex: "percent", key: "percent", title: "使用率" }
               ]}
               rowKey="device"
               pagination={false}
             />
-
-            {/* 大文件列表（仅当存在 large_files 且有内容时） */}
-            {item.disk_usage
-              .filter(disk => disk.large_files && disk.large_files.length > 0)
-              .map(disk =>
-                disk.large_files ? (
-                  <Fragment key={disk.device}>
-                    <Plaintext>{`大文件列表 (${disk.mount_point})`}</Plaintext>
-                    <Table
-                      dataSource={{ list: disk.large_files }}
-                      columns={[
-                        { dataIndex: "path", key: "path", title: "路径" },
-                        { dataIndex: "size", key: "size", title: "大小" }
-                      ]}
-                      rowKey="path"
-                      pagination={false}
-                    />
-                  </Fragment>
-                ) : null
-              )}
           </Card>
         ))}
       </View>

package/docs/preview-container.react.md

@@ -0,0 +1,71 @@
+---
+tagName: ai-portal.preview-container
+displayName: WrappedAiPortalPreviewContainer
+description: TSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalPreviewContainer
+
+> TSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalPreviewContainer } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性   | 类型     | 必填 | 默认值 | 说明                                                            |
+| ------ | -------- | ---- | ------ | --------------------------------------------------------------- |
+| source | `string` | 否   | -      | TSX 源码字符串，将被解析并渲染为页面视图                        |
+| url    | `string` | 否   | -      | 渲染上下文中可访问的 URL，传入后可在视图内通过路由相关 API 使用 |
+
+## Examples
+
+### 基础使用
+
+将 TSX 源码字符串解析并渲染为磁盘使用情况报告视图。
+
+```tsx
+<WrappedAiPortalPreviewContainer
+  style={{ position: "fixed", inset: 0, overflowY: "auto" }}
+  source={`
+    const RESPONSE = {
+      "list": [
+        {
+          "ip": "172.30.0.134",
+          "disk_usage": [
+            { "device": "/dev/sda1", "mount_point": "/", "total": "95.00GB", "used": "85.00GB", "free": "9.00GB", "percent": "91%", "rw_status": "rw" }
+          ]
+        }
+      ]
+    };
+
+    export default (
+      <View title="磁盘使用情况">
+        {RESPONSE.list.map((item) => (
+          <Card title={item.ip}>
+            <Table
+              dataSource={{ list: item.disk_usage }}
+              columns={[
+                { dataIndex: "device", key: "device", title: "设备" },
+                { dataIndex: "mount_point", key: "mount_point", title: "挂载点" },
+                { dataIndex: "total", key: "total", title: "总大小" },
+                { dataIndex: "used", key: "used", title: "已用空间" },
+                { dataIndex: "free", key: "free", title: "可用空间" },
+                { dataIndex: "percent", key: "percent", title: "使用率" },
+                { dataIndex: "rw_status", key: "rw_status", title: "读写状态" }
+              ]}
+              rowKey="device"
+              pagination={false}
+            />
+          </Card>
+        ))}
+      </View>
+    );
+  `}
+/>
+```

package/docs/project-conversations.md

@@ -1,8 +1,36 @@
-构件 `ai-portal.project-conversations`
+---
+tagName: ai-portal.project-conversations
+displayName: WrappedAiPortalProjectConversations
+description: 项目会话列表构件，展示项目中的会话记录，支持目标分类、操作菜单。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.project-conversations
+
+> 项目会话列表构件，展示项目中的会话记录，支持目标分类、操作菜单。
+
+## Props
+
+| 属性        | 类型             | 必填 | 默认值 | 说明                                                                         |
+| ----------- | ---------------- | ---- | ------ | ---------------------------------------------------------------------------- |
+| list        | `Conversation[]` | 否   | -      | 会话列表数据，为 undefined 时显示加载状态                                    |
+| urlTemplate | `string`         | 否   | -      | 会话详情链接模板，支持使用会话字段插值，如 /conversations/{{conversationId}} |
+| actions     | `ActionType[]`   | 否   | -      | 操作菜单配置，每项会话行尾显示可操作的菜单项                                 |
+| goals       | `Goal[]`         | 否   | -      | 目标列表，用于显示会话关联的目标名称                                         |
+
+## Events
+
+| 事件         | detail                                                                                                        | 说明                         |
+| ------------ | ------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| goal.click   | `Conversation` — { conversationId: 会话ID, title: 会话标题, startTime: 开始时间, goalInstanceId: 目标实例ID } | 点击会话关联的目标标签时触发 |
+| action.click | `ActionClickDetail` — { action: 操作项配置, item: 所属会话数据 }                                              | 点击操作菜单项时触发         |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+展示会话列表，当 list 为 undefined 时显示加载态。
 
 ```yaml preview
 brick: ai-portal.project-conversations
@@ -12,13 +40,66 @@ properties:
       title: 标题一
       description: 这是一段描述
       startTime: 1757904096
-      goal: GOAL0005
     - conversationId: "conv-b"
       title: 标题二
       startTime: 1757863597
 ```
 
-### Loading
+### 带目标分类
+
+配置 goals 后会话卡片会显示关联的目标名称标签。
+
+```yaml preview
+brick: ai-portal.project-conversations
+properties:
+  goals:
+    - instanceId: "GOAL0001"
+      title: "提升研发效率"
+    - instanceId: "GOAL0002"
+      title: "降低故障率"
+  list:
+    - conversationId: "conv-a"
+      title: 关联目标的会话
+      startTime: 1757904096
+      goalInstanceId: "GOAL0001"
+    - conversationId: "conv-b"
+      title: 全局会话（无目标）
+      startTime: 1757863597
+```
+
+### 带操作菜单
+
+配置 actions 后每行显示可操作的菜单项。
+
+```yaml preview
+brick: ai-portal.project-conversations
+properties:
+  actions:
+    - text: "删除"
+      event: "delete"
+      icon:
+        lib: "antd"
+        icon: "delete"
+  list:
+    - conversationId: "conv-a"
+      title: 会话标题一
+      description: 这是一段描述
+      startTime: 1757904096
+      username: "alice"
+    - conversationId: "conv-b"
+      title: 会话标题二
+      startTime: 1757863597
+events:
+  action.click:
+    action: console.log
+    args:
+      - "操作点击:"
+      - "<% EVENT.detail %>"
+```
+
+### 加载状态
+
+list 为 undefined 时显示加载中状态。
 
 ```yaml preview
 brick: ai-portal.project-conversations