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

package/skills/rabetbase/references/rabetbase-config.md

@@ -2,7 +2,9 @@
 
 项目级配置文件，放在项目根目录。CLI 启动时自动读取，全局配置（`~/.rabetbase.json`）作为 fallback。
 
-这份文件描述的是**本地配置模型**：默认应用、应用名到 `appcode`/`env`/`apiDir` 的映射，以及输出格式、风险等级、认证信息等本地偏好。
+这份文件描述的是**本地配置模型**：默认应用、应用名到 `appcode`/`apiDir` 的映射，以及输出格式、风险等级、认证信息等本地偏好。
+
+独立部署应用需要确认业务环境与平台连接的对应关系时，读取[独立部署指南](../guides/independent-deployment.md#理解用户说的测试环境与线上环境)。
 
 它**不是**平台应用目录。若要查看当前登录账号在平台上能访问哪些应用，应使用 `rabetbase app list --remote`，而不是直接查看 `.rabetbase.json`。
 
@@ -24,8 +26,7 @@ rabetbase workspace init --appcode <code>
 {
   "apps": {
     "main": {
-      "appcode": "app-xxxxxxxx",
-      "env": "daily"
+      "appcode": "app-xxxxxxxx"
     }
   }
 }
@@ -33,16 +34,15 @@ rabetbase workspace init --appcode <code>
 
 CLI 对旧版顶层 `appcode` 仍兼容读取，但它已经不是推荐主模型。
 
-CLI 新写入或重写配置时不会持久化默认内部路由字段；历史文件仍保持读取兼容。若顶层存在非默认值，而某个应用显式回到默认值，写入时会把非默认值下沉到实际继承它的应用，再省略默认标记，确保配置精简且生效语义不变。
+CLI 新写入或重写配置时会省略平台环境等默认路由值；显式非默认值仍可配置并生效。若顶层存在非默认值，而某个应用显式回到默认值，写入时会把非默认值下沉到实际继承它的应用，再省略默认标记，确保配置精简且生效语义不变。
 
 ## 兼容读取的单应用模式
 
-兼容读取的最简配置只需 `appcode` 和 `env`：
+兼容读取的最简配置只需顶层 `appcode`：
 
 ```json
 {
-  "appcode": "app-xxxxxxxx",
-  "env": "daily"
+  "appcode": "app-xxxxxxxx"
 }
 ```
 
@@ -90,7 +90,6 @@ CLI 新写入或重写配置时不会持久化默认内部路由字段；历史
   "apps": {
     "order": {
       "appcode": "app-yyyyyyyy",
-      "env": "daily",
       "riskLevel": "write"
     },
     "product": {
@@ -107,7 +106,7 @@ CLI 新写入或重写配置时不会持久化默认内部路由字段；历史
 管理命令（声明式 flags，非位置参数）：
 
 ```bash
-rabetbase workspace add order --appcode app-order-001 --env daily
+rabetbase workspace add order --appcode app-order-001
 rabetbase workspace add product --appcode app-product-002 --region id
 rabetbase workspace use --app order
 rabetbase app list
@@ -121,7 +120,7 @@ rabetbase workspace remove product --yes
 | 字段 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
 | `appcode` | string | — | 顶层单应用兼容字段。新写入优先使用 `apps`。兼容旧名 `app` |
-| `env` | string | — | 历史兼容字段；默认连接不落盘，读取旧配置时仍兼容 |
+| `env` | string | `"production"`（省略） | Lovrabet 平台自身产品研发迭代的环境：`daily` 为平台日常测试，`production` 为平台线上 |
 | `locale` | string | `"en-US"` | 应用本地化设置（不是 CLI 语言；目前命令尚未消费） |
 | `cookie` | string | — | 内联 session cookie。设置后优先于 `~/.lovrabet/cookie` 文件 |
 | `accessKey` | string | — | Access Key 认证（预留，未来替代 cookie） |
@@ -151,7 +150,7 @@ rabetbase workspace remove product --yes
 | `apiGroup` | string | 可选显式归并键。同一套业务 API 的多个部署使用相同值并共用一个 `apiDir`；普通单应用不配置 |
 | `region` | string | 覆盖顶层国家/地区；当前可写 `cn`、`id`、`global`。显式 `cn` 会保留，以便覆盖顶层 `id` |
 | `kbServiceDomain` | string | 当前应用的 KB Service HTTPS origin，覆盖顶层同名字段；已导入的企业 `routing` 清单仍优先作为完整路由来源 |
-| `env` | string | 历史兼容字段；默认连接不落盘 |
+| `env` | string | 覆盖顶层 Lovrabet 平台研发迭代环境，含义同顶层 `env`；默认值省略 |
 | `apiDir` | string | 覆盖顶层 `apiDir` |
 | `cookie` | string | 覆盖顶层 `cookie` |
 | `accessKey` | string | 覆盖顶层 `accessKey` |
@@ -185,7 +184,7 @@ CLI flag (--appcode, --format, --app ...)
 | 环境变量 | 对应配置项 | 说明 |
 |----------|-----------|------|
 | `RABETBASE_APPCODE` | — | 仅作为 shell 变量供脚本显式传给 `--appcode`；业务命令检测到冲突时会拒绝执行 |
-| `RABETBASE_ENV` | `env` | 无项目 env 时的环境 fallback |
+| `RABETBASE_ENV` | `env` | Lovrabet 平台自身研发迭代环境；无项目 env 时的 fallback |
 | `RABETBASE_COOKIE` | `cookie` | Session cookie |
 | `RABETBASE_ACCESS_KEY` | `accessKey` | Access Key |
 | `RABETBASE_FORMAT` | `format` | 输出格式 |
@@ -221,17 +220,17 @@ CLI flag (--appcode, --format, --app ...)
 
 ```bash
 export RABETBASE_APPCODE=app-xxx
-export RABETBASE_ENV=daily
 rabetbase dataset list --appcode "$RABETBASE_APPCODE"
 ```
 
-### 开发环境单应用
+### Lovrabet 平台自身研发测试示例
+
+连接 Lovrabet 平台日常测试环境 `daily`：
 
 ```json
 {
   "appcode": "app-xxxxxxxx",
-  "env": "daily",
-  "riskLevel": "high-risk-write"
+  "env": "daily"
 }
 ```
 
@@ -243,8 +242,7 @@ rabetbase dataset list --appcode "$RABETBASE_APPCODE"
   "defaultApp": "order",
   "apps": {
     "order": {
-      "appcode": "app-order-001",
-      "env": "daily"
+      "appcode": "app-order-001"
     },
     "product": {
       "appcode": "app-product-002",
@@ -268,7 +266,6 @@ rabetbase dataset list --app product
 ```bash
 # 写入项目级配置（默认；须在能解析到项目 .rabetbase.json 的目录下执行）
 rabetbase config set --key apiDomain --value https://custom-api.example.com
-rabetbase config set --key env --value daily
 
 # 写入全局配置（任意目录）
 rabetbase config set --key apiDomain --value https://custom-api.example.com --global

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

@@ -2,12 +2,14 @@
 
 按精确菜单 ID 或 path 批量显示、隐藏线上菜单。该命令只更新 `visible`，不删除页面，也不修改 path、URL、父级、排序或资源。
 
+风险等级：`write`。
+
 ## 隐藏菜单
 
 ```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 visibility-update --menu-ids "10,11" --visible=false --expect-visible=true --expected-count 2 --format compress
 rabetbase menu list --format json --jq '.data.menus[] | select(.id == 10 or .id == 11) | {id, path, visible}'
 ```
 
@@ -15,7 +17,7 @@ rabetbase menu list --format json --jq '.data.menus[] | select(.id == 10 or .id
 
 ```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
+rabetbase menu visibility-update --menu-ids "10,11" --visible=true --expect-visible=false --expected-count 2 --format compress
 ```
 
 ## Flags
@@ -28,7 +30,6 @@ rabetbase menu visibility-update --menu-ids "10,11" --visible=true --expect-visi
 | `--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 选中同一菜单时自动去重。
 
@@ -37,7 +38,7 @@ rabetbase menu visibility-update --menu-ids "10,11" --visible=true --expect-visi
 1. 先用 `menu list` 取得精确 ID、path 和当前 `visible`。
 2. dry-run 时同时传 `--expect-visible` 与 `--expected-count`。
 3. 检查 `targets[].before/after`，确认只有 `visible` 改变。
-4. 复用相同 selector、目标值和断言，添加 `--yes` 正式执行。
+4. 复用相同 selector、目标值和断言，移除 `--dry-run` 正式执行。
 5. 检查 `succeeded/failed` 与 `verification.matchesRequestedState`，再用 `menu list` 回查。
 
 目标已经等于期望值时返回 `skipped=true`，不发送更新请求。批量请求出现部分失败时不会自动重试；先按 `succeeded/failed` 和 `menu list` 核对实际状态，再为仍未生效的精确 ID 重新 dry-run。

package/skills/rabetbase/references/rabetbase-workspace.md

@@ -24,7 +24,7 @@ rabetbase workspace remove <name> [--global]
 | `--app <name>` | 工作空间里的应用名，如 `crm`、`order` |
 | `--appcode <code>` | 应用 App Code；不知道本地应用名时可直接使用 |
 | `--region <region>` | 写入该 app profile 的国家/地区：`cn` / `id` |
-| `--env <env>` | 历史兼容参数；默认内部路由值不会写入 app profile |
+| `--env <env>` | 仅显式传入时写入 app profile；平台环境定义见[配置参考](rabetbase-config.md#顶层字段)中的 `env` |
 | `--apiDir <dir>` | 写入该 app profile 的 API 目录 |
 | `--defaultFormat <format>` | 写入该 app profile 的默认输出格式 |
 | `--pageSize <n>` | 写入该 app profile 的分页大小 |
@@ -33,6 +33,8 @@ rabetbase workspace remove <name> [--global]
 
 `add` / `remove` 用位置参数 `<name>` 指定应用名；`add` 必带 `--appcode <code>`，两者都支持 `--global`（写/删全局清单，全局视作一个大工作空间），其余 profile flags 与上表一致。
 
+独立部署应用需要确认业务环境与平台连接的对应关系时，读取[独立部署指南](../guides/independent-deployment.md#理解用户说的测试环境与线上环境)。
+
 ## 行为
 
 - `workspace init --appcode app-xxx`：用 appcode 作为应用名写入 `apps.app-xxx`；若它是唯一应用，不写 `defaultApp`。

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

@@ -1,6 +1,6 @@
 ---
 name: rabetbase-page-generation
-version: 2.5.5-beta.2
+version: 2.5.5-beta.3
 description: "根据用户需求，为已有 Dataset 选择、生成、串联、验证和发布 CustomJSX 页面；提供列表、详情、新增、更新基础模板，并支持裁剪或扩展页面。"
 metadata:
   requires:

package/skills/rabetbase.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "rabetbase",
   "packageName": "@lovrabet/rabetbase-cli",
-  "packageVersion": "2.5.5-beta.2",
-  "skillVersion": "2.5.5-beta.2",
+  "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": "46e08874ae244a126497186b6f930955164184baac9690d026efbbdb07b820a8"
+  "digest": "1af259428a098b2004287a1c523512325f89477eaa9b4704e1896c851c38d80a"
 }