@lovrabet/rabetbase-cli 2.4.3 → 2.4.4

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

@@ -14,7 +14,7 @@ tags: [page, layout, page-schema]
 
 | 类型 | 判断条件 | 特点 | 场景 |
 |------|----------|------|------|
-| 磁贴布局 | 包含 `YtRglContainer` | 网格定位、支持并排 | 仪表盘、数据看板 |
+| 磁贴布局 | 包含 `YtRglContainer` | 网格定位、支持并排 | 多区域表单、列表与详情组合 |
 | 流式布局 | 无 `YtRglContainer` | 上下排列 | 表单页、详情页 |
 
 ---
@@ -56,7 +56,6 @@ tags: [page, layout, page-schema]
 |------|------|
 | 每行总宽度 | 必须为 12 |
 | Filter/Table | 必须独占一行（w: 12） |
-| 图表并排 | 两个图表各占 w: 6 |
 
 ---
 
@@ -83,31 +82,6 @@ tags: [page, layout, page-schema]
 
 ## 常见布局场景
 
-### 并排图表
-
-```json
-{
-  "RGLlayout": [
-    {"i": "chart1", "w": 6, "h": 20, "x": 0, "y": 0},
-    {"i": "chart2", "w": 6, "h": 20, "x": 6, "y": 0}
-  ]
-}
-```
-
-### 统计卡 + 图表
-
-```json
-{
-  "RGLlayout": [
-    {"i": "stat1", "w": 3, "h": 10, "x": 0, "y": 0},
-    {"i": "stat2", "w": 3, "h": 10, "x": 3, "y": 0},
-    {"i": "stat3", "w": 3, "h": 10, "x": 6, "y": 0},
-    {"i": "stat4", "w": 3, "h": 10, "x": 9, "y": 0},
-    {"i": "chart1", "w": 12, "h": 20, "x": 0, "y": 10}
-  ]
-}
-```
-
 ### Filter + Table
 
 ```json
@@ -151,19 +125,11 @@ tags: [page, layout, page-schema]
     "componentName": "YtRglContainer",
     "props": {
       "RGLlayout": [
-        {"i": "node_stat1", "w": 3, "h": 8, "x": 0, "y": 0},
-        {"i": "node_stat2", "w": 3, "h": 8, "x": 3, "y": 0},
-        {"i": "node_stat3", "w": 3, "h": 8, "x": 6, "y": 0},
-        {"i": "node_stat4", "w": 3, "h": 8, "x": 9, "y": 0},
-        {"i": "node_filter", "w": 12, "h": 10, "x": 0, "y": 8, "autoHeight": true},
-        {"i": "node_table", "w": 12, "h": 30, "x": 0, "y": 18}
+        {"i": "node_filter", "w": 12, "h": 10, "x": 0, "y": 0, "autoHeight": true},
+        {"i": "node_table", "w": 12, "h": 30, "x": 0, "y": 10}
       ]
     },
     "children": [
-      {"id": "node_stat1", "componentName": "LrSmartStatistic"},
-      {"id": "node_stat2", "componentName": "LrSmartStatistic"},
-      {"id": "node_stat3", "componentName": "LrSmartStatistic"},
-      {"id": "node_stat4", "componentName": "LrSmartStatistic"},
       {"id": "node_filter", "componentName": "LrSmartFilter"},
       {"id": "node_table", "componentName": "LrSmartTable"}
     ]

package/skills/rabetbase/knowledge/react-page/generation-standards.md

@@ -23,6 +23,7 @@
 | 路由     | 使用 `navigate` 跳转、使用 `location` 读取地址，不使用 `window.location`                                                  |
 | 样式     | 使用 Ant Design CSS 变量，不写死颜色或其他样式常量                                                                        |
 | 数据访问 | `client` 支持当前页面可用的全部 `@lovrabet/sdk` 能力，先确认数据集、SQL 或 BFF 的事实与 SDK 调用方式，再使用 `client` |
+| 图表     | 使用 `echarts@5` 构建图表、统计卡片与数据大屏；ECharts 只负责呈现，不承担数据访问或权限判断                         |
 
 ### 依赖白名单（严格）
 
@@ -97,10 +98,18 @@ export default App;
 | 方式 | 优先考虑的场景 | 使用边界 |
 | --- | --- | --- |
 | 单一数据集请求 | 只涉及一个数据集的列表查询、详情读取、分页、筛选、创建、更新或删除，且业务逻辑主要由数据集模型能力完成 | 优先使用 API-doc 中确认过的 `client.models` 方法；不要为简单的数据集操作改用 SQL 或 BFF，也不要猜测未在 API-doc 中出现的字段和参数 |
-| 自定义 SQL | 需要一次查询组合多个数据集，或需要数据库完成明确的关联、聚合、分组、排序、计算和复杂筛选 | 先确认 SQL 资源、参数和实际返回结构，再按 SDK 规范调用；不要在页面中拼接 SQL、把 SQL 当作通用业务逻辑容器，或据 CLI 的 `data.rows` 推断运行时返回值 |
-| BFF | 需要在数据操作生命周期中注入业务校验、转换、加密、条件分支、多步编排，或需要调用外部服务 | 将这类业务逻辑放在已确认的 BFF 中，由页面通过 SDK 调用；不要用 BFF 包装本可直接完成的简单 CRUD，也不要在页面中实现应由 BFF 负责的敏感逻辑 |
+| Custom SQL | 需要一次查询组合多个数据集，或需要数据库完成明确的关联、聚合、分组、排序、计算和复杂筛选 | 先复用或按 SQL 工作流创建、校验并发布 Custom SQL，再通过 `client.sql.execute({ sqlCode, params })` 调用；不要在页面中拼接 SQL、把 SQL 当作通用业务逻辑容器，或据 CLI 的 `data.rows` 推断运行时返回值 |
+| BFF | 需要基于当前用户、角色、数据范围或业务规则额外鉴权，或需要转换、加密、条件分支、多步编排和外部服务 | 将校验与业务逻辑放在已确认的 BFF 中，由页面通过 SDK 调用；前端只传业务参数，BFF 内按需执行已发布的 Custom SQL；不要用 BFF 包装本可直接完成的简单查询 |
 
-选择顺序：先判断单一数据集请求是否能直接满足需求；仅在数据组合或数据库计算是主要问题时使用自定义 SQL；当核心问题是业务规则、数据处理流程或外部服务协同时使用 BFF。三种方式的具体方法、参数、返回值和异常形态，均以当前资源事实和 `@lovrabet/sdk` 使用规范为准。
+选择顺序：先判断单一数据集请求是否能直接满足需求；仅在数据组合或数据库计算是主要问题时使用 Custom SQL；当当前用户、角色、数据范围或业务规则需要额外控制时使用 BFF。三种方式的具体方法、参数、返回值和异常形态，均以当前资源事实和 `@lovrabet/sdk` 使用规范为准。
+
+页面和 BFF 通过已发布 Custom SQL 的 `sqlCode` + `params` 执行查询。执行失败时保留并报告原始错误，根据 SQL 资源状态、参数与权限定位问题。
+
+### 图表与统计页面
+
+- 使用 `echarts@5` 构建图表、统计卡片和数据大屏，复用 React 组件生命周期管理图表实例。
+- ECharts option 只负责数据映射与呈现，数据通过 Dataset、已发布的 Custom SQL 或受控 BFF 获取。
+- ECharts 不做权限判断；需要额外用户、角色或数据范围控制时由 BFF 承担。
 
 ### 国际化与样式
 
@@ -161,11 +170,13 @@ const client = useSdkClient();
 
 - 数据集模型调用（如 `models.<dataset>`）的调用标识、方法、参数、返回值和异常形态，严格以当前数据集的 API-doc 返回文档为准，不得自行推测或自由发挥
 - SQL、BFF 及其他非数据集能力的可用方法、参数、返回值和异常形态，均以 `@lovrabet/sdk` 的使用规范为准
+- 页面通过已发布 Custom SQL 的 `sqlCode` + `params` 执行查询
 - 页面调用 SQL 前，先用 `rabetbase sql list` 与 `rabetbase sql detail --sqlcode <sqlCode>` 确认目标资源
 - 生成使用自定义 SQL 的页面代码前，使用代表性参数执行 `rabetbase sql exec --sqlcode <sqlCode> --params <json> --format json`。若返回 `data.error`，先解决执行错误；成功后再根据 `data.rows` 与 `data.rowCount` 确认实际数据结构
 - `sql exec` 仅用于确认 SQL 可执行及返回数据结构。页面代码按 `@lovrabet/sdk` 的使用规范处理 `client.sql` 的返回值，不使用 CLI 输出字段 `data.rows`
 - 页面调用 BFF 前，先用 `rabetbase bff list` 与 `rabetbase bff detail --id <id>` 确认目标资源
 - 数据操作需要注入自定义业务逻辑，例如校验、转换或加密时，优先考虑使用 BFF；页面运行时通过 `client` 按 `@lovrabet/sdk` 规范调用已确认的 BFF
+- Dataset、Custom SQL 或 BFF 执行失败时保留并报告原始错误，根据资源状态、参数与权限定位问题
 - CLI 只用于读取 SQL 与 BFF 的资源事实，页面运行时仍通过 `client` 调用，不在页面中拼接 CLI 命令或平台接口
 - 不在文档中出现的 dataset 字段、参数名、返回形态、方法名不得猜测
 - `client` 只是页面内可直接调用的入口，页面侧不在本地重新创建 `createClient` 或重复注册模型

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

@@ -11,7 +11,7 @@ rabetbase app-config list --format compress
 rabetbase app-config get <key> --format compress
 rabetbase app-config get <key> --reveal --format compress
 rabetbase app-config set <key> --from-env ENV_NAME --dry-run
-rabetbase app-config set <key> --from-env ENV_NAME --yes
+rabetbase app-config set <key> --from-env ENV_NAME
 rabetbase app-config delete <key> --dry-run
 rabetbase app-config delete <key> --yes
 ```
@@ -66,7 +66,7 @@ rabetbase app-config set vectorengine.apiKey --file ./secret.txt --dry-run
 确认 dry-run 的 `operation`、`selector.appCode`、`selector.key`、`before`、`after` 后，再执行正式写入：
 
 ```bash
-rabetbase app-config set vectorengine.apiKey --from-env VECTORENGINE_API_KEY --yes
+rabetbase app-config set vectorengine.apiKey --from-env VECTORENGINE_API_KEY
 ```
 
 显式位置参数 `<value>` 可用，但不推荐用于敏感值，因为 shell history 可能记录明文。

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

@@ -2,15 +2,15 @@
 
 把本地 BFF 脚本上传到远端。
 
-> **风险等级：high-risk-write** — 必须显式 `--yes`。
+> **风险等级：write** — 建议先使用 `--dry-run` 预览。
 
 ## 命令
 
 ```bash
-rabetbase bff push --yes --format json
-rabetbase bff push --yes --type ENDPOINT --name getUserList --format json
+rabetbase bff push --format json
+rabetbase bff push --type ENDPOINT --name getUserList --format json
 rabetbase bff push --type ENDPOINT --name getUserList --dry-run --format json
-rabetbase bff push --yes --type HOOK --name beforeFilter --format json
+rabetbase bff push --type HOOK --name beforeFilter --format json
 ```
 
 ## 参数
@@ -21,7 +21,6 @@ rabetbase bff push --yes --type HOOK --name beforeFilter --format json
 | `--name <name>` | string | 否 | — | 仅推指定函数名；传时必须搭配 `--type` |
 | `--force` | boolean | 否 | — | 忽略 hash 保护强制推送 |
 | `--dry-run` | boolean | 否 | — | 仅预览将要推送的本地脚本 |
-| `--yes` | boolean | 是 | — | 跳过高风险确认 |
 | `--format <fmt>` | string | 否 | `pretty` | 输出格式 |
 
 ## 输出

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

@@ -7,7 +7,7 @@
 > - 本地创建：`rabetbase bff create`
 > - 查看状态：`rabetbase bff status`
 > - 预览上传：`rabetbase bff push --dry-run`
-> - 推送远端：`rabetbase bff push --yes`
+> - 推送远端：`rabetbase bff push`
 > - 拉取远端：`rabetbase bff pull`
 > - 删除脚本：`rabetbase bff delete --yes --target ...`
 
@@ -27,7 +27,7 @@ rabetbase bff save --file ./scripts/getUserInfo.js --name getUserInfo --format j
 rabetbase bff create --type ENDPOINT --name getUserInfo --format json
 # 编辑 .rabetbase/bff/<appCode>/ENDPOINT/getUserInfo.js
 rabetbase bff push --dry-run --format json
-rabetbase bff push --yes --format json
+rabetbase bff push --format json
 ```
 
 ### 旧“更新已有脚本”
@@ -45,7 +45,7 @@ rabetbase bff pull --format json
 # 编辑同步目录中的本地文件
 rabetbase bff status --format json
 rabetbase bff push --dry-run --format json
-rabetbase bff push --yes --format json
+rabetbase bff push --format json
 ```
 
 ## Agent 规则

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

@@ -87,7 +87,7 @@ CLI 对旧版顶层 `appcode` 仍兼容读取，但它已经不是推荐主模
 }
 ```
 
-每个 app profile 可单独覆盖普通顶层字段。`riskLevel` 是安全例外：默认值为 `high-risk-write`，全局、项目、profile 与环境变量都作为 ceiling，最终取最严格值。CLI 运行时根据 `--app <name>` 或 `defaultApp` 选择激活的 profile。
+每个 app profile 可单独覆盖普通顶层字段。`riskLevel` 是安全例外：默认值为 `write`，全局、项目与 profile 决定基础上限并取最严格值；环境变量只能继续收紧，不能提权。CLI 运行时根据 `--app <name>` 或 `defaultApp` 选择激活的 profile。权限不足时只能提醒用户手动编辑配置；Agent 和自动化脚本不得自行修改 `riskLevel` 或尝试提权。
 
 管理命令（声明式 flags，非位置参数）：
 
@@ -112,7 +112,7 @@ rabetbase workspace remove product --yes
 | `accessKey` | string | — | Access Key 认证（预留，未来替代 cookie） |
 | `format` | string | — | 默认输出格式。可选值：`json`、`pretty`、`compress`。不设则命令默认 `compress` |
 | `pageSize` | number | — | 默认分页大小，用于 `sql list` 等分页命令 |
-| `riskLevel` | string | `"high-risk-write"` | 允许执行的最高风险等级。可选值：`read`、`write`、`high-risk-write`。兼容旧名 `maxRisk` |
+| `riskLevel` | string | `"write"` | 允许执行的最高风险等级。可选值：`read`、`write`、`high-risk-write`。兼容旧名 `maxRisk` |
 | `inherit` | boolean | 省略 | 配置继承模式。**省略**（默认）：项目主导，仅从全局白名单继承 cookie/accessKey/locale/format/riskLevel/pageSize，不继承 apps/defaultApp/appcode。**`true`**：全量合并全局+项目（旧行为，需显式开启）。**`false`**：普通字段完全隔离；全局 `riskLevel` 仍作为不可绕过的上限 |
 | `apiDir` | string | `"./src/api"` | `api pull` 生成代码的输出目录 |
 | `template_base_url` | string | 平台默认 CDN | 模板 CDN 基础 URL，一般无需修改 |

package/skills/rabetbase/references/rabetbase-db-analyze.md

@@ -70,7 +70,7 @@ rabetbase db analyze-status --id 10157 --plan <traceId> --format compress
 
 必须按 `index` 严格串行：每批独立调用一次 `analyze-start`，并保存一个独立 `planId`。当前批次为 `PENDING / RUNNING / RETRYING / CANCELING` 时继续查询同一 planId；`SUCCESS` 才直接进入下一批；`PARTIAL_SUCCESS` 记录失败事实后继续；`FAILED / CANCELLED` 停止整个批次编排；未知状态停止自动推进。
 
-如果 `analyze-start` 没有明确返回 `data.planId`，停止自动推进且不得盲目重试，因为请求结果可能不确定。全部批次结束后重新执行完整 `db diff --all --changed-only`；只对仍在 `data.toAnalyzeTables` 的非删除表逐表串行恢复一次，最后再执行一次完整 diff。
+如果 `analyze-start` 没有明确返回 `data.planId`，停止自动推进且不得盲目重试，因为请求结果可能不确定。全部批次结束后按 `db detail.tableCount` 的 200 表阈值决定直接读取或先执行 `db diff-refresh-start/status`，再执行完整 `db diff --all --changed-only`；只对仍在 `data.toAnalyzeTables` 的非删除表逐表串行恢复一次，最后按同一策略再读取一次完整 diff。
 
 显式单批 `analyze-start --tables` 的持久化参数超过 1024 UTF-8 bytes 时，CLI 会在调用 API 前返回 validation error 并提示先运行 `db analyze-batch-plan`。960 是规划安全预算；960 至 1024 bytes 的显式单批仍允许启动。未传 `--tables` 的全量分析不受此保护影响。
 
@@ -101,7 +101,7 @@ rabetbase db analyze-status --id 10157 --plan <traceId> --format compress
 | `data.totalElapsedMs` | 从 `firstStartTime` 到 `endTime` 或当前查询时刻的 plan 墙钟耗时；缺少可靠时间戳时为 `null` |
 | `data.hasMultipleAttempts` | `firstStartTime` 与 `startTime` 都有效且不相同时为 `true`，表示服务端开启过后续执行尝试 |
 
-`PENDING / RUNNING / RETRYING / CANCELING` 与未知状态都不是终态。不要根据 `failedTables`、`retryCount` 或错误文案推测状态。`PARTIAL_SUCCESS` 只表示任务已到终态；必须复跑 `db diff --all --changed-only` 验证目标差异收敛，才能得出本轮分析完成结论。
+`PENDING / RUNNING / RETRYING / CANCELING` 与未知状态都不是终态。不要根据 `failedTables`、`retryCount` 或错误文案推测状态。`PARTIAL_SUCCESS` 只表示任务已到终态；必须按 200 表阈值刷新或直接复跑 `db diff --all --changed-only` 验证目标差异收敛，才能得出本轮分析完成结论。
 
 `analyze-status` 每次只查询一次。轮询时必须继续使用当前任务的同一 `planId`；查询超时、断网或临时 API 失败不等于分析失败，也不得触发新的 `analyze-start`。当前稳定任务状态中没有独立的 `TIMEOUT` 终态。
 

package/skills/rabetbase/references/rabetbase-db-detail.md

@@ -5,6 +5,7 @@
 ## 何时用
 
 - 已用 `db list` 拿到 `id`，需要比列表更全的字段
+- 读取 `tableCount`，按 200 张表阈值决定是否先刷新差异结果
 - 需要当前 **`latestAnalysisTraceId`** 查询最新分析状态；取消已知任务时仍使用正在跟踪的原 planId
 
 ## 命令
@@ -23,5 +24,7 @@ rabetbase db detail --id 10157 --format compress
 
 ## 参考
 
+输出中的 `tableCount` 是当前连接表数量：不大于 200 时通常直接读取 `db diff`；大于 200 时建议先执行 `db diff-refresh-start/status`。字段缺失时不猜测数量，也不隐式刷新。
+
 - [database-connection-workflow.md](../guides/database-connection-workflow.md)
 - [SKILL.md](../SKILL.md)

package/skills/rabetbase/references/rabetbase-db-diff-refresh.md

@@ -0,0 +1,53 @@
+# db diff-refresh-start / diff-refresh-status
+
+显式刷新服务端数据库表差异结果。`diff-refresh-start` 为 **write**，只提交一次异步任务；`diff-refresh-status` 为 **read**，只查询一次指定 `traceId`。
+
+## 何时刷新
+
+- `db detail` 返回 `tableCount > 200`，读取差异前建议刷新。
+- 用户明确要求“实时刷新”或“强制刷新”，无论表数量多少都刷新。
+- `tableCount <= 200` 时服务端通常实时计算差异，默认不刷新。
+
+刷新只影响默认 `db diff` 差异视角；`db diff --view all` 本身就是实时全表分页，不需要先刷新差异快照。
+
+## 命令
+
+```bash
+rabetbase db diff-refresh-start --id 10157 --format compress
+rabetbase db diff-refresh-status --id 10157 --plan <traceId> --format compress
+```
+
+## 执行规则
+
+1. `diff-refresh-start` 只执行一次并保存 `data.traceId`。
+2. 若响应没有明确 `traceId`，结果未知，停止且不得自动重提。
+3. `PENDING / RUNNING / RETRYING` 时继续执行 `data.query.command`，始终查询同一个 traceId。
+4. `SUCCESS` 时执行 `data.lookup.command`，重新读取刷新后的差异结果。
+5. `FAILED / CANCELLED` 为失败终态；报告 `data.status.errorMsg`，不得自动重启。
+6. 未知状态不是终态，停止自动推进或继续只读查询，不猜测成功。
+
+## 输出
+
+`diff-refresh-start`：
+
+- `data.dbLinkId`
+- `data.traceId`
+- `data.status`
+- `data.query.command`
+
+`diff-refresh-status`：
+
+- `data.status`：服务端原始任务事实
+- `data.knownStatus`：是否属于已知运行态或终态；未知时为 `false` 且不提供自动查询命令
+- `data.isTerminal`
+- `data.isSuccessful`
+- `data.query`：非终态时的同 traceId 查询命令
+- `data.lookup`：仅成功时返回的 `db diff --all --changed-only` 命令
+
+差异刷新任务与 schema 分析任务不是同一业务动作。不要用 `diff-refresh-start` 代替 `analyze-start`，也不要把刷新成功描述为数据集分析已经完成。
+
+## 参考
+
+- [db diff](rabetbase-db-diff.md)
+- [database-connection-workflow.md](../guides/database-connection-workflow.md)
+- [SKILL.md](../SKILL.md)

package/skills/rabetbase/references/rabetbase-db-diff.md

@@ -1,57 +1,76 @@
 # db diff
 
-分页查看**线上库相对上次分析**的 schema 差异（新增表、删除表、改字段等）。只读。
+分页查看数据库表差异或全部数据表。只读。
 
-## 何时用
+## 两种视角
 
-- 表结构变更后，决定是跑全量分析还是 `analyze-start --tables …` 增量
-- 排查「平台数据集与真实库不一致」
+| 视角           | 命令                 | 服务端语义                                                                                              |
+|---|---|---|
+| 差异表（默认） | `db diff`            | 调用 `getDiffTableByPage`。表数量不大于 200 时服务端通常实时计算；大于 200 时可能读取最近一次差异快照。 |
+| 全部表         | `db diff --view all` | 调用实时分页接口，包含 `ALREADY_ANALYZED`，用于查看无差异表或手动选择重新分析。                         |
+
+`--all` 始终表示“聚合当前视角的全部分页”，不表示“全部表”。需要全部表必须显式传 `--view all`。
 
 ## 命令
 
 ```bash
+# 默认差异表视角
 rabetbase db diff --id 10157 --format compress
-rabetbase db diff --id 10157 --table order --page 1 --pagesize 20 --format compress
 rabetbase db diff --id 10157 --all --changed-only --format compress
+
+# 全部表实时视角
+rabetbase db diff --id 10157 --view all --page 1 --pagesize 20 --format compress
+rabetbase db diff --id 10157 --view all --all --format compress
 ```
 
 ## 参数
 
 | Flag | 必填 | 说明 |
-|------|------|------|
+|---|---|---|
 | `--id` | **是** | dblink id |
+| `--view`                | 否     | `diff`（默认）或 `all`                                                                    |
 | `--table` | 否 | 表名模糊过滤 |
 | `--page` / `--pagesize` | 否 | 默认 `1` / `20` |
-| `--all` | 否 | 从第 1 页开始按 `pageSize=100` 自动聚合全部分页；优先级高于 `--page / --pagesize` |
-| `--changed-only` | 否 | 只从 `tables / tableList` 排除 `ALREADY_ANALYZED`；保留 `DELETED_TABLE` |
+| `--all`                 | 否     | 从第 1 页开始按 `pageSize=100` 自动聚合当前视角全部分页；优先级高于 `--page / --pagesize` |
+| `--changed-only`        | 否     | 从输出行中排除 `ALREADY_ANALYZED`；保留 `DELETED_TABLE`                                   |
+
+## 刷新决策
+
+先执行 `db detail --id <id>` 读取 `tableCount`：
+
+- `tableCount <= 200`：直接读取 `db diff`；除非用户明确要求，否则不要刷新。
+- `tableCount > 200`：读取前建议按 [`db diff-refresh-start/status`](rabetbase-db-diff-refresh.md) 刷新差异快照。
+- 用户明确要求“实时刷新/强制刷新”：不考虑表数量，执行刷新。
+- 用户明确要求“不刷新/只看现有结果”：直接读取；大库需提示结果可能滞后。
+- `tableCount` 缺失：直接读取并说明新鲜度未知，不要因为未知而隐式发起写任务。
+
+`db diff` 是只读命令，绝不隐式启动刷新任务。
 
 ## 机器可读摘要
 
 | 字段 | 语义 |
-|------|------|
+|---|---|
+| `view`               | 当前视角：`diff` 或 `all`                                                      |
 | `summaryByType` | 本次查询范围内四种 `diffType` 的计数 |
 | `toAnalyzeTables` | 仅包含 `NEW_TABLE` 与 `MODIFIED_TABLE` 的表名，可传给 `analyze-start --tables` |
 | `deletedTables` | 仅包含 `DELETED_TABLE`，供人工确认，不自动分析或清理 |
 | `modifiedFieldDiffs` | 修改表的新增、删除、变更字段摘要 |
 
-未传 `--all` 时，上述字段只代表当前页；需要完整范围时使用 `--all`。派生字段基于过滤前的查询范围计算，因此使用 `--changed-only` 时，`summaryByType.ALREADY_ANALYZED` 仍可反映原始计数。
+未传 `--all` 时，派生字段只代表当前页。默认差异视角通常不会返回 `physicalTableCount`、`datasetTableCount` 或 `summary`；CLI 不以 `0` 伪造缺失值。全表实时视角在服务端提供这些字段时会原样返回。
 
-## `diffType` 语义（与 yuntoo-web-app 增量分析抽屉一致）
-
-接口返回 `IDbTableDiffInfo.diffType`，工作台「数据库连接 → 增量分析」里对每行表的展示文案如下，可与 CLI 输出对照：
+## `diffType` 语义
 
 | `diffType` | 界面文案 | 含义 |
-|------------|----------|------|
-| `NEW_TABLE` | 表新增 | 物理库中**有**该表，但**尚未纳入**（或尚未完成）上次智能分析；适合勾选后走 `db analyze-start --tables …` 做增量分析。 |
-| `DELETED_TABLE` | 表删除 | 相对上次已分析快照，该表在库侧**已不存在**（或已被移除）；界面上勾选增量分析时**不可选**该行。 |
-| `MODIFIED_TABLE` | 表修改 | 表仍在，但**结构相对上次分析有变**；同条记录里可能有 `fieldDiff`（`addedColumns` / `deletedColumns` / `modifiedColumns`）。 |
-| `ALREADY_ANALYZED` | 无差异 | 当前表结构与上次分析结果**一致**，无需因本表再跑增量（界面用灰色「无差异」标签）。 |
-
-`DELETED_TABLE` 不会进入 `toAnalyzeTables`。如果自动分页在达到 `totalCount` 前遇到空页或不再产生新的唯一表，命令会失败，不把部分结果当作完整结果返回。
+|---|---|---|
+| `NEW_TABLE`        | 表新增   | 物理库中有该表，但尚未纳入或尚未完成上次智能分析。                     |
+| `DELETED_TABLE`    | 表删除   | 相对上次已分析结果，该表在库侧已不存在或已被移除。                     |
+| `MODIFIED_TABLE`   | 表修改   | 表仍在，但结构相对上次分析有变化。                                     |
+| `ALREADY_ANALYZED` | 无差异   | 当前表结构与上次分析结果一致；在 `--view all` 中可供用户主动重新分析。 |
 
-`--all` 聚合的是服务端实时分页结果，不是事务一致性快照。数据库结构在翻页期间持续变化时，结果可能来自不同查询时刻；检测到分页无进展会直接失败。此时应等待库表结构稳定后重试，并在分析结束后再次执行 `db diff --all --changed-only` 验证差异收敛。
+`DELETED_TABLE` 不进入 `toAnalyzeTables`。自动分页在达到 `totalCount` 前遇到空页或没有新增唯一表时，命令失败，不把部分结果伪装成完整结果。
 
 ## 参考
 
+- [差异刷新](rabetbase-db-diff-refresh.md)
 - [database-connection-workflow.md](../guides/database-connection-workflow.md)
 - [SKILL.md](../SKILL.md)

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

@@ -27,7 +27,7 @@ rabetbase db list --appcode app-xxxx --format compress
 
 ## 输出要点
 
-- `connections[]`：每条含 `id`、`dbName`、`dbType`、`latestAnalysisStatus`、`latestAnalysisTraceId` 等
+- `connections[]`：每条含 `id`、`dbName`、`dbType`、`latestAnalysisStatus`、`latestAnalysisTraceId`，以及服务端提供时的 `tableCount` 等
 - 返回中密码已脱敏
 - 若接口未返回分页元数据，`paging.totalCount` 为 `null` 并带 `note`，**勿将本页条数当作全量总数**
 

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

@@ -11,9 +11,9 @@ rabetbase kb list --format compress
 rabetbase kb list --appcode app-xxxxx --title "业务规则" --format compress
 rabetbase kb detail --id 60 --format compress
 rabetbase kb create --title "业务规则" --file ./knowledge.md --dry-run
-rabetbase kb create --title "业务规则" --file ./knowledge.md --yes
+rabetbase kb create --title "业务规则" --file ./knowledge.md
 rabetbase kb update --id 60 --file ./knowledge.md --expected-version 2 --dry-run
-rabetbase kb update --id 60 --file ./knowledge.md --expected-version 2 --yes
+rabetbase kb update --id 60 --file ./knowledge.md --expected-version 2
 rabetbase kb delete --id 60 --dry-run
 rabetbase kb delete --id 60 --yes
 ```
@@ -33,9 +33,10 @@ rabetbase kb delete --id 60 --yes
 
 ## create
 
+- `create/update` 为 `write`，正式执行不要求 `--yes`；仍应先审阅 dry-run。
 - 只需 `--title`、`--file`；应用由标准全局应用解析得到。
 - 写前按 `(company, appCode, title)` 精确检查重复。
-- 正式执行必须显式 `--yes`，请求最多提交一次。
+- 审阅 dry-run 后，使用相同参数移除 `--dry-run` 正式执行；请求最多提交一次。
 - 正常响应使用服务端返回 VO/ID 并按 ID 回读。只有底层响应不确定时，才按同一 company/app/title 三元组做只读恢复；零条或多条都返回 outcome unknown，绝不自动重提。
 - 授权、权限、参数和其他确定性服务端错误直接失败，不能用旧状态回读伪装成成功。
 
@@ -50,6 +51,7 @@ rabetbase kb delete --id 60 --yes
 ## delete
 
 - 已验证服务端合同：`POST /admin/knowledge-base/delete`，请求体 `{id}`，成功为 `Result<Void>`。
+- `delete` 保持 `high-risk-write`；正式执行必须显式 `--yes`，并建议先审阅 dry-run。
 - 写前读取目标，校验 ID、company scope、appCode、可选 expected-version 和安全快照；`--expected-version` 仍是非原子断言，dry-run 明确输出 `atomicCompareAndSet: false`。
 - 目标明确不存在时返回 no-op 且不发请求；只有服务端 `DATA_NOT_EXIST (306)` 可识别为不存在，`PARAM_INVALID (103)`、权限、认证或传输错误不能降级为 no-op。
 - 正式删除最多提交一次，再按同一 ID 回读；明确不存在用于验证数据库软删除。

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

@@ -2,7 +2,7 @@
 
 更新指定线上微前端菜单的 CDN 资源 URL。
 
-> **风险等级：high-risk-write** — 修改线上菜单运行资源；非交互正式执行必须显式 `--yes`。
+> **风险等级：write** — 修改线上菜单运行资源；建议先 dry-run，正式执行复用相同参数并移除 `--dry-run`。
 
 ## 命令
 
@@ -12,7 +12,7 @@ rabetbase menu asset-update
 
 # 使用 menu list 返回的真实 path 精确预览并更新
 rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://...css"}' --dry-run --format compress
-rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://...css"}' --yes --format compress
+rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://...css"}' --format compress
 
 # 按菜单 ID 精确更新，并显式切换加载方式
 rabetbase menu asset-update --menu-ids "<menu-id>" --load-mode fetch --params '{"jsUrl":"https://...js"}' --dry-run --format compress
@@ -53,7 +53,7 @@ rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://.
 5. **正式执行必须复用 dry-run 的同一组 selector、`--mode` 和 `--params`**：
 
 ```bash
-rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://...css"}' --yes --format compress
+rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://...css"}' --format compress
 ```
 
 6. **执行后回查资源现状**：
@@ -67,15 +67,15 @@ rabetbase menu list --format json --jq '.data.menus[] | select(.resources | leng
 ```bash
 # 只替换 CSS，保留已有 JS
 rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://cdn.example.com/app.css"}' --dry-run --format compress
-rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://cdn.example.com/app.css"}' --yes --format compress
+rabetbase menu asset-update --paths "<menu-path>" --params '{"cssUrl":"https://cdn.example.com/app.css"}' --format compress
 
 # 只替换 JS，保留已有 CSS
 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"}' --yes --format compress
+rabetbase menu asset-update --menu-ids "<menu-id>" --params '{"jsUrl":"https://cdn.example.com/app.js"}' --format compress
 
 # 显式更新全部菜单的 JS + CSS
 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"}' --yes --format compress
+rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/app.js","cssUrl":"https://cdn.example.com/app.css"}' --format compress
 ```
 
 ## 参数
@@ -86,7 +86,6 @@ rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/ap
 | `--menu-ids <csv>` | string | 至少一个 selector | — | 精确菜单 ID；只接受正安全整数；可与 paths 组合，不可与 all 组合 |
 | `--paths <csv>` | string | 至少一个 selector | — | 精确菜单 path；可与 menu-ids 组合，不可与 all 组合 |
 | `--all` | boolean | 至少一个 selector | `false` | 显式选择所有已有 resources 的菜单；不可与 ID/path 组合 |
-| `--yes` | boolean | 正式执行必填 | — | 跳过高风险确认并更新已选择菜单，必须配合有效 `--params` |
 | `--mode <mode>` | string | 否 | `patch` | `patch` 只在目标唯一时替换传入的同类型资源并保留其他资源；`replace` 将传入 URL 作为完整 `resources` |
 | `--load-mode <mode>` | string | 否 | 保留线上值 | 显式修改为 `import`、`script` 或 `fetch` |
 | `--force` | boolean | 否 | `false` | 允许 `replace` 删除已有 JS 资源；仅用于明确的资源降级/迁移 |
@@ -96,7 +95,7 @@ rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/ap
 ## 执行模式
 
 1. **selector + `--params` + `--dry-run`** — 非交互预览精确目标；全量必须显式 `--all`
-2. **selector + `--params` + `--yes`** — 正式更新精确目标；必须复用 dry-run 参数
+2. **selector + `--params`** — 正式更新精确目标；必须复用 dry-run 参数并移除 `--dry-run`
 3. **TTY 交互式** — 未给 selector 时展示全部有资源菜单并二次确认；给 selector 时只展示目标
 
 ## 输出
@@ -109,7 +108,7 @@ rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/ap
 ## 提示
 
 - 仅更新已配置了资源 URL 且被 selector 命中的菜单
-- 非交互和 dry-run 缺 selector 会被拒绝；`--yes` 不能裸跑；空 `--params` 也会被拒绝
+- 非交互和 dry-run 缺 selector 会被拒绝；空 `--params` 也会被拒绝
 - 写入采用 read-modify-write：默认只更新 `extend.resources`，保留 `loadScriptMode` 和其他扩展字段
 - 只有显式传 `--load-mode` 才修改加载方式
 - 默认 `patch`；使用 `replace` 时仍会阻止无意删除已有 JS
@@ -120,7 +119,7 @@ rabetbase menu asset-update --all --params '{"jsUrl":"https://cdn.example.com/ap
 ## 常见错误
 
 - 跳过 `--dry-run` 直接写入。
-- `--yes` 裸跑、缺 selector 或传空 `--params`。
+- 缺 selector 或传空 `--params`。
 - 需要单菜单更新却使用 `--all`。
 - 只想换 CSS 却显式使用 `replace`，导致已有 JS 被删除风险。
 - dry-run 已出现删除 JS warning，仍未取得用户明确确认就继续执行。

package/skills/rabetbase/references/rabetbase-menu-external-link-update.md

@@ -2,7 +2,7 @@
 
 按精确 ID 原地更新一个既有 `iframe` 或 `link` 叶子菜单的 URL。只修改 URL，不删除重建菜单。
 
-> **风险等级：high-risk-write** — 会改变线上菜单实际打开地址；必须先 dry-run，正式执行显式传 `--yes`。
+> **风险等级：write** — 会改变线上菜单实际打开地址；建议先 dry-run，正式执行复用相同参数并移除 `--dry-run`。
 
 ## 命令
 
@@ -20,7 +20,6 @@ rabetbase menu external-link-update \
   --url "https://admin.example.com/new-page?hideShell=true" \
   --expect-url "https://admin.example.com/old-page?hideShell=true" \
   --expect-parent-id "<folder-id|root>" \
-  --yes \
   --format compress
 ```
 
@@ -34,7 +33,6 @@ rabetbase menu external-link-update \
 | `--expect-parent-id <id\|root>` | string | 是 | — | 始终断言当前父级 |
 | `--appcode <code>` | string | 否 | 配置解析 | 显式指定 App Code |
 | `--dry-run` | boolean | 否 | `false` | 输出精确 URL patch，不写入 |
-| `--yes` | boolean | 正式执行必填 | — | 明确确认高风险写入 |
 
 ## 目标边界
 

package/skills/rabetbase/references/rabetbase-menu-regroup-start.md

@@ -2,13 +2,13 @@
 
 提交一个异步任务：新建根级 folder，并将一组精确的非 folder 叶子菜单放入其中。命令返回重新分组任务的 `taskId/status`。
 
-> **风险等级：high-risk-write** — 必须先 dry-run，正式执行必须显式 `--yes`。
+> **风险等级：write** — 建议先 dry-run，正式执行复用相同参数并移除 `--dry-run`。
 
 ## 命令
 
 ```bash
 rabetbase menu regroup-start --label "业务管理" --menu-ids "<menu-id-1>,<menu-id-2>" --dry-run --format compress
-rabetbase menu regroup-start --label "业务管理" --menu-ids "<menu-id-1>,<menu-id-2>" --yes --format compress
+rabetbase menu regroup-start --label "业务管理" --menu-ids "<menu-id-1>,<menu-id-2>" --format compress
 rabetbase task status --task-id "<task-id>" --format compress
 ```
 
@@ -19,7 +19,6 @@ rabetbase task status --task-id "<task-id>" --format compress
 | `--label <label>` | string | 是 | 新建根 folder 名称；不能与现有根 folder 同名 |
 | `--menu-ids <ids>` | string | 是 | 逗号分隔的精确叶子菜单 ID，最多 100 个 |
 | `--dry-run` | boolean | 预览时 | 返回当前快照、before/after 和请求体，不写入 |
-| `--yes` | boolean | 正式执行时 | 显式授权重新分组 |
 
 ## 状态流
 

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

@@ -1,6 +1,6 @@
 # rabetbase notification config-list
 
-只读查询当前应用的应用级通知渠道配置，主要用于获取 BFF 消息通知扩展需要的 `configCode`。
+只读查询当前应用的应用级通知渠道配置，主要用于获取 BFF 消息通知扩展需要的应用级 `configCode`。
 
 ## 命令
 
@@ -69,7 +69,7 @@ await context.client.extension.execute("notification", "send", {
 边界：
 
 * `configCode` 是应用级通知配置编码。
-* dataset 级通知通道的 `channelCode` 不能替代 `configCode`。
+* 数据集级通知通道的 `channelCode` 不能替代应用级 `configCode`；创建、更新和删除应用级配置见 [`rabetbase-notification-config-mutations.md`](rabetbase-notification-config-mutations.md)。
 * 没有查询结果时，不要编造配置编码。
 * 多个候选无法判断时，向用户确认，不要默认取第一条。
 * 该命令不会发送通知，也不会修改平台配置。