@lovrabet/lovrabet-cli 2.3.0 → 2.3.1-beta.1

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

@@ -21,11 +21,11 @@ lovrabet config init --domain-config ./lovrabet-domains.json
 
 - `--region` 只接受 `cn` / `id`
 - 选择 `cn` 时省略冗余的 `region` 字段，以默认值保持向前兼容；选择 `id` 时写入 `"region": "id"`
-- 切回官方节点会删除全局配置里的五个显式 Domain，以及兼容读取的旧 Domain 字段
+- 切回官方节点会删除全局配置里的六个显式 Domain，以及兼容读取的旧 Domain 字段
 
 ### 独立部署模式
 
-Domain 文件必须是 JSON 对象，只允许以下五个字段，且至少提供一个：
+Domain 文件必须是 JSON 对象，只允许以下六个字段，且至少提供一个：
 
 ```json
 {
@@ -33,15 +33,16 @@ Domain 文件必须是 JSON 对象，只允许以下五个字段，且至少提
   "apiDomain": "https://api.customer.example.com",
   "runtimeDomain": "https://runtime.customer.example.com",
   "skillDomain": "https://skills.customer.example.com",
-  "kbDomain": "https://kb.customer.example.com"
+  "kbDomain": "https://kb.customer.example.com",
+  "kbSearchDomain": "https://kb-search.customer.example.com"
 }
 ```
 
-也可以用 `--user-domain`、`--api-domain`、`--runtime-domain`、`--skill-domain`、`--kb-domain` 逐项传入；显式 flag 覆盖文件里的同名字段。所有值必须是无账号、路径、query 和 fragment 的 HTTPS origin。
+也可以用 `--user-domain`、`--api-domain`、`--runtime-domain`、`--skill-domain`、`--kb-domain`、`--kb-search-domain` 逐项传入；显式 flag 覆盖文件里的同名字段。所有值必须是无账号、路径、query 和 fragment 的 HTTPS origin。
 
-进入独立部署模式会删除全局 `region` 和旧 Domain 字段，再写入本次提供的 Domain。未提供的 Domain 仍按默认 `cn` 节点和当前 `env` 回退到 Lovrabet 公共服务；如果企业部署需要五类请求全部进入私有服务，应完整提供五个 Domain。
+进入独立部署模式会删除全局 `region` 和旧 Domain 字段，再写入本次提供的 Domain。未提供的普通 Domain 仍按默认 `cn` 节点和当前 `env` 回退到 Lovrabet 公共服务；`kbSearchDomain` 在中国大陆使用登记地址，其他区域没有默认搜索地址。企业部署需要所有请求进入私有服务时，应完整提供六个 Domain。
 
-两种模式都保留 AccessKey、env、format、locale、应用绑定等其他全局配置。当前目录 `.lovrabet.json` 的同名字段仍会覆盖全局配置；初始化后用 `lovrabet doctor` 核对最终生效的 region 和五个 API Endpoint。
+两种模式都保留 AccessKey、env、format、locale、应用绑定等其他全局配置。当前目录 `.lovrabet.json` 的同名字段仍会覆盖全局配置；初始化后用 `lovrabet doctor` 核对最终生效的 region 和 API Endpoint。
 
 ## config list — 查看完整配置
 

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

@@ -60,16 +60,17 @@
 | `apiDomain` | string | 节点内置值 | 平台 API HTTPS origin 覆盖 |
 | `runtimeDomain` | string | 节点内置值 | 普通 Runtime HTTPS origin 覆盖 |
 | `skillDomain` | string | 节点默认 | SkillHub HTTPS origin 覆盖 |
-| `kbDomain` | string | 节点默认 | 知识库 HTTPS origin 覆盖 |
+| `kbDomain` | string | 节点默认 | Personal KB 管理 HTTPS origin 覆盖 |
+| `kbSearchDomain` | string | CN 已登记 KB Service；其他区域无默认值 | `kb search` 专用 HTTPS origin；与管理域独立，未登记区域不回退 |
 
-五个 Domain 各自独立覆盖同名服务地址。没有显式配置的字段按 `region` 和 `env` 使用内置值；`development` 与 `daily` 共用非生产地址。当前开放的官方节点如下：
+六个 Domain 各自独立覆盖同名服务地址。没有显式配置的普通字段按 `region` 和 `env` 使用内置值；`development` 与 `daily` 共用非生产地址。`kbSearchDomain` 只有中国大陆内置地址，其他区域失败关闭。当前开放的官方节点如下：
 
-| 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` |
+| region | env | userDomain | apiDomain | runtimeDomain | skillDomain | kbDomain | kbSearchDomain |
+|--------|-----|------------|-----------|---------------|-------------|----------|----------------|
+| `cn` | `production` | `https://user.lovrabet.com` | `https://api.lovrabet.com` | `https://runtime.lovrabet.com` | `https://skills.lovrabet.com` | `https://runtime.lovrabet.com` | `https://kb-service.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` | `https://kb-service-daily.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--初始化连接配置)。
 

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

@@ -24,3 +24,5 @@ lovrabet doctor
 ```
 
 `doctor` 不修改配置、不安装 Skill，也不替代业务命令的认证和权限检查。
+
+`API Endpoints` 同时显示 `kbDomain`（Personal KB 管理）与独立的 `kbSearchDomain`。当前 region 没有登记原生搜索地址且未显式配置时，后者显示 `not registered`。

package/skills/lovrabet/references/lovrabet-kb-workflow.md

@@ -10,7 +10,9 @@ lovrabet kb detail --id <id> --format compress
 lovrabet kb search --query "订单审批" --topk 5 --format compress
 ```
 
-`kb search` 会返回当前用户可见的多来源知识，使用 `scope` 区分来源。结果顺序由服务端当前检索策略决定；CLI 保留服务端返回顺序，不在本地重新排序，也不根据 `scope` 推断固定来源优先级。
+`kb search` 只携带当前 AK，使用独立 `kbSearchDomain` 调用固定 Runtime 搜索接口。中国大陆 daily/production 使用已登记 KB Service；其他区域未显式配置搜索域时失败关闭，不回退到 `kbDomain` 或其他服务。返回范围是 `public/company/personal`，使用 `scope` 区分来源。
+
+结构化输出固定为 `data: { schemaVersion:2, profile:"runtime", total, strategyFingerprint, timingsMs, hits }`。`--topk` 可选且必须是 1–50 的整数；命中完整保留 `documentId/revision/chunkId/scope/title/text/tags/rank/rawScore/finalScore/scoreKind` 的服务端顺序和值，不输出 legacy 别名。无命中是 `total:0/hits:[]` 的成功；字段、rank、score、timing、`no-store` 或 scope 漂移都会以脱敏错误失败。
 
 ## 业务执行中的 KB 消费
 

package/skills/lovrabet/references/lovrabet-personal-bff-workflow.md

@@ -134,3 +134,35 @@ lovrabet personal-bff exec --id <id> --params '{"status":"active"}' --format com
 ```
 
 确认字段、空态和错误形状后，再按下游调用方的契约完成接入。
+
+### 前端 SDK 调用
+
+页面通过 `client.personal.bff.execute({ scriptId, params })` 调用已经确认的 Personal Backend Function。`scriptId` 必须是 `list`、`detail`、`create` 或前序可信上下文得到的正整数，并且属于当前用户和当前应用；不要猜测 ID。
+
+```typescript
+interface OrderSummary {
+  total: number;
+}
+
+const personalBff = lovrabetClient?.personal?.bff;
+if (typeof personalBff?.execute !== "function") {
+  throw new Error("client.personal.bff.execute is not available");
+}
+
+const summary = await personalBff.execute<OrderSummary>({
+  scriptId: 123,
+  params: { status: "active" },
+});
+
+if (!summary || typeof summary.total !== "number") {
+  throw new Error("Unexpected Personal Backend Function response");
+}
+```
+
+安全边界：
+
+- 浏览器使用当前登录 Cookie，不在前端源码、构建变量、页面配置或日志中保存 Cookie、Client AK、SecretKey 或 token。
+- 服务端使用 Client AK 时，凭据只保存在服务端，并显式设置 `authMode: "client-ak"`；Personal Backend Function 不支持 OpenAPI。
+- 可选链只用于读取能力。禁止使用 `lovrabetClient?.personal?.bff?.execute?.(...)`，因为方法缺失时会静默得到 `undefined`。
+- 能力不存在时明确失败，并升级到包含 `client.personal.bff.execute` 的 SDK 版本。检测通过后通过 `personalBff.execute(...)` 调用，不要提取方法后裸调用。
+- SDK 直接返回个人函数的业务结果，不带 `execSuccess` 或 `execResult`。按前序 CLI 验证得到的返回契约检查必需字段和空态，不用 `result === undefined` 猜测 SDK 能力是否存在。

package/skills/lovrabet.manifest.json

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