@lovrabet/rabetbase-cli 2.4.6 → 2.4.7-beta.2

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

@@ -1,6 +1,6 @@
 # bff list
 
-列出当前 App 下的 BFF 脚本。
+列出当前 App 下的 Backend Function 脚本。
 
 ## 命令
 
@@ -24,12 +24,12 @@ rabetbase bff list --name getUserInfo --format json
 ## 多应用过滤
 
 多应用模式下：
-- 不加 `--app` / `--appcode`：遍历所有已配置应用，依次列出各应用的 BFF
-- 加 `--app <name>`：仅列出指定应用的 BFF
+- 不加 `--app` / `--appcode`：遍历所有已配置应用，依次列出各应用的 Backend Function
+- 加 `--app <name>`：仅列出指定应用的 Backend Function
 - 加 `--appcode <code>`：反查到对应 app profile，使用其 cookie/env
 
 ```bash
-# 仅列出 order 应用的 BFF
+# 仅列出 order 应用的 Backend Function
 rabetbase bff list --app order
 
 # 指定 appcode
@@ -40,19 +40,19 @@ rabetbase bff list --appcode app-xxxxxxxx
 
 默认返回精简列表（id, functionName, description, scriptType）。`--verbose` 返回完整对象。
 
-## BFF 脚本类型
+## Backend Function 脚本类型
 
 | 类型 | 用途 | 说明 |
 |------|------|------|
 | ENDPOINT | 独立业务端点，前端通过 `client.bff.execute()` 调用 | 默认类型 |
-| COMMON | 公共函数，供其他 BFF 脚本 import 复用 | 需 `--type COMMON` 查询 |
+| COMMON | 公共函数，供其他 Backend Function 脚本 import 复用 | 需 `--type COMMON` 查询 |
 | HOOK | 挂在标准数据接口前后执行 | 通过数据集详情查看 |
 
 ## 提示
 
-- 写 BFF 前先查公共函数列表（`--type COMMON`），看是否有可复用函数
+- 写 Backend Function 前先查公共函数列表（`--type COMMON`），看是否有可复用函数
 - 复用 COMMON 前用 `bff detail --id <id>` 确认入参、返回值和副作用，不要按函数名猜契约
-- 修改已有 BFF 前必须先用此命令找到脚本 ID
+- 修改已有 Backend Function 前必须先用此命令找到脚本 ID
 
 ## 参考
 

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

@@ -1,6 +1,6 @@
 # bff pull
 
-把远端 BFF 脚本同步到本地 `.rabetbase/bff/<appCode>/...`。
+把远端 Backend Function 脚本同步到本地 `.rabetbase/bff/<appCode>/...`。
 
 ## 命令
 

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

@@ -1,6 +1,6 @@
 # bff push
 
-把本地 BFF 脚本上传到远端。
+把本地 Backend Function 脚本上传到远端。
 
 > **风险等级：write** — 建议先使用 `--dry-run` 预览。
 
@@ -43,8 +43,8 @@ rabetbase bff push --type HOOK --name beforeFilter --format json
 - 写入字段、必填字段、枚举 `options[].value` 来自当前 `dataset detail`
 - `filter()` 结果从 `.tableData` 读取
 - `create()` 返回新记录 ID，不访问 `created.id`
-- BFF 中没有使用前端 SDK 初始化能力，如 `createClient`、`registerModels`
-- 通知型 BFF 只使用已确认的 `configCode` / `audiences` / `message`，没有渠道地址、密钥、旧 MANUAL 参数或 `${...}` 模板表达式
+- Backend Function 中没有使用前端 SDK 初始化能力，如 `createClient`、`registerModels`
+- 通知型 Backend Function 只使用已确认的 `configCode` / `audiences` / `message`，没有渠道地址、密钥、旧 MANUAL 参数或 `${...}` 模板表达式
 
 ## 提示
 

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

@@ -1,6 +1,6 @@
 # bff status
 
-检查本地 BFF 脚本与 `.rabetbase/bff.lock.json` 的同步状态。
+检查本地 Backend Function 脚本与 `.rabetbase/bff.lock.json` 的同步状态。
 
 ## 命令
 

package/skills/rabetbase/references/rabetbase-codegen-sql.md

@@ -15,17 +15,17 @@ rabetbase codegen sql --sqlcode 2305f915-dd48cd4c > ./src/api/getUserList.ts
 | Flag | 类型 | 必填 | 默认 | 说明 |
 |------|------|------|------|------|
 | `--sqlcode <code>` | string | 是 | — | SQL code 标识符（格式：`xxxxxxxx-xxxxxxxx`） |
-| `--target <target>` | string | 否 | `sdk` | 生成目标：`sdk`（SDK 调用） / `bff`（BFF 脚本内调用） |
+| `--target <target>` | string | 否 | `sdk` | 生成目标：`sdk`（SDK 调用） / `bff`（Backend Function 脚本内调用） |
 | `--no-imports` | boolean | 否 | — | 不包含 import 语句 |
 | `--format <fmt>` | string | 否 | `pretty` | 输出格式 |
 
 ## 输出
 
-生成的 TypeScript 代码直接打印到 stdout。`--target sdk` 生成前端 SDK 调用代码，`--target bff` 生成 BFF 脚本内调用代码。
+生成的 TypeScript 代码直接打印到 stdout。`--target sdk` 生成前端 SDK 调用代码，`--target bff` 生成 Backend Function 脚本内调用代码。
 
 ## 提示
 
-- `--target bff` 生成的代码使用 `context.client.sql.execute()`，注意 BFF 中 SQL 返回直接是数组
+- `--target bff` 生成的代码使用 `context.client.sql.execute()`，注意 Backend Function 中 SQL 返回直接是数组
 - `--target sdk` 生成的代码使用 `client.sql.execute()`，返回 `{ execSuccess, execResult }`
 
 ## 参考

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

@@ -96,7 +96,7 @@ rabetbase dataset detail --code <数据集编码> --format json --jq '.data.oper
 
 ## 提示
 
-- 写 SQL / BFF 前先调用此命令确认真实字段名、类型与枚举；关联关系统一看 **`dataset relations`**
+- 写 SQL / Backend Function 前先调用此命令确认真实字段名、类型与枚举；关联关系统一看 **`dataset relations`**
 - `--alias` 需要先执行 `rabetbase api pull` 生成 `api.ts`
 - 横切数据访问流程、外键与性能：见 [`guides/data-api-guidelines.md`](../guides/data-api-guidelines.md)
 

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

@@ -1,8 +1,8 @@
 # rabetbase kb
 
-管理开发者侧当前解析应用下的 `company` 知识库。所有命令都通过标准工作区、`--app <name>` 或 `--appcode <code>` 解析目标应用，并在读写前后精确校验 `scope=company`、appCode 和 ID。
+管理开发者侧当前解析应用下的 `company` 知识库，并检索当前应用可访问的公司与公共知识。所有命令都通过标准工作区、`--app <name>` 或 `--appcode <code>` 解析目标应用。
 
-> 边界：`lovrabet kb` 使用运行态 AK/当前应用/当前用户，面向个人知识库和可见知识搜索；`rabetbase kb` 使用开发者登录态，面向公司知识库管理。不要用其中一个替代另一个。
+> 边界：`lovrabet kb` 使用运行态 AK/当前应用/当前用户，面向个人知识库和可见知识搜索；`rabetbase kb` 使用开发者登录态，面向公司知识库管理以及公司/公共知识检索。不要用其中一个替代另一个。
 
 ## 命令
 
@@ -10,6 +10,8 @@
 rabetbase kb list --format compress
 rabetbase kb list --appcode app-xxxxx --title "业务规则" --format compress
 rabetbase kb detail --id 60 --format compress
+rabetbase kb search --query "怎么查订单？" --format compress
+rabetbase kb search --query "体育特长生的录取条件是什么？" --topk 5 --format compress
 rabetbase kb create --title "业务规则" --file ./knowledge.md --dry-run
 rabetbase kb create --title "业务规则" --file ./knowledge.md
 rabetbase kb update --id 60 --file ./knowledge.md --expected-version 2 --dry-run
@@ -23,7 +25,7 @@ rabetbase kb delete --id 60 --yes
 - `create --file` 必填，`update --file` 可选；输入必须是可读的普通 UTF-8 文本或 Markdown 文件。
 - CLI 保留解码后的文本，不解析 JSON、不重排段落，也不把路径映射转换成其他格式。
 - 空白文件、目录、无效 UTF-8、缺失或不可读文件都会在网络请求前拒绝。
-- 结构化输出不包含正文，只展示 `contentByteSize`、`contentHash`、`snapshotHash` 等安全元数据。
+- 管理命令的结构化输出不包含知识库全文，只展示 `contentByteSize`、`contentHash`、`snapshotHash` 等安全元数据；`search` 会按检索用途返回命中的正文片段。
 
 ## list / detail
 
@@ -31,6 +33,14 @@ rabetbase kb delete --id 60 --yes
 - `detail` 使用正安全整数 ID 精确读取，并验证返回 ID、scope 和 appCode。
 - 服务端 Long 字段即使序列化为十进制字符串，CLI 也只接受能安全转换的整数；超出 JavaScript 安全整数范围时失败关闭。
 
+## search
+
+- 调用 `POST /smartapi/knowledge/company-public/search`，请求仅包含 `query`、解析后的 `appCode` 和可选 `topK`。
+- 不传 `userId`，不查询个人知识库；命中 `scope` 只可能为 `COMPANY` 或 `PUBLIC`。
+- `--query` 必填且不能是纯空白；`--topk` 可选，必须是正整数。不传时沿用服务端缺省规则。
+- 输出 `total` 与 `hits`，命中字段为 `scope/title/docId/score/weightedScore/content/jsonPath/jsonData`；无命中时返回空数组。
+- 同时判断 HTTP 状态和平台业务结果；未登录、无权限、参数错误、检索异常或响应字段漂移都会以结构化错误失败。
+
 ## create
 
 - `create/update` 为 `write`，正式执行不要求 `--yes`；仍应先审阅 dry-run。

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

@@ -1,6 +1,6 @@
 # rabetbase notification config-list
 
-只读查询当前应用的应用级通知渠道配置，主要用于获取 BFF 消息通知扩展需要的应用级 `configCode`。
+只读查询当前应用的应用级通知渠道配置，主要用于获取 Backend Function 消息通知扩展需要的应用级 `configCode`。
 
 ## 命令
 
@@ -54,7 +54,7 @@ CLI 只输出用于选择配置的安全字段，不输出：
 
 若服务端返回的任一记录缺少非空的 `configCode`、`configName` 或 `channelType`，CLI 会返回 `api_error`，不会用空字符串伪造可用配置，也不会输出可能不完整的成功列表。
 
-## BFF 使用
+## Backend Function 使用
 
 先根据 `configName` 和 `description` 选择目标配置，再把同一项的 `configCode` 传给：
 
@@ -76,5 +76,5 @@ await context.client.extension.execute("notification", "send", {
 
 ## 参考
 
-* [BFF 创建工作流](../guides/bff-creation-workflow.md)
+* [Backend Function 创建工作流](../guides/bff-creation-workflow.md)
 * [Backend Function 消息通知扩展](../guides/backend-function.md#消息通知扩展)

package/skills/rabetbase.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "rabetbase",
   "packageName": "@lovrabet/rabetbase-cli",
-  "packageVersion": "2.4.6",
-  "skillVersion": "2.4.6",
+  "packageVersion": "2.4.7-beta.2",
+  "skillVersion": "2.4.7-beta.2",
   "files": [
     "SKILL.md",
     "guides/backend-function.md",
@@ -131,5 +131,5 @@
     "references/rabetbase-user-account.md",
     "references/rabetbase-workspace.md"
   ],
-  "digest": "cda9976607a5ec8b8ab704654bb3a37807aefee9bcdee2092571b5b44b057c7b"
+  "digest": "91bcc2cef3e9a2edb89cc0216a5c5e15757c30699d13312778d4bf7dd8d96805"
 }

package/templates/rules/lovrabet_rules.mdc.tpl

@@ -71,7 +71,7 @@ if (result.execSuccess && result.execResult) {
 - HTTP 错误：抛出 `LovrabetError` 异常
 - 应用层职责：检查 `execSuccess` 状态，处理业务结果
 
-#### BFF API - Backend Functions
+#### Backend Function API
 
 ```typescript
 const dashboard = await client.bff.execute({
@@ -102,7 +102,7 @@ try {
   // Use result directly (it's already the business data)
 } catch (error) {
   if (error instanceof LovrabetError) {
-    console.error('BFF call failed:', error.message);
+    console.error('Backend Function call failed:', error.message);
   }
 }
 ```
@@ -118,7 +118,7 @@ try {
 - `orderBy: 'createTime desc'` → Use `orderBy: [{ createTime: 'desc' }]`
 - `where: { name: 'LIKE %keyword%' }` → Use `where: { name: { $contain: 'keyword' } }`
 - SQL: Wrong format → Use `client.sql.execute({ sqlCode, params })`
-- BFF: Wrong format → Use `client.bff.execute({ scriptName, params })`
+- Backend Function: Wrong format → Use `client.bff.execute({ scriptName, params })`
 - Filter: `getList()` → Use `filter()` (getList is deprecated)
 
 ### 2. MCP SQL Workflow (STRICT ORDER)
@@ -343,7 +343,7 @@ try {
   }
 }
 
-// ✅ 正确：BFF API - 直接使用返回的业务数据
+// ✅ 正确：Backend Function API - 直接使用返回的业务数据
 try {
   const dashboard = await client.bff.execute({
     scriptName: 'getUserDashboard',
@@ -775,7 +775,7 @@ import {
 
 **注意**：
 - 所有方法返回的都是 `data`（业务数据层），不是完整的响应对象
-- SQL 和 BFF 的返回值需要应用层检查业务状态（如 `execSuccess`）
+- SQL 和 Backend Function 的返回值需要应用层检查业务状态（如 `execSuccess`）
 
 ### 记住
 
@@ -805,7 +805,7 @@ import {
 - **使用方式**：`client.sql.execute({ sqlCode, params })` - 对象参数格式
 - **返回值检查**：应用层必须检查 `execSuccess` 状态
 
-#### BFF API
+#### Backend Function API
 - **使用方式**：`client.bff.execute({ scriptName, params })` - 直接客户端访问
 - **返回值**：直接是业务数据对象，无需检查 `execSuccess`
 
@@ -869,7 +869,7 @@ import {
 ### v2.1.0 (2025-01-24)
 - ✨ **完善 SDK 返回值行为说明** - 明确 SDK 返回 `data`（业务数据层），应用层负责检查业务状态
 - ✨ **补充 SQL API 详细说明** - 明确返回值结构和应用层职责，添加类型安全示例
-- ✨ **补充 BFF API 详细说明** - 添加完整的使用示例和错误处理
+- ✨ **补充 Backend Function API 详细说明** - 添加完整的使用示例和错误处理
 - ✨ **补充 Filter API 逻辑操作符** - 添加 `$and`、`$or` 嵌套组合示例
 - ✨ **新增 API 集成指南** - 添加 `lovrabet api pull` 使用说明
 - 📝 更新"快速参考"和"记住"部分，明确 SDK 返回值结构和使用方式

package/templates/skill/SKILL.md.tpl

@@ -1,6 +1,6 @@
 ---
 name: lovrabet
-description: 当用户请求涉及 Lovrabet/云兔/yuntoo 平台的数据集查询、SQL 创建、BFF 开发时使用。触发词：数据集、数据表、自定义 SQL、filter、sql.execute、bff.execute、get_dataset_detail、validate_sql_content、save_or_update_custom_sql、save_or_update_bff_script、@lovrabet/sdk、MCP SQL 工作流、多表关联、lovrabet 开发。
+description: 当用户请求涉及 Lovrabet/云兔/yuntoo 平台的数据集查询、SQL 创建、Backend Function 开发时使用。触发词：数据集、数据表、自定义 SQL、filter、sql.execute、bff.execute、get_dataset_detail、validate_sql_content、save_or_update_custom_sql、save_or_update_bff_script、@lovrabet/sdk、MCP SQL 工作流、多表关联、lovrabet 开发。
 ---
 
 # Lovrabet 开发工作流（路由指南）
@@ -15,8 +15,8 @@ Lovrabet 中文名为**云兔**，也常写作 **yuntoo**。本文档是**路由
 |---------|--------------|
 | 创建 / 修改 / 保存 SQL | `.lovrabet/skill/guides/02-mcp-sql-workflow.md` |
 | 涉及 SQL 本地落盘、目录规范 | `.lovrabet/skill/guides/07-sql-creation-workflow.md` |
-| 创建 / 修改 / 保存 BFF 脚本 | `.lovrabet/skill/guides/08-bff-creation-workflow.md` |
-| 涉及 BFF 本地落盘、目录规范 | `.lovrabet/skill/guides/05-backend-function.md` |
+| 创建 / 修改 / 保存 Backend Function 脚本 | `.lovrabet/skill/guides/08-bff-creation-workflow.md` |
+| 涉及 Backend Function 本地落盘、目录规范 | `.lovrabet/skill/guides/05-backend-function.md` |
 | 遇到冲突提示 / blocked / confirmationRequired | `.lovrabet/skill/guides/09-conflict-detection.md` |
 | 使用 TypeScript SDK / filter / sql.execute | `.lovrabet/skill/guides/01-typescript-sdk.md` |
 | 数据接口设计、多表关联、性能优化 | `.lovrabet/skill/guides/06-data-api-guidelines.md` |
@@ -49,8 +49,8 @@ Lovrabet 中文名为**云兔**，也常写作 **yuntoo**。本文档是**路由
 | 获取数据集详情 | `get_dataset_detail` |
 | 执行已保存的 SQL | `execute_custom_sql` |
 | 列出 SQL 查询 | `list_sql_queries` |
-| 列出 BFF 脚本 | `list_bff_scripts` |
-| 获取 BFF 详情 | `get_bff_script_info` |
+| 列出 Backend Function 脚本 | `list_bff_scripts` |
+| 获取 Backend Function 详情 | `get_bff_script_info` |
 | 生成 SDK 代码 | `generate_sdk_code` |
 | 生成 SQL 代码 | `generate_sql_code` |
 
@@ -62,11 +62,11 @@ Lovrabet 中文名为**云兔**，也常写作 **yuntoo**。本文档是**路由
 |------|----------------|------|
 | 验证 SQL 语法 | `validate_sql_content` | 静态语法 + 可选 schema 验证 |
 | 保存 SQL | `save_or_update_custom_sql` | 通过 toolbox，自动冲突检测 |
-| 保存 BFF | `save_or_update_bff_script` | 通过 toolbox，自动冲突检测 |
+| 保存 Backend Function | `save_or_update_bff_script` | 通过 toolbox，自动冲突检测 |
 
 **冲突处理**：保存工具返回 `blocked: true`（例如他人为最后提交者）时，告知用户在平台上手动处理，**不要**自动重试同一保存。`confirmationRequired` / `nextAction` 等字段以工具返回为准；细节见 `09-conflict-detection.md`。
 
-**BFF 写入类 MCP**：若看不到 `list_bff_scripts` / `save_or_update_bff_script`，请在数据集 MCP 的启动参数中加入 `--enable-bff-save`，旧名 `--dangerously-bff-save` 仍可用；详见 `11-bff-sync-workflow.md`。
+**Backend Function 写入类 MCP**：若看不到 `list_bff_scripts` / `save_or_update_bff_script`，请在数据集 MCP 的启动参数中加入 `--enable-bff-save`，旧名 `--dangerously-bff-save` 仍可用；详见 `11-bff-sync-workflow.md`。
 
 ## 快速决策树
 
@@ -84,9 +84,9 @@ Lovrabet 中文名为**云兔**，也常写作 **yuntoo**。本文档是**路由
     │   ├─ 4. 用 MCP: save_or_update_custom_sql（保存，含冲突检测）
     │   └─ 5. 用 MCP: execute_custom_sql（测试）
     │
-    ├─ 创建/修改 BFF？
+    ├─ 创建/修改 Backend Function？
     │   ├─ 0. 读取 .lovrabet/skill/guides/08-bff-creation-workflow.md（必须）
-    │   ├─ 1. 生成 BFF 代码
+    │   ├─ 1. 生成 Backend Function 代码
     │   └─ 2. 用 MCP: save_or_update_bff_script（保存，含冲突检测）
     │
     ├─ 生成 SDK 代码？
@@ -106,11 +106,11 @@ Lovrabet 中文名为**云兔**，也常写作 **yuntoo**。本文档是**路由
 | 创建自定义 SQL（MCP 模式） | `.lovrabet/skill/guides/02-mcp-sql-workflow.md` |
 | React 前端开发 | `.lovrabet/skill/guides/03-frontend-development.md` |
 | 故障排查 | `.lovrabet/skill/guides/04-troubleshooting.md` |
-| 创建 BFF 脚本 | `.lovrabet/skill/guides/05-backend-function.md` |
+| 创建 Backend Function 脚本 | `.lovrabet/skill/guides/05-backend-function.md` |
 | 数据接口规范 | `.lovrabet/skill/guides/06-data-api-guidelines.md` |
 | SQL 创建工作流 | `.lovrabet/skill/guides/07-sql-creation-workflow.md` |
-| BFF 创建工作流 | `.lovrabet/skill/guides/08-bff-creation-workflow.md` |
-| BFF 同步与协作（平台脚本列表、保存） | `.lovrabet/skill/guides/11-bff-sync-workflow.md` |
+| Backend Function 创建工作流 | `.lovrabet/skill/guides/08-bff-creation-workflow.md` |
+| Backend Function 同步与协作（平台脚本列表、保存） | `.lovrabet/skill/guides/11-bff-sync-workflow.md` |
 | 冲突检测和处理 | `.lovrabet/skill/guides/09-conflict-detection.md` |
 | 团队协作最佳实践 | `.lovrabet/skill/guides/10-best-practices.md` |