@amaster.ai/cli 1.1.27 → 1.1.28
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 +130 -12
- package/dist/cli.cjs +1981 -93
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +1961 -94
- package/dist/cli.js.map +1 -1
- package/package.json +6 -3
package/README.md
CHANGED
|
@@ -1,17 +1,135 @@
|
|
|
1
1
|
# @amaster.ai/cli
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`amaster-cli` 提供两类能力:
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
1. 模板检查
|
|
6
|
+
2. Addon Marketplace
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
- `amaster-cli check ast --stack react-vite`
|
|
9
|
-
- `amaster-cli check type --stack react-vite`
|
|
10
|
-
- `amaster-cli check build --stack react-vite`
|
|
11
|
-
- `amaster-cli check type --stack taro`
|
|
12
|
-
- `amaster-cli check build --stack taro`
|
|
13
|
-
- `amaster-cli check all --stack react-vite`
|
|
14
|
-
- `amaster-cli check all --stack taro`
|
|
8
|
+
## Registry
|
|
15
9
|
|
|
16
|
-
|
|
17
|
-
|
|
10
|
+
- 默认 registry:`helige` -> `https://www.helige.cn`
|
|
11
|
+
- 内置别名:`helige-int` -> `https://www.helige-int.cn`
|
|
12
|
+
- 默认 registry 可通过环境变量 `AMASTER_CLI_REGISTRY` 覆盖
|
|
13
|
+
- 临时切换其他环境时使用 `--registry`
|
|
14
|
+
|
|
15
|
+
## 认证
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
export AMASTER_CLI_REGISTRY=amaster.local
|
|
19
|
+
|
|
20
|
+
amaster-cli login
|
|
21
|
+
amaster-cli login --registry helige-int --browser
|
|
22
|
+
amaster-cli login --registry helige-int
|
|
23
|
+
amaster-cli login --registry https://demo.example.com --email admin@amaster.ai --password password
|
|
24
|
+
amaster-cli whoami
|
|
25
|
+
amaster-cli logout
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
登录流程:
|
|
29
|
+
|
|
30
|
+
1. `--browser`:打开 `/login?redirect=/api/oauth/authorize...`,通过本地 `http://127.0.0.1:18147/oauth/callback` 接收授权码
|
|
31
|
+
2. 默认密码模式:先登录 `/api/auth/login`
|
|
32
|
+
3. 再用 `amaster-cli` 这个 public PKCE OAuth client 兑换 Addon 写接口可用的 Bearer Token
|
|
33
|
+
4. 本地 session 按 registry 隔离保存到 `~/.amaster/cli/config.json`
|
|
34
|
+
|
|
35
|
+
## Addon 命令
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
amaster-cli addon search crm
|
|
39
|
+
amaster-cli addon view crm-pages
|
|
40
|
+
amaster-cli addon view crm-pages@1.0.0
|
|
41
|
+
amaster-cli addon versions crm-pages
|
|
42
|
+
amaster-cli addon members crm-pages@1.0.0
|
|
43
|
+
amaster-cli addon content crm-pages@1.0.0 lead-summary
|
|
44
|
+
|
|
45
|
+
amaster-cli addon publish .
|
|
46
|
+
amaster-cli addon publish ./dist/addon.tgz --scope official
|
|
47
|
+
amaster-cli addon activate crm-pages
|
|
48
|
+
amaster-cli addon deactivate crm-pages
|
|
49
|
+
amaster-cli addon delete crm-pages
|
|
50
|
+
|
|
51
|
+
amaster-cli addon install crm-pages@1.0.0
|
|
52
|
+
amaster-cli addon install crm-pages --registry helige-int
|
|
53
|
+
amaster-cli addon upgrade crm-pages
|
|
54
|
+
amaster-cli addon list
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
`addon search` 在未显式传 `--application-type` 时,会从当前目录向上查找最近的 `package.json`,读取同级 `app.settings.yml` 的 `type`,并自动按 `web` 或 `mini` 过滤。
|
|
58
|
+
|
|
59
|
+
常用参数:
|
|
60
|
+
|
|
61
|
+
- `--registry <alias-or-url>`
|
|
62
|
+
- `--organization-code <code>`
|
|
63
|
+
- `--json`
|
|
64
|
+
- `--set key=value`:安装参数
|
|
65
|
+
- `--application-type web|mini`
|
|
66
|
+
- `--target <path>`:显式指定应用根目录;不传时从当前目录向上查找最近的 `package.json`
|
|
67
|
+
|
|
68
|
+
## 安装规则
|
|
69
|
+
|
|
70
|
+
设计态安装成员类型:
|
|
71
|
+
|
|
72
|
+
- `component`
|
|
73
|
+
- `page`
|
|
74
|
+
- `theme`
|
|
75
|
+
- `workflow`
|
|
76
|
+
- `bpmn`
|
|
77
|
+
- `entity`
|
|
78
|
+
- `datasource`
|
|
79
|
+
|
|
80
|
+
安装结果会写入:
|
|
81
|
+
|
|
82
|
+
- `src/addons/<addon-name>/meta.json`
|
|
83
|
+
|
|
84
|
+
页面注册方式:
|
|
85
|
+
|
|
86
|
+
- `web`:生成 `src/amaster/registry/addon-routes.generated.ts`,并 patch `src/routes.tsx`
|
|
87
|
+
- `mini`:生成 `src/amaster/registry/addon-pages.generated.ts`,并 patch `src/app.config.ts`
|
|
88
|
+
|
|
89
|
+
升级策略:
|
|
90
|
+
|
|
91
|
+
- 先读取已安装 `meta.json`
|
|
92
|
+
- 如果受管文件被本地修改,升级会停止
|
|
93
|
+
- 冲突会先汇总后返回,不会写入半成品
|
|
94
|
+
- 普通输出会打印冲突摘要;`--json` 会输出 MCP/AI 可消费的结构化冲突信息
|
|
95
|
+
|
|
96
|
+
冲突 JSON 示例:
|
|
97
|
+
|
|
98
|
+
```json
|
|
99
|
+
{
|
|
100
|
+
"success": false,
|
|
101
|
+
"code": "ADDON_INSTALL_CONFLICT",
|
|
102
|
+
"message": "Addon install has 1 conflict(s)",
|
|
103
|
+
"operation": "install",
|
|
104
|
+
"addon": {
|
|
105
|
+
"name": "approval-addon",
|
|
106
|
+
"version": "1.0.0",
|
|
107
|
+
"applicationType": "web"
|
|
108
|
+
},
|
|
109
|
+
"targetDir": "/path/to/app",
|
|
110
|
+
"conflicts": [
|
|
111
|
+
{
|
|
112
|
+
"kind": "target_exists",
|
|
113
|
+
"path": "src/pages/approval/index.tsx",
|
|
114
|
+
"sourcePath": "pages/approval/index.tsx",
|
|
115
|
+
"memberName": "approval-page",
|
|
116
|
+
"memberType": "page",
|
|
117
|
+
"message": "src/pages/approval/index.tsx already exists in target application"
|
|
118
|
+
}
|
|
119
|
+
]
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
MCP 接入时可按 `conflicts[].path` 读取应用里的当前文件,并按 `memberName` / `sourcePath` 获取 Addon 原始内容,再交给 AI 合并后重试安装或升级。
|
|
124
|
+
|
|
125
|
+
## 模板检查
|
|
126
|
+
|
|
127
|
+
命令:
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
amaster-cli check route [--cwd <path>] [--routes-file <path>]
|
|
131
|
+
amaster-cli check ast --stack react-vite [--cwd <path>]
|
|
132
|
+
amaster-cli check type --stack <react-vite|taro> [--cwd <path>]
|
|
133
|
+
amaster-cli check build --stack <react-vite|taro> [--cwd <path>]
|
|
134
|
+
amaster-cli check all --stack <react-vite|taro> [--cwd <path>]
|
|
135
|
+
```
|