@lovrabet/lovrabet-cli 2.2.7 → 2.3.0-beta.2

package/skills/lovrabet/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: lovrabet
 displayName: Lovrabet 运行态 CLI
-version: 2.2.7
+version: 2.3.0-beta.2
 description: "Lovrabet 运行态 CLI — 面向业务场景的 AI 操作套件，通过 lovrabet 命令管理应用目录、业务角色与权限、用户级外部账号、Service Tree 业务命令、API 文档发现、数据集查询、Instant API 数据操作、Custom SQL/Backend Function、Personal Backend Function、文件上传、面向票证类业务材料文字与结构化字段提取的 OCR、定时任务、Skill、知识库与运行态 app-config key 状态检查。触发词：云图、lovrabet、lovrabet-cli、业务角色、角色成员、页面权限、菜单权限、数据集权限、user-account bind、provider 外部账号绑定、钉钉 userId 绑定、service tree、业务服务树、api-doc、dataset、data filter、file upload、file query-url、ocr recognize、OCR 识别、票证文字提取、票证字段提取、发票识别、票据识别、证照识别、附件上传、personal-bff、schedule、定时任务、cron、kb、skill、sql exec、bff exec、app-config、accessKey、compress、jq。"
 metadata:
   requires:
@@ -49,13 +49,12 @@ npm 包会自动安装同版本 Built-in Skill。若 `lovrabet doctor` 报告缺
 
 ### 认证命令选择
 
+- **首次使用或切换节点**：执行 `lovrabet config init`，选择 `cn` / `id`；独立部署使用 `--domain-config <file>`。该命令固定维护全局连接配置，不需要 `--global`
 - **只想更新 AK，尽量保留现有配置**：用户提供 AccessKey 后，使用 `lovrabet auth login --access-key <ACCESS_KEY>`
-- **还没有 AK，需要先自助创建**：Agent 可先执行 `lovrabet auth login --non-interactive` 获取无打扰提示，把 `https://user.lovrabet.com/user/ak` 发给用户；用户把 AccessKey 发给 Agent 后，再执行 `lovrabet auth login --access-key <ACCESS_KEY>`
+- **还没有 AK，需要先自助创建**：Agent 可先执行 `lovrabet auth login --non-interactive` 获取无打扰提示，把命令根据当前 `userDomain` 返回的创建地址发给用户；用户把 AccessKey 发给 Agent 后，再执行 `lovrabet auth login --access-key <ACCESS_KEY>`
 - **想确认当前 AK 对应的是哪个用户**：使用 `lovrabet auth info`
 - **凡是后续命令需要“当前登录用户身份信息”**：统一先执行 `lovrabet auth info` 获取，不要猜当前 AK 对应的人
-- **要从头重建当前作用域认证配置**：使用 `lovrabet auth init`
-- **不要**把 `auth init` 当作普通登录命令；它会清空当前作用域下已有配置，再只写回新的认证结果
-- `auth login --env` 仅作为实现层兼容能力存在，默认不要在指导中主推；需要“清空后重建 + 写 env”时优先用 `auth init --env ...`
+- **修改节点或 Domain**：使用 `lovrabet config init` 重建连接配置，或使用 `config set/delete` 精确修改；`auth login` 不负责节点配置
 
 ## 本地配置原则
 
@@ -228,7 +227,7 @@ Service Tree 未命中不是失败条件，也不代表业务能力不存在。
 - 明确要强制刷新时：`lovrabet app list --no-cache`
 - 仅排查未发布应用是否在远端目录中时：`lovrabet app list --include-unpublished`
 
-`app list` 的应用条目中，应用支持语种以 `languages` 或 `i18nInfo.langs` 为准；`locale` 是 CLI 本地兼容配置字段，不代表应用真实语种。
+`app list` 的应用条目中，应用支持语种以 `languages` 或 `i18nInfo.langs` 为准。本地可用 `config set locale` 写入应用本地化偏好，这不是 CLI 语言，目前命令尚未消费；`data.items[].locale` 来自本地配置覆盖，可能为 `null`，不代表平台语种。
 
 ### 如何根据需求判断使用哪个应用
 
@@ -268,9 +267,8 @@ Service Tree 未命中不是失败条件，也不代表业务能力不存在。
 
 | 服务 | 命令 | 说明 | 风险等级 | 认证 |
 |------|------|------|----------|------|
-| **auth** | `login` | 保存 accessKey | — | 本地 |
-| **auth** | `init` | 清空当前作用域配置并重建认证 | write | 本地 |
-| **auth** | `logout` | 清除本地 accessKey | — | 本地 |
+| **auth** | `login` | 保存 accessKey | write | 本地 |
+| **auth** | `logout` | 清除本地 accessKey | write | 本地 |
 | **auth** | `info` | 查询当前 AK 对应的登录用户信息 | read | AK |
 | **app** | `list` | 列出当前 AK 可运行态访问应用（默认仅已发布，远端优先，带缓存） | read | AK |
 | **app** | `pull` | 刷新本地 app cache | write | AK |
@@ -278,6 +276,7 @@ Service Tree 未命中不是失败条件，也不代表业务能力不存在。
 | **workspace** | `use` | 设置当前工作目录的默认应用上下文 | write | 本地 |
 | **config** | `list` | 查看完整配置 | read | 本地 |
 | **config** | `get` | 读取配置项 | read | 本地 |
+| **config** | `init` | 初始化全局官方节点或独立部署 Domain | write | 本地 |
 | **config** | `set` | 写入配置项 | write | 本地 |
 | **config** | `delete` | 删除配置项 | write | 本地 |
 | **role** | `list` / `detail` | 查询当前应用的业务角色 | read | AK |
@@ -366,7 +365,7 @@ Service Tree 未命中不是失败条件，也不代表业务能力不存在。
 | 查看当前 AK 对应的登录用户 | `lovrabet auth info` |
 | 任何依赖“当前登录用户身份”的场景先取身份 | `lovrabet auth info` |
 | 绑定当前用户的钉钉 userId | `lovrabet user-account bind --provider dingtalk --account-id <id> --dry-run`，核对后以相同 provider 和账号 ID 移除 `--dry-run` 正式执行 |
-| 重置并重建认证配置 | `lovrabet auth init --access-key <ACCESS_KEY> [--env daily]` |
+| 首次配置或切换节点 | `lovrabet config init`；自动化使用 `--region cn\|id`，独立部署使用 `--domain-config <file>` |
 | 登出 | `lovrabet auth logout` |
 | 查看当前认证状态 | `lovrabet auth status` |
 | 查看配置 | `lovrabet config list` |
@@ -394,7 +393,7 @@ Service Tree 未命中不是失败条件，也不代表业务能力不存在。
 - `PRODUCT_CONFIG.npmPackageName`：npm 包名
 - `PRODUCT_CONFIG.skillSource`：CLI Built-in Skill 发布源
 - `PRODUCT_CONFIG.envPrefix`：环境变量前缀
-- `PRODUCT_CONFIG.domains`：默认服务域名
+- `PRODUCT_CONFIG.regionDomains`：当前开放的 `cn` / `id` 内置服务域名
 - `PRODUCT_CONFIG.userCenterDisplayName` / `accessKeyCreatePath`：AK 创建提示
 
 ### 数据集与 Instant API
@@ -688,7 +687,7 @@ personal KB 使用文件型 create/update。更新前先 `kb detail` 查看正
 | 等级 | 命令 | 保护 |
 |------|------|------|
 | read | api-doc list/detail, dataset list/detail/sdk-doc, data filter/getOne/aggregate, sql detail/exec, bff detail/exec, app-config get, personal-bff list/detail, file upload/query-url, ocr recognize, kb list/detail/search, schedule validate/list/detail, service validate/list/detail, skill install/create/validate/list/diagram-validate/diagram-show, cli-skill install, update, app list, config list/get, logs show | OCR 支持 dry-run，只展示服务端调用链路，不上传、不识别 |
-| write | data create, data batchCreate, data update, user-account bind, personal-bff create/update/exec, kb create/update, service import/export/remove, skill push/diagram-push, workspace init/use, app import, config set/delete | 支持 dry-run 的命令先预览；账号绑定先核对当前身份、provider 和目标账号 ID |
+| write | auth login/logout, data create, data batchCreate, data update, user-account bind, personal-bff create/update/exec, kb create/update, service import/export/remove, skill push/diagram-push, workspace init/use, app import, config init/set/delete | 支持 dry-run 的命令先预览；账号绑定先核对当前身份、provider 和目标账号 ID |
 | high-risk-write | data delete, schedule create/run/delete | 需 `--yes` 或交互确认 |
 
 ## 详细参考

package/skills/lovrabet/guides/troubleshooting.md

@@ -12,9 +12,9 @@
 
 如果确认只是没登录：
 
-- 先到 `https://user.lovrabet.com/user/ak` 创建 AccessKey
-- 想保留当前配置，执行 `lovrabet auth login`
-- 想清空当前作用域配置后重建认证，执行 `lovrabet auth init --access-key <ACCESS_KEY> [--env daily]`
+- 先执行 `lovrabet auth login --non-interactive`，到命令根据当前 `userDomain` 返回的地址创建 AccessKey
+- 想保留当前配置，使用 `lovrabet auth login --access-key <ACCESS_KEY>`
+- 想切换节点或重建连接配置，执行 `lovrabet config init --region cn|id`，再按需执行 `lovrabet auth login --access-key <ACCESS_KEY>`
 
 ## 已登录，但业务命令仍失败
 
@@ -29,20 +29,24 @@
 lovrabet app list --no-cache
 ```
 
-如果你怀疑当前作用域配置已经混乱，比如：
+如果你怀疑连接配置或认证信息不符合预期，比如：
 
 - `defaultApp` 明显不对
 - `env` 和预期不一致
 - `auth info` 返回的用户不是你预期的账号
-- 同一作用域里残留了不该继承的旧配置
+- `lovrabet doctor` 显示的 region 或 Domain 不符合预期
 
-可直接重建认证配置：
+分别重设全局连接配置和 AccessKey：
 
 ```bash
-lovrabet auth init --access-key <ACCESS_KEY> --env daily
+lovrabet config init --region cn
+lovrabet config set env daily --global
+lovrabet auth login --access-key <ACCESS_KEY>
 ```
 
-注意：这会清掉当前作用域里已有的其他配置字段，不只是 `accessKey`。
+如果业务节点在印尼，把第一条改成 `lovrabet config init --region id`。企业独立部署使用 `lovrabet config init --domain-config <file>`。
+
+`config init` 只替换全局 region/Domain 路由字段，`auth login` 只替换目标作用域的 AccessKey；两者都保留其他配置。当前目录配置仍会覆盖全局同名字段，最后执行 `lovrabet doctor` 核对最终生效值。
 
 ## `defaultApp` 已有，但仍然找不到 appcode
 

package/skills/lovrabet/references/lovrabet-app.md

@@ -44,7 +44,7 @@ lovrabet app list --include-unpublished
 - `data.items[].enableI18n`：应用是否开启国际化；旧缓存或远端缺失该字段时为 `null`
 - `data.items[].languages`：应用支持的语种列表，来自平台真实 `i18nInfo.langs`
 - `data.items[].i18nInfo`：平台返回的应用国际化配置
-- `data.items[].locale`：CLI 本地兼容配置字段，不代表应用支持语种，可能为 `null`
+- `data.items[].locale`：本地应用本地化设置覆盖，可能为 `null`；不是 CLI 语言，也不代表平台支持语种
 - `data.meta.env`：环境
 - `data.meta.source`：来源
 - `data.meta.fetchedAt`：最近同步时间

package/skills/lovrabet/references/lovrabet-auth.md

@@ -14,7 +14,7 @@ lovrabet auth login --global
 **行为**：
 - 默认写入全局配置 `~/.lovrabet.json`
 - 兼容场景可用 `--project` 写入当前目录本地配置；常规使用不需要
-- 交互模式下，不传 `--access-key` 会提示输入 AK，并提示先到 `https://user.lovrabet.com/user/ak` 自助创建
+- 交互模式下，不传 `--access-key` 会提示输入 AK，并给出当前 `userDomain` 下的 `/user/ak` 自助创建地址
 - `--non-interactive` 表示无打扰模式：不进入 stdin prompt；如果缺少 AccessKey，会立即提示创建链接和 `--access-key` 命令
 - `auth login` 不支持 `--yes`；`--yes` 只用于高风险写操作的确认跳过
 - 也可以直接显式传入：`lovrabet auth login --access-key <ACCESS_KEY>`
@@ -27,34 +27,16 @@ lovrabet auth login --global
 
 **推荐顺序**：
 
-1. Agent 先执行 `lovrabet auth login --non-interactive`，把提示里的 `https://user.lovrabet.com/user/ak` 发给用户
+1. Agent 先执行 `lovrabet auth login --non-interactive`，把命令根据当前 `userDomain` 返回的创建地址发给用户
 2. 用户创建或复制 AccessKey，并提供给 Agent
 3. Agent 执行 `lovrabet auth login --access-key <ACCESS_KEY>`
 4. 再执行 `lovrabet auth info`，确认当前 AK 对应的是预期用户
 
-## auth init — 清空并重建当前作用域认证配置
+## 配置节点与认证的边界
 
-```bash
-lovrabet auth init --access-key <ACCESS_KEY>
-lovrabet auth init --access-key <ACCESS_KEY> --env daily
-```
-
-**行为**：
-- 会清空当前作用域下已有的整份 `.lovrabet.json` 配置内容，再仅写回新的认证初始化结果
-- 默认写入全局配置 `~/.lovrabet.json`
-- 兼容场景可用 `--project` 写入当前目录本地配置；常规使用不需要
-- 支持 `--env`，会和新的 `accessKey` 一起写入
-
-**风险提醒**：
-- 这是破坏性操作
-- 当前作用域下已有的 `defaultApp`、`format`、`pageSize`、域名覆盖等字段都会被清掉
-- 如果只是想换 AK，不要用 `auth init`，优先用 `auth login`
-
-## 什么时候用 login，什么时候用 init
-
-- **保留现有配置，只更新认证**：`lovrabet auth login`
-- **当前作用域配置已经混乱，想彻底重来**：`lovrabet auth init`
-- **需要同时清空旧配置并重建 env**：`lovrabet auth init --access-key <ACCESS_KEY> --env daily`
+- 首次使用先执行 `lovrabet config init` 配置官方节点或独立部署 Domain
+- `auth login` 只保存 AccessKey，不接受 region 或 Domain 参数，也不会清除其他配置
+- 后续切换节点继续使用 `config init --region <region>`；精确调整使用 `config set/delete`
 
 ## auth logout — 清除本地 accessKey
 
@@ -124,7 +106,7 @@ CLI flag (--access-key)
 - `lovrabet app list` 可以直接查询当前 AK 在平台上的应用目录
 - 结果会缓存在 `~/.lovrabet/cache/<env>/<ak-fingerprint>/my-apps.json`
 
-`auth login` / `auth init` 本身都不会主动把应用目录写进 `.lovrabet.json`。
+`auth login` 本身不会主动把应用目录写进 `.lovrabet.json`。
 
 ## 参考
 

package/skills/lovrabet/references/lovrabet-config-commands.md

@@ -4,6 +4,45 @@
 
 > **边界**：平台应用目录不在 `.lovrabet.json`。应用目录缓存位于 `~/.lovrabet/cache/...`，平时由 `app list` 驱动更新；`app pull` 只是手动刷新入口。
 
+## config init — 初始化连接配置
+
+固定写入全局配置 `~/.lovrabet.json`，不需要也不接受用 `--global` 改变目标。它只配置连接路由，不登录、不保存 AccessKey，也不建立当前目录的应用绑定。
+
+交互模式用方向键选择 `Mainland China (cn)` 或 `Indonesia (id)`；当前不提供 `global`。非交互且未传 region/Domain 时默认 `cn`。自动化示例：
+
+```bash
+lovrabet config init --region id
+lovrabet config init --domain-config ./lovrabet-domains.json
+```
+
+官方节点与独立部署 Domain 互斥：不能同时传 `--region` 和任一 Domain 输入。
+
+### 官方节点模式
+
+- `--region` 只接受 `cn` / `id`
+- 选择 `cn` 时省略冗余的 `region` 字段，以默认值保持向前兼容；选择 `id` 时写入 `"region": "id"`
+- 切回官方节点会删除全局配置里的五个显式 Domain，以及兼容读取的旧 Domain 字段
+
+### 独立部署模式
+
+Domain 文件必须是 JSON 对象，只允许以下五个字段，且至少提供一个：
+
+```json
+{
+  "userDomain": "https://user.customer.example.com",
+  "apiDomain": "https://api.customer.example.com",
+  "runtimeDomain": "https://runtime.customer.example.com",
+  "skillDomain": "https://skills.customer.example.com",
+  "kbDomain": "https://kb.customer.example.com"
+}
+```
+
+也可以用 `--user-domain`、`--api-domain`、`--runtime-domain`、`--skill-domain`、`--kb-domain` 逐项传入；显式 flag 覆盖文件里的同名字段。所有值必须是无账号、路径、query 和 fragment 的 HTTPS origin。
+
+进入独立部署模式会删除全局 `region` 和旧 Domain 字段，再写入本次提供的 Domain。未提供的 Domain 仍按默认 `cn` 节点和当前 `env` 回退到 Lovrabet 公共服务；如果企业部署需要五类请求全部进入私有服务，应完整提供五个 Domain。
+
+两种模式都保留 AccessKey、env、format、locale、应用绑定等其他全局配置。当前目录 `.lovrabet.json` 的同名字段仍会覆盖全局配置；初始化后用 `lovrabet doctor` 核对最终生效的 region 和五个 API Endpoint。
+
 ## config list — 查看完整配置
 
 以 JSON 格式输出当前合并后的完整配置。
@@ -54,7 +93,6 @@ lovrabet config set <key> <value>
 | Flag | 类型 | 默认 | 说明 |
 |------|------|------|------|
 | `--global` | boolean | false | 写入全局配置 `~/.lovrabet.json` |
-| `--app <name>` | string | — | 写入指定应用 profile 内 |
 
 **风险等级**：`write`
 
@@ -65,18 +103,17 @@ lovrabet config set <key> <value>
 ```bash
 # 写入当前目录配置（默认；须在含 .lovrabet.json 的目录下执行）
 lovrabet config set env daily
-lovrabet config set riskLevel write
+lovrabet config set format compress
 
 # 写入全局配置（任意目录可用，需用户明确意图）
 lovrabet config set env daily --global
 
-# 写入指定应用配置
-lovrabet config set riskLevel write --app order
-
 # 配置 User AK（client-ak）
 lovrabet config set accessKey <ACCESS_KEY>
 ```
 
+> **安全边界**：`riskLevel` 是 CLI 保护字段，`config set riskLevel ...` 与 `config delete riskLevel` 均会被拒绝，避免 Agent 或脚本静默提高风险权限。只有用户可以直接编辑配置文件修改该字段。
+
 ## config delete — 删除配置项
 
 从 `.lovrabet.json` 中移除一个配置项。

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

@@ -5,9 +5,9 @@
 这意味着：
 - `accessKey` / `env` / `format` / `riskLevel` / `defaultApp` 等仍然放在 `.lovrabet.json`
 - 当前 AK 在平台上可见的应用列表，放在 `~/.lovrabet/cache/.../my-apps.json`
-- 常规使用不需要先创建本地配置文件；登录后可以直接 `app list` 并通过 `--app` / `--appcode` 操作
+- 首次使用推荐执行 `lovrabet config init` 配置全局节点；未执行时仍按默认中国节点 `cn` 工作
 
-兼容旧名：`.lovrabetrc`（优先级 `.lovrabet.json` > `.lovrabetrc`）。
+只自动读取 `.lovrabet.json`；`.lovrabetrc` 和其他 CLI 的配置文件不参与运行态配置发现。需要导入外部配置时，显式执行 `lovrabet app import --file <path>`。
 
 ## 单应用模式
 
@@ -55,7 +55,23 @@
 | `pageSize` | number | — | 默认分页大小 |
 | `riskLevel` | string | `write` | 允许执行的最高风险等级 |
 | `defaultApp` | string | — | 默认候选应用名称 |
-| `inherit` | boolean | true | 当前目录配置是否继承全局配置 |
+| `region` | string | `cn` | 当前开放的官方节点：`cn` / `id`；默认 `cn` 可省略 |
+| `userDomain` | string | 节点内置值 | User 服务 HTTPS origin 覆盖 |
+| `apiDomain` | string | 节点内置值 | 平台 API HTTPS origin 覆盖 |
+| `runtimeDomain` | string | 节点内置值 | 普通 Runtime HTTPS origin 覆盖 |
+| `skillDomain` | string | 节点默认 | SkillHub HTTPS origin 覆盖 |
+| `kbDomain` | string | 节点默认 | 知识库 HTTPS origin 覆盖 |
+
+五个 Domain 各自独立覆盖同名服务地址。没有显式配置的字段按 `region` 和 `env` 使用内置值；`development` 与 `daily` 共用非生产地址。当前开放的官方节点如下：
+
+| region | env | userDomain | apiDomain | runtimeDomain | skillDomain | kbDomain |
+|--------|-----|------------|-----------|---------------|-------------|----------|
+| `cn` | `production` | `https://user.lovrabet.com` | `https://api.lovrabet.com` | `https://runtime.lovrabet.com` | `https://skills.lovrabet.com` | `https://runtime.lovrabet.com` |
+| `cn` | `development` / `daily` | `https://user-daily.lovrabet.com` | `https://daily-api.lovrabet.com` | `https://daily-runtime.lovrabet.com` | `https://skills-daily.lovrabet.com` | `https://daily-runtime.lovrabet.com` |
+| `id` | `production` | `https://user.lovrabet.id` | `https://api.lovrabet.id` | `https://runtime.lovrabet.id` | `https://skills.lovrabet.id` | `https://runtime.lovrabet.id` |
+| `id` | `development` / `daily` | `https://user-daily.lovrabet.id` | `https://daily-api.lovrabet.id` | `https://daily-runtime.lovrabet.id` | `https://skills-daily.lovrabet.id` | `https://daily-runtime.lovrabet.id` |
+
+`config init` 的完整模式切换、独立部署 JSON 和校验规则见 [配置管理](lovrabet-config-commands.md#config-init--初始化连接配置)。
 
 ## 解析优先级
 
@@ -96,12 +112,16 @@ CLI flag (--appcode, --env, --format, --app ...)
 
 | 作用域 | 查找目录 | 文件名优先级 |
 |--------|---------|------------|
-| 当前目录 | `process.cwd()` | `.lovrabet.json` > `.lovrabetrc` |
-| 全局级 | `~` | 同上 |
+| 当前目录 | `process.cwd()` | 仅 `.lovrabet.json` |
+| 全局级 | `~` | 仅 `.lovrabet.json` |
 
 合并策略：
 - 标量字段：当前目录配置覆盖全局级
 - `defaultApp`：当前目录显式声明 > 全局 `defaultApp`
+- `apps`：当前目录显式声明时整体覆盖全局 `apps`；当前目录未声明时使用全局 `apps`
+- `inherit` 不是受支持的配置项；旧字段会被忽略，可用 `lovrabet config delete inherit` 清理
+
+因此，`lovrabet config init` 虽然固定更新全局连接配置，当前目录文件中的 `region` 或 Domain 仍具有更高优先级。初始化后可执行 `lovrabet doctor` 查看最终生效值。
 
 ## 示例
 

package/skills/lovrabet.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "lovrabet",
   "packageName": "@lovrabet/lovrabet-cli",
-  "packageVersion": "2.2.7",
-  "skillVersion": "2.2.7",
+  "packageVersion": "2.3.0-beta.2",
+  "skillVersion": "2.3.0-beta.2",
   "files": [
     "SKILL.md",
     "guides/app-resolution.md",
@@ -37,5 +37,5 @@
     "references/lovrabet-user-account.md",
     "references/lovrabet-workspace.md"
   ],
-  "digest": "9a93317b44b00c6aa73f86b181706a8e430136f20088fe9fa8ddf211560cf785"
+  "digest": "5c22be545ab5d6315e8b966eb4f49e90f0c87e0d05c63de9b57e90fbbdb4fb79"
 }