@amaster.ai/cli 1.1.46 → 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 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
- 这些文件只用于发布到 Addon Marketplace,不会被 `addon install` 安装到应用工程。
76
+ 这些 `marketplace/` 文件只用于发布到 Addon Marketplace,不会被 `addon install` 安装到应用工程。需要随 Addon 安装到应用工程并被代码引用的运行素材,应声明为 `assets` member。
76
77
 
77
- `addon search` 在未显式传 `--application-type` 时,会从当前目录向上查找最近的 `package.json`,读取同级 `app.settings.yml` 的 `type`,并自动按 `web` 或 `mini` 过滤。
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,