@guanzhu.me/xbot-cli 0.7.4 → 0.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -9,6 +9,8 @@
9
9
 
10
10
  通过影刀客户端内置的 shell-cli、studio-mcp 和 browser-use-mcp 管理应用、编辑流程、运行验证及浏览器自动化。Agent 可以逐层查询帮助和参数 schema,通过稳定的 JSON 结果判断下一步,并安装随包提供的开发 Skill。CLI 使用 Rust 实现,通过 npm 分发预编译程序。
11
11
 
12
+ 普通操作和应用运行默认沿用客户端通道;`platform` 仅供企业版用户明确选择开放 API 时作为备用入口。
13
+
12
14
  ## 安装
13
15
 
14
16
  **环境要求:Windows x64,Node.js 22 或更高版本。** npm 包包含原生可执行文件,不需要用户安装 Rust,也不在 `postinstall` 阶段下载程序。执行影刀操作前,需要本机已安装影刀客户端并启动、登录;帮助、版本、命令 schema 和内置指南可离线使用。
@@ -20,6 +22,9 @@ npm install -g '@guanzhu.me/xbot-cli'
20
22
  xbot version
21
23
  ```
22
24
 
25
+ **0.7.5 已弃用:** 新增的开放平台 API 执行逻辑存在问题,请升级到 0.7.6。
26
+ 普通应用操作仍使用原有客户端 CLI;`platform` 仅供企业版用户明确选择时作为备用入口。
27
+
23
28
  `xbot version` 和 `xbot-cli version` 离线输出当前 CLI 版本,`--version` / `-V` 仍可使用。版本默认输出一行文本,即使接入管道也不变;Agent 可用 `xbot version --json` 读取 `data.name` 和 `data.version`。
24
29
 
25
30
  不进行全局安装也可调用:
@@ -142,7 +147,7 @@ xbot-cli install --skills --global --json
142
147
 
143
148
  请使用支持 `.agents/skills` 的 Agent,或明确让 Agent 阅读生成的 `SKILL.md`。不支持自动加载 Skill 的工具也可以直接阅读下方完整指令。已有 Skill 内容不同时,CLI 会返回冲突;先查看差异,确认覆盖后再追加 `--yes`。
144
149
 
145
- 从 **CLI 0.7.4** 起内置 **Skill v10,共 38 个文件**,包含 Web/Windows 模块、12 个脚本及业务任务、用途分析、定位和修复提议模板。使用 0.7.3 或更早版本时,先升级 CLI,再运行 `xbot-cli install --skills` 安装新 Skill;已有本地改动时先查看差异,再决定是否覆盖。
150
+ 从 **CLI 0.7.4** 起内置 **Skill v10**。当前源码包含 39 个资源,包括 Web/Windows 模块、12 个脚本、开放平台排障指南及业务任务、用途分析、定位和修复提议模板。使用 0.7.3 或更早版本时,先升级 CLI,再运行 `xbot-cli install --skills` 安装新 Skill;已有本地改动时先查看差异,再决定是否覆盖。
146
151
 
147
152
  | 能力 | 实现与范围 |
148
153
  |---|---|
@@ -191,6 +196,7 @@ Web 生成 helper 需要支持 `stripTypeScriptTypes` 的 Node 运行时和固
191
196
  | `flow` | 流程读取、参数、静态检查、实际运行与等待 |
192
197
  | `flow code` / `flow visual` | CodeFlow 源码和 VisualFlow 块 |
193
198
  | `task` | 已发布应用的控制台任务 |
199
+ | `platform` | 企业版可选备用入口:开放 API 运行、调度记录和云端日志 |
194
200
  | `web`(别名 `browser`) | 浏览器上下文、快照与 click/fill/press 等交互 |
195
201
  | `win32 snapshot` | 实验性只读 UIA 快照,显式限定 HWND/PID,独立于 Studio 与原生 Selector |
196
202
  | `tool studio` / `tool browser` | 原始工具的发现、schema 和调用 |
@@ -226,6 +232,40 @@ Web 生成 helper 需要支持 `stripTypeScriptTypes` 的 Node 运行时和固
226
232
 
227
233
  完整参数语义、兼容命令、确认边界和设计依据见 [CLI 参考](docs/cli-reference.md);Agent 也可运行 `xbot-cli guide cli-contract`。
228
234
 
235
+ ## 企业版备用入口
236
+
237
+ 从 CLI 0.7.5 起保留 `platform`,仅供企业版用户在明确选择开放 API 运行应用、
238
+ 调用调度或查询平台日志时使用。正常开发、运行和报错分析继续使用原有
239
+ `status`、`app`、`flow`、`task`、`web` 命令;应用运行用 `task run`,
240
+ 运行日志用 `task logs`,Studio 流程用 `flow run/verify`。
241
+ 配置了 API 凭据也不会改变默认通道,原命令报错时不会自动切换或再启动一份应用。
242
+
243
+ 确认选择企业版备用入口后,通过环境变量配置
244
+ `XBOT_PLATFORM_ACCESS_KEY_ID` / `XBOT_PLATFORM_ACCESS_KEY_SECRET`,或提供
245
+ `XBOT_PLATFORM_ACCESS_TOKEN`。此入口不依赖本机客户端;专有云可设置
246
+ `XBOT_PLATFORM_BASE_URL` 为 HTTPS origin。
247
+
248
+ ```powershell
249
+ xbot-cli platform auth status --json
250
+ xbot-cli platform auth check --json
251
+ xbot-cli platform api schema job.start --json
252
+ xbot-cli platform job list --status error --json
253
+ xbot-cli platform job status <jobUuid> --json
254
+ xbot-cli platform job logs <jobUuid> --search "错误" --json
255
+ xbot-cli platform job logs <jobUuid> --async --timeout 10 --json
256
+ xbot-cli platform schedule runs <scheduleUuid> --json
257
+ xbot-cli platform task status <taskUuid> --json
258
+ xbot-cli platform api list --json
259
+ xbot-cli platform api schema log.search --json
260
+ xbot-cli guide platform
261
+ ```
262
+
263
+ 内置 68 个官方文档索引及 44 个接口契约,覆盖鉴权、企业账号、应用、机器人、
264
+ 调度、日志、队列、文件和运行数据。`platform api call` 提供通用调用,
265
+ 写操作支持 `--dry-run` 并要求 `--yes`。查询保留原始分页,不自动遍历历史;
266
+ 异步日志轮询超时保留 `request_id`。应用运行数据查询的时间跨度限制为 7 天。
267
+ 配置、标识关系和错误分析流程见 [平台指南](skills/xbot-app-dev/references/platform.md)。
268
+
229
269
  ## 项目目录
230
270
 
231
271
  ```text
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guanzhu.me/xbot-cli",
3
- "version": "0.7.4",
3
+ "version": "0.7.6",
4
4
  "description": "Agent-friendly CLI for ShadowBot RPA applications, flows, tasks and browser automation",
5
5
  "license": "MIT",
6
6
  "author": "wn0x00",