@ziniao-open/cli 1.1.2 → 1.1.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.
Files changed (2) hide show
  1. package/README.md +4 -70
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -10,45 +10,14 @@
10
10
  npm install -g @ziniao-open/cli
11
11
  ```
12
12
 
13
- 紫鸟客户端自带的 `ziniao` CLI 需要同步到 AppCache 并加入 PATH。执行 `npm install -g @ziniao-open/cli` 时会自动尝试同步;安装紫鸟客户端后,也可以手动执行以下命令:
14
-
15
- ```bash
16
- source "$(npm root -g)/@ziniao-open/cli/scripts/setup-ziniao-cli.sh"
17
- ```
18
-
19
- Windows PowerShell 执行:
20
-
21
- ```powershell
22
- . "$(npm root -g)\@ziniao-open\cli\scripts\setup-ziniao-cli.ps1"
23
- ```
13
+ 安装时会自动下载当前平台对应的预编译二进制(支持 macOS / Linux / Windows × amd64 / arm64),并做 SHA-256 校验。
24
14
 
25
- 也可以在安装后手动修复:
15
+ 如果同时使用紫鸟桌面客户端,安装后可执行 `ziniao-cli doctor` 检查环境;PATH 异常时可用:
26
16
 
27
17
  ```bash
28
18
  ziniao-cli doctor fix-path
29
19
  ```
30
20
 
31
- 遍历当前 PATH 清理旧的 `ziniao` shim,并清理 Unix 端的 `ziniaobrowser/cli` 缓存目录(默认只预览):
32
-
33
- ```powershell
34
- & "$(npm root -g)\@ziniao-open\cli\scripts\remove-ziniao-cli-shims.ps1"
35
- & "$(npm root -g)\@ziniao-open\cli\scripts\remove-ziniao-cli-shims.ps1" -Apply
36
- ```
37
-
38
- macOS/Linux:
39
-
40
- ```bash
41
- "$(npm root -g)/@ziniao-open/cli/scripts/remove-ziniao-cli-shims.sh"
42
- "$(npm root -g)/@ziniao-open/cli/scripts/remove-ziniao-cli-shims.sh" --apply
43
- ```
44
-
45
- 脚本只探测 `ziniao.app` / `ziniao` 的安装目录;Windows 会优先查询卸载注册表中 `DisplayIcon` 包含 `ziniao.exe` 的条目,再从本体目录的 `resources/app.asar.unpacked/envkit/cli` 查找 CLI。Windows 使用 `%APPDATA%\ziniaobrowser\cli`,macOS 使用 `~/Library/Application Support/ziniaobrowser/cli`,Linux 使用 `${XDG_CONFIG_HOME:-~/.config}/ziniaobrowser/cli`,在目标目录缺少 CLI 或文件内容发生变化时同步最新文件,并注册当前用户 PATH。找不到源文件时只提示并继续,不阻断 PATH 配置。若安装目录无法自动探测,可设置 `ZINIAO_INSTALL_DIR`;若目标位置不同,可设置 `ZINIAO_APP_CACHE_DIR`。
46
- Windows 同时会把找到的紫鸟本体绝对路径写入 `%APPDATA%\ziniaobrowser\gui-path`,供 CLI 定位桌面客户端。
47
- macOS/Linux 也会在找到桌面本体时写入对应的 `gui-path`(macOS 为 `~/Library/Application Support/ziniaobrowser/gui-path`,Linux 为 `${XDG_CONFIG_HOME:-~/.config}/ziniaobrowser/gui-path`)。
48
- macOS/Linux 还会在 `~/.local/bin/ziniao` 创建固定 shim,避免向随机 PATH 目录写入文件。
49
-
50
- 安装时会自动下载当前平台对应的预编译二进制(支持 macOS / Linux / Windows × amd64 / arm64),并做 SHA-256 校验。
51
-
52
21
  ## 快速开始
53
22
 
54
23
  ```bash
@@ -75,7 +44,7 @@ ziniao-cli --help
75
44
  | 类别 | 命令 | 说明 |
76
45
  |------|------|------|
77
46
  | 基础 | `config` | apiKey 等配置初始化与查看 |
78
- | 基础 | `doctor` | 环境自检(认证、网络、ZClaw 桥可用性) |
47
+ | 基础 | `doctor` | 环境自检(认证、网络、Skills、本地浏览器桥) |
79
48
  | 基础 | `completion` | 生成 shell 自动补全 |
80
49
  | 通用 | `api <path>` | 调用任意紫鸟 OpenAPI 路径 |
81
50
  | 桥接 | `zclaw` | 本地浏览器 Bridge(页面操作、店铺管理等) |
@@ -83,44 +52,9 @@ ziniao-cli --help
83
52
 
84
53
  完整列表见 `ziniao-cli --help`。
85
54
 
86
- ## 本地 dev/prod 打包与切换
87
-
88
- 在仓库根目录执行以下命令,可分别生成本地测试环境包和本地正式环境包:
89
-
90
- ```bash
91
- make package-dev
92
- make package-prod
93
- ```
94
-
95
- 两个命令都会生成本地多平台 snapshot 包。版本基于最近的发布 tag,并使用本机递增计数器:最近 tag 为 `v1.0.7` 时,依次生成 `1.0.7-dev-1`、`1.0.7-dev-2`、`1.0.7-dev-3`。
96
-
97
- 计数器保存在 `~/.ziniao-cli/dev-build-counter`;当最近 tag 变化时计数从 `1` 重新开始。可通过 `ZINIAO_CLI_DEV_COUNTER_FILE` 指定其他计数器路径,便于 CI 或测试隔离。产物写入 `dist/`,该命令只打包,不发布。
98
-
99
- `package-dev` 内置测试环境 `https://test-sbappstoreapi.ziniao.com` 与 `https://test-open.ziniao.com`,默认使用独立配置目录 `~/.ziniao-cli-dev/`,本地二进制写入 `~/.ziniao-cli-dev/bin/ziniao-cli`。
100
-
101
- `package-prod` 内置正式环境 `https://sbappstoreapi.ziniao.com` 与 `https://open.ziniao.com`,默认使用独立配置目录 `~/.ziniao-cli-prod/`,本地二进制写入 `~/.ziniao-cli-prod/bin/ziniao-cli`。
102
-
103
- 仓库内的 `scripts/ziniao-cli-use` 提供统一切换入口;如果你已将该脚本加入 PATH,可直接执行:
104
-
105
- ```bash
106
- ziniao-cli-use dev
107
- ziniao-cli-use prod
108
- ziniao-cli-use online
109
- ```
110
-
111
- - `ziniao-cli-use dev`:切换到 `~/.ziniao-cli-dev/bin/ziniao-cli`
112
- - `ziniao-cli-use prod`:切换到 `~/.ziniao-cli-prod/bin/ziniao-cli`
113
- - `ziniao-cli-use online`:切换回 npm 安装的线上版 `ziniao-cli`,继续使用默认线上配置目录 `~/.ziniao-cli/`
114
-
115
- `make package-dev` 与 `make package-prod` 只会更新各自隔离的本地输出路径,不会改写仓库根目录的 `./ziniao-cli`。如果你需要仓库根目录的开发测试二进制,继续使用 `make build`。
116
-
117
- dev、本地 prod、online 三套 CLI 默认分别使用 `~/.ziniao-cli-dev/`、`~/.ziniao-cli-prod/`、`~/.ziniao-cli/`,API Key 和配置互不读取。首次运行某个本地环境前,执行 `ziniao-cli config init` 即可在对应目录完成初始化。
118
-
119
55
  ## AI Agent Skills
120
56
 
121
- 仓库提供 12 个开箱即用的 AI Agent Skill:访问策略、账号、部门、设备、OpenAPI 探索、页面、角色、共享基础、Skill 创建、员工、店铺和批量账号授权。
122
-
123
- 安装 Skill:
57
+ 仓库提供开箱即用的 AI Agent Skill,覆盖账号、店铺、员工、部门等常见操作。
124
58
 
125
59
  ```bash
126
60
  ziniao-cli skills install
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ziniao-open/cli",
3
- "version": "1.1.2",
3
+ "version": "1.1.3",
4
4
  "description": "紫鸟开放平台命令行工具,为开发者和 AI Agent 提供统一的接口调用入口。",
5
5
  "license": "UNLICENSED",
6
6
  "bin": {