@amaster.ai/cli 1.1.28 → 1.1.30

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
@@ -1,6 +1,6 @@
1
1
  # @amaster.ai/cli
2
2
 
3
- `amaster-cli` 提供两类能力:
3
+ `amaster` 提供两类能力,`amaster-cli` 作为兼容命令保留:
4
4
 
5
5
  1. 模板检查
6
6
  2. Addon Marketplace
@@ -17,12 +17,12 @@
17
17
  ```bash
18
18
  export AMASTER_CLI_REGISTRY=amaster.local
19
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
20
+ amaster login
21
+ amaster login --registry helige-int --browser
22
+ amaster login --registry helige-int
23
+ amaster login --registry https://demo.example.com --email admin@amaster.ai --password password
24
+ amaster whoami
25
+ amaster logout
26
26
  ```
27
27
 
28
28
  登录流程:
@@ -35,23 +35,23 @@ amaster-cli logout
35
35
  ## Addon 命令
36
36
 
37
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
38
+ amaster addon search crm
39
+ amaster addon view crm-pages
40
+ amaster addon view crm-pages@1.0.0
41
+ amaster addon versions crm-pages
42
+ amaster addon members crm-pages@1.0.0
43
+ amaster addon content crm-pages@1.0.0 lead-summary
44
+
45
+ amaster addon publish .
46
+ amaster addon publish ./dist/addon.tgz --scope official
47
+ amaster addon activate crm-pages
48
+ amaster addon deactivate crm-pages
49
+ amaster addon delete crm-pages
50
+
51
+ amaster addon install crm-pages@1.0.0
52
+ amaster addon install crm-pages --registry helige-int
53
+ amaster addon upgrade crm-pages
54
+ amaster addon list
55
55
  ```
56
56
 
57
57
  `addon search` 在未显式传 `--application-type` 时,会从当前目录向上查找最近的 `package.json`,读取同级 `app.settings.yml` 的 `type`,并自动按 `web` 或 `mini` 过滤。
@@ -76,10 +76,48 @@ amaster-cli addon list
76
76
  - `bpmn`
77
77
  - `entity`
78
78
  - `datasource`
79
+ - `settings`
79
80
 
80
81
  安装结果会写入:
81
82
 
82
83
  - `src/addons/<addon-name>/meta.json`
84
+ - `settings` 成员会深合并到应用根目录 `app.settings.yml`
85
+
86
+ Addon 可在 `addon.json` 中声明安装后的运行配置要求:
87
+
88
+ ```json
89
+ {
90
+ "install": {
91
+ "npm": {
92
+ "dependencies": {
93
+ "@tanstack/react-query": "^5.66.0"
94
+ }
95
+ },
96
+ "requirements": {
97
+ "envs": [
98
+ {
99
+ "key": "OAUTH_CLIENT_ID",
100
+ "required": true,
101
+ "description": "OAuth client id",
102
+ "defaultValue": "demo-client"
103
+ }
104
+ ],
105
+ "secrets": [
106
+ {
107
+ "key": "OAUTH_CLIENT_SECRET",
108
+ "required": true,
109
+ "description": "OAuth client secret"
110
+ }
111
+ ]
112
+ }
113
+ }
114
+ }
115
+ ```
116
+
117
+ `install.npm` 会写入应用根目录 `package.json`。如果目标应用已声明同名包且版本不一致,安装/升级会停止并返回 `package_dependency_conflict`。
118
+ 通过 registry 执行 `addon install` / `addon upgrade` 时,如果 `package.json` 有变更,CLI 会按当前应用自动执行 `bun install`、`pnpm install`、`npm install` 或 `yarn install`。
119
+
120
+ `install.requirements` 会写入 `meta.json`,并在安装/升级结果中返回 `requirements` 和 `missingRequirements`。`secrets` 只保存键名和说明,不保存密钥值。
83
121
 
84
122
  页面注册方式:
85
123
 
@@ -127,9 +165,9 @@ MCP 接入时可按 `conflicts[].path` 读取应用里的当前文件,并按 `
127
165
  命令:
128
166
 
129
167
  ```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>]
168
+ amaster check route [--cwd <path>] [--routes-file <path>]
169
+ amaster check ast --stack react-vite [--cwd <path>]
170
+ amaster check type --stack <react-vite|taro> [--cwd <path>]
171
+ amaster check build --stack <react-vite|taro> [--cwd <path>]
172
+ amaster check all --stack <react-vite|taro> [--cwd <path>]
135
173
  ```