@lovrabet/rabetbase-cli 2.4.5 → 2.4.6-beta.2

package/skills/rabetbase/guides/{react-custom-page-workflow.md → custom-page-workflow.md}

@@ -1,12 +1,12 @@
-# React 自定义页面工作流
+# 自定义页面工作流
 
-本指南说明如何使用 `rabetbase` 创建、修改和发布 React 自定义页面。页面内容由完整 JSX、样式和多语言文件组成。
+本指南说明如何使用 `rabetbase` 创建、修改和发布自定义页面。页面内容由完整 JSX、样式和多语言文件组成。
 
 ## 适用范围
 
 适用于以下目标：
 
-- 新建或修改 React 自定义页面、看板、门户、落地页或复杂交互页面
+- 新建或修改 自定义页面、看板、门户、落地页或复杂交互页面
 - 使用 ECharts 实现图表、统计卡片和数据大屏
 
 ## 前置上下文
@@ -19,58 +19,58 @@
 
 ### 新建页面
 
-1. 先阅读 [`rabetbase-page-react-create.md`](../references/rabetbase-page-react-create.md)
-2. 可选传入完整 `--page-content`；省略时 CLI 生成默认文件。先执行 `page react-create --dry-run`，确认页面名称、父菜单和最终页面文件
+1. 先阅读 [`rabetbase-page-create.md`](../references/rabetbase-page-create.md)
+2. 使用基础模板时传 `--page-pattern BLANK`；已有完整源码时只传 `--page-content`。先执行 `page create --dry-run`，确认页面名称、父菜单和最终页面文件
 3. 经用户确认后创建页面，记录 `data.after.pageId`。新页面默认尚未发布
-4. 执行 `page react-detail --id <pageId>`，以 `data.codeContent` 中的完整页面文件为修改基线
+4. 执行 `page custom-detail --id <pageId>`，以 `data.codeContent` 中的完整页面文件为修改基线
 5. 需要定制初始文件时，再按“更新页面”流程保存完整页面文件
 
 创建页面会同时创建菜单入口。不得额外调用菜单创建命令重复创建入口。
 
 ### 查找或修改已有页面
 
-1. 未知页面 ID 时，先阅读 [`rabetbase-page-react-list.md`](../references/rabetbase-page-react-list.md)，执行 `page react-list --appcode <appCode>`
+1. 未知页面 ID 时，先阅读 [`rabetbase-page-custom-list.md`](../references/rabetbase-page-custom-list.md)，执行 `page custom-list --appcode <appCode>`
 2. 根据 `data.pages[].pageId` 与 `label` 与用户确认目标页面；`data.pages[].pageUrl` 用于查看最新保存内容，`data.pages[].editPageUrl` 用于打开页面编辑器
-3. 阅读 [`rabetbase-page-react-detail.md`](../references/rabetbase-page-react-detail.md)，执行 `page react-detail --id <pageId>`
+3. 阅读 [`rabetbase-page-custom-detail.md`](../references/rabetbase-page-custom-detail.md)，执行 `page custom-detail --id <pageId>`
 4. 只在返回的最新 `data.codeContent` 基础上编辑，不得根据旧缓存或猜测覆盖文件
 
 ### 更新页面
 
-1. 阅读 [`rabetbase-page-react-update.md`](../references/rabetbase-page-react-update.md)
+1. 阅读 [`rabetbase-page-custom-update.md`](../references/rabetbase-page-custom-update.md)
 2. 将新增、修改和保留的所有文件整理为完整 `page-content` JSON
-3. 先执行 `page react-update --dry-run` 审阅完整页面文件
+3. 先执行 `page custom-update --dry-run` 审阅完整页面文件
 4. 经用户确认后执行更新
-5. 再执行 `page react-detail --id <pageId>`，确认 `codeContent` 已包含预期文件和内容
+5. 再执行 `page custom-detail --id <pageId>`，确认 `codeContent` 已包含预期文件和内容
 6. 已发布页面更新后，最新保存内容需要再次发布，用户访问的已发布页面才能看到本次修改
 
-`page react-update` 会完整保存页面文件：未提交的文件会被删除。不得仅提交本次修改的单个文件，也不得为删除文件再调用不存在的独立删除命令。
+`page custom-update` 会完整保存页面文件：未提交的文件会被删除。不得仅提交本次修改的单个文件，也不得为删除文件再调用不存在的独立删除命令。
 
-当前 CLI 没有逐文件新增、编辑或删除命令。将本地文件操作整理为完整 `codeContent` 后再调用 `react-update`；每次更新都会创建一个新的保存版本，`react-detail` 默认读取最新页面内容。
+当前 CLI 没有逐文件新增、编辑或删除命令。将本地文件操作整理为完整 `codeContent` 后再调用 `custom-update`；每次更新都会创建一个新的保存版本，`custom-detail` 默认读取最新页面内容。
 
 ### 发布页面
 
-1. 先执行 `page react-detail --id <pageId>`，确认当前 `data.status`
-2. 当前状态为 `FORMAL` 时，表示当前保存内容已发布，不执行 `page react-publish`，直接查看已发布页面或继续后续流程
-3. 当前状态不是 `FORMAL` 时，读取 [`rabetbase-page-react-publish.md`](../references/rabetbase-page-react-publish.md)，再执行 `page react-publish --dry-run`
+1. 先执行 `page custom-detail --id <pageId>`，确认当前 `data.status`
+2. 当前状态为 `FORMAL` 时，表示当前保存内容已发布，不执行 `page custom-publish`，直接查看已发布页面或继续后续流程
+3. 当前状态不是 `FORMAL` 时，读取 [`rabetbase-page-custom-publish.md`](../references/rabetbase-page-custom-publish.md)，再执行 `page custom-publish --dry-run`
 4. 发布会影响用户实际访问的页面，必须取得用户明确确认后再执行
 5. 从 `data.after.status` 确认 `FORMAL`，表示内容已发布
 
-`data.pageUrl` 用于查看最新保存内容，包含尚未发布的修改；`data.editPageUrl` 用于打开页面编辑器；`page react-publish` 成功返回的 `data.runtimePageUrl` 用于查看已发布内容。不要将三者混用。
+`data.pageUrl` 用于查看最新保存内容，包含尚未发布的修改；`data.editPageUrl` 用于打开页面编辑器；`page custom-publish` 成功返回的 `data.runtimePageUrl` 用于查看已发布内容。不要将三者混用。
 
 ## 页面生命周期
 
-React 页面有“未发布”和“已发布”两种状态。未发布的修改可通过 `pageUrl` 或编辑器查看，已发布页面只展示最近一次发布的内容。
+自定义页面的 React JSX 实现有“未发布”和“已发布”两种状态。未发布的修改可通过 `pageUrl` 或编辑器查看，已发布页面只展示最近一次发布的内容。
 
 ```text
-page react-create
+page create --page-pattern BLANK
   → 未发布
   → 生成或更新完整页面文件
   → 未发布
-  → page react-publish
+  → page custom-publish
   → 已发布（FORMAL）→ 可通过 runtimePageUrl 查看已发布内容
-  → page react-update
+  → page custom-update
   → 未发布（已发布页面仍显示上一次发布内容）
-  → page react-publish
+  → page custom-publish
   → 已发布（FORMAL）→ 已发布页面展示最新发布内容
 ```
 
@@ -81,9 +81,9 @@ page react-create
 | 发布后 | 当前已发布版本，状态为 `FORMAL` | 本次已发布内容 | 通过 `runtimePageUrl` 查看或继续修改 |
 | 已发布后再次更新 | 最新保存内容，尚未发布 | 更新前的已发布内容 | 再次发布后才切换已发布页面内容 |
 
-`page react-detail` 用于确认最新保存内容，`page react-publish` 用于发布当前保存内容。不要仅因 `react-update` 成功就认为已发布页面已经更新。
+`page custom-detail` 用于确认最新保存内容，`page custom-publish` 用于发布当前保存内容。不要仅因 `custom-update` 成功就认为已发布页面已经更新。
 
-`react-detail` 返回 `FORMAL` 时，表示当前保存内容已经发布。没有新的修改时，跳过重复发布，继续查看已发布页面或后续流程。
+`custom-detail` 返回 `FORMAL` 时，表示当前保存内容已经发布。没有新的修改时，跳过重复发布，继续查看已发布页面或后续流程。
 
 ### 地址语义
 
@@ -95,7 +95,7 @@ page react-create
 
 ## 数据与服务契约
 
-图表与统计场景使用 `page react-create/update/publish` 管理的 React JSX 页面，呈现层直接使用白名单内的 `echarts@5`。
+图表与统计场景使用 `page create` 与 `page custom-update/publish` 管理的 React JSX 页面，呈现层直接使用白名单内的 `echarts@5`。
 
 ### 选型
 
@@ -130,16 +130,16 @@ page react-create
 
 ### ECharts 呈现层
 
-- 在 React 页面中直接使用白名单内的 `echarts@5` 构建图表；按组件生命周期初始化、更新和销毁实例。
+- 在自定义页面的 React JSX 实现中直接使用白名单内的 `echarts@5` 构建图表；按组件生命周期初始化、更新和销毁实例。
 - ECharts 只消费页面已经取得的业务数据，不负责访问数据库、执行 SQL 或做权限判断。
-- `page react-*` 页面与 `project create` 微前端模板是不同运行环境；前者不得因为模板示例使用了包装库，就引入白名单外依赖。
+- `page custom-*` 页面与 `project create` 微前端模板是不同运行环境；前者不得因为模板示例使用了包装库，就引入白名单外依赖。
 - 图表查询使用 Dataset、`client.sql.execute({ sqlCode, params })` 或受控 BFF，并完整处理加载、空态、失败和重试行为。
 
 ## 页面开发参考
 
-编写页面内容前，先阅读 [`generation-standards.md`](../knowledge/react-page/generation-standards.md)。
+编写页面内容前，先阅读 [`generation-standards.md`](../knowledge/custom-page/generation-standards.md)。
 
-- 选择、组合或新增 UI 组件时，按需阅读 [`components.md`](../knowledge/react-page/components.md)
+- 选择、组合或新增 UI 组件时，按需阅读 [`components.md`](../knowledge/custom-page/components.md)
 - 调用页面上下文、国际化、路由或数据客户端时，按需阅读 `generation-standards.md` 中的“页面上下文内置能力”
 - 未登记的组件、方法、参数和返回结构不得猜测，先补充确认后的规范再复用
 
@@ -156,7 +156,7 @@ src/components/*.jsx
 
 代码遵循以下约束：
 
-- 仅导入 [`generation-standards.md`](../knowledge/react-page/generation-standards.md)“依赖白名单”中的包及其子路径
+- 仅导入 [`generation-standards.md`](../knowledge/custom-page/generation-standards.md)“依赖白名单”中的包及其子路径
 - 使用页面上下文时，从 `@/context/app-context` 导入 `useSdkClient`、`useI18n`、`useNavigate`、`useLocation`
 - 数据读取或写入前，先确认数据集及 SDK 用法；接口或字段无法从现有事实确认时，不得猜测请求协议
 - 所有用户可见文案通过 `$i18n.t("key")` 获取，并在 `src/locales/index.js` 提供有效翻译
@@ -164,39 +164,39 @@ src/components/*.jsx
 - CSS 使用 Ant Design CSS 变量，不写死颜色或其他样式常量
 - 不新增白名单外依赖，不使用 `window.location`
 
-未传 `--page-content` 时，`react-create` 生成基础 JSX、样式和词包。首次自定义时，将初始文案和样式一并调整为上述约束后再发布，不把初始化模板视为最终页面实现。
+传 `--page-pattern BLANK` 时，`page create` 生成基础 JSX、样式和词包。首次自定义时，将初始文案和样式一并调整为上述约束后再发布，不把初始化模板视为最终页面实现。
 
 ## 页面内容自检
 
 在首次提交或每次更新完整 `codeContent` 前，按以下顺序自检：
 
-1. 先用 `page react-detail --id <pageId>` 读取最新页面文件，避免覆盖其他尚未发布的修改
+1. 先用 `page custom-detail --id <pageId>` 读取最新页面文件，避免覆盖其他尚未发布的修改
 2. 确认提交内容包含全部需要保留的文件，入口、样式、词包和组件之间的导入路径一致
-3. 对照 [`generation-standards.md`](../knowledge/react-page/generation-standards.md) 检查依赖白名单、国际化、路由、样式和数据契约
+3. 对照 [`generation-standards.md`](../knowledge/custom-page/generation-standards.md) 检查依赖白名单、国际化、路由、样式和数据契约
 4. 使用组件或内置方法时，分别对照 `components.md` 和 `generation-standards.md` 中的“页面上下文内置能力”，确认不存在未登记的属性、方法或返回结构假设
-5. 先完成“页面生成规范”中的静态自检，再执行 `page react-update --dry-run`。CLI 会阻止缺少 React 源码或存在基础 JS/JSX/TS/TSX 语法错误的内容，但不推断变量引用、模块导出、数据契约或运行时行为
-6. 更新后再次执行 `page react-detail --id <pageId>`，确认最新保存的 `codeContent` 与提交内容一致
-7. 需要让用户查看已发布页面时，先检查最新 `data.status`。状态为 `FORMAL` 时跳过发布；否则执行 `page react-publish --dry-run`、取得确认后发布，并确认 `data.after.status` 为 `FORMAL` 和 `data.runtimePageUrl` 已返回
+5. 先完成“页面生成规范”中的静态自检，再执行 `page custom-update --dry-run`。CLI 会阻止缺少 React 源码或存在基础 JS/JSX/TS/TSX 语法错误的内容，但不推断变量引用、模块导出、数据契约或运行时行为
+6. 更新后再次执行 `page custom-detail --id <pageId>`，确认最新保存的 `codeContent` 与提交内容一致
+7. 需要让用户查看已发布页面时，先检查最新 `data.status`。状态为 `FORMAL` 时跳过发布；否则执行 `page custom-publish --dry-run`、取得确认后发布，并确认 `data.after.status` 为 `FORMAL` 和 `data.runtimePageUrl` 已返回
 
 当前 CLI 不提供已发布页面截图或自动浏览器预览。发布成功后，使用返回的 `data.runtimePageUrl` 打开已发布页面进行人工预览。
 
 ## 最小验证闭环
 
 ```text
-新建：react-create --dry-run → react-create → react-detail → [按需] react-update --dry-run → react-update → react-detail → [尚未发布（status 非 FORMAL）且经确认] react-publish --dry-run → react-publish
+新建：create --page-pattern BLANK --dry-run → create --page-pattern BLANK → custom-detail → [按需] custom-update --dry-run → custom-update → custom-detail → [尚未发布（status 非 FORMAL）且经确认] custom-publish --dry-run → custom-publish
 
-修改：react-list（按需）→ react-detail → react-update --dry-run → react-update → react-detail → [尚未发布（status 非 FORMAL）且经确认] react-publish --dry-run → react-publish
+修改：custom-list（按需）→ custom-detail → custom-update --dry-run → custom-update → custom-detail → [尚未发布（status 非 FORMAL）且经确认] custom-publish --dry-run → custom-publish
 ```
 
 CLI 当前不提供本地预览或独立删除命令。
 
 ## 参考
 
-- [`rabetbase-page-react-create.md`](../references/rabetbase-page-react-create.md)
-- [`rabetbase-page-react-list.md`](../references/rabetbase-page-react-list.md)
-- [`rabetbase-page-react-detail.md`](../references/rabetbase-page-react-detail.md)
-- [`rabetbase-page-react-update.md`](../references/rabetbase-page-react-update.md)
-- [`rabetbase-page-react-publish.md`](../references/rabetbase-page-react-publish.md)
-- [`generation-standards.md`](../knowledge/react-page/generation-standards.md)
-- [`components.md`](../knowledge/react-page/components.md)
+- [`rabetbase-page-create.md`](../references/rabetbase-page-create.md)
+- [`rabetbase-page-custom-list.md`](../references/rabetbase-page-custom-list.md)
+- [`rabetbase-page-custom-detail.md`](../references/rabetbase-page-custom-detail.md)
+- [`rabetbase-page-custom-update.md`](../references/rabetbase-page-custom-update.md)
+- [`rabetbase-page-custom-publish.md`](../references/rabetbase-page-custom-publish.md)
+- [`generation-standards.md`](../knowledge/custom-page/generation-standards.md)
+- [`components.md`](../knowledge/custom-page/components.md)
 - [`rabetbase-codegen-sdk.md`](../references/rabetbase-codegen-sdk.md)

package/skills/rabetbase/guides/page-development-workflow.md

@@ -1,14 +1,14 @@
-# 智能列表页（Smart List Page，page）工作流
+# 数据列表页（Data List Page，page）工作流
 
 前置知识：已完成 `rabetbase auth` 登录，当前上下文已有 `appcode`，并已理解 `knowledge/page-schema/` 是 PageSchema 组件知识，不是 `rabetbase page` 命令说明。
 
 ## 适用范围
 
-本工作流只适用于 **智能列表页（Smart List Page，DOV2 `smart_page`）** 路径：
+本工作流只适用于 **数据列表页（Data List Page，DOV2 `smart_page`）** 路径：
 
-- 基于数据集首次生成智能列表页
-- 数据集字段变更后同步已有智能列表页
-- 将智能列表页 schema 拉到本地进行 IDE 修改，再推回平台
+- 基于数据集首次生成数据列表页
+- 数据集字段变更后同步已有数据列表页
+- 将数据列表页 schema 拉到本地进行 IDE 修改，再推回平台
 
 不适用于：
 
@@ -16,11 +16,11 @@
 - 本地主子应用开发（使用 `rabetbase project`）
 - 只凭“数据集缺页”就批量生成所有页面的场景
 
-评论、附件、历史记录等子资源，默认不优先作为独立主页面；若业务目标不是标准智能列表页（Smart List Page），先停下来确认是否还应继续走 `page` 工作流。
+评论、附件、历史记录等子资源，默认不优先作为独立主页面；若业务目标不是数据列表页（Data List Page），先停下来确认是否还应继续走 `page` 工作流。
 
 ## 核心原则
 
-1. 智能列表页是“标准后台”方案，不是所有数据集的默认答案。
+1. 数据列表页是数据查看与维护方案，不是所有数据集的默认答案，也不等同于最终业务工作台。
 2. 平台是页面权威来源；本地 schema 开发也必须通过 `pull -> IDE 编辑 -> push` 闭环。
 3. 新编排与自动化链路统一按 async-first 契约编排：任务状态查询与页面事实查询分离。
 4. 生产环境先做 `--dry-run`，确认目标、页面组和风险后再执行真实写操作。
@@ -33,13 +33,13 @@
 
 ### 1. 确认业务目标
 
-先确认这次目标是不是智能列表页最擅长的事情：
+先确认这次目标是不是数据列表页最擅长的事情：
 
-- 列表 / 新建 / 编辑 / 详情型智能列表页（Smart List Page）
+- 列表 / 新建 / 编辑 / 详情型数据列表页（Data List Page）
 - 标准管理后台
 - 单数据集或轻度关联数据集
 
-如果目标是工作台、看板、时间轴、复杂协作视图，说明它不属于本地 `rabetbase page` 工作流；本地研发工程师应改走 `rabetbase project` 主子应用开发路径。
+如果目标是工作台、看板、时间轴或复杂协作视图，它不属于数据列表页工作流，但仍然属于页面需求，应使用 `rabetbase page create --page-pattern BLANK` 或 `--page-content` 创建 CUSTOM JSX 页面。`rabetbase project` 表达的是独立子应用工程，不是页面类型，也不是复杂页面的兜底入口。
 
 ### 2. 校验数据集与关联页
 
@@ -54,7 +54,7 @@ rabetbase dataset relations --datasetcode <datasetCode> --format json
 
 - 数据集是否存在
 - 字段名、字段类型、关联关系是否符合预期
-- `relatedPages` 中是否已有未删除智能列表页
+- `relatedPages` 中是否已有未删除数据列表页
 
 ### 3. 判断用 `generate-start / sync`
 
@@ -67,7 +67,7 @@ rabetbase dataset relations --datasetcode <datasetCode> --format json
 推荐先做预演（`generate-start` 默认就是预演，必须显式 `--apply` 才提交）：
 
 ```bash
-rabetbase page standard-page-status --datasetcode <datasetCode> --format json
+rabetbase page data-list-status --datasetcode <datasetCode> --format json
 rabetbase page generate-start --datasetcode <datasetCode> --format json
 rabetbase page sync --datasetcode <datasetCode> --dry-run --format json
 ```
@@ -81,7 +81,7 @@ rabetbase page generate-start --datasetcode <datasetCode> --apply --format json
 rabetbase page generate-status --datasetcode <datasetCode> --task-id <taskId> --format json
 ```
 
-`taskId` 是首选查询标识；只有旧响应没有 taskId 时才回退 `operationId`，两者都丢失时再用 `clientOperationId`。三种标识必须且只能传一个。查询超时、未知状态或网络失败时继续查询原任务，不重新提交生成。成功终态后，从 `standardPageStatus.pageSets[]` 读取页面事实和 `versionTag`；存在多个完整组、残留页或冲突时交给用户确认，不猜测页面组。
+`taskId` 是首选查询标识；只有旧响应没有 taskId 时才回退 `operationId`，两者都丢失时再用 `clientOperationId`。三种标识必须且只能传一个。查询超时、未知状态或网络失败时继续查询原任务，不重新提交生成。成功终态后，从 `dataListPageStatus.pageSets[]` 读取页面事实和 `versionTag`；存在多个完整组、残留页或冲突时交给用户确认，不猜测页面组。
 
 ### 4. 拉取页面 schema 到本地
 
@@ -98,7 +98,7 @@ rabetbase page pull --datasetcode <datasetCode> --version-tag <versionTag> --for
 - `--id` 用于单页
 - `--datasetcode` / `--alias` 用于按数据集批量
 - 同一命令里 `--id` 与 `--datasetcode` / `--alias` 互斥
-- 生成链路优先使用 `page generate-status` 的 `standardPageStatus.pageSets[].versionTag`
+- 生成链路优先使用 `page generate-status` 的 `dataListPageStatus.pageSets[].versionTag`
 - 批量模式下若同一数据集存在多组页面且 `versionTag` 不唯一，必须由用户确认后显式传 `--version-tag`
 
 本地文件位置：
@@ -143,18 +143,18 @@ rabetbase page push --datasetcode <datasetCode> --version-tag <tag> --format jso
 
 ## 常见分支
 
-### A. 首次补齐智能列表页
+### A. 首次补齐数据列表页
 
 ```text
-dataset detail → standard-page-status → page generate-start（默认预览） → page generate-start --apply → 保存 taskId → page generate-status → 从 standardPageStatus.pageSets[] 选择 versionTag
+dataset detail → page data-list-status → page generate-start（默认预览） → page generate-start --apply → 保存 taskId → page generate-status → 从 dataListPageStatus.pageSets[] 选择 versionTag
 ```
 
 适用于：
 
-- 主业务对象还没有任何智能列表页
-- 目标是快速补齐标准智能列表页（Smart List Page）
+- 主业务对象还没有任何数据列表页
+- 目标是快速补齐基础数据列表页（Data List Page）
 
-### B. 字段变更后同步已有智能列表页
+### B. 字段变更后同步已有数据列表页
 
 ```text
 dataset detail → page sync --dry-run → page sync
@@ -163,7 +163,7 @@ dataset detail → page sync --dry-run → page sync
 适用于：
 
 - 数据集字段已变化
-- 关联智能列表页已经存在
+- 关联数据列表页已经存在
 
 ### C. 本地 schema 开发
 
@@ -173,7 +173,7 @@ page pull → IDE 编辑 → page push --dry-run → page push
 
 适用于：
 
-- 智能列表页已经生成
+- 数据列表页已经生成
 - 需要在 formal schema 层做本地定制
 
 ## 参考
@@ -181,7 +181,7 @@ page pull → IDE 编辑 → page push --dry-run → page push
 - [SKILL.md](../SKILL.md)
 - [rabetbase-page-generate-start.md](../references/rabetbase-page-generate-start.md)
 - [rabetbase-page-generate-status.md](../references/rabetbase-page-generate-status.md)
-- [rabetbase-standard-page-status.md](../references/rabetbase-standard-page-status.md)
+- [rabetbase-data-list-status.md](../references/rabetbase-data-list-status.md)
 - [rabetbase-page-sync.md](../references/rabetbase-page-sync.md)
 - [rabetbase-page-pull.md](../references/rabetbase-page-pull.md)
 - [rabetbase-page-push.md](../references/rabetbase-page-push.md)

package/skills/rabetbase/knowledge/{react-page → custom-page}/components.md

@@ -1,6 +1,6 @@
-# React 自定义页面组件用法
+# 自定义页面组件用法
 
-本文件登记 React 自定义页面可复用的 UI 组件规范。生成或修改页面前先阅读 [`generation-standards.md`](generation-standards.md)。
+本文件登记自定义页面可复用的 UI 组件规范。生成或修改页面前先阅读 [`generation-standards.md`](generation-standards.md)。
 
 ## 使用边界
 

package/skills/rabetbase/knowledge/{react-page → custom-page}/generation-standards.md

@@ -1,6 +1,6 @@
-# React 自定义页面生成规范
+# 自定义页面生成规范
 
-本规范用于编写或修改 React 自定义页面的完整 `codeContent`。执行命令流程、参数和发布规则以 [`react-custom-page-workflow.md`](../../guides/react-custom-page-workflow.md) 为准。
+本规范用于编写或修改自定义页面的完整 `codeContent`。执行命令流程、参数和发布规则以 [`custom-page-workflow.md`](../../guides/custom-page-workflow.md) 为准。
 
 ## 使用方式
 
@@ -15,7 +15,7 @@
 
 | 范畴     | 约束                                                                                                                      |
 | -------- | ------------------------------------------------------------------------------------------------------------------------- |
-| 提交内容 | `page react-update` 提交完整页面文件，未提交的已有文件会被删除                                                            |
+| 提交内容 | `page custom-update` 提交完整页面文件，未提交的已有文件会被删除                                                            |
 | 推荐结构 | 页面入口仍为 `src/app/index.jsx`；其余文件和组件目录可按页面需要组织，`src/app/index.css`、`src/locales/index.js`、`src/components/*.jsx` 仅为示例 |
 | 组件复用 | 优先查阅并复用已有组件库和页面已有组件；仅当现有能力无法满足需求时才创建新组件 |
 | 依赖     | 仅使用“依赖白名单”中的包及其子路径                                                                                       |
@@ -61,9 +61,9 @@
 
 ### `src/app/index.jsx` 模板
 
-初始化创建自定义页面时，必须以此模板生成 `src/app/index.jsx`。将 `{{pageName}}` 替换为页面名称；保留词包注册、上下文 Hook 和样式导入，再按需求扩展布局、状态与数据调用。通过 `page react-create --page-content` 初始化创建时，传入的 `src/app/index.jsx` 也必须从此模板派生。
+初始化创建自定义页面时，必须以此模板生成 `src/app/index.jsx`。将 `{{pageName}}` 替换为页面名称；保留词包注册、上下文 Hook 和样式导入，再按需求扩展布局、状态与数据调用。通过 `page create --page-content` 初始化创建时，传入的 `src/app/index.jsx` 也必须从此模板派生。
 
-更新已有页面时，以 `page react-detail` 返回的最新 `codeContent` 为基线；不强制套用或补齐本模板，应仅按更新需求修改页面内容。
+更新已有页面时，以 `page custom-detail` 返回的最新 `codeContent` 为基线；不强制套用或补齐本模板，应仅按更新需求修改页面内容。
 
 ```jsx
 import React from "react";
@@ -402,6 +402,6 @@ const location = useLocation();
 - [ ] 数据集、SQL、BFF 与其他 SDK 调用的资源事实、参数和返回结构均有依据
 - [ ] 路由、状态和错误反馈符合已确认的交互
 - [ ] CSS 未写死颜色或其他样式常量
-- [ ] 已先执行 `page react-create --dry-run` 或 `page react-update --dry-run` 审阅完整提交内容，并通过 CLI 的基础 JS/JSX/TS/TSX 语法校验
+- [ ] 已先执行 `page create --dry-run` 或 `page custom-update --dry-run` 审阅完整提交内容，并通过 CLI 的基础 JS/JSX/TS/TSX 语法校验
 
 CLI 的基础校验只确认页面包含 `.jsx` 或 `.tsx` 文件，且页面内的 JS、JSX、TS、TSX 文件能够解析。变量引用、相对模块导出、数据调用契约和运行时行为必须由本清单和页面发布后的实际使用继续确认

package/skills/rabetbase/knowledge/page-schema/LrSmartTable.md

@@ -38,9 +38,9 @@ tags: [table, page-schema, select, orderBy, isFetched, defaultSortOrder, sortabl
 | toolbar.exportButtons | BatchButton[] | 批量操作 |
 | rowSelection.enable | boolean | 行选择 |
 | pagination.enable | boolean | 分页 |
-| pagination.currentPageKey | string | 系统管理的当前页 state key；标准页面更新时保留 |
-| pagination.pageSizeKey | string | 系统管理的每页条数 state key；标准页面更新时保留 |
-| pagination.totalKey | string | 系统管理的总数 state key；标准页面更新时保留 |
+| pagination.currentPageKey | string | 系统管理的当前页 state key；数据列表页更新时保留 |
+| pagination.pageSizeKey | string | 系统管理的每页条数 state key；数据列表页更新时保留 |
+| pagination.totalKey | string | 系统管理的总数 state key；数据列表页更新时保留 |
 | columnSetting.enable | boolean | 列设置 |
 | columnSetting.storageKey | string | 列设置缓存 key |
 | otherTableProps | Record<string, any> | 其他 Ant Design 5 Table 的原生属性 |
@@ -213,11 +213,11 @@ V2 页面生成时已为数据集所有字段全量生成 columns，通过 `isSh
 
 `LrSmartTable` 的分页状态放在页面级 state 中管理，`pagination.currentPageKey`、`pagination.pageSizeKey`、`pagination.totalKey` 用于隔离同一页面中不同表格的分页状态，避免多个表格共用 `currentPage`、`pageSize`、`total` 这类固定 key 后互相影响。
 
-这三个 key 属于系统管理字段，不是业务配置。标准页面中由生成器或修复工具写入；Agent 更新标准页面时应保留已有 key，不主动配置、不主动改名。
+这三个 key 属于系统管理字段，不是业务配置。数据列表页中由生成器或修复工具写入；Agent 更新数据列表页时应保留已有 key，不主动配置、不主动改名。
 
 Agent 规则：
 
-- 常规标准页面更新：保留已有分页 key，只维护业务相关的分页开关、数据源、列和按钮。
+- 常规数据列表页更新：保留已有分页 key，只维护业务相关的分页开关、数据源、列和按钮。
 - 新增带分页的 `LrSmartTable`：由生成器生成表格独立的分页 key，Agent 不手写固定公共 key。
 - 历史 schema 缺失分页 key：作为修复场景补齐，不把它当成普通配置流程。
 
@@ -617,7 +617,7 @@ context 对象在 **JSFunction** 中通过 `config._context` 访问，用于状
 
 ## 权限配置
 
-当前标准页面由运行时过滤按钮权限。Agent 只需要维护表格按钮本身；按钮是否展示由运行时权限过滤决定。
+当前数据列表页由运行时过滤按钮权限。Agent 只需要维护表格按钮本身；按钮是否展示由运行时权限过滤决定。
 
 | 按钮位置 | 当前权限动作 |
 |----------|--------------|

package/skills/rabetbase/knowledge/page-schema/external-resources-usage.md

@@ -176,7 +176,7 @@ HOOK 脚本绑定到数据集 API 上，在 API 执行前或执行后自动触
 
 ## 4. 权限点使用规范
 
-当前标准页面权限由 `LrSmartTable` 运行时内置逻辑处理，Agent 只维护 `LrSmartTable` schema，不生成权限字段。
+当前数据列表页权限由 `LrSmartTable` 运行时内置逻辑处理，Agent 只维护 `LrSmartTable` schema，不生成权限字段。
 
 ### 4.1 当前实现
 

package/skills/rabetbase/references/rabetbase-bff-create.md

@@ -40,6 +40,8 @@ BFF 源码**仅**应在此目录树内创建与长期维护（与 `bff status` /
 - [`backend-function.md`](../guides/backend-function.md)：`context.client`、模型键、返回值、事务、消息通知扩展、禁止事项
 - [`data-api-guidelines.md`](../guides/data-api-guidelines.md)：字段、枚举、外键、性能规则
 
+脚手架会生成中文 JSDoc 契约，包含真实接口/配置地址、根请求参数、返回值，以及依赖数据集、调用 BF、执行 SQL、副作用等维护项。提交前必须按实际代码补充每个 `params.<字段名>` 的类型与含义，更新依赖维护项；显式抛出异常时还要补充 `@throws`。无依赖或无副作用的项目可以保留“无”，不能把模板提示当作已确认的业务事实。
+
 创建可由 CLI 调用的通知型 BFF 时使用 `ENDPOINT`，并先用 [`rabetbase notification config-list`](rabetbase-notification-config-list.md) 确认当前应用真实的通知 `configCode`。纯通知 ENDPOINT 不需要虚构数据集；脚本只通过 `context.client.extension.execute("notification", "send", ...)` 使用 `configCode`、`audiences`、`message`，不得写渠道地址或密钥。
 
 ## 提示

package/skills/rabetbase/references/{rabetbase-standard-page-status.md → rabetbase-data-list-status.md}

@@ -1,18 +1,18 @@
-# page standard-page-status
+# page data-list-status
 
-查询某个数据集当前智能列表页（Smart List Page）事实快照。
+查询某个数据集当前数据列表页（Data List Page）事实快照。
 
 ## 命令
 
 ```bash
-rabetbase page standard-page-status --datasetcode 097b7361b76c42bcb12b923fa5a08861 --format json
-rabetbase page standard-page-status --alias order --format json
+rabetbase page data-list-status --datasetcode 097b7361b76c42bcb12b923fa5a08861 --format json
+rabetbase page data-list-status --alias order --format json
 ```
 
 ## 行为说明
 
 - 该命令只返回**页面事实**：
-  - 智能列表页组
+  - 数据列表页组
   - 是否完整
   - 残留页
   - 菜单事实
@@ -22,7 +22,7 @@ rabetbase page standard-page-status --alias order --format json
 ## 适用场景
 
 - 生成前判断是否允许继续 `generate-start`
-- 生成完成后确认是否真的形成完整智能列表页组
+- 生成完成后确认是否真的形成完整数据列表页组
 - 排查为什么当前数据集被判定为 `blocked_*`
 
 ## 参考

package/skills/rabetbase/references/rabetbase-dataset-generate.md

@@ -185,7 +185,7 @@ Status 成功后的 `data` 包含：
 - `PENDING` / `PROCESSING` 都不是完成；始终继续查询同一个 taskId。
 - 超时、未知状态或 start 响应丢失时只做状态恢复，不得自动重提生成请求。
 - 成功后用 `rabetbase dataset detail --code <createdDataset.code> --format compress` 确认结构。
-- 如需生成智能列表页，再执行 `rabetbase page generate-start --datasetcode <createdDataset.code> --format compress`。
+- 如需生成数据列表页，再执行 `rabetbase page generate-start --datasetcode <createdDataset.code> --format compress`。
 - 真实业务行数据验证交接到 `lovrabet data filter|getOne`。
 
 ## 常见失败

package/skills/rabetbase/references/rabetbase-dataset-relation-mutations.md

@@ -48,7 +48,7 @@ rabetbase dataset relation-delete --appcode <appCode> --relation-id <relationId>
 |------|----|:---:|------|
 | `DB_TABLE` | `DB_TABLE` | 是 | V2 数据集之间关系，底层可映射到表关系 |
 | `DB_TABLE` | `METADATA` | 是 | `DB_TABLE` 字段消费 `METADATA` 字典/选项源 |
-| `METADATA` | `METADATA` | 是 | V2 标准页面/配置数据集关系 |
+| `METADATA` | `METADATA` | 是 | V2 数据列表页/配置数据集关系 |
 | `METADATA` | `DB_TABLE` | 否 | CLI 校验阶段拒绝 |
 
 | Flag | update | 说明 |

package/skills/rabetbase/references/rabetbase-dataset-relations.md

@@ -57,7 +57,7 @@ rabetbase dataset relations --from-source DB_TABLE --to-source METADATA --format
 
 ## Agent 使用规则
 
-- 页面关系审计、标准页面绑定、字典/选项源判断，直接使用 `dataset relations --format compress`；命令底层默认读取 D0/DO V2 关系事实
+- 页面关系审计、数据列表页绑定、字典/选项源判断，直接使用 `dataset relations --format compress`；命令底层默认读取 D0/DO V2 关系事实
 - 更新或删除前确认 `relationId`；写入前确认来源/目标 `datasetCode + field`、`to.labelField`、`relation.cardinality` 和 `relation.bizRelationType`
 - `DB_TABLE -> METADATA` 表示业务表字段消费 METADATA 字典，不要把它理解为数据库外键
 - `METADATA -> METADATA` 可以是自关联父子关系；是否自关联由 `from.datasetCode === to.datasetCode` 自行判断，不在协议里增加派生字段

package/skills/rabetbase/references/rabetbase-dataset-restore.md

@@ -35,7 +35,7 @@ rabetbase dataset restore --dbid 10282 --expected-count 3 --confirm --yes --form
 - 命令只在已删除数据集中定位目标。
 - dry-run 输出每个 Dataset 的 `relatedPageCount`，便于判断后续是否需要恢复页面。
 - 每个 Dataset 必须恰好匹配一条删除记录；记录缺失或存在多条匹配记录时中止。
-- 恢复结果固定标记 `pagesRestored=false`。关联页面需按需执行 `rabetbase page restore --id <pageId> --appcode <appCode>`；STANDARD 页面恢复会恢复对应菜单。
+- 恢复结果固定标记 `pagesRestored=false`。关联页面需按需执行 `rabetbase page restore --id <pageId> --appcode <appCode>`；数据列表页恢复会恢复对应菜单。
 - `--dbid` 批量恢复建议始终配合 `--expected-count`。
 - 该命令不会创建新的物理表，也不会修改业务数据。
 

package/skills/rabetbase/references/rabetbase-menu-list.md

@@ -117,6 +117,7 @@ rabetbase menu list --verbose --format json
 - 查看菜单是否已配置 CDN 资源 URL。
 - 审计重复 path、根级 label 重复、孤儿父节点等菜单异常，并生成平台人工处理清单。
 - 修改菜单名称前确认 `id/label`；所有菜单类型统一使用 `menu rename`。
+- 显示或隐藏菜单前确认 `id/path/visible`；批量写入统一使用 `menu visibility-update`。
 - 修改 iframe/link 页面 URL 前确认 `id/url/parentId`；写入入口使用 `menu external-link-update`。
 - 修改微前端 JS/CSS 资源前确认当前 resources；写入入口使用 `menu asset-update`。
 - 提供稳定的菜单事实入口，避免使用底层数据源查询菜单配置。
@@ -124,10 +125,10 @@ rabetbase menu list --verbose --format json
 ## 不负责
 
 - 不做本地 `src/pages` 与线上菜单 diff；这类对比使用 `menu sync`。
-- 不做智能列表页菜单审计；dataset-scoped 页面事实使用 `page standard-page-status`。
+- 不做数据列表页菜单审计；dataset-scoped 页面事实使用 `page data-list-status`。
 - 不修改外链 URL；使用 `menu external-link-update`，并带旧 URL 与父级断言。
 - 不修改菜单资源；更新 JS / CSS 资源 URL 使用 `menu asset-update`，并先执行 dry-run。
-- 不修改菜单；改名使用 `menu rename`，空 folder 删除使用计划化的 `menu delete`，分组生命周期使用 `group-create/group-update/regroup-start`，写操作都必须先 dry-run。
+- 不修改菜单；显示隐藏使用 `menu visibility-update`，改名使用 `menu rename`，空 folder 删除使用计划化的 `menu delete`，分组生命周期使用 `group-create/group-update/regroup-start`，写操作都必须先 dry-run。
 
 ## 参考
 
@@ -135,6 +136,7 @@ rabetbase menu list --verbose --format json
 - [menu external-link-create](rabetbase-menu-external-link-create.md)
 - [menu external-link-update](rabetbase-menu-external-link-update.md)
 - [menu rename](rabetbase-menu-rename.md)
+- [menu visibility-update](rabetbase-menu-visibility-update.md)
 - [menu asset-update](rabetbase-menu-asset-update.md)
 - [menu delete](rabetbase-menu-delete.md)
 - [menu group-create](rabetbase-menu-group-create.md)

package/skills/rabetbase/references/rabetbase-menu-visibility-update.md

@@ -0,0 +1,59 @@
+# menu visibility-update
+
+按精确菜单 ID 或 path 批量显示、隐藏线上菜单。该命令只更新 `visible`，不删除页面，也不修改 path、URL、父级、排序或资源。
+
+## 隐藏菜单
+
+```bash
+rabetbase menu list --format compress
+rabetbase menu visibility-update --menu-ids "10,11" --visible=false --expect-visible=true --expected-count 2 --dry-run --format compress
+rabetbase menu visibility-update --menu-ids "10,11" --visible=false --expect-visible=true --expected-count 2 --yes --format compress
+rabetbase menu list --format json --jq '.data.menus[] | select(.id == 10 or .id == 11) | {id, path, visible}'
+```
+
+## 恢复显示
+
+```bash
+rabetbase menu visibility-update --menu-ids "10,11" --visible=true --expect-visible=false --expected-count 2 --dry-run --format compress
+rabetbase menu visibility-update --menu-ids "10,11" --visible=true --expect-visible=false --expected-count 2 --yes --format compress
+```
+
+## Flags
+
+| Flag | 类型 | 说明 |
+|---|---|---|
+| `--menu-ids <csv>` | string | 精确菜单 ID；只接受正安全整数，可与 paths 组合并去重 |
+| `--paths <csv>` | string | 精确菜单 path；同一路径命中多条时必须改用 ID |
+| `--visible <true\|false>` | boolean | 必填，目标可见性；显式 `false` 不会被忽略 |
+| `--expect-visible <true\|false>` | boolean | 可选，断言所有目标当前可见性，防止覆盖并发变化 |
+| `--expected-count <n>` | number | 可选，断言去重后的精确目标数量 |
+| `--dry-run` | boolean | 输出目标、before/after、snapshotHash 和最小请求，不写入 |
+| `--yes` | boolean | 正式执行必填；该命令是 `high-risk-write` |
+
+`--menu-ids` 与 `--paths` 至少提供一个。任一 selector 未命中会整批失败，不会静默更新子集；ID 与 path 选中同一菜单时自动去重。
+
+## 执行检查
+
+1. 先用 `menu list` 取得精确 ID、path 和当前 `visible`。
+2. dry-run 时同时传 `--expect-visible` 与 `--expected-count`。
+3. 检查 `targets[].before/after`，确认只有 `visible` 改变。
+4. 复用相同 selector、目标值和断言，添加 `--yes` 正式执行。
+5. 检查 `succeeded/failed` 与 `verification.matchesRequestedState`，再用 `menu list` 回查。
+
+目标已经等于期望值时返回 `skipped=true`，不发送更新请求。批量请求出现部分失败时不会自动重试；先按 `succeeded/failed` 和 `menu list` 核对实际状态，再为仍未生效的精确 ID 重新 dry-run。
+
+## 常见错误
+
+- `menu_selector_not_found`：ID 或 path 不存在；重新执行 `menu list` 获取当前事实。
+- `menu_selector_ambiguous`：一个 path 命中多条菜单；按错误提示改用 `--menu-ids`。
+- `menu_expected_count_mismatch`：去重后的目标数量与断言不一致；重新检查 selector。
+- `menu_state_drift`：当前可见性或菜单快照发生变化；重新读取并 dry-run。
+- `menu_verification_failed`：写后 visible 或未修改字段无法确认；先执行 `menu list`，不要直接重试整批。
+
+隐藏菜单只影响菜单展示，不等于禁用页面或修改权限。页面能否通过直达地址访问，仍由平台现有权限事实决定。
+
+## 相关命令
+
+- [menu list](rabetbase-menu-list.md)
+- [menu move](rabetbase-menu-move.md)
+- [menu asset-update](rabetbase-menu-asset-update.md)