@guanzhu.me/xbot-cli 0.6.0 → 0.7.0

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
@@ -1,5 +1,7 @@
1
1
  # xbot-cli
2
2
 
3
+ [npm 安装包:@guanzhu.me/xbot-cli](https://www.npmjs.com/package/@guanzhu.me/xbot-cli) · [GitHub Releases 下载](https://github.com/wn0x00/xbot-cli/releases) · [最新版本说明](https://github.com/wn0x00/xbot-cli/releases/latest)
4
+
3
5
  面向 AI Agent 的影刀(ShadowBot)RPA 命令行工具。通过影刀客户端内置的 shell-cli、studio-mcp 和 browser-use-mcp 管理应用、编辑流程、运行验证及浏览器自动化。
4
6
 
5
7
  Agent 可以逐层查询帮助和参数 schema,通过稳定的 JSON 结果判断下一步,并安装随包提供的开发 Skill。CLI 使用 Rust 实现,通过 npm 分发预编译程序。
@@ -8,22 +10,22 @@ Agent 可以逐层查询帮助和参数 schema,通过稳定的 JSON 结果判
8
10
 
9
11
  当前分发目标为 **Windows x64,Node.js 22 或更高版本**。npm 包包含原生可执行文件,不需要用户安装 Rust,也不在 `postinstall` 阶段下载程序。执行影刀操作前,需要本机已安装影刀客户端并启动、登录;帮助、版本、命令 schema 和内置指南可离线使用。
10
12
 
11
- 通过 npm 安装。**npm 包名是 `@guanzhu.me/xbot-cli`,安装后的命令名仍是 `xbot-cli`。**
13
+ 通过 npm 安装。**npm 包名是 `@guanzhu.me/xbot-cli`,安装后可使用 `xbot` 或 `xbot-cli`,两者调用同一程序。**
12
14
 
13
15
  ```powershell
14
16
  npm install -g '@guanzhu.me/xbot-cli'
15
- xbot-cli --version
16
- xbot-cli
17
- xbot-cli status --json
17
+ xbot --version
18
+ xbot
19
+ xbot status --json
18
20
  ```
19
21
 
20
22
  不进行全局安装也可调用:
21
23
 
22
24
  ```powershell
23
- npx --yes --package '@guanzhu.me/xbot-cli' xbot-cli --help
25
+ npx --yes --package '@guanzhu.me/xbot-cli' xbot --help
24
26
  ```
25
27
 
26
- 这里的 `npx --yes` 是 npm 的安装确认选项,不是 xbot-cli 的操作确认。需要可重复执行的 Agent 环境时,固定版本,例如 `npm install -g '@guanzhu.me/xbot-cli@0.6.0'`。PowerShell 中带 `@` 的 npm 包参数使用单引号包围。
28
+ 这里的 `npx --yes` 是 npm 的安装确认选项,不是 xbot-cli 的操作确认。需要可重复执行的 Agent 环境时,将包名写为 `@guanzhu.me/xbot-cli@<version>`,用已验证的实际版本替换 `<version>`。PowerShell 中带 `@` 的 npm 包参数使用单引号包围。
27
29
 
28
30
  也可从源码构建并直接运行:
29
31
 
@@ -121,6 +123,30 @@ xbot-cli task status <task-id> --json
121
123
  xbot-cli task logs <task-id> --json
122
124
  ```
123
125
 
126
+ ### 浏览器交互:`xbot web`
127
+
128
+ 使用类似 Playwright CLI 的短命令完成“打开页面 → 读取快照 → 操作元素”的循环,常用动作无需手写 JSON。执行仍通过影刀的浏览器后端,需要已打开 Studio 应用,并有安装影刀扩展的浏览器,或使用内置影刀浏览器。
129
+
130
+ ```powershell
131
+ xbot web open baidu.com
132
+ xbot web snapshot
133
+ # 从当前快照选择实际元素编号;以下 e4、e7 仅演示语法
134
+ xbot web fill e4 "影刀 RPA"
135
+ xbot web press Enter --ref e4
136
+ xbot web click e7
137
+ xbot web snapshot --output after-search.txt
138
+ ```
139
+
140
+ 裸域名会补全为 HTTPS。`open` 不带 URL 时打开 `about:blank`;附着用户当前活动页使用 `xbot web active`(别名 `attach`),在受控页面内跳转使用 `xbot web goto <url>`。
141
+
142
+ 打开、附着、导航和常用交互成功后会自动读取快照,使用返回的真实 ref 继续操作;可加 `--no-snapshot` 跳过。快照保留后端的元数据,内容可能是增量变化。自动快照失败时,动作仍返回成功并附带 warning 和 `applied: true`,此时单独调用 `web snapshot`,不要重复执行刚才的点击或提交。`close` 关闭当前受控页,不读取关闭后的快照。
143
+
144
+ `snapshot --output <file>`(别名 `--filename`)保存快照文本,不覆盖已有文件。需要分析 JSON 时显式加 `--json`;需要在管道中读取快照文本时使用 `--format text`。
145
+
146
+ 元素操作可用 `--name <名称>` 指定暂存选择器名称;省略时 CLI 自动生成唯一中文临时名。这些名称会暂存在后端,调用 `web_review` 前不会写入项目元素库。`browser` 是 `web` 的兼容别名,旧的 `xbot-cli browser` 调用仍可使用。
147
+
148
+ 更多命令见 `xbot web --help` 或 `xbot guide browser`;上传、下载等专用能力通过 `tool browser` 按实时 schema 调用。
149
+
124
150
  ## 命令与输出契约
125
151
 
126
152
  | 入口 | 用途 |
@@ -130,7 +156,7 @@ xbot-cli task logs <task-id> --json
130
156
  | `flow` | 流程读取、参数、静态检查、实际运行与等待 |
131
157
  | `flow code` / `flow visual` | CodeFlow 源码和 VisualFlow 块 |
132
158
  | `task` | 已发布应用的控制台任务 |
133
- | `browser` | 浏览器上下文、快照与交互 |
159
+ | `web`(别名 `browser`) | 浏览器上下文、快照与 click/fill/press 等交互 |
134
160
  | `tool studio` / `tool browser` | 原始工具的发现、schema 和调用 |
135
161
  | `wiki` / `schema` / `guide` | 官方知识库、命令参数与内置开发指南 |
136
162
  | `install --skills` | 安装 Agent Skill |
@@ -206,7 +232,20 @@ cargo build --release
206
232
 
207
233
  非标准客户端安装可使用 `XBOT_SHELL_CLI`、`XBOT_MCP_ENDPOINT`、`XBOT_BROWSER_MCP_ENDPOINT`、`XBOT_LAUNCHER` 覆盖默认路径或连接地址。不要把账号凭据、生产环境配置或运行日志提交到仓库。
208
234
 
209
- 源码托管于 [wn0x00/xbot-cli](https://github.com/wn0x00/xbot-cli),npm 包名为 [`@guanzhu.me/xbot-cli`](https://www.npmjs.com/package/@guanzhu.me/xbot-cli),CLI 命令名为 `xbot-cli`。配置发布身份及正式发布步骤见[发布说明](docs/releasing.md)。
235
+ 源码托管于 [wn0x00/xbot-cli](https://github.com/wn0x00/xbot-cli),npm 包名为 [`@guanzhu.me/xbot-cli`](https://www.npmjs.com/package/@guanzhu.me/xbot-cli),CLI 可通过 `xbot` 或 `xbot-cli` 调用。配置发布身份及正式发布步骤见[发布说明](docs/releasing.md)。
236
+
237
+ ## 参与开发与发版
238
+
239
+ 从功能分支或 Fork 提交 PR,使用 `feat(cli): ...`、`fix(flow): ...` 等 Conventional Commits 标题,并以 Squash 方式合并。开发检查、兼容性要求和 PR 说明见[贡献指南](CONTRIBUTING.md)。普通开发 PR 不手动修改版本号。
240
+
241
+ 维护者决定版本,运行 `npm run release:version -- 0.6.2` 同步 Rust 和 npm 的四个版本文件,更新 `CHANGELOG.md`,将改动合并到 `main` 并等待 CI 通过。然后手动推送对应 tag:
242
+
243
+ ```powershell
244
+ git tag -a v0.6.2 -m 'Release v0.6.2'
245
+ git push origin v0.6.2
246
+ ```
247
+
248
+ 示例版本需替换为本次实际版本,并在已同步的 `main` 发布提交上打 tag。推送 `v<version>` 后,`publish.yml` 自动完成构建、安装验证、npm OIDC 发布,以及 GitHub Release 创建和附件上传。版本脚本只修改文件,不提交、不打 tag、不发布;普通提交和 PR 合并不会自动发版。完整步骤、发布身份和失败恢复见[发布说明](docs/releasing.md)。
210
249
 
211
250
  ## 许可
212
251
 
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guanzhu.me/xbot-cli",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Agent-friendly CLI for ShadowBot RPA applications, flows, tasks and browser automation",
5
5
  "license": "MIT",
6
6
  "author": "wn0x00",
@@ -9,13 +9,34 @@
9
9
  "url": "git+https://github.com/wn0x00/xbot-cli.git"
10
10
  },
11
11
  "homepage": "https://github.com/wn0x00/xbot-cli#readme",
12
- "bugs": { "url": "https://github.com/wn0x00/xbot-cli/issues" },
13
- "keywords": ["xbot", "shadowbot", "rpa", "cli", "agent", "automation"],
14
- "bin": { "xbot-cli": "bin/xbot-cli.cjs" },
15
- "files": ["bin/xbot-cli.cjs", "native/win32-x64/xbot-cli.exe"],
16
- "os": ["win32"],
17
- "cpu": ["x64"],
18
- "engines": { "node": ">=22" },
12
+ "bugs": {
13
+ "url": "https://github.com/wn0x00/xbot-cli/issues"
14
+ },
15
+ "keywords": [
16
+ "xbot",
17
+ "shadowbot",
18
+ "rpa",
19
+ "cli",
20
+ "agent",
21
+ "automation"
22
+ ],
23
+ "bin": {
24
+ "xbot": "bin/xbot-cli.cjs",
25
+ "xbot-cli": "bin/xbot-cli.cjs"
26
+ },
27
+ "files": [
28
+ "bin/xbot-cli.cjs",
29
+ "native/win32-x64/xbot-cli.exe"
30
+ ],
31
+ "os": [
32
+ "win32"
33
+ ],
34
+ "cpu": [
35
+ "x64"
36
+ ],
37
+ "engines": {
38
+ "node": ">=22"
39
+ },
19
40
  "scripts": {
20
41
  "build": "node scripts/build.cjs",
21
42
  "check": "cargo fmt --check && cargo clippy --locked --all-targets -- -D warnings",
@@ -23,7 +44,11 @@
23
44
  "test": "cargo test --locked && npm run test:npm",
24
45
  "test:npm": "node --test tests/npm/*.test.cjs",
25
46
  "test:package": "node scripts/test-package.cjs",
47
+ "release:version": "node scripts/set-version.cjs",
26
48
  "prepack": "npm run build && node scripts/check-package.cjs"
27
49
  },
28
- "publishConfig": { "registry": "https://registry.npmjs.org/", "access": "public" }
50
+ "publishConfig": {
51
+ "registry": "https://registry.npmjs.org/",
52
+ "access": "public"
53
+ }
29
54
  }