@lovrabet/rabetbase-cli 2.5.4-beta.4 → 2.5.4-beta.5

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

@@ -63,8 +63,8 @@ rabetbase bff push --type HOOK --name beforeFilter --format json
 - 预演中无法确认目标的脚本显示 `status: failed` 与 `error`，不会上传或更改 lock
 - alias 与 Dataset code 命名空间碰撞、Dataset 映射漂移或同一 Dataset 出现多个本地目录会在首次远端写入前阻断
 - HOOK 可挂载 `DB_TABLE` 或 `METADATA` 数据集；METADATA 不支持 SQL / aggregate 路径，脚本中使用平台返回的标准数据操作
-- 推送成功只代表脚本配置已同步到平台；如需确认最终运行效果，使用运行验证（例如 `lovrabet bff exec --name <functionName> --params '<json>' --format compress`）
-- 管理态已同步但运行态仍旧版本时，按传播延迟 / 缓存延迟处理：等待后重试，必要时对目标脚本精确执行 `--force` 推送；仍不生效时记录平台运行态缓存风险
+- 推送成功只代表脚本配置已同步到平台；需要运行验证时，按[创建流程的运行验证步骤](../guides/bff-creation-workflow.md#9-运行态-smoke按需)确认目标、权限及函数副作用后执行
+- 已确认独立部署并需验证，或出现平台到业务环境的同步疑点时，读取[独立部署指南](../guides/independent-deployment.md)；普通 push 不额外查询部署标识
 
 ## 参考
 

package/skills/rabetbase/references/rabetbase-data-list-status.md

@@ -18,6 +18,7 @@ rabetbase page data-list-status --alias order --format json
   - 菜单事实
 - 它不返回异步任务的执行进度，也不负责表达 job 状态。
 - 这是 `page generate-start` 的前置判定与终态回查依据，属于事实接口，不是任务状态接口。
+- 数据列表页生成流程会自动创建菜单入口。生成后核对页面组及其对应的 `hasMenu`、`menuPath`、`menuVisible`：菜单存在与是否可见是不同事实，不要求每个辅助页面都有可见菜单。预期入口缺失时报告并核查，不自动使用 `menu sync` 补建或绑定子应用 appName。
 
 ## 适用场景
 

package/skills/rabetbase/references/rabetbase-deployment-sync-all.md

@@ -1,6 +1,6 @@
 # rabetbase deployment sync-all
 
-研发资源保存后的增量同步由服务端自动处理。`deployment sync` 已移除，`bff push` 与 `sql push` 也不再追加客户端同步请求。
+`sync-all` 提交应用范围的显式补偿任务。自动同步与项目后续发布步骤的区别见[独立部署指南](../guides/independent-deployment.md)。`deployment sync` 已移除，`bff push` 与 `sql push` 不追加客户端同步请求。
 
 `sync-all` 是管理员补偿工具，仅用于以下场景：
 
@@ -13,7 +13,9 @@
 ## 使用前确认
 
 - 已完成 rabetbase 认证，并明确目标应用的 `appCode`。
+- 已按[独立部署指南](../guides/independent-deployment.md)确认平台同步的实际目标及本次操作所处环节。
 - 已确认属于初始化、回填或恢复场景，而不是普通资源保存或发布。
+- [`app detail`](rabetbase-app-detail.md) 已确认 `vipDeploy=true`，并具备相应权限与执行授权；未确认能力时不提交任务。
 - 应用已停止编辑，当前处于安静窗口，避免全量任务与服务端自动增量同步并行。
 - 已准备在任务结束后执行独立的业务验收。
 
@@ -51,6 +53,8 @@ rabetbase deployment sync-status --job-id <jobId> --format compress
 rabetbase deployment sync-jobs --appcode <appCode> --format compress
 ```
 
+这些查询用于显式提交的同步任务，不包含保存后自动产生的增量同步任务；不能用空列表判断自动同步是否运行或失败。
+
 只根据 `isTerminal` 判断是否为已知终态；若为 `null`，保留服务端状态并交给用户判断。逐项资源类型和 action 是服务端开放字符串，不建立枚举闭集，也不因新值自动重提。
 
 任务成功只表示服务端完成了当前支持范围内的 UPSERT。目标端额外记录不会被删除，且任务明细可能受服务端保留上限影响，因此完成后仍需按业务事实验收。

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

@@ -1,8 +1,10 @@
 # menu asset-update
 
-更新指定线上微前端菜单的 CDN 资源 URL。
+更新指定线上菜单自身的 CDN 资源 URL。宿主可同时集成多个前端子应用和平台页面（数据列表页、自定义页面）。平台页面按其配置与发布流程管理，需要菜单资源时，该资源是正常加载配置，无需绑定 appName；本命令不修改页面内容或代替页面发布。绑定有效子应用共享资源时，支持该机制的宿主优先加载对应子应用的共享资源，菜单资源才作为兜底。
 
-> **风险等级：write** — 修改线上菜单运行资源；建议先 dry-run，正式执行复用相同参数并移除 `--dry-run`。
+仅在明确需要调整菜单资源时，平台页面才按菜单 ID/path 使用本命令。例如，自定义页面通过 [`page create`](rabetbase-page-create.md) 同时创建页面与菜单，后续按 pageId 使用 [`page custom-update`](rabetbase-page-custom-update.md)、[`page custom-publish`](rabetbase-page-custom-publish.md) 保存和发布，无需额外绑定 appName 或用 `menu sync` 注册菜单。前端子应用先用 `rabetbase menu subapp-assets-status --appcode <host-appcode> --app-name <name>` 核查，升级使用 `menu subapp-assets-update`；只有明确维护菜单自身的兜底配置时才使用本命令。
+
+> **风险等级：write** — 修改菜单自身的资源配置；建议先 dry-run，正式执行复用相同参数并移除 `--dry-run`。
 
 ## 命令
 
@@ -17,13 +19,13 @@ rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://.
 # 按菜单 ID 精确更新，并显式切换加载方式
 rabetbase menu asset-update --menu-ids "<menu-id>" --load-mode fetch --params '{"jsUrl":"https://...js"}' --dry-run --format compress
 
-# 明确需要全量发布时显式选择全部
+# 仅当明确要更新当前宿主所有已有 resources 的菜单时使用，不用于子应用版本升级
 rabetbase menu asset-update --all --params '{"jsUrl":"https://...js","cssUrl":"https://...css"}' --dry-run --format compress
 ```
 
 ## 高频 SOP：修改菜单资源 URL
 
-修改菜单中的 JS / CSS 资源 URL 是 `menu asset-update` 的主路径，不需要 `menu detail` 或其他配置更新命令。
+修改菜单自己的 JS / CSS 资源 URL 使用 `menu asset-update`：包括平台页面的正常资源配置，以及明确维护的子应用菜单兜底配置。不需要 `menu detail` 或其他配置更新命令。
 
 1. **先确认资源现状**，只看已配置资源的菜单：
 
@@ -73,7 +75,7 @@ rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://c
 rabetbase menu asset-update --menu-ids "<menu-id>" --params '{"jsUrl":"https://cdn.example.com/app.js"}' --dry-run --format compress
 rabetbase menu asset-update --menu-ids "<menu-id>" --params '{"jsUrl":"https://cdn.example.com/app.js"}' --format compress
 
-# 显式更新全部菜单的 JS + CSS
+# 显式更新当前宿主全部已有 resources 的菜单，不限定为某个子应用
 rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/app.js","cssUrl":"https://cdn.example.com/app.css"}' --dry-run --format compress
 rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/app.js","cssUrl":"https://cdn.example.com/app.css"}' --format compress
 ```
@@ -113,7 +115,7 @@ rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/ap
 - 只有显式传 `--load-mode` 才修改加载方式
 - 默认 `patch`；使用 `replace` 时仍会阻止无意删除已有 JS
 - patch 被更新类型已有多个资源时会拒绝，不通过 `--force` 猜测替换目标
-- 典型场景：新版本构建后批量更新 CDN 地址
+- 典型场景：更新选定平台页面的 CDN 地址，或明确维护菜单兜底 URL；前端子应用升级优先更新共享资源
 - 交互模式会展示受影响菜单的摘要表
 
 ## 常见错误
@@ -124,7 +126,7 @@ rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/ap
 - 只想换 CSS 却显式使用 `replace`，导致已有 JS 被删除风险。
 - dry-run 已出现删除 JS warning，仍未取得用户明确确认就继续执行。
 - patch 报告同类型资源不唯一时尝试用 `--force` 绕过；应先确认完整资源集合，只有明确重写时才改用 `replace`。
-- 把资源 URL 修改误判为需要 `menu detail` / `config-update`；资源 URL 变更统一使用 `menu asset-update`。
+- 修改菜单自己的资源 URL 时误用 `menu detail` / `config-update`；此类变更使用 `menu asset-update`。同名子应用共享资源版本另行管理。
 
 ## 参考
 

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

@@ -119,7 +119,7 @@ rabetbase menu list --verbose --format json
 - 修改菜单名称前确认 `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`。
+- 前端子应用优先用 `menu subapp-assets-status` 核查共享资源，升级使用 `menu subapp-assets-update`；平台页面或明确维护的菜单兜底资源使用 `menu asset-update`。
 - 提供稳定的菜单事实入口，避免使用底层数据源查询菜单配置。
 
 ## 不负责
@@ -127,7 +127,7 @@ rabetbase menu list --verbose --format json
 - 不做本地 `src/pages` 与线上菜单 diff；这类对比使用 `menu sync`。
 - 不做数据列表页菜单审计；dataset-scoped 页面事实使用 `page data-list-status`。
 - 不修改外链 URL；使用 `menu external-link-update`，并带旧 URL 与父级断言。
-- 不修改菜单资源；更新 JS / CSS 资源 URL 使用 `menu asset-update`，并先执行 dry-run。
+- 不修改资源；共享子应用与独立菜单资源分别使用对应更新命令，并先执行 dry-run。
 - 不修改菜单；显示隐藏使用 `menu visibility-update`，改名使用 `menu rename`，空 folder 删除使用计划化的 `menu delete`，分组生命周期使用 `group-create/group-update/regroup-start`，写操作都必须先 dry-run。
 
 ## 参考

package/skills/rabetbase/references/rabetbase-menu-subapp-assets-status.md

@@ -0,0 +1,19 @@
+# menu subapp-assets-status
+
+只读核查指定菜单宿主中一个前端子应用的共享资源、关联菜单及回退资源。
+
+查询需要目标宿主应用的应用开发者或应用管理员权限；更新共享资源需要该应用的应用管理员权限。系统管理员、所属租户管理员沿用平台现有权限规则。“宿主”只表示目标应用，不是独立权限角色；其他业务应用的权限不能替代目标宿主应用的权限。
+
+```bash
+rabetbase menu subapp-assets-status --app-name store-app --format json
+```
+
+`--app-name` 必填，去除首尾空白后精确匹配宿主 `extend.assets[].appName` 和菜单 `extend.appName`。CLI 不从包名、目录名或应用 profile 自动推导该值；标识来源与冲突处理见[宿主前端集成指南](../guides/host-frontend-integration.md)。菜单宿主沿用 CLI 的应用选择：可用 `--appcode` / `--app` 指定，否则使用工作区默认应用或唯一应用；多应用未选定目标时提示选择。`defaultApp` 是默认应用上下文，在本命令中作为菜单宿主。前端子应用访问哪些业务 appCode 是独立关系，不根据业务应用列表遍历或批量操作。默认应用与目标宿主不同时，用参数覆盖。
+
+输出 `data.appCode` 是本次查询的菜单宿主，`data.appName` 是输入标识去除首尾空白后的回显，即使未匹配到配置也会返回。`sharedConfigured` 表示同名共享配置条目是否存在，`boundMenus` 表示关联菜单数量；条目存在不代表资源非空。`sharedResources` 返回该子应用共享资源；`menus[].menuFallbackResources` 返回每个关联菜单自己的资源。菜单回退资源格式异常时，该值及 `fallbackDiffers` 为 `null`，`menuFallbackError` 返回原因，不阻断有效共享资源的核查；无共享资源可用时，该菜单的 `preferredResourcesIfSupported` 也为 `null`，应报告无法判断，不能当成版本一致或空资源。
+
+检测资源版本时，先读取子应用共享资源；共享资源非空时优先使用，否则逐菜单使用回退资源。按 `menus[].preferredSourceIfSupported` 和 `preferredResourcesIfSupported` 与目标资源 URL 比较。`staleMenuFallbacks` 只表示菜单回退配置与共享资源有差异，不代表当前优先资源版本不一致。没有关联菜单时仍可核查 `sharedResources`，但不能据此声称页面已挂载。
+
+比较本地发布版本时，先按[资源版本核验](../guides/host-frontend-integration.md#子应用资源版本核验)取得可信发布记录或构建上传结果中的完整资源 URL 列表；不能仅凭 `package.json.version` 判断发布一致。缺少资源对应关系时报告无法判断，并展示已查到的配置。URL 列表相同只表示配置一致。
+
+`hostCapabilityVerified=false` 表示未验证目标宿主的加载能力；优先级字段描述支持共享资源的宿主。不同宿主版本可能只支持菜单资源，发布前需核实目标宿主的加载行为。本命令不校验 CDN 文件内容，不更新配置；URL 一致不能代替发布验证。

package/skills/rabetbase/references/rabetbase-menu-subapp-assets-update.md

@@ -0,0 +1,27 @@
+# menu subapp-assets-update
+
+更新指定菜单宿主中一个已存在的前端子应用共享资源 URL。只替换该条目的 `resources`，保留读取到的加载方式、基础路径、其他条目以及 `extend` 中的其他配置（包括直连数据库设置）。通过 `--resources` 提供完整资源 URL 列表。
+
+正式写入需要目标宿主应用的应用管理员权限。系统管理员、所属租户管理员沿用平台现有权限规则。“宿主”只表示目标应用，不是独立权限角色；其他业务应用的权限不能替代目标宿主应用的权限。仅具有该应用的应用开发者权限时可以查询和预演，但不能更新；预演成功不代表具有写权限。遇到权限不足时说明所需权限，不通过逐菜单更新或切换业务 appCode 绕过。
+
+```bash
+rabetbase menu subapp-assets-update --app-name store --resources '["https://cdn.example.com/store/2/app.js","https://cdn.example.com/store/2/app.css"]' --dry-run --format json
+rabetbase menu subapp-assets-update --app-name store --resources '["https://cdn.example.com/store/2/app.js","https://cdn.example.com/store/2/app.css"]' --expected-hash <data.body.preview.expectedHash> --format json
+rabetbase menu subapp-assets-status --app-name store --format json
+```
+
+`--app-name` 必填，去除首尾空白后精确匹配宿主中已有的 `extend.assets[].appName`。标识沿用平台已有绑定，不随包名或版本变化；CLI 不自动从工程推导，来源与冲突处理见[宿主前端集成指南](../guides/host-frontend-integration.md)。菜单宿主沿用 CLI 的应用选择：可用 `--appcode` / `--app` 指定，否则使用工作区默认应用或唯一应用；多应用未选定目标时提示选择。`defaultApp` 是默认应用上下文，在本命令中作为菜单宿主。前端子应用访问哪些业务 appCode 是独立关系，不根据业务应用列表批量更新。默认应用与目标宿主不同时，用参数覆盖。
+
+本命令不创建子应用条目、不改名、不修改菜单绑定。已有菜单绑定但缺少共享条目时，保留原绑定和菜单资源，使用平台已有配置入口建立同名共享条目，再查询核对；不能因为共享配置缺失就自动改成逐菜单更新。
+
+用户要求更新“子应用版本／子应用资源”时使用本命令；只有明确要求修改菜单自身资源时才使用 `menu asset-update`。同名子应用在不同宿主下分别配置，本次只修改选中的宿主。预演与正式写入必须保持同一宿主、子应用和目标 URL 列表；修改其中任何一项后应重新预演。
+
+用户只给版本号或要求“从 A 升到 B”时，先按[资源版本核验](../guides/host-frontend-integration.md#子应用资源版本核验)确认完整资源 URL 和当前起点；不猜测目标 URL。起始版本不符或无法确认时先澄清，当前配置已匹配目标 URL 时不重复写入。预演指纹用于检测配置漂移，不证明当前配置对应用户指定的起始版本。
+
+`--resources` 必填，值为资源 URL 的 JSON 字符串数组。JSON/compress 预演结果位于 `data.body.preview`，返回 `preview.appCode`、`preview.appName`、`preview.before`、`preview.after`、`preview.expectedHash`，不写入。正式结果返回 `data.appCode` 与 `data.appName` 标明实际目标。指纹同时绑定宿主、子应用、目标 URL 列表和当前应用配置；正式执行要求 `--expected-hash` 与本次输入及写前回读配置匹配，写后再次读取管理端应用并核对资源和扩展字段；URL 未变化时不重复写入。命令要求目标子应用条目唯一、应用发布状态可读、资源 URL 为绝对 HTTPS 地址且至少包含一个 JS 入口。
+
+现有应用更新接口整列替换 `extend`，不提供原子并发比较；预演摘要只能阻止已发生的变化，不能消除写前检查与实际写入之间的竞争窗口。更新期间应避免并发修改同一宿主配置。
+
+CLI 的保留和回读校验范围是应用读取接口返回的配置，无法证明数据库中未被接口返回的字段得到保留。直接访问数据库不是日常更新的通用前置条件；若发现未知扩展字段或有具体证据表明接口遗漏字段，应单独协调有权限的维护人员进行只读核查，核清后再决定是否更新，不得据管理端回读声称所有数据库字段均已保留。
+
+服务端保存应用时可能触发独立部署自动同步，但命令仅确认管理端回读，`independentDeploymentVerified=false` 不表示目标已生效。本命令不上传文件，也不校验 CDN 文件字节；写入前需确认 CDN 资源已就绪。若写入结果或回读验证不确定，先用 `menu subapp-assets-status` 按相同宿主和子应用核查，不要直接重试。

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

@@ -1,33 +1,56 @@
 # menu sync
 
-扫描本地 `src/pages/**/*.tsx`，把线上缺失的路由注册为平台 `procode` 菜单。
+将前端子应用工程中平台缺失的页面路由注册为 `procode` 菜单。优先读取 `src/features/routing/routes.json` 中声明的页面路由，包括 `visible: false`；没有该清单时沿用 `src/pages/**/*.tsx` 扫描。命令只注册菜单与资源引用，不上传页面源码或构建资源。
+
+数据列表页和自定义页面走各自的页面创建与发布流程，不使用本命令接入；操作入口见[宿主前端集成指南](../guides/host-frontend-integration.md)。
 
 > **风险等级：write** — 修改平台菜单配置。
 
-## 命令
+## 默认引导：Agent 按菜单树注册
+
+前端子应用优先由 Agent 按业务菜单树规划，再调用 `menu sync` 注册页面并引用子应用共享资源。`menu sync` 是新旧流程共用的注册命令；作为兼容兜底保留的是手动扫描、逐菜单填写资源及原有批量操作方式。交互向导、`--yes` 全量同步、`--paths` 精确选择及默认根级创建均保持兼容，不增加 CLI 参数门禁。
+
+1. 读取项目路由和 `menu list --verbose` 的 `id / parentId / type / path / extend.appName`，核实菜单宿主，按[宿主前端集成指南](../guides/host-frontend-integration.md) 确定本工程的绑定，优先复用现有分组。源码目录和 URL 层次不等于业务菜单层次。
+2. 展示拟创建的菜单树，注明新增分组、页面显隐和子应用绑定。只有业务归属不明确时才询问用户；已明确的根级页面可正常创建。
+3. 缺失分组用 `menu group-create` 按父子顺序创建并回读，取得真实 ID。分组重名时按父链定位，不猜测名称对应关系。
+4. 用 `menu subapp-assets-status` 核查共享资源。子应用页面优先传 `appName`，通常不传菜单 JS/CSS。查询失败或共享资源缺失不等于用户选择了旧路径，不自动改写成逐菜单资源。
+5. Agent 默认按明确 `--paths`、`parentId` 或路由清单里的 `group` 预演和创建。不同父节点分批处理，或复用清单中能唯一匹配的分组；不要给跨组页面统一覆盖一个父节点。用户明确采用原有全量或交互流程时，沿用其选择。
+6. 用 `menu list --verbose` 回读父节点、排序、显隐及 `extend.appName` 绑定，不只按创建数量报告成功。请求结果未知时先回读，不盲目重试。已有菜单默认保留层次，移动或重组是独立操作。
+
+子应用版本升级使用 `menu subapp-assets-update`，不批量更新菜单 URL。共享资源与菜单兜底 URL 不同，应分别报告，不能直接判断子应用版本不一致。
+
+```bash
+# 示例中的 42 应替换为已核实的目录 ID
+rabetbase menu list --appcode <host-appcode> --verbose --format compress
+rabetbase menu subapp-assets-status --appcode <host-appcode> --app-name store-app --format compress
+rabetbase menu sync --appcode <host-appcode> --paths "/record-detail" --params '{"appName":"store-app","parentId":42,"visible":false}' --dry-run --format compress
+rabetbase menu sync --appcode <host-appcode> --paths "/record-detail" --params '{"appName":"store-app","parentId":42,"visible":false}' --yes --format compress
+```
+
+## 兜底：原有终端与脚本路径
+
+这些用法保持兼容。没有分组信息的新页面按原行为创建到根级，不会把已有菜单打平或移动。涉及业务分组时先核对预演结果，避免误把新页面全部放到根级。
 
 ```bash
-# 交互模式（TTY）
+# 交互向导仍可使用
 rabetbase menu sync
 
-# 发现待同步页面的真实 path，不写入
+# 查看全部待同步页面，不写入
 rabetbase menu sync --dry-run --format json
 
-# 按 targetPages[].path 精确预览
-rabetbase menu sync --paths "<local-page-path>" --params '{"jsUrl":"https://cdn.example.com/app.js"}' --dry-run --format compress
-
-# 静默全量同步
+# 原有全量同步仍可使用
 rabetbase menu sync --yes
 
-# 静默部分同步（预填 URL 和精确 path）
-rabetbase menu sync --paths "<local-page-path-1>,<local-page-path-2>" --params '{"jsUrl":"https://...js","cssUrl":"https://...css"}' --yes
+# 原有指定路径、菜单资源用法仍可使用
+rabetbase menu sync --paths "<local-page-path>" --params '{"jsUrl":"https://cdn.example.com/app.js"}' --dry-run --format compress
+rabetbase menu sync --paths "<local-page-path>" --params '{"jsUrl":"https://cdn.example.com/app.js"}' --yes --format compress
 ```
 
 ## 参数
 
 | Flag | 类型 | 必填 | 默认 | 说明 |
 |------|------|------|------|------|
-| `--params <json>` | string | 否 | — | 预填 JS/CSS URL。JSON 格式：`{"jsUrl":"...","cssUrl":"..."}` |
+| `--params <json>` | string | 否 | — | 可填 `jsUrl`、`cssUrl`、`appName`、`visible`、`parentId`。`visible` 为布尔值，`parentId` 为非负整数 |
 | `--paths <csv>` | string | 否 | — | 按本地页面 path 精确选择；值来自 dry-run 的 `targetPages[].path` |
 | `--yes` | boolean | 否 | — | 确认非交互执行；未传 `--paths` 时创建全部本地未上线页面 |
 | `--dry-run` | boolean | 否 | `false` | 复用真实扫描、线上 diff 和 URL 校验，返回计划但不创建菜单 |
@@ -37,7 +60,7 @@ rabetbase menu sync --paths "<local-page-path-1>,<local-page-path-2>" --params '
 
 1. **`--yes`** — 非交互同步；未传 `--paths` 时创建全部本地未在平台上的页面
 2. **`--paths` + `--yes`** — 按本地 path 精确同步指定页面
-3. **TTY 交互式** — 展示名称、path 与线上状态 → checkbox 选择未注册页面 → 输入 JS/CSS URL → 确认 → 执行创建
+3. **TTY 交互式** — 展示名称、path 与线上状态 → checkbox 选择未注册页面 → 填写 JS/CSS URL 或使用已配置子应用 → 确认 → 执行创建
 
 ## 输出
 
@@ -47,12 +70,15 @@ rabetbase menu sync --paths "<local-page-path-1>,<local-page-path-2>" --params '
 
 ## 提示
 
-- 本地页面扫描 `src/pages` 目录
+- 有 `src/features/routing/routes.json` 时只同步清单中的有效页面；每项必须有存在的 `pageFile`、一致的 `path`、非空 `label` 和布尔 `visible`。隐藏页面也必须注册菜单，`visible: false` 只控制导航显隐
+- 清单可选 `group` 与 `order`。显式 `--params.parentId` 优先于清单 `group`：非零 ID 指向的节点不存在或不是当前宿主中的 folder 时拒绝，`0` 表示根节点。未指定 `parentId` 时，若提供了 `group`，则必须匹配宿主中唯一的 folder；两者均未提供时，保留原有根级创建行为
+- 无清单时扫描 `src/pages`，保持原有项目兼容
 - 同步前会获取线上菜单列表做 diff
 - path 是稳定选择器，名称只用于展示；多个 path 必须全部匹配
-- 已在平台存在的 path 不会重复创建
+- path 比较统一忽略首尾斜杠，重复选择同一路径只创建一次；已在平台存在的 path 不会重复创建
 - 交互模式下会展示 compare table（名称、path、本地与线上状态）
 - CLI 只注册菜单和资源引用，不构建、不上传源码或静态资源
+- `--params.appName` 将页面绑定到菜单宿主的同名前端子应用共享资源。菜单宿主使用 CLI 当前选中的应用，支持工作区默认应用或唯一应用，也可用 `--appcode` / `--app` 覆盖；子应用访问的业务 appCode 是独立关系。子应用资源在支持该机制的宿主中优先生效；不填 JS/CSS 时 CLI 会先确认同名共享资源非空，菜单资源留空。仍须核对目标宿主支持共享资源
 - 当前 React/Vite 模板使用 `loadScriptMode=import`；资源 URL 指向已部署的 CDN 构建产物
 
 ## 参考

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

@@ -1,6 +1,6 @@
 # page create
 
-创建 JSX 自定义页面，并同时创建菜单入口。命令固定返回 `pageType=CUSTOM`。
+创建自定义页面，并同时创建菜单入口。命令固定返回 `pageType=CUSTOM`。
 
 该命令不接受 `--page-type`。工作台、看板、门户或复杂交互仍然属于 CUSTOM 页面；`rabetbase project` 管理独立子应用工程，不是页面类型或复杂页面的兜底入口。
 

package/skills/rabetbase/references/rabetbase-page-generate-start.md

@@ -2,10 +2,12 @@
 
 异步提交或复用数据列表页（Data List Page）生成任务。
 
+生成流程会在生成页面后自动创建菜单入口，无需额外绑定子应用 appName 或执行 `menu sync`。提交成功仅表示任务已受理；跟进原任务，并核对完整页面组及对应菜单事实后，再报告页面和菜单已就绪。
+
 ## 命令
 
 ```bash
-# 默认行为：仅预览，不调用平台 API
+# 默认行为：仅预览，会读取前置事实，不提交生成任务
 rabetbase page generate-start --datasetcode 097b7361b76c42bcb12b923fa5a08861 --format json
 rabetbase page generate-start --alias order --format json
 rabetbase page generate-start --datasetcode 097b7361b76c42bcb12b923fa5a08861 --dry-run --format json
@@ -22,8 +24,8 @@ rabetbase page generate-start --alias order --apply --format json
 - CLI 会先执行 `page data-list-status` 做前置判定；底层仍调用既有服务端 `standard-page-status` 接口。
 - 若允许生成且传入 `--apply`，CLI 会自动生成 `clientOperationId`，并调用 Java 侧 `generate-standard-pages/start`。
 - 提交结果固定返回 `pageType=DATA_LIST` 与 `pagePattern=CRUD_PAGE_SET`；命令不接受 `--page-type` 或 `--page-pattern`。
-- 返回结果里的 `operationId` 是服务端 job 主标识；`clientOperationId` 是调用方恢复 / 幂等锚点。
-- `query.command` 默认给出 `operationId` 查询；调用方若只保留了 `clientOperationId`，也可以用它恢复到同一条任务查询。
+- 返回结果里的 `taskId` 是首选查询标识；`operationId` 用于兼容旧响应，`clientOperationId` 是调用方恢复 / 幂等锚点。
+- `query.command` 优先使用 `taskId`，缺失时使用 `operationId`，再回退到 `clientOperationId`，查询时只携带其中一个标识。
 - Agent / 自动化编排优先直接复用返回值里的 `query.command`，不要自己重新拼接恢复查询命令。
 - Agent 自动化场景下，编排器应先跑一次默认预览校验候选数据集，再带 `--apply` 提交；不应直接对所有数据集跑 `--apply`。
 

package/skills/rabetbase/references/rabetbase-page-generate-status.md

@@ -21,6 +21,7 @@ rabetbase page generate-status --datasetcode 097b7361b76c42bcb12b923fa5a08861 --
 
 - 命令查询的是**任务状态**，不是页面事实。
 - 当任务进入成功终态时，CLI 会补查 `page data-list-status`，把页面事实一并附在结果里，方便你直接判断是否形成完整数据列表页组。
+- 生成流程自动创建菜单入口；成功终态仍需核对完整页面组及对应菜单事实。预期菜单入口缺失时如实报告并核查，不报告整体就绪，也不自动用 `menu sync` 补建。
 - 若任务仍在 `PENDING/PROCESSING/RUNNING`，结果会保持机器可读的 `status / nextAction / query`。
 - 提交生成后保存 `taskId`、`operationId` 与 `clientOperationId`；超时、未知状态或网络失败时复用原标识查询，不重新执行 `generate-start --apply`，不得自动重提。
 - 成功终态时，页面组锚点位于 `data.dataListPageStatus.pageSets[].versionTag`。存在多个完整组、残留页或冲突时交给用户确认，不猜测 `versionTag`。

package/skills/rabetbase.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "rabetbase",
   "packageName": "@lovrabet/rabetbase-cli",
-  "packageVersion": "2.5.4-beta.4",
-  "skillVersion": "2.5.4-beta.4",
+  "packageVersion": "2.5.4-beta.5",
+  "skillVersion": "2.5.4-beta.5",
   "files": [
     "SKILL.md",
     "guides/approval-flow-development-workflow.md",
@@ -18,6 +18,8 @@
     "guides/data-api-guidelines.md",
     "guides/database-connection-workflow.md",
     "guides/frontend-development.md",
+    "guides/host-frontend-integration.md",
+    "guides/independent-deployment.md",
     "guides/legacy-application-blueprint-workflow.md",
     "guides/menu-anomaly-manual-cleanup.md",
     "guides/page-development-workflow.md",
@@ -43,6 +45,7 @@
     "references/rabetbase-api-list.md",
     "references/rabetbase-api-pull.md",
     "references/rabetbase-app-config.md",
+    "references/rabetbase-app-detail.md",
     "references/rabetbase-app-list.md",
     "references/rabetbase-app-members-list.md",
     "references/rabetbase-auth-login.md",
@@ -109,6 +112,8 @@
     "references/rabetbase-menu-move.md",
     "references/rabetbase-menu-regroup-start.md",
     "references/rabetbase-menu-rename.md",
+    "references/rabetbase-menu-subapp-assets-status.md",
+    "references/rabetbase-menu-subapp-assets-update.md",
     "references/rabetbase-menu-sync.md",
     "references/rabetbase-menu-visibility-update.md",
     "references/rabetbase-notification-config-list.md",
@@ -150,5 +155,5 @@
     "references/rabetbase-user-account.md",
     "references/rabetbase-workspace.md"
   ],
-  "digest": "e1381f35f9285560710dd0866fe6a155b9c0fed7ed937c8da8f723eafd12eaa1"
+  "digest": "29391368de80e9469389f4d839ddb9163d68fdb445babf794b62f90dea4ccccf"
 }