@amaster.ai/cli 1.1.47 → 1.1.48
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 +5 -2
- package/dist/cli.cjs +26 -6
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +26 -6
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -36,6 +36,7 @@ amaster logout
|
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
38
|
amaster addon search crm
|
|
39
|
+
amaster addon search crm --target /path/to/app
|
|
39
40
|
amaster addon view crm-pages
|
|
40
41
|
amaster addon view crm-pages@1.0.0
|
|
41
42
|
amaster addon versions crm-pages
|
|
@@ -72,9 +73,9 @@ marketplace/screenshots/preview.png
|
|
|
72
73
|
}
|
|
73
74
|
```
|
|
74
75
|
|
|
75
|
-
|
|
76
|
+
这些 `marketplace/` 文件只用于发布到 Addon Marketplace,不会被 `addon install` 安装到应用工程。需要随 Addon 安装到应用工程并被代码引用的运行素材,应声明为 `assets` member。
|
|
76
77
|
|
|
77
|
-
`addon search` 在未显式传 `--application-type`
|
|
78
|
+
`addon search` 在未显式传 `--application-type` 时,会从 `--target` 指定目录或当前目录向上查找最近的 `package.json`,读取同级 `app.settings.yml` 的 `type`,并自动按 `web` 或 `mini` 过滤。`addon search --target` 只用于推断应用类型,不会修改目标应用。
|
|
78
79
|
`addon search --json` 返回面向 MCP/AI 的轻量结果,只包含 `name`、`version`、`installSpecifier`、标题、描述、类目、适用类型、阶段、成员类型和主图地址。
|
|
79
80
|
|
|
80
81
|
常用参数:
|
|
@@ -97,6 +98,7 @@ marketplace/screenshots/preview.png
|
|
|
97
98
|
- `bpmn`
|
|
98
99
|
- `entity`
|
|
99
100
|
- `datasource`
|
|
101
|
+
- `assets`
|
|
100
102
|
- `settings`
|
|
101
103
|
|
|
102
104
|
`skill` member 可以发布到 Marketplace,供 Agent 通过 Server API 下载并安装到自己的 skill cache;普通设计态 `addon install` 不会把 `skill` 写入应用工程。Skill member 的 `source.path` 必须指向一个目录,目录内必须包含带 `name` 和 `description` frontmatter 的 `SKILL.md`,可选包含 `references/`、`assets/` 和 `scripts/`。如果存在 `scripts/`,必须提供 `scripts/scripts.json` 声明可执行入口的名称、路径、用途和确认策略;脚本依赖的辅助文件可放在 `scripts/` 下,不需要逐个声明为入口。
|
|
@@ -105,6 +107,7 @@ marketplace/screenshots/preview.png
|
|
|
105
107
|
|
|
106
108
|
- `src/addons/<addon-name>/meta.json`
|
|
107
109
|
- `settings` 成员会深合并到应用根目录 `app.settings.yml`
|
|
110
|
+
- `assets` 成员会复制到 `src/assets/<addon-name>`;组件或页面可用 `@/assets/<addon-name>/...` 静态导入这些图片、JSON、字体或其他前端运行素材
|
|
108
111
|
|
|
109
112
|
Addon 可在 `addon.json` 中声明安装后的运行配置要求:
|
|
110
113
|
|
package/dist/cli.cjs
CHANGED
|
@@ -612,7 +612,7 @@ function validateAddonManifest(manifest) {
|
|
|
612
612
|
validateInstallNpm(manifest);
|
|
613
613
|
}
|
|
614
614
|
function validateMembers(manifest) {
|
|
615
|
-
const allowedTypes = /* @__PURE__ */ new Set(["component", "page", "function", "skill", "theme", "settings", "workflow", "bpmn", "entity", "datasource"]);
|
|
615
|
+
const allowedTypes = /* @__PURE__ */ new Set(["component", "page", "function", "skill", "theme", "settings", "workflow", "bpmn", "entity", "datasource", "assets"]);
|
|
616
616
|
for (const member of manifest.members) {
|
|
617
617
|
if (!member.name || typeof member.name !== "string") {
|
|
618
618
|
throw new Error("addon.json member missing name");
|
|
@@ -1190,6 +1190,9 @@ function toImportSpecifier(targetPath) {
|
|
|
1190
1190
|
const normalized = targetPath.replace(/\\/g, "/").replace(/^src\//, "@/");
|
|
1191
1191
|
return removePathExtension(normalized).replace(/\/index$/, "");
|
|
1192
1192
|
}
|
|
1193
|
+
function toAssetImportSpecifier(targetPath) {
|
|
1194
|
+
return targetPath.replace(/\\/g, "/").replace(/^src\//, "@/");
|
|
1195
|
+
}
|
|
1193
1196
|
function resolveInstalledAddonDisplay(meta) {
|
|
1194
1197
|
const legacyMeta = meta;
|
|
1195
1198
|
return {
|
|
@@ -1201,6 +1204,7 @@ function buildAddonLlmGuidance(input) {
|
|
|
1201
1204
|
const pageMembers = input.meta.members.filter((member) => member.type === "page");
|
|
1202
1205
|
const componentMembers = input.meta.members.filter((member) => member.type === "component");
|
|
1203
1206
|
const functionMembers = input.meta.members.filter((member) => member.type === "function");
|
|
1207
|
+
const assetMembers = input.meta.members.filter((member) => member.type === "assets");
|
|
1204
1208
|
const settingsMembers = input.meta.members.filter((member) => member.type === "settings");
|
|
1205
1209
|
const webRoutes = input.meta.members.filter((member) => member.type === "page" && member.page?.web).map((member) => ({
|
|
1206
1210
|
route: member.page.web.route,
|
|
@@ -1222,6 +1226,11 @@ function buildAddonLlmGuidance(input) {
|
|
|
1222
1226
|
name: member.name,
|
|
1223
1227
|
targetPaths: member.targetPaths
|
|
1224
1228
|
}));
|
|
1229
|
+
const assets = assetMembers.map((member) => ({
|
|
1230
|
+
name: member.name,
|
|
1231
|
+
targetPaths: member.targetPaths,
|
|
1232
|
+
importFrom: member.targetPaths[0] ? toAssetImportSpecifier(member.targetPaths[0]) : void 0
|
|
1233
|
+
}));
|
|
1225
1234
|
const settings = settingsMembers.map((member) => ({
|
|
1226
1235
|
targetPath: member.settings?.targetPath || member.targetPaths[0] || "",
|
|
1227
1236
|
paths: member.settings?.paths.map((item) => item.path) || []
|
|
@@ -1240,6 +1249,9 @@ function buildAddonLlmGuidance(input) {
|
|
|
1240
1249
|
if (functionMembers.length > 0) {
|
|
1241
1250
|
instructions.push("Use installed function members by invoking their function names from the host application.");
|
|
1242
1251
|
}
|
|
1252
|
+
if (assetMembers.length > 0) {
|
|
1253
|
+
instructions.push("Import installed asset members from their @/assets paths instead of hardcoding external URLs.");
|
|
1254
|
+
}
|
|
1243
1255
|
if (hasInstallRequirements(input.requirements)) {
|
|
1244
1256
|
instructions.push(
|
|
1245
1257
|
"Configure the declared env/secret requirements before running or deploying the application. Use the app_secret_env tool instead of writing secret values into source files or .env examples."
|
|
@@ -1256,6 +1268,7 @@ function buildAddonLlmGuidance(input) {
|
|
|
1256
1268
|
miniPages: miniPages.length ? miniPages : void 0,
|
|
1257
1269
|
components: components.length ? components : void 0,
|
|
1258
1270
|
functions: functions.length ? functions : void 0,
|
|
1271
|
+
assets: assets.length ? assets : void 0,
|
|
1259
1272
|
settings: settings.length ? settings : void 0,
|
|
1260
1273
|
requirements: hasInstallRequirements(input.requirements) ? input.requirements : void 0,
|
|
1261
1274
|
npm: hasNpmDependencies(input.npm) ? input.npm : void 0
|
|
@@ -1372,12 +1385,12 @@ async function collectDirectoryFiles(sourceDir) {
|
|
|
1372
1385
|
}
|
|
1373
1386
|
return files.sort();
|
|
1374
1387
|
}
|
|
1375
|
-
async function planCopyMember(sourceRoot, sourceRelativePath, targetBaseRelativeDir, member, targetRelativePath) {
|
|
1388
|
+
async function planCopyMember(sourceRoot, sourceRelativePath, targetBaseRelativeDir, member, targetRelativePath, defaultTargetRelativePath) {
|
|
1376
1389
|
const sourceAbsolutePath = path.join(sourceRoot, sourceRelativePath);
|
|
1377
1390
|
const sourceStat = await promises$1.stat(sourceAbsolutePath);
|
|
1378
1391
|
const plannedFiles = [];
|
|
1379
1392
|
const targetPaths = [];
|
|
1380
|
-
const defaultTargetPath = path.join(targetBaseRelativeDir, path.basename(sourceRelativePath)).replace(/\\/g, "/");
|
|
1393
|
+
const defaultTargetPath = defaultTargetRelativePath ?? path.join(targetBaseRelativeDir, path.basename(sourceRelativePath)).replace(/\\/g, "/");
|
|
1381
1394
|
const memberTargetPath = targetRelativePath ?? defaultTargetPath;
|
|
1382
1395
|
if (sourceStat.isDirectory()) {
|
|
1383
1396
|
const sourceFiles = await collectDirectoryFiles(sourceAbsolutePath);
|
|
@@ -1461,6 +1474,9 @@ async function buildInstallPlan(options) {
|
|
|
1461
1474
|
case "theme":
|
|
1462
1475
|
targetBaseRelativeDir = path.join("src", "assets", manifest.name);
|
|
1463
1476
|
break;
|
|
1477
|
+
case "assets":
|
|
1478
|
+
targetBaseRelativeDir = path.join("src", "assets", manifest.name);
|
|
1479
|
+
break;
|
|
1464
1480
|
case "workflow":
|
|
1465
1481
|
targetBaseRelativeDir = path.join("src", "workflow");
|
|
1466
1482
|
break;
|
|
@@ -1480,6 +1496,9 @@ async function buildInstallPlan(options) {
|
|
|
1480
1496
|
throw new Error(`Unsupported addon member type: ${member.type}`);
|
|
1481
1497
|
}
|
|
1482
1498
|
const targetRelativePath = resolveMemberTargetPath(member);
|
|
1499
|
+
const sourceAbsolutePath = path.join(options.extractedDir, sourceRelativePath);
|
|
1500
|
+
const sourceStat = await promises$1.stat(sourceAbsolutePath);
|
|
1501
|
+
const defaultTargetPath = member.type === "assets" && sourceStat.isDirectory() ? targetBaseRelativeDir.replace(/\\/g, "/") : path.join(targetBaseRelativeDir, path.basename(sourceRelativePath)).replace(/\\/g, "/");
|
|
1483
1502
|
if (targetRelativePath && !isSameOrInsidePath(targetRelativePath, targetBaseRelativeDir)) {
|
|
1484
1503
|
throw new Error(
|
|
1485
1504
|
`Member ${member.name} target.path must stay inside ${targetBaseRelativeDir}: ${targetRelativePath}`
|
|
@@ -1490,7 +1509,8 @@ async function buildInstallPlan(options) {
|
|
|
1490
1509
|
sourceRelativePath,
|
|
1491
1510
|
targetBaseRelativeDir,
|
|
1492
1511
|
member,
|
|
1493
|
-
targetRelativePath
|
|
1512
|
+
targetRelativePath,
|
|
1513
|
+
defaultTargetPath
|
|
1494
1514
|
);
|
|
1495
1515
|
files.push(...planned.files);
|
|
1496
1516
|
const installedMember = {
|
|
@@ -3924,9 +3944,9 @@ addJsonOption(addRegistryOption(program.command("whoami").description("Show the
|
|
|
3924
3944
|
}
|
|
3925
3945
|
);
|
|
3926
3946
|
var addon = program.command("addon").description("Addon marketplace commands");
|
|
3927
|
-
addJsonOption(addOrganizationOption(addRegistryOption(addon.command("search [query]").description("Search addons")))).option("--application-type <type>", "Application type").option("--phase <phase>", "Phase filter").option("--member-type <type>", "Member type filter").option("--scope <scope>", "Scope filter").option("--page <page>", "Page number", (value) => Number.parseInt(value, 10)).option("--page-size <pageSize>", "Page size", (value) => Number.parseInt(value, 10)).action(async (query, options) => {
|
|
3947
|
+
addJsonOption(addOrganizationOption(addRegistryOption(addon.command("search [query]").description("Search addons")))).option("--target <path>", "Application root directory used to detect application type").option("--application-type <type>", "Application type").option("--phase <phase>", "Phase filter").option("--member-type <type>", "Member type filter").option("--scope <scope>", "Scope filter").option("--page <page>", "Page number", (value) => Number.parseInt(value, 10)).option("--page-size <pageSize>", "Page size", (value) => Number.parseInt(value, 10)).action(async (query, options) => {
|
|
3928
3948
|
const registry = resolveRegistryFromOptions(options);
|
|
3929
|
-
const applicationType = options.applicationType ?? await tryDetectNearestApplicationType();
|
|
3949
|
+
const applicationType = options.applicationType ?? await tryDetectNearestApplicationType(options.target);
|
|
3930
3950
|
const result = await searchAddons(registry, {
|
|
3931
3951
|
query,
|
|
3932
3952
|
applicationType,
|