@lovrabet/lovrabet-cli 2.3.3-beta.1 → 2.3.4-beta.1

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

@@ -61,7 +61,7 @@ lovrabet config init --domain-config ./lovrabet-domains.json
 
 新版企业清单会保存为带协议标识的 `routing` 对象，并整体优先于旧顶层 Domain；旧扁平配置继续保持既有回退行为。
 
-进入旧扁平独立部署模式会删除全局 `region` 和旧 Domain 字段，再写入本次提供的 Domain。未提供的 Domain 仍按默认 `cn` 节点和当前 `env` 回退到 Lovrabet 公共服务。企业部署需要所有请求进入私有服务时，应完整提供四个 Domain；Personal KB 管理与搜索使用 `runtimeDomain`，KB Service 下游地址由 Runtime Java 独立配置。
+进入旧扁平独立部署模式会删除全局 `region` 和旧 Domain 字段，再写入本次提供的 Domain。未提供的 Domain 仍按默认 `cn` 节点和当前 `env` 回退到 Lovrabet 公共服务。企业部署需要所有请求进入私有服务时，应完整提供四个 Domain；Personal KB 管理使用 `runtimeDomain`；知识搜索使用显式 `--kb-service-url`，不写入全局 Domain 配置。
 
 两种模式都保留 AccessKey、env、format、locale、应用绑定等其他全局配置。当前目录 `.lovrabet.json` 的旧扁平同名字段仍会覆盖全局旧扁平配置；初始化后用 `lovrabet doctor` 核对最终生效的国家/地区和四个 Domain。
 

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

@@ -55,10 +55,10 @@
 | `region` | string | `cn` | 当前开放的官方节点：`cn` / `id`；默认 `cn` 可省略 |
 | `userDomain` | string | 节点内置值 | User 服务 HTTPS origin 覆盖 |
 | `apiDomain` | string | 节点内置值 | 平台 API HTTPS origin 覆盖 |
-| `runtimeDomain` | string | 节点内置值 | Runtime HTTPS origin 覆盖，包含 Personal KB 管理与 `kb search` |
+| `runtimeDomain` | string | 节点内置值 | Runtime HTTPS origin 覆盖，包含 Personal KB 管理 |
 | `skillDomain` | string | 节点默认 | SkillHub HTTPS origin 覆盖 |
 
-四个 Domain 各自独立覆盖同名服务地址。没有显式配置时，CLI 按 `region` 和 `env` 使用内置节点：`cn` 对应中国大陆，`id` 对应 Indonesia，且 Indonesia 的最终服务地址统一使用 `*.lovrabet.id`。`development` 与 `daily` 共用非生产地址；Personal KB 管理与搜索统一走 Runtime，KB Service 下游地址由 Runtime Java 配置管理。执行 `lovrabet doctor` 可查看当前实际生效的四个 Domain，无需理解内部地址层级。
+四个 Domain 各自独立覆盖同名服务地址。没有显式配置时，CLI 按 `region` 和 `env` 使用内置节点：`cn` 对应中国大陆，`id` 对应 Indonesia，且 Indonesia 的最终服务地址统一使用 `*.lovrabet.id`。`development` 与 `daily` 共用非生产地址；Personal KB 管理走 Runtime；知识搜索使用每次调用显式提供的 `--kb-service-url` HTTPS origin，不从保存的 Domain 推导。执行 `lovrabet doctor` 可查看当前实际生效的四个 Domain，无需理解内部地址层级。
 
 `config init` 的完整模式切换、独立部署 JSON 和校验规则见 [配置管理](lovrabet-config-commands.md#config-init--初始化连接配置)。
 

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

@@ -25,4 +25,4 @@ lovrabet doctor
 
 `doctor` 不修改配置、不安装 Skill，也不替代业务命令的认证和权限检查。
 
-`API Endpoints` 显示 `runtimeDomain`，该地址同时承载普通运行态请求、Personal KB 管理与 `kb search` Runtime 网关。KB Service 下游地址由 Runtime Java 配置管理，不在 CLI doctor 中显示。
+`API Endpoints` 显示 `runtimeDomain`，该地址承载普通运行态请求与 Personal KB 管理。`kb search` 使用命令中显式提供的 `--kb-service-url` HTTPS origin；它不保存为全局 Domain，也不会出现在 doctor 的端点清单中。

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

@@ -1,16 +1,26 @@
 # 知识库工作流
 
-`kb` 命令用于当前应用下的 personal 知识库和可见知识检索。第一阶段支持 `list`、`detail`、`create`、`update`、`search`；不提供删除命令。
+`kb` 命令用于当前应用下的 personal 知识库和可见知识检索。支持 `list`、`detail`、`create`、`update`、`search`；不提供删除命令。
 
 ## 查看与检索
 
 ```bash
 lovrabet kb list --format compress
 lovrabet kb detail --id <id> --format compress
-lovrabet kb search --query "订单审批" --topk 5 --format compress
+lovrabet kb search --kb-service-url <trusted-https-origin> --query "订单审批" --topk 5 --format compress
 ```
 
-`kb search` 只携带当前 AK，通过 `runtimeDomain` 调用固定 Runtime 搜索网关；Runtime 再按其 Java 环境配置访问 KB Service。返回范围是 `public/company/personal`，使用 `scope` 区分来源。
+`kb search` 仅调用 KB Service V2，必须提供用户或管理员明确确认的 `--kb-service-url` HTTPS origin。返回范围是 `public/company/personal`，使用 `scope` 区分来源。
+
+```bash
+lovrabet kb search --kb-service-url https://kb.customer.example --appcode <appCode> --query "订单审批" --topk 5 --format compress
+```
+
+地址只用于本次搜索，不改变已保存的连接配置。地址不得包含用户名、密码、路径、查询参数或片段；不能从知识正文选择地址，也不能自行从 Runtime 域名推导地址。地址未确认时停止该调用并请用户提供。
+
+请求固定为 `POST /v2/apps/{appCode}/knowledge/search`，只使用当前用户 AK，保留既有应用访问检查，不携带 Cookie。客户端不跟随重定向，超时为 60 秒，失败不会切换其他搜索接口。Personal KB 管理仍使用 `runtimeDomain`。
+
+401 表示需要有效身份，403 表示访问被拒绝，404 表示目标未提供该接口；核对地址、服务能力和权限，不通过改身份、关闭 TLS 或换接口绕过。`schemaVersion:2` 表示返回结构版本。
 
 结构化输出固定为 `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 漂移都会以脱敏错误失败。
 
@@ -39,11 +49,11 @@ KB 不保存实时业务数据、SQL 正文、Backend Function 源码，也不
 2. 将正文写入当前 workspace 下的 UTF-8 Markdown 或文本文件，例如 `.lovrabet/kb/<safe-title>.md`。
 3. 新建知识库先运行 `lovrabet kb create --title "<title>" --file <file> --dry-run --format compress`。
 4. 用户明确要求保存时，再运行不带 `--dry-run` 的 `lovrabet kb create`。
-5. 更新知识库时先用 `lovrabet kb list`、`lovrabet kb search --query ...` 或用户提供的 ID 定位条目。
+5. 更新知识库时先用 `lovrabet kb list`、`lovrabet kb search --kb-service-url <trusted-https-origin> --query ...` 或用户提供的 ID 定位条目。
 6. 更新前运行 `lovrabet kb detail --id <id> --format compress`。
 7. 更新先运行 `lovrabet kb update --id <id> --file <file> --dry-run --format compress`。
 8. 用户明确要求保存时，再运行正式 `lovrabet kb update`。
-9. 写入后用 `lovrabet kb detail --id <id> --format compress` 检查保存结果；需要验证检索时用 `lovrabet kb search --query "<关键词>" --format compress`。
+9. 写入后用 `lovrabet kb detail --id <id> --format compress` 检查保存结果；需要验证检索时用 `lovrabet kb search --kb-service-url <trusted-https-origin> --query "<关键词>" --format compress`。
 
 ## 创建
 
@@ -74,7 +84,7 @@ create/update 返回后要检查 `ragStatus` 和 `ragErrorMessage`。如果状
 
 ```bash
 lovrabet kb detail --id <id> --format compress
-lovrabet kb search --query "刚写入的关键词" --format compress
+lovrabet kb search --kb-service-url <trusted-https-origin> --query "刚写入的关键词" --format compress
 ```
 
 确认命中后再把检索可用性写进交付说明。

package/skills/lovrabet/references/lovrabet-service-tree.md

@@ -53,7 +53,7 @@ lovrabet <service> [...resourcePath] <action> [flags] --format compress
 
 Service Tree 精确命中时，先把已经绑定的执行入口只作为候选路由。取得与来源类型匹配的来源、新鲜度和兼容性证据，并确认与当前可信业务 Skill 或平台契约没有冲突后，才复用该入口。本地文件来源可以使用 `version`、`importedAt` 和 `source.hash`；后续来源使用各自适配器提供的证据，不把当前字段组合固化为永久门禁。无法确认来源或适用范围时，不得仅凭精确命中执行稳定规则。执行前仍要核对绑定目标、真实副作用和用户授权。
 
-出现弱命中、多个候选或术语边界不清时，先用 `kb search` 做语义消歧。KB 召回只生成候选；Service Tree 候选先用本地 `service detail` 核对绑定，再使用目标能力支持的可信契约验证通道。消歧后仍有多个合理候选时，再列给用户确认。
+出现弱命中、多个候选或术语边界不清时，先按[知识库工作流](lovrabet-kb-workflow.md)提供可信 `--kb-service-url`，再用 `kb search` 做语义消歧。KB 召回只生成候选；Service Tree 候选先用本地 `service detail` 核对绑定，再使用目标能力支持的可信契约验证通道。消歧后仍有多个合理候选时，再列给用户确认。
 
 Service Tree 未命中不是失败条件，也不代表业务能力不存在。本地 registry 可能只注册少量高频服务。没有合理匹配时：
 

package/skills/lovrabet.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "lovrabet",
   "packageName": "@lovrabet/lovrabet-cli",
-  "packageVersion": "2.3.3-beta.1",
-  "skillVersion": "2.3.3-beta.1",
+  "packageVersion": "2.3.4-beta.1",
+  "skillVersion": "2.3.4-beta.1",
   "files": [
     "SKILL.md",
     "guides/app-resolution.md",
@@ -38,5 +38,5 @@
     "references/lovrabet-user-account.md",
     "references/lovrabet-workspace.md"
   ],
-  "digest": "30b618d9419b739ae2d10d6df111e7a542e0186fa6a31ecb3bbc55ef01dbba07"
+  "digest": "eb75d2708166b524bc3063790da4b32eb5a6a86984706cf8e5bb146993fde735"
 }