openclawmp 1.0.0-alpha.0 → 1.0.0-alpha.1

package/README.md

@@ -18,8 +18,8 @@ npm install -g openclawmp
 # 搜索市场资产
 openclawmp search 天气
 
-# 查看资产详情
-openclawmp info 7c19dc4c3244418096f1dcb59c93f795
+# 根据 assetId 查看资产详情
+openclawmp info 6c476a36955a4270a3fa303beeeed5ee
 
 # 安装资产
 openclawmp install skill/7c19dc4c3244418096f1dcb59c93f795
@@ -34,13 +34,13 @@ openclawmp list
 openclawmp uninstall skill/demo-skill
 
 # 发布本地资产
-openclawmp publish ./my-skill --type skill --version 1.0.0 --yes
+openclawmp publish ./my-asset --yes
 ```
 
 ## 功能概览
 
 - `search`：搜索市场资产，按类型、作者、安装量、标签和简介格式化输出。
-- `info`：查看资产详情与版本信息。
+- `info`：根据 `assetId` 查看资产详情与版本信息。
 - `install`：根据 `assetId` 和可选 `semver` 下载归档并安装到本地 OpenClaw 目录。
 - `uninstall`：删除本地安装目录，并清理对应锁文件记录。
 - `list`：扫描本地已安装资产，结合 lockfile 和安装元数据展示结果。
@@ -90,18 +90,34 @@ openclawmp publish /path/to/asset
 示例：
 
 ```bash
-openclawmp publish ./my-skill \
-  --type skill \
-  --category productivity \
-  --tags agent,automation \
-  --version 1.0.0 \
-  --yes
+cat .metadata.json
+```
+
+```json
+{
+  "assetType": "skill",
+  "name": "my-skill",
+  "displayName": "My Skill",
+  "semver": "1.0.0",
+  "category": "productivity",
+  "tags": ["agent", "automation"]
+}
+```
+
+```bash
+openclawmp publish ./my-skill --yes
+```
+
+查看资产详情：
+
+```bash
+openclawmp info 6c476a36955a4270a3fa303beeeed5ee
 ```
 
 更新已有资产版本：
 
 ```bash
-openclawmp publish ./my-skill --version 1.0.1 --yes
+openclawmp publish ./my-skill --asset-id s-123456 --yes
 ```
 
 如果目录根部已存在 `.assetid`，会自动把该值透传为 `assetId`；也可显式传入 `--asset-id <id>`。
@@ -138,24 +154,16 @@ openclawmp search 天气 --page-size 10
 
 - `publish`
 - `search`
+- `info`
 - `install`
 - `uninstall`
 - `list`
 
-其中当前可用的是 `publish`、`search`、`install`、`uninstall`、`list`。
+其中当前可用的是 `publish`、`search`、`info`、`install`、`uninstall`、`list`。
 
 ## 发布命令参数
 
-- `--type <skill|experience|plugin|trigger|channel>`
 - `--asset-id <id>`：未传时会尝试读取目录根部 `.assetid`
-- `--name <slug>`
-- `--display-name <name>`
-- `--description <text>`
-- `--version <semver>`
-- `--category <category>`
-- `--tags <a,b,c>`
-- `--tag <value>`：可重复
-- `--long-description <text>`
 - `--base-url <url>`
 - `--token-file <path>`
 - `--part-size-mb <number>`
@@ -171,16 +179,15 @@ openclawmp search 天气 --page-size 10
 - 根目录可通过 `.openclawmpignore` 补充忽略规则，也会读取根目录 `.gitignore` / `.npmignore` 的常见规则
 - 子路径遇到无权限读取的目录或文件时会自动跳过；使用 `--verbose` 可查看具体跳过项
 
-## Metadata 提取规则
+## Publish Metadata
 
-- 优先级：CLI 显式参数 > `.metadata.json` > `README.md` > `package.json` > `openclaw.plugin.json` > `SKILL.md`
-- `.metadata.json` 存在时会优先使用，适合显式固定 `type`、`name`、`displayName`、`description`、`version`、`category`、`tags`、`longDescription`
-- `SKILL.md` 的 `name`、`display-name`、`description`、`version`、`tags` 只从 frontmatter（`---` 到 `---`）提取，不会把正文内容混进 `description`
-- `README.md` 支持 YAML frontmatter 和前置 `key: value` 形式字段提取 `name`、`display-name`、`description`、`version`、`type`、`category`、`tags`
-- `trigger` / `experience` 会把 README 标题后的第一段作为描述兜底
-- 发布必填规则：`assetType`、`name`、`displayName`、`semver`
-- `version` 必须是严格的 `x.x.x` 形式，例如 `1.2.1`、`1.1.10`
-- `assetId` 为可选字段；有就透传，没有就省略，由后端判断是新建还是已有资产发新版
+- `publish` 只读取发布目录或归档里的 `.metadata.json`
+- `.metadata.json` 必须包含 `assetType`、`name`、`displayName`、`semver`
+- `semver` 必须是严格的 `x.y.z` 纯数字格式，例如 `1.2.3`
+- 可选字段：`assetId`、`category`、`tags`、`description`、`longDescription`
+- 不再从 `README.md`、`package.json`、`openclaw.plugin.json`、`SKILL.md` 自动推断发布 metadata
+- 不再通过 CLI 参数补录 `assetType`、`name`、`displayName`、`semver`
+- `assetId` 可写在 `.metadata.json`，也可以通过 `--asset-id` 或目录根部 `.assetid` 透传
 - `objectId` 由上传完成后自动生成，登录态始终必需
 - 调用发布接口前会打印 `CreateAssetSemver` 请求预览；真正发网请求前会打印对应 request body
 

package/lib/api.js

@@ -115,7 +115,7 @@ function createCatalogClient(options) {
       "Connect-Protocol-Version": "1",
       "Content-Type": "application/json",
       "Accept": "application/json",
-      "User-Agent": "mpdev/" + (options.cliVersion || "dev")
+      "User-Agent": "openclawmp/" + (options.cliVersion || "dev")
     };
 
     if (options.token) {

package/lib/archive.js

@@ -879,7 +879,7 @@ async function preparePackage(inputPath) {
   const inspected = await inspectPublishInput(inputPath);
 
   if (inspected.isDirectory) {
-    const tempDir = await fsp.mkdtemp(path.join(os.tmpdir(), "mpdev-cli-"));
+    const tempDir = await fsp.mkdtemp(path.join(os.tmpdir(), "openclawmp-cli-"));
     const packagePath = path.join(tempDir, inspected.packageFileName);
     await createTarGzFromEntries(inspected.entries, packagePath);
     const packageStat = await fsp.stat(packagePath);

package/lib/cli-text.js

@@ -0,0 +1,34 @@
+"use strict";
+
+const CLI_NAME = "openclawmp";
+
+function buildInstallSpecifier(assetType, assetId, semver) {
+  const normalizedAssetType = String(assetType || "").trim();
+  const normalizedAssetId = String(assetId || "").trim();
+  const normalizedSemver = String(semver || "").trim();
+
+  if (!normalizedAssetType || !normalizedAssetId) {
+    return "";
+  }
+
+  return (
+    normalizedAssetType +
+    "/" +
+    normalizedAssetId +
+    (normalizedSemver ? "@" + normalizedSemver : "")
+  );
+}
+
+function buildInstallCommand(assetType, assetId, semver) {
+  const specifier = buildInstallSpecifier(assetType, assetId, semver);
+  if (!specifier) {
+    return "";
+  }
+  return CLI_NAME + " install " + specifier;
+}
+
+module.exports = {
+  CLI_NAME,
+  buildInstallSpecifier,
+  buildInstallCommand
+};

package/lib/commands/info.js

@@ -1,8 +1,9 @@
 "use strict";
 
 const { parseOptions } = require("../cli-parser");
+const { CLI_NAME } = require("../cli-text");
 const { createCatalogClient } = require("../api");
-const { fromCatalogAssetType, normalizeLocalAssetType, toCatalogAssetType } = require("../asset-types");
+const { fromCatalogAssetType } = require("../asset-types");
 const { resolveConnectBaseUrl } = require("../config");
 const { generateRequestId, humanize } = require("../utils");
 
@@ -15,10 +16,13 @@ const TYPE_ICONS = {
 };
 
 function printHelp() {
-  console.log("mpdev info");
+  console.log(CLI_NAME + " info");
   console.log("");
   console.log("用法:");
-  console.log("  mpdev info <asset-id | type/name | type/@author/name | query> [options]");
+  console.log("  " + CLI_NAME + " info <assetId> [options]");
+  console.log("");
+  console.log("示例:");
+  console.log("  " + CLI_NAME + " info 6c476a36955a4270a3fa303beeeed5ee");
   console.log("");
   console.log("参数:");
   console.log("  --base-url <url>           API 基地址");
@@ -33,57 +37,28 @@ function pickFirstText(values) {
   }) || "";
 }
 
-function normalizeName(input) {
-  return String(input || "")
-    .trim()
-    .toLowerCase()
-    .replace(/\s+/g, " ");
-}
+function parseAssetId(positionals) {
+  const args = Array.isArray(positionals) ? positionals.filter(Boolean) : [];
+  const usageExample = CLI_NAME + " info 6c476a36955a4270a3fa303beeeed5ee";
 
-function parseAssetReference(raw) {
-  const text = String(raw || "").trim();
-  if (!text) {
-    throw new Error("info 命令缺少资产标识");
+  if (args.length === 0) {
+    throw new Error("info 命令缺少 assetId");
   }
 
-  if (/^(?:[a-z]{1,4}-[a-z0-9]+|[a-f0-9]{32})$/iu.test(text)) {
-    return {
-      kind: "assetId",
-      assetId: text
-    };
+  if (args.length !== 1) {
+    throw new Error("info 命令只支持 <assetId> 用法，例如: " + usageExample);
   }
 
-  let match = text.match(/^([^/]+)\/@([^/]+)\/(.+)$/u);
-  if (match) {
-    const assetType = normalizeLocalAssetType(match[1]);
-    if (!assetType) {
-      throw new Error("未知资产类型: " + match[1]);
-    }
-    return {
-      kind: "typedAuthorName",
-      assetType,
-      authorId: match[2],
-      query: match[3].trim()
-    };
+  const assetId = String(args[0] || "").trim();
+  if (!assetId) {
+    throw new Error("info 命令缺少 assetId");
   }
 
-  match = text.match(/^([^/]+)\/(.+)$/u);
-  if (match) {
-    const assetType = normalizeLocalAssetType(match[1]);
-    if (!assetType) {
-      throw new Error("未知资产类型: " + match[1]);
-    }
-    return {
-      kind: "typedName",
-      assetType,
-      query: match[2].trim()
-    };
+  if (/\s/u.test(assetId) || assetId.includes("/")) {
+    throw new Error("info 命令只支持 <assetId> 用法，例如: " + usageExample);
   }
 
-  return {
-    kind: "query",
-    query: text
-  };
+  return assetId;
 }
 
 function formatTypeLabel(assetType) {
@@ -156,100 +131,6 @@ function normalizeTimestamp(value) {
   return "";
 }
 
-async function listAllUserAssets(client, authorId, assetType) {
-  const items = [];
-  let pageToken = "";
-
-  do {
-    const response = await client.listUserAssets({
-      userId: authorId,
-      assetType: toCatalogAssetType(assetType),
-      pageSize: 100,
-      pageToken
-    });
-
-    const pageItems = Array.isArray(response.data.items) ? response.data.items : [];
-    items.push.apply(items, pageItems);
-    pageToken = response.data.nextPageToken || "";
-  } while (pageToken);
-
-  return items;
-}
-
-function buildAmbiguousError(items) {
-  return (
-    "匹配到多个资产，请改用更精确的 assetId 或 type/@author/name。候选项: " +
-    items
-      .map(function mapItem(item) {
-        return (
-          (item.displayName || item.name || item.assetId) +
-          " [" +
-          (item.assetId || "") +
-          "] @" +
-          (item.ownerUserId || "unknown")
-        );
-      })
-      .join(", ")
-  );
-}
-
-function pickAssetFromItems(items, requestedName) {
-  const normalizedRequested = normalizeName(requestedName);
-  const exactMatches = items.filter(function filterItem(item) {
-    return (
-      item &&
-      (normalizeName(item.name) === normalizedRequested ||
-        normalizeName(item.displayName) === normalizedRequested)
-    );
-  });
-
-  if (exactMatches.length === 1) {
-    return exactMatches[0];
-  }
-  if (exactMatches.length > 1) {
-    throw new Error(buildAmbiguousError(exactMatches));
-  }
-
-  const fuzzyMatches = items.filter(function filterItem(item) {
-    return (
-      item &&
-      (normalizeName(item.name).includes(normalizedRequested) ||
-        normalizeName(item.displayName).includes(normalizedRequested))
-    );
-  });
-
-  if (fuzzyMatches.length === 1) {
-    return fuzzyMatches[0];
-  }
-  if (fuzzyMatches.length > 1) {
-    throw new Error(buildAmbiguousError(fuzzyMatches));
-  }
-
-  throw new Error("未找到资产: " + requestedName);
-}
-
-async function resolveAssetSummary(client, reference) {
-  if (reference.kind === "assetId") {
-    return {
-      assetId: reference.assetId
-    };
-  }
-
-  if (reference.kind === "typedAuthorName") {
-    const items = await listAllUserAssets(client, reference.authorId, reference.assetType);
-    return pickAssetFromItems(items, reference.query);
-  }
-
-  const response = await client.searchAssets({
-    query: reference.query,
-    assetType: reference.assetType ? toCatalogAssetType(reference.assetType) : 0,
-    pageSize: 50,
-    pageToken: ""
-  });
-  const items = Array.isArray(response.data.items) ? response.data.items : [];
-  return pickAssetFromItems(items, reference.query);
-}
-
 function printAssetInfo(detail, summary, semvers, verbose) {
   const localAssetType = fromCatalogAssetType(detail.assetType);
   const title = pickFirstText([detail.displayName, detail.name, detail.assetId]) || "(未命名资产)";
@@ -309,10 +190,7 @@ async function run(context) {
     verbose: { type: "boolean" }
   });
 
-  const rawReference = parsed.positionals.join(" ").trim();
-  if (!rawReference) {
-    throw new Error("info 命令缺少资产标识");
-  }
+  const assetId = parseAssetId(parsed.positionals);
 
   const requestId = parsed.options["request-id"] || generateRequestId();
   const client = createCatalogClient({
@@ -321,13 +199,6 @@ async function run(context) {
     requestId
   });
 
-  const reference = parseAssetReference(rawReference);
-  const summary = await resolveAssetSummary(client, reference);
-  const assetId = summary.assetId;
-  if (!assetId) {
-    throw new Error("未能解析 assetId: " + rawReference);
-  }
-
   const assetResponse = await client.getAsset({
     assetId
   });
@@ -340,13 +211,14 @@ async function run(context) {
   const semvers = Array.isArray(semverResponse.data.items)
     ? semverResponse.data.items
     : [];
+  const asset = assetResponse.data || {};
 
-  printAssetInfo(assetResponse.data || {}, summary, semvers, Boolean(parsed.options.verbose));
+  printAssetInfo(asset, asset, semvers, Boolean(parsed.options.verbose));
 
   return {
-    asset: assetResponse.data || {},
+    asset,
     semvers,
-    summary
+    summary: asset
   };
 }
 

package/lib/commands/install.js

@@ -4,8 +4,9 @@ const fs = require("node:fs/promises");
 const os = require("node:os");
 const path = require("node:path");
 
-const { fromCatalogAssetType, normalizeLocalAssetType } = require("../asset-types");
+const { VALID_ASSET_TYPES, fromCatalogAssetType, normalizeLocalAssetType } = require("../asset-types");
 const { parseOptions } = require("../cli-parser");
+const { CLI_NAME, buildInstallCommand } = require("../cli-text");
 const { createCatalogClient } = require("../api");
 const { resolveConnectBaseUrl, getInstallRoot } = require("../config");
 const { loadHubCredentials } = require("../credentials");
@@ -22,21 +23,32 @@ const {
 } = require("../utils");
 
 function printHelp() {
-  console.log("mpdev install");
+  console.log(CLI_NAME + " install");
   console.log("");
   console.log("用法:");
-  console.log("  mpdev install <type>/<assetId>[@<semver>] [options]");
+  console.log("  " + CLI_NAME + " install <type>/<assetId>[@<semver>] [options]");
+  console.log("");
+  console.log("说明:");
+  console.log("  type 支持: " + VALID_ASSET_TYPES.join(", "));
+  console.log("  install 需要本地 token，默认读取 ~/.openclaw/hub-credentials.json");
+  console.log("  可通过 --token-file <path> 指定其他凭证文件");
+  console.log("  默认安装目录:");
+  console.log("    skill -> ~/.openclaw/skills");
+  console.log("    plugin -> ~/.openclaw/extensions");
+  console.log("    channel -> ~/.openclaw/extensions");
+  console.log("    trigger -> ~/.openclaw/triggers");
+  console.log("    experience -> ~/.openclaw/experiences");
   console.log("");
   console.log("示例:");
-  console.log("  mpdev install skill/7c19dc4c3244418096f1dcb59c93f795");
-  console.log("  mpdev install skill/7c19dc4c3244418096f1dcb59c93f795@1.0.3");
+  console.log("  " + buildInstallCommand("skill", "7c19dc4c3244418096f1dcb59c93f795"));
+  console.log("  " + buildInstallCommand("skill", "7c19dc4c3244418096f1dcb59c93f795", "1.0.3"));
   console.log("");
   console.log("参数:");
   console.log("  --version <semver>         安装指定版本（也可写在 <assetId>@<semver>）");
   console.log("  --base-url <url>           API 基地址");
   console.log("  --token-file <path>        本地命令行令牌文件");
   console.log("  --request-id <id>          手动指定 X-Request-ID");
-  console.log("  --target-dir <path>        自定义安装目录");
+  console.log("  --target-dir <path>        自定义安装根目录，最终会安装到 <target-dir>/<asset-name>");
   console.log("  --verbose                  输出更多上下文");
   console.log("  -h, --help                 查看帮助");
 }
@@ -116,6 +128,18 @@ function resolveAssetTypeFromDetail(assetDetail) {
   );
 }
 
+function buildReversionDownloadUrlRequest(assetId, semver) {
+  const request = {
+    assetId
+  };
+
+  if (semver && semver.reversionId) {
+    request.reversionId = semver.reversionId;
+  }
+
+  return request;
+}
+
 async function downloadBuffer(url) {
   printTerminalOperationNotice("下载归档文件", [url]);
 
@@ -252,14 +276,11 @@ async function run(context) {
     assetId: assetDetail.assetId || specifier.assetId,
     latestSemver: assetDetail.latestSemver || ""
   }, requestedVersion);
+  const resolvedAssetId = assetDetail.assetId || specifier.assetId;
 
-  if (!semver.reversionId) {
-    throw new Error("版本缺少 reversionId，无法下载安装");
-  }
-
-  const downloadInfo = await client.getReversionDownloadUrl({
-    reversionId: semver.reversionId
-  });
+  const downloadInfo = await client.getReversionDownloadUrl(
+    buildReversionDownloadUrlRequest(resolvedAssetId, semver)
+  );
 
   const downloadUrl = downloadInfo.data.downloadUrl;
   if (!downloadUrl) {
@@ -267,9 +288,11 @@ async function run(context) {
   }
 
   if (parsed.options.verbose) {
-    console.log("资产ID: " + (assetDetail.assetId || specifier.assetId));
+    console.log("资产ID: " + resolvedAssetId);
     console.log("下载版本: " + semver.semver);
-    console.log("reversionId: " + semver.reversionId);
+    if (semver.reversionId) {
+      console.log("reversionId: " + semver.reversionId);
+    }
     console.log("downloadUrl: " + downloadUrl);
   }
 
@@ -288,7 +311,6 @@ async function run(context) {
   await installDownloadedArchive(downloaded.buffer, targetDir, fileNameHint);
   await writeInstallMetadata(targetDir, assetDetail);
 
-  const resolvedAssetId = assetDetail.assetId || specifier.assetId;
   const lockKey = specifier.assetType + "/" + resolvedAssetId;
   await upsertInstalledAsset({
     key: lockKey,
@@ -311,6 +333,7 @@ async function run(context) {
 }
 
 module.exports = {
+  buildReversionDownloadUrlRequest,
   parseAssetSpecifier,
   printHelp,
   resolveRequestedVersion,

package/lib/commands/list.js

@@ -4,6 +4,7 @@ const fs = require("node:fs/promises");
 const path = require("node:path");
 
 const { parseOptions } = require("../cli-parser");
+const { CLI_NAME } = require("../cli-text");
 const { VALID_ASSET_TYPES, normalizeLocalAssetType } = require("../asset-types");
 const { getInstallRoot } = require("../config");
 const { normalizeInstallMetadata, readInstallMetadata } = require("../install-metadata");
@@ -20,10 +21,10 @@ const TYPE_ICONS = {
 };
 
 function printHelp() {
-  console.log("mpdev list");
+  console.log(CLI_NAME + " list");
   console.log("");
   console.log("用法:");
-  console.log("  mpdev list [options]");
+  console.log("  " + CLI_NAME + " list [options]");
   console.log("");
   console.log("参数:");
   console.log("  --type <type>              skill | experience | plugin | trigger | channel");

package/lib/commands/login.js

@@ -1,14 +1,15 @@
 "use strict";
 
+const { CLI_NAME } = require("../cli-text");
 const { defaultCredentialsPath } = require("../config");
 const { loadHubCredentials } = require("../credentials");
 const { parseOptions } = require("../cli-parser");
 
 function printHelp() {
-  console.log("mpdev login");
+  console.log(CLI_NAME + " login");
   console.log("");
   console.log("用法:");
-  console.log("  mpdev login [options]");
+  console.log("  " + CLI_NAME + " login [options]");
   console.log("");
   console.log("参数:");
   console.log("  --token-file <path>        指定本地凭证文件路径");