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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovrabet/lovrabet-cli",
-  "version": "2.3.2",
+  "version": "2.3.3-beta.1",
   "description": "Runtime CLI for Lovrabet apps, datasets, SQL, Backend Function, skills, and AI agent workflows.",
   "license": "Apache-2.0",
   "keywords": [

package/skills/lovrabet/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: lovrabet
 displayName: Lovrabet 运行态 CLI
-version: 2.3.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。"
+version: 2.3.3-beta.1
+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、approval、审批、待办、approve、reject、transfer、schedule、定时任务、cron、kb、skill、sql exec、bff exec、app-config、accessKey、compress、jq。"
 metadata:
   requires:
     bins: ["lovrabet"]
@@ -28,6 +28,7 @@ metadata:
   - [数据集与数据流程](guides/dataset-and-data-workflow.md)
   - [Custom SQL 与 Backend Function 流程](guides/sql-and-bff-workflow.md)
   - [排障](guides/troubleshooting.md)
+  - [审批流运行态办理](references/lovrabet-approval-workflow.md)
 - 命令细节 / 参数参考：
   - `references/*.md`
 

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

@@ -0,0 +1,73 @@
+# 审批流运行态办理
+
+Runtime CLI 只负责当前 AccessKey 用户的运行态任务查询和办理，不管理流程定义。当前用户由 `X-User-AK` 对应的服务端认证上下文确定，命令不接受 `--user-id`。
+
+## 查询待办
+
+```bash
+lovrabet approval todo --app-code <APP_CODE>
+lovrabet approval todo --app-code <APP_CODE> --page 2 --page-size 20 --format compress
+```
+
+未传 `--app-code` 时，命令使用当前工作区解析出的应用；服务端请求参数是 `appCode`、`currentPage` 和 `pageSize`。
+
+## 查看任务
+
+```bash
+lovrabet approval task-detail --task-id <TASK_ID> --format json
+```
+
+详情中的 `canHandle`、`canCancel`、`transferCandidates`、`formData` 和流程上下文以 Runtime 返回为准。输出会遮罩敏感键；如响应包含 `variables`，其中的值只显示脱敏占位符。
+
+## 审批和拒绝
+
+先预览请求：
+
+```bash
+lovrabet approval approve --task-id <TASK_ID> --comment '同意' --dry-run
+lovrabet approval reject --task-id <TASK_ID> --comment '需要补充材料' --dry-run
+```
+
+确认后执行：
+
+```bash
+lovrabet approval approve --task-id <TASK_ID> --comment '同意' --yes
+lovrabet approval reject --task-id <TASK_ID> --comment '需要补充材料' --yes
+```
+
+`approve` 和 `reject` 都调用 Runtime 的 `/api/flow/approve`，区别只在请求体的 `approved` 值。流程后续路径由已发布流程定义决定，CLI 不自行解释。
+
+## 转交
+
+目标用户应来自任务详情的 `transferCandidates` 或其他已确认的 Runtime 资源：
+
+```bash
+lovrabet approval transfer \
+  --task-id <TASK_ID> \
+  --target-user-id <USER_ID> \
+  --comment '请协助处理' \
+  --dry-run
+
+lovrabet approval transfer \
+  --task-id <TASK_ID> \
+  --target-user-id <USER_ID> \
+  --comment '请协助处理' \
+  --yes
+```
+
+最终授权和候选人合法性由 Runtime 校验。
+
+## Variables 与安全
+
+审批变量支持内联 JSON 或文件：
+
+```bash
+lovrabet approval approve --task-id <TASK_ID> \
+  --variables '{"amount":100}' --yes
+lovrabet approval approve --task-id <TASK_ID> \
+  --variables @variables.json --yes
+```
+
+变量解析失败时不会发送请求。dry-run、错误重试命令和本地命令日志不会回显变量值、AccessKey、token 或 secret。
+
+高风险命令在非交互模式必须传 `--yes`；`--dry-run` 只生成脱敏预览，不执行写请求。

package/skills/lovrabet.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "lovrabet",
   "packageName": "@lovrabet/lovrabet-cli",
-  "packageVersion": "2.3.2",
-  "skillVersion": "2.3.2",
+  "packageVersion": "2.3.3-beta.1",
+  "skillVersion": "2.3.3-beta.1",
   "files": [
     "SKILL.md",
     "guides/app-resolution.md",
@@ -15,6 +15,7 @@
     "references/instant-api-workflow.md",
     "references/lovrabet-app-config.md",
     "references/lovrabet-app.md",
+    "references/lovrabet-approval-workflow.md",
     "references/lovrabet-auth.md",
     "references/lovrabet-bff-workflow.md",
     "references/lovrabet-config-commands.md",
@@ -37,5 +38,5 @@
     "references/lovrabet-user-account.md",
     "references/lovrabet-workspace.md"
   ],
-  "digest": "65b3f2960eb4b77a8c291368d7bfc7a5e624cdd47d1ffa958f7406c70140ee5f"
+  "digest": "30b618d9419b739ae2d10d6df111e7a542e0186fa6a31ecb3bbc55ef01dbba07"
 }