@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.
- package/README.md +4 -70
- 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
|
-
|
|
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` | 环境自检(认证、网络、
|
|
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
|
-
|
|
122
|
-
|
|
123
|
-
安装 Skill:
|
|
57
|
+
仓库提供开箱即用的 AI Agent Skill,覆盖账号、店铺、员工、部门等常见操作。
|
|
124
58
|
|
|
125
59
|
```bash
|
|
126
60
|
ziniao-cli skills install
|