@ziniao-open/cli 1.1.2 → 1.2.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 +14 -68
- 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,49 +52,26 @@ ziniao-cli --help
|
|
|
83
52
|
|
|
84
53
|
完整列表见 `ziniao-cli --help`。
|
|
85
54
|
|
|
86
|
-
##
|
|
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`。
|
|
55
|
+
## AI Agent Skills
|
|
102
56
|
|
|
103
|
-
|
|
57
|
+
仓库提供开箱即用的 AI Agent Skill,覆盖账号、店铺、员工、部门等常见操作。
|
|
104
58
|
|
|
105
59
|
```bash
|
|
106
|
-
ziniao-cli
|
|
107
|
-
ziniao-cli-use prod
|
|
108
|
-
ziniao-cli-use online
|
|
60
|
+
ziniao-cli skills install
|
|
109
61
|
```
|
|
110
62
|
|
|
111
|
-
|
|
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` 即可在对应目录完成初始化。
|
|
63
|
+
备选:`npx skills add ziniao-open/skills -y -g`
|
|
118
64
|
|
|
119
|
-
|
|
65
|
+
详见 [ziniao-skills](https://github.com/ziniao-open/skills)。
|
|
120
66
|
|
|
121
|
-
|
|
67
|
+
### 操作店铺中的新标签页
|
|
122
68
|
|
|
123
|
-
|
|
69
|
+
点击链接或手动打开新标签后,可列出页面并选择后续命令的默认目标:
|
|
124
70
|
|
|
125
71
|
```bash
|
|
126
|
-
ziniao-cli
|
|
72
|
+
ziniao-cli page list --store-id <店铺ID>
|
|
73
|
+
ziniao-cli page select --store-id <店铺ID> --target-id <页面ID>
|
|
74
|
+
ziniao-cli page content --store-id <店铺ID>
|
|
127
75
|
```
|
|
128
76
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
详见 [ziniao-skills](https://github.com/ziniao-open/skills)。
|
|
77
|
+
列表返回 `targetId`、`title`、`url`、`selected`。`selected` 表示 CLI 默认目标,不代表浏览器前台标签。选择操作不会导航或激活页面,选择在当前店铺运行会话中生效。页面命令仍可使用 `--target-id` 指定目标;沿用现有行为,该操作也会更新后续默认目标。目标关闭后会重新解析;有多个可操作页面且没有有效默认目标时,需要重新选择。需配合支持 `list_pages`、`select_page` 的客户端使用。
|