@amaster.ai/cli 1.1.26 → 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 CHANGED
@@ -1,17 +1,135 @@
1
1
  # @amaster.ai/cli
2
2
 
3
- CLI utilities for React + Vite template checks.
3
+ `amaster-cli` 提供两类能力:
4
4
 
5
- Current commands:
5
+ 1. 模板检查
6
+ 2. Addon Marketplace
6
7
 
7
- - `amaster-cli check route`
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
- This command validates that the default-exported routes config in `src/routes.tsx`
17
- contains a home route whose `path` resolves to `"/"`.
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
+ ```