@guanzhu.me/xbot-cli 0.11.1 → 0.11.3

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
@@ -17,12 +17,14 @@ xbot-cli 通过影刀客户端内置通道管理应用、编辑流程、运行
17
17
 
18
18
  - **Agent 优先的输出契约。** 裸调用逐层返回帮助,`schema <path>` 给出机器可读的参数定义;成功写 stdout、失败写 stderr,配合明确的退出码与 `ok/data/error` JSON 信封。
19
19
  - **应用与流程全生命周期。** `app` 创建、打开、保存、同步、发布;`flow` 读取、静态检查、运行与等待;`task` 运行已发布应用。
20
+ - **应用 Python 依赖管理。** `python package list/install/uninstall` 查询、安装和卸载当前应用依赖,支持精确版本、多包和安装源,兼容新旧 MCP;安装和卸载可用 `--dry-run` 预览。
21
+ - **新旧 MCP 自动适配。** 保留旧版 Studio MCP,支持 6.4 Copilot MCP 会话;`flow source read/write/edit` 编辑 6.4 可视化流程和代码,`flow params set` 自动选择原生参数接口或旧适配器。用 `doctor --json` 查看实际通道,`guide mcp` 了解能力差异。
20
22
  - **安全的写入边界。** `--dry-run` 离线预览,`--expect-app` 断言当前应用,高风险操作必须显式 `--yes`。
21
23
  - **浏览器自动化。** `xbot-cli web` 提供“打开页面 → 快照 → 操作元素”的短命令循环,同时返回支持操作的影刀 Python;`web browser list` 查询插件安装与浏览器注册信息,`--browser <id>` 指定目标,打开网页时可自动启动目标浏览器;`web xpath <ref...>` 生成单元素或相似元素 XPath。
22
24
  - **安装环境自动发现。** 支持识别非默认影刀安装目录,诊断失败时显示实际后端路径和针对性修复建议。
23
- - **Windows 自动化。** `win32 list --title "咚咚"` 搜索窗口并表格显示 PID/HWND;`win32 activate` 按注册表和最大数字版本目录定位本机影刀 DLL,激活显式指定的进程。`win32 snapshot` 展示树并保存快照,`inspect/click/fill/type/press/check/select/scroll` 等命令通过 UIA 校验和操作实时控件,动作后返回新树;缺少 Pattern 时不自动回退物理点击。
25
+ - **Windows 自动化。** `win32 list --title "咚咚"` 搜索窗口并表格显示 PID/HWND;`win32 activate` 自动适配 x86 企业微信,其他目标按架构调用本机影刀组件,支持 Windows x64 上的 x86/x64 应用。`win32 snapshot` 展示树并保存快照,`inspect/click/fill/type/press/check/select/scroll` 等命令校验和操作实时控件;click 默认物理点击,`--method invoke` 可选,结果返回实际方法和坐标,动作后返回新树。
24
26
  - **开放平台 Open API。** `oapi` 一条命令保存 AccessKey,token 自动刷新;应用、机器人、调度、日志、队列、企业账号全覆盖。
25
- - **内置 Agent Skill。** `xbot-cli install --skills` 同时安装 `xbot-app-dev` 和 `xbot-development-standards`,包含应用/指令集开发规范、Web/Windows 修复辅助和排障指南。
27
+ - **内置 Agent Skill。** `xbot-cli install --skills` 同时安装 `xbot-app-dev` 和 `xbot-development-standards`,包含应用/指令集开发规范、故障前置分析、临时测试恢复及 Web/Windows 修复辅助;按仅运行、开发和维护任务读取对应资料。
26
28
 
27
29
  ## 安装
28
30
 
@@ -44,7 +46,8 @@ xbot-cli update # 升级到最新版本;--check 只检查不升级
44
46
  ## 快速上手
45
47
 
46
48
  ```powershell
47
- xbot-cli status --json # 确认客户端环境
49
+ xbot-cli client info --json # 客户端版本、目录、进程和实际 MCP 通道
50
+ xbot-cli status --json # 当前客户端及应用状态
48
51
  xbot-cli app open <app-id> --json # 打开应用
49
52
  xbot-cli flow verify <flow-id> --json # 静态检查并运行流程
50
53
  xbot-cli task run <app-id> --json # 运行已发布应用
@@ -59,6 +62,17 @@ xbot-cli app sync --expect-app <app-id> --json
59
62
  该命令调用 `shadowbot.shell-cli.exe studio current sync`,将当前编辑应用同步到云端并关闭
60
63
  Studio,不发布应用。`--dry-run` 可离线预览;结果分别报告同步、编辑器关闭和上传日志证据。
61
64
 
65
+ 管理当前 Studio 应用的 Python 依赖:
66
+
67
+ ```powershell
68
+ xbot-cli python package list --expect-app <app-id> --json
69
+ xbot-cli python package install openpyxl requests --expect-app <app-id> --json
70
+ xbot-cli python package install "openpyxl==3.1.5" --expect-app <app-id> --dry-run --json
71
+ xbot-cli python package uninstall openpyxl --expect-app <app-id> --json
72
+ ```
73
+
74
+ 依赖由客户端安装到应用工作区并更新应用配置;详见 `xbot-cli guide python-packages`。
75
+
62
76
  浏览器交互:
63
77
 
64
78
  ```powershell
@@ -131,11 +145,13 @@ xbot-cli oapi job logs <jobUuid> --json
131
145
 
132
146
  ## 文档
133
147
 
148
+ - [0.11.2 更新说明](docs/updates/2026-11-20-windows-skills.md):32 位目标激活、企微适配、默认物理点击、快照修复与 Skill 维护优化
134
149
  - [0.9.3 更新说明](docs/updates/2026-11-05-flow-parameters.md):不受 MCP 六类型白名单限制的流程参数写入、类型查询和使用文档
135
150
  - [0.9.2 更新说明](docs/updates/2026-11-05-browser-development-standards.md):浏览器列表、指定浏览器、自动启动及指令集/应用开发规范 Skill
136
151
  - [0.9.1 更新说明](docs/updates/2026-10-30-web-python-xpath.md):Web Python、XPath、安装环境发现及验证范围
137
152
  - [CLI 参考](docs/cli-reference.md):完整命令、参数语义、输出契约与设计依据
138
153
  - [流程参数使用文档](docs/flow-parameters.md):真实类型 ID、批量增改删、默认值及 reload 回读
154
+ - [MCP 兼容指南](skills/xbot-app-dev/references/mcp-compatibility.md):6.3/6.4 自动分流、源码编辑、动态工具和配置
139
155
  - [Skill v10 升级说明](docs/skill-v10-upgrade.md):Skill 模块、依赖与限制
140
156
  - [平台指南](skills/xbot-app-dev/references/oapi.md):开放 API 的配置、概念与排障
141
157
  - [发布说明](docs/releasing.md):版本同步与发布流程
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guanzhu.me/xbot-cli",
3
- "version": "0.11.1",
3
+ "version": "0.11.3",
4
4
  "description": "Agent-friendly CLI for ShadowBot RPA applications, flows, tasks and browser automation",
5
5
  "license": "MIT",
6
6
  "author": "wn0x00",
@@ -47,6 +47,10 @@
47
47
  "test:skill": "node --test tests/skill/*.test.cjs",
48
48
  "test:win32-live": "python -X utf8 tests/win32_actions_live.py native/win32-x64/xbot-cli.exe",
49
49
  "test:win32-faults": "python -X utf8 tests/win32_actions_faults.py native/win32-x64/xbot-cli.exe",
50
+ "test:win32-activation": "python -X utf8 tests/win32_activation_live.py native/win32-x64/xbot-cli.exe",
51
+ "test:win32-misc": "python -X utf8 tests/win32_wxwork_activation_live.py native/win32-x64/xbot-cli.exe",
52
+ "test:win32-wework": "python -X utf8 tests/win32_wework_builtin_live.py native/win32-x64/xbot-cli.exe",
53
+ "test:win32-collect": "python -X utf8 tests/win32_snapshot_collect.py",
50
54
  "test:package": "node scripts/test-package.cjs",
51
55
  "release:version": "node scripts/set-version.cjs",
52
56
  "prepack": "npm run build && node scripts/check-package.cjs"