@lovrabet/rabetbase-cli 2.5.5-beta.1 → 2.5.5-beta.3

package/skills/rabetbase-page-generation/references/generation.md

@@ -10,31 +10,49 @@ npx skills add /path/to/rabetbase-cli/skills/rabetbase-page-generation -g -y
 
 将路径替换为当前 CLI 包的真实位置，安装后确认 Agent 可发现 `rabetbase-page-generation`。CLI 既有 postinstall 安装的是 `rabetbase` Skill；此独立 Skill 的安装由使用方显式执行。
 
+## 确定应用与页面需求
+
+默认在正式环境（prod）的当前应用完成任务。先核对当前 CLI 路由、用户提供的应用链接、Dataset 和已有页面是否一致；用户明确指定 daily 或企业部署时沿用该目标，不因查不到应用而切换环境试写。命令示例沿用已核验的当前路由，daily 检查不是 prod 交付门禁，也不要求非技术用户选择环境参数。
+
+用户要求创建或重做页面后，按该任务范围完成页面创建、保存、串联、验收和发布，不要求用户逐个批准命令或每个页面。只有业务范围或目标应用不明确时做一次必要的简短确认，例如“我会做一个问卷列表，支持查看和新增，完成后给你入口”。用户只要方案或预览时尊重这个停止点；工具权限拦截时保留已完成成果，不绕过控制、不自行提高风险上限。
+
+先形成内部页面计划，记录需要的能力、入口、页面间跳转、菜单展示和旧页面处理：
+
+- `list / detail / create / update` 是可选基础模板。只读场景按需保留列表、详情；仅查看单条记录可以只有详情，仅录入可以只有新增。不可编辑时不创建更新页，也移除所有编辑入口和写入逻辑；“不可修改”与“允许新增”的边界若不明确，用业务语言简短确认。明确只读时同时移除新增、编辑、删除和批量写入能力。
+- 用户需要看板、审批或汇总时可以扩展页面。按实际业务需求决定入口，不强行补齐四页；未选择的页面不创建菜单，不留下链接或按钮。
+- 通过 Dataset 关联页、`menu list` 与对应页面详情识别已有 lowcode 和 CustomJSX 页面。内部记录旧页面到新页面的名称、类型、`pageId`、`menuId`、路径和用途对应关系；旧 lowcode 的 ID 不得用于 `custom-detail`、`custom-update` 或 `custom-publish`。
+- 用户给的链接可能只是定位应用的旧页面。新流程应使用计划内新页面的真实路径，不能把旧页面路径回填成新页面路径；交付时提供新的入口。重试前查已有创建回执和线上页面，不能仅凭同名判断同一页面或重复创建。
+
+## 菜单与旧页面安排
+
+新页面默认只显示业务入口，作为详情、录入、编辑等流程内部节点的页面设为隐藏；独立入口按用户需求显示。扩展或裁剪页面后同步调整菜单策略，不能固定假设永远有四个页面。
+
+新流程验收通过后，可以向用户建议隐藏旧 lowcode 页面，确认不再使用时也可以建议删除。已包含在用户替换要求中的隐藏安排直接执行；未明确要替换旧入口时先建议，不能悄悄隐藏仍在使用的旧页面。删除旧页面需有明确删除意图、核对影响范围和外部引用；保留页面不影响新流程交付。隐藏保留路由，删除不能用来代替隐藏。
+
 ## 绑定真实 Dataset
 
 1. 用 `rabetbase dataset detail --code <datasetCode> --format compress` 读取字段、类型、必填、枚举和操作。用 `rabetbase codegen sdk` 核验 SDK 签名；不要从原始接口元信息猜测请求或响应。
 2. 将 `templates/onepage` 整体复制到页面工作目录。先阅读对应页面目录的 `README.md` 和 `preview.png`，明确布局与交互；`shared/` 保存四页共用代码，复制时一起保留。它是供 Agent 改写的 JSX 模板，不是配置解释器：客户字段展示了分组、数字、枚举、日期、智能筛选和表单的完整写法。按真实 Dataset 改写 `shared/model.js` 的字段与查询、`shared/record-layout.jsx` 的分组说明、`list/index.jsx` 的筛选/标题/手机主字段、`shared/editor.jsx` 的控件/校验/写入字段及 `detail/index.jsx` 的标题/主键读取。不能只替换 Dataset code 就直接发布给其他业务。
-3. 替换 `shared/model.js` 中 `__APP_CODE__`、`__DATASET_CODE__`；创建前将尚无真实路径的 `__LIST_PATH__`、`__DETAIL_PATH__`、`__CREATE_PATH__`、`__UPDATE_PATH__` 设为空字符串，创建后回填服务端真实路径。四页使用相同绑定。示例以数字 `id` 为主键；其他类型需要同时改写校验、记录导航和 SDK 参数。
+3. 替换 `shared/model.js` 中 `__APP_CODE__`、`__DATASET_CODE__`；创建前将尚无真实路径的 `__LIST_PATH__`、`__DETAIL_PATH__`、`__CREATE_PATH__`、`__UPDATE_PATH__` 设为空字符串，创建后回填服务端真实路径。计划内页面使用相同绑定；未选页面不保留导航入口。示例以数字 `id` 为主键；其他类型需要同时改写校验、记录导航和 SDK 参数。
 4. 页面使用宿主 `useSdkClient()`：已核验的 Dataset 模型提供 `filter({where,currentPage,pageSize,orderBy})`、`getOne(id)`、`create(fields)`、`update(id,fields)`。列表读取 `tableData` 和 `paging.totalCount`；若实际 SDK 不同，按真实契约改写。只在已确认需要连接、聚合或业务规则时改用 Custom SQL / Backend Function。
 
 保持零值、枚举、空日期和主键类型正确；数字不加千分位，金额精度按字段定义。列表、详情和表单均区分加载、空数据、错误与重试。分页只使用已提交的筛选；搜索、重置和切换页大小回第一页，忽略过期响应。
 
-## 构建四个独立目录
+## 组装计划内页面目录
 
-在页面工作目录安装页面构建工具 `esbuild`，准备已核验版本的智能搜索 JSX 入口及 CSS；不要求 CLI 安装这些页面开发依赖。`build.mjs` 只打包当前目录的四页源码，不读取 Dataset、不选模板、不创建平台资源。
+确认宿主可解析已发布的 `@lovrabet/components` 版本，并且该版本从包根入口导出 `LrSmartFilter`。模板直接使用这个公共组件，不复制 JSX 或 CSS 源码，也不改写成本地筛选器；不要求 CLI 安装页面构建依赖。若宿主解析失败，停止页面发布，通知用户需要由 `app-platform` 更新依赖或构建模板，不修改该仓库。`build.mjs` 只组装当前目录的四页可读源码，不读取 Dataset、不选模板、不创建平台资源，也不生成 `page.js`。平台保存/发布时使用新的微应用构建模板完成 JSX 编译。
 
 ```sh
-npm install --save-dev esbuild
-node build.mjs ./pages-v1 /path/to/smart-filter/index.tsx /path/to/smart-filter/style.css
+node build.mjs ./pages-v1
 ```
 
-输出目录必须尚不存在，避免旧文件混入更新。结果为 `pages-v1/list`、`detail`、`create`、`update`；每页包含完整的 `src/app/index.jsx`、`page.js`、`page.css`，没有跨页源码依赖。四页共享相同 CSS 内容，避免打开子页时宿主更新资源导致父列表丢失样式。页面文案默认中文，按应用语言调整源码；需要多语言时使用宿主 `useI18n` 和页面自己的语言资源。
+输出目录必须尚不存在，避免旧文件混入更新。结果为 `pages-v1/list`、`detail`、`create`、`update`；每页包含可读的 `src/app/index.jsx`、`src/shared` 源码，并通过 `import { LrSmartFilter } from "@lovrabet/components"` 使用公共组件，不包含 `page.js` 或其他预编译 bundle。基础脚本仍输出四个目录，不负责选择页面；只对计划中的目录执行创建、更新和发布，本地多出的目录不代表已创建平台资源。扩展页由 Agent 在工作目录按相同 `src/app/index.jsx` 与所需 `src/shared` 结构组织，不假设脚本自动发现新目录，也不为本次业务改写已安装的 Skill。每个上传页面都拥有完整源码，避免更新一个页面时依赖另一个页面的文件。删除未选页面对应的按钮、导航、字段动作和不可用操作；详情没有编辑页时不能保留“编辑”按钮。组装成功不等于平台编译成功。页面文案默认中文，按应用语言调整源码；需要多语言时使用宿主 `useI18n` 和页面自己的语言资源。
 
-构建脚本解析当前页面项目安装的 esbuild。若使用 npm 包形式的智能搜索入口，先检查实际 exports 并解析出具体文件路径；不要假设某版本存在 `smart-filter` 子入口。缺失组件或 CSS 时先解决依赖，不改成简易输入框宣称效果一致。
+构建脚本不复制组件源码或独立 CSS，也不把它改成简易输入框或预编译 bundle 来规避依赖问题。组件导出已经发布后，真实页面验收必须覆盖智能搜索和结构化筛选；若宿主仍不识别导出，按组件宿主阻断处理，通知用户由 `app-platform` 修复后再继续，不能用页面内副本冒充组件库复用。
 
 ## 创建、回填与更新
 
-对四页分别执行已有命令，下面以列表为例：
+只对页面计划选中的页面执行已有命令，下面以列表为例：
 
 ```sh
 rabetbase page create --name "<页面名称>" --page-dir ./pages-v1/list --appcode <appCode> --dry-run --format compress
@@ -42,9 +60,9 @@ rabetbase page create --name "<页面名称>" --page-dir ./pages-v1/list --appco
 rabetbase page custom-detail --id <pageId> --appcode <appCode> --format compress
 ```
 
-复用 `page create` 的默认建菜单行为，需要父菜单时使用已有 `--parent-menu-id`。菜单展示通过既有 `rabetbase menu` 命令管理，先查看 `menu list` 和 `menu visibility-update --help` 并按要求预演，再执行授权的调整。隐藏菜单保留路由和资源，不等同于不创建菜单；不得删除页面绑定菜单来模拟隐藏。当前任务若允许四页菜单，按该策略验收；不要声称只有入口绑定菜单。菜单状态只根据真实返回和回查结果判断。
+复用 `page create` 的默认建菜单行为，需要父菜单时使用已有 `--parent-menu-id`。菜单展示通过既有 `rabetbase menu` 命令管理，先查看 `menu list` 和 `menu visibility-update --help` 并按要求预演，再执行授权的调整。隐藏菜单保留路由和资源，不等同于不创建菜单；不得删除页面绑定菜单来模拟隐藏。按页面计划设置菜单可见性并逐项回查；隐藏的子页仍绑定菜单，不要声称只有入口绑定菜单。菜单状态只根据真实返回和回查结果判断。
 
-记录四页 `pageId` 与真实路径，回填 `shared/model.js`，重新构建到新的输出目录。先回读远端当前 `codeContent`，再更新；`--page-dir` 是整目录替换，目录必须完整：
+记录每个计划内页面的 `pageId`、`menuId`、类型与真实路径，回填 `shared/model.js`，重新组装到新的输出目录。发布前逐条比对导航路径和新页面映射，特别检查新增按钮没有指向旧 lowcode 表单。先回读远端当前 `codeContent`，再更新；`--page-dir` 是整目录替换，目录必须完整：
 
 ```sh
 rabetbase page custom-update --id <pageId> --appcode <appCode> --page-dir ./pages-v2/list --format compress
@@ -52,9 +70,11 @@ rabetbase page custom-update --id <pageId> --appcode <appCode> --page-dir ./page
 
 ONEPAGE 子页读取 `onePageInfo.innerSearchParams.id`，直接访问时读取 `useLocation().search`。缺少或无效主键时不发数据请求。列表通过 `navigate(pathWithQuery, {onePage:true})` 打开子页；详情的上一条/下一条和详情切编辑使用当前面板替换，避免不断增加层级。更新保存后回原详情或父列表；直接访问返回真实入口。SDK 保存成功才发送按列表路径区分的刷新事件，父列表保留筛选和分页并重新读取数据；取消不写入数据、不发送刷新。
 
-## 本地与浏览器验收
+上述导航按实际页面组合改写：没有列表时移除“返回列表”和列表刷新依赖，返回计划内的真实入口，或留在当前独立页面显示保存结果；没有详情时更新不能返回详情。独立详情入口必须有明确的记录选择或参数来源，不能让用户直接面对缺少主键的错误。增加看板等入口时一并调整返回目标和需要刷新的页面。
 
-在非沙箱页面工作目录预览迭代；临时预览夹具、模拟数据和运行回执放任务验收目录，不加入 CLI 源码；页面目录中的 `preview.png` 是随 Skill 分发的效果参考。浏览器使用 Codex 内置浏览器。
+## 页面与浏览器验收
+
+在当前任务工作目录中预览迭代；页面目录中的 `preview.png` 是随 Skill 分发的效果参考。使用当前可用的浏览器能力，不要求安装桌面客户端、浏览器扩展或切换到外部浏览器。若没有浏览器能力，继续完成可执行的源码、构建和状态检查，清楚记录交互尚未验证；不能把命令成功当成浏览器验收通过。以下检查只应用于计划内能力；被裁剪的能力应检查其按钮、导航和写入调用已移除。
 
 - 同 Dataset 对比旧标准页的字段、分组、智能搜索、表单密度与操作位置；覆盖空数据、有数据、无匹配结果和超过一页的数据。
 - 查询、重置、翻页、页大小、勾选和列设置；自然语言查询必须读取真实结果，失败不冒充空结果。
@@ -63,15 +83,44 @@ ONEPAGE 子页读取 `onePageInfo.innerSearchParams.id`，直接访问时读取
 - 桌面及手机窄屏，列表和子页无溢出，底部按钮可访问；父列表保持筛选/分页。实际设备软键盘、深色主题等未覆盖项需明确记录。
 - 仅操作授权的测试数据，写入前保留原值，验收后还原修改并清理本轮测试记录。旧页面只用于对比，不作为新流程的运行依赖。
 
-本地模拟不能证明真实 SDK、权限或 ONEPAGE 宿主正确。用四页预览验证真实数据流后再发布；若正式态暴露问题，修复后重新验收。
+本地模拟不能证明真实 SDK、权限或 ONEPAGE 宿主正确。按页面计划验证真实数据流后再发布；若正式态暴露问题，修复后重新验收。能力缺失造成的未验证项与明确的验收失败分别记录；用户若接受未验证范围并要求先发布，按该范围继续，仍不得声称完整验收通过。
 
 ## 发布与结果回查
 
+对每个计划内 CustomJSX 页面，发布前先 `custom-detail` 核对类型、应用、保存内容和版本：
+
+- `status=FORMAL` 且有效的 `draftVersion === formalVersion`：当前保存内容已发布，跳过重复发布并检查运行页面；编辑器或本地尚未保存的改动不算已发布。
+- 有新草稿或首次发布：确认已保存内容对应本轮验收源码，再发布。不能只因 `status=FORMAL` 就忽略较新的草稿。
+- 版本缺失、异常、状态矛盾或远端内容与预期不一致：先回读并核对，不能把两个缺失版本当作相等，也不能覆盖他人的新改动或猜测已发布。
+
 ```sh
+rabetbase page custom-detail --id <pageId> --appcode <appCode> --format compress
+# 仅在确有待发布内容且已完成前述检查时执行
 rabetbase page custom-publish --id <pageId> --appcode <appCode> --remark "页面验收通过" --format compress
 rabetbase page custom-detail --id <pageId> --appcode <appCode> --format compress
 ```
 
-四页分别检查发布状态 `FORMAL`、源码及版本，使用返回的运行 URL 打开正式态复验；报告实际菜单绑定情况。保留与最终提交/版本对应的复现步骤和结果，作为 MR 附件或外部验收材料；不把旧回执当成新版本证据。
+发布后逐页检查 `FORMAL`、正式版本是否等于本轮待发布版本、源码和运行地址。用返回的运行 URL 复验入口、子页跳转和菜单展示；命令成功、页面发布和业务交互验收是不同事实。网络超时、响应丢失或 500 时先回读状态，不立即重复发布。
+
+## 失败分类与恢复
+
+内部保留失败发生在哪一步、页面、时间、已脱敏错误及请求标识（若工具提供）。按证据选择恢复动作：
+
+| 观察到的事实 | 判断与下一步 |
+| --- | --- |
+| 正式版本已等于预期版本，源码相符 | 目标已发布，停止重复调用并检查运行页；不能据此断言先前 500 的原因就是重复发布。 |
+| 平台编译结果指出源码或组件/依赖错误 | 按构建错误修复，再保存和验证；组件处理遵循组件基线，不把构建失败说成没有数据。 |
+| 页面事实是 lowcode，或 ID/应用与计划不同 | 回到新旧映射选择正确页面及对应命令；不要将旧页面当成新页面重复创建或发布。 |
+| 鉴权、权限或 CLI 风险限制拒绝 | 保留成果，不绕过检查；只说明具体未完成操作和用户能采取的必要动作。 |
+| 页面发布成功，但菜单设置失败 | 分别回查页面和菜单，恢复未完成的菜单步骤；不能把页面称为未发布或把菜单称为已隐藏。 |
+| 只有 HTTP 500、超时或未知错误，回读也未能确定结果 | 原因待确认，保留证据，通过可用且授权的排障入口继续定位；不编造重复发布、组件缺失等根因，不循环重试。 |
+
+用户反馈用业务语言，例如“页面已经发布，可以直接打开”“页面已发布，但侧边栏还没调整完成”“这次发布没有完成，我正在检查原因”。只有确实存在未保存修改时才建议重新保存，不能把“重新保存再发布”当成所有错误的通用解决办法。
+
+## 内部记录与用户交付
+
+内部记录页面计划、新旧映射、页面与菜单标识、源码对应版本、发布结果、菜单实况，以及本轮验收的步骤、结果和未覆盖项。有可写任务目录时和源码一起保存，临时夹具和回执不加入 CLI 仓库或上传到业务页面；没有持久位置时保留在当前任务上下文，不要求用户提供存储目录，不保证任务结束后仍可取回。不记录凭据或完整业务数据，也不把旧回执当成新版本证据。
+
+向非技术用户只交付创建了哪些页面、用途、可直接打开的入口，以及旧页面处理建议和确需人工完成的事项。需要修改页面时提供工具返回的编辑链接，并与访问链接区分；不要自行拼接或沿用旧链接。详情等需要记录参数的页面优先通过入口访问，不把无参数错误页作为正常体验交付。默认不展示 pageId、menuId、接口、版本号、命令和本地验收文件路径；用户明确要求技术细节时再提供相关内容。
 
-CLI beta 发布遵循 CLI 发布流程；页面验收不等于 npm 发布成功。Development Sandbox 中安装 CLI beta 及独立 Skill 后，验证 Agent 可发现该 Skill，并完整执行四页生成和浏览器 E2E；Runtime Sandbox 不安装该 Skill。
+CLI beta 发布遵循 CLI 发布流程；页面验收不等于 npm 发布成功。安装 CLI beta 及独立 Skill 后，确认执行方能够发现该 Skill，并按页面计划执行生成和端到端验收。

package/skills/rabetbase-page-generation/templates/onepage/build.mjs

@@ -1,63 +1,48 @@
-import { createRequire } from "node:module";
-import { mkdir, stat, writeFile } from "node:fs/promises";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-// 页面项目自行安装构建依赖；此脚本不参与 CLI 命令或宿主构建。
-const require = createRequire(path.resolve("package.json"));
-const { build } = require("esbuild");
+// Assemble uploadable page directories from readable JSX source. The platform
+// micro-app template performs the actual JSX build when the page is saved or
+// published; this script must not upload a precompiled page.js bundle.
 const root = path.dirname(fileURLToPath(import.meta.url));
-const [output, componentEntry, componentCss] = process.argv.slice(2);
-if (!output || !componentEntry || !componentCss)
-  throw Error(
-    "Usage: node build.mjs <output directory> <smart-filter JSX entry> <smart-filter CSS>",
-  );
-const entry = path.resolve(componentEntry);
-const css = path.resolve(componentCss);
-for (const file of [entry, css]) {
-  if (!(await stat(file)).isFile()) throw Error(`Not a file: ${file}`);
-}
-// 输出必须是新目录，避免旧文件进入 custom-update 的完整替换范围。
+const [output] = process.argv.slice(2);
+if (!output) throw Error("Usage: node build.mjs <output directory>");
+
 const destination = path.resolve(output);
-const external = [
-  "react",
-  "react/jsx-runtime",
-  "antd",
-  "@ant-design/icons",
-  "dayjs",
-  "@/context/app-context",
+await mkdir(destination, { recursive: false });
+
+const sharedFiles = [
+  "model.js",
+  "record-layout.jsx",
+  "responsive.jsx",
+  "editor.jsx",
+  "page.css",
 ];
-const outputs = [];
-for (const kind of ["list", "detail", "create", "update"]) {
-  const result = await build({
-    stdin: {
-      contents: `import ${JSON.stringify(css)};\nexport { default } from "./${kind}/index.jsx";`,
-      resolveDir: root,
-      sourcefile: "page-entry.jsx",
-      loader: "jsx",
-    },
-    bundle: true,
-    format: "esm",
-    platform: "browser",
-    jsx: "automatic",
-    outfile: path.join(destination, kind, "src/app/page.js"),
-    write: false,
-    external,
-    alias: { "@lovrabet/components/smart-filter": entry },
-  });
-  outputs.push(...result.outputFiles);
-}
-// 四页都引入相同的筛选 CSS 和页面 CSS，避免宿主资源替换破坏父列表。
-await mkdir(path.dirname(destination), { recursive: true });
-await mkdir(destination);
-for (const file of outputs) {
-  await mkdir(path.dirname(file.path), { recursive: true });
-  await writeFile(file.path, file.contents);
-}
-for (const kind of ["list", "detail", "create", "update"]) {
+const pageKinds = ["list", "detail", "create", "update"];
+
+for (const kind of pageKinds) {
+  const pageRoot = path.join(destination, kind);
+  await mkdir(path.join(pageRoot, "src", "app"), { recursive: true });
+  await mkdir(path.join(pageRoot, "src", "shared"), { recursive: true });
+
+  const pageSource = await readFile(
+    path.join(root, kind, "index.jsx"),
+    "utf8",
+  );
   await writeFile(
-    path.join(destination, kind, "src/app/index.jsx"),
-    'import "./page.css";\nexport { default } from "./page.js";\n',
+    path.join(pageRoot, "src", "app", "index.jsx"),
+    pageSource,
   );
+
+  for (const file of sharedFiles) {
+    await writeFile(
+      path.join(pageRoot, "src", "shared", file),
+      await readFile(path.join(root, "shared", file)),
+    );
+  }
 }
-console.log(`Built four CustomJSX page directories in ${destination}`);
+
+console.log(
+  `Assembled four readable CustomJSX page directories in ${destination}`,
+);

package/skills/rabetbase-page-generation/templates/onepage/list/index.jsx

@@ -26,8 +26,12 @@ import {
   ReloadOutlined,
   SettingOutlined,
 } from "@ant-design/icons";
-import { useAppTheme, useNavigate, useSdkClient } from "@/context/app-context";
-import { LrSmartFilter } from "@lovrabet/components/smart-filter";
+import {
+  useAppTheme,
+  useNavigate,
+  useSdkClient,
+} from "@/context/app-context";
+import { LrSmartFilter } from "@lovrabet/components";
 import {
   APP_CODE,
   DATASET_CODE,

package/skills/rabetbase.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "rabetbase",
   "packageName": "@lovrabet/rabetbase-cli",
-  "packageVersion": "2.5.5-beta.1",
-  "skillVersion": "2.5.5-beta.1",
+  "packageVersion": "2.5.5-beta.3",
+  "skillVersion": "2.5.5-beta.3",
   "files": [
     "SKILL.md",
     "guides/approval-flow-development-workflow.md",
@@ -155,5 +155,5 @@
     "references/rabetbase-user-account.md",
     "references/rabetbase-workspace.md"
   ],
-  "digest": "38a5a0bf6c62d0aad2a3a129a84b96669c85b6cf1c88b6c0437569ce5dbffd86"
+  "digest": "1af259428a098b2004287a1c523512325f89477eaa9b4704e1896c851c38d80a"
 }