openclawmp 1.0.1 → 1.0.3

package/README.md

@@ -2,7 +2,7 @@
 
 **OpenClaw Marketplace CLI** — 水产市场命令行工具
 
-A command-line client for the [OpenClaw Marketplace](https://openclawmp.cc), allowing you to search, install, publish, and manage agent assets (skills, plugins, triggers, channels, and more).
+A command-line client for the [OpenClaw Marketplace](https://openclawmp.stepfun.com), allowing you to search, install, publish, and manage agent assets (skills, plugins, triggers, channels, and more).
 
 ## 安装
 
@@ -21,15 +21,15 @@ openclawmp oauth <your-token>
 # 搜索市场资产
 openclawmp search 天气
 
+# 搜索用户
+openclawmp users 张三
+
 # 根据 assetId 查看资产详情
 openclawmp info 6c476a36955a4270a3fa303beeeed5ee
 
 # 安装资产
 openclawmp install skill/7c19dc4c3244418096f1dcb59c93f795
 
-# 安装指定版本
-openclawmp install skill/7c19dc4c3244418096f1dcb59c93f795@1.0.3
-
 # 列出本地已安装资产
 openclawmp list
 
@@ -43,6 +43,7 @@ openclawmp publish ./my-asset --yes
 ## 功能概览
 
 - `search`：搜索市场资产，按类型、作者、安装量、标签和简介格式化输出。
+- `users`：搜索用户，默认展示前 10 条，并显示总结果数与下一页游标。
 - `oauth`：将 token 写入本地凭证文件。
 - `info`：根据 `assetId` 查看资产详情与版本信息。
 - `install`：根据 `assetId` 和可选 `semver` 下载归档并安装到本地 OpenClaw 目录。
@@ -106,12 +107,12 @@ cat .metadata.json
 
 ```json
 {
-  "assetType": "skill",
-  "name": "my-skill",
-  "displayName": "My Skill",
-  "semver": "1.0.0",
-  "category": "productivity",
-  "tags": ["agent", "automation"]
+    "assetType": "skill",
+    "name": "my-skill",
+    "displayName": "My Skill",
+    "semver": "1.0.0",
+    "category": "productivity",
+    "tags": ["agent", "automation"]
 }
 ```
 
@@ -157,6 +158,7 @@ openclawmp uninstall skill/demo-skill
 
 ```bash
 openclawmp search 天气 --page-size 10
+openclawmp users openclawmp.cc
 ```
 
 ## 命令结构
@@ -166,12 +168,13 @@ openclawmp search 天气 --page-size 10
 - `publish`
 - `oauth`
 - `search`
+- `users`
 - `info`
 - `install`
 - `uninstall`
 - `list`
 
-其中当前可用的是 `publish`、`oauth`、`search`、`info`、`install`、`uninstall`、`list`。
+其中当前可用的是 `publish`、`oauth`、`search`、`users`、`info`、`install`、`uninstall`、`list`。
 
 ## 发布命令参数
 
@@ -184,33 +187,3 @@ openclawmp search 天气 --page-size 10
 - `--dry-run`
 - `--yes, -y`
 - `--verbose`
-
-## 目录发布打包规则
-
-- 目录发布会默认跳过 `.git`、`node_modules`、`__MACOSX`、`.DS_Store`、`Thumbs.db`
-- 根目录可通过 `.openclawmpignore` 补充忽略规则，也会读取根目录 `.gitignore` / `.npmignore` 的常见规则
-- 子路径遇到无权限读取的目录或文件时会自动跳过；使用 `--verbose` 可查看具体跳过项
-
-## Publish Metadata
-
-- `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` 由上传完成后自动生成，登录态始终必需
-- 发布流程不再打印请求预览或请求头明细；终端仅显示操作类型与 request-id
-
-## 默认配置来源
-
-`baseUrl` 优先级：
-
-1. `--base-url`
-2. `OPENCLAWMP_API_BASE_URL`
-3. `OPENCLAWMP_BASE_URL`
-4. `API_BASE_URL`
-5. `NEXT_PUBLIC_API_BASE_URL`
-6. 仓库根目录 `.env.local` / `.env` / `.env.prod`
-7. `https://seafood.c.stepfun-inc.net`

package/bin/openclawmp.js

@@ -24,6 +24,9 @@ const COMMAND_LOADERS = {
   search: function loadSearch() {
     return require("../lib/commands/search");
   },
+  users: function loadUsers() {
+    return require("../lib/commands/users");
+  },
   info: function loadInfo() {
     return require("../lib/commands/info");
   },

package/lib/api.js

@@ -10,6 +10,7 @@ const {
 } = require("./utils");
 
 const CATALOG_SERVICE = "step.seafood.catalog.CatalogService";
+const IDENTITY_SERVICE = "step.seafood.identity.IdentityService";
 
 class ApiError extends Error {
   constructor(message, details) {
@@ -79,14 +80,68 @@ function detectTokenPrefix(token) {
   return text;
 }
 
+function stringifyVerboseValue(value) {
+  if (value === undefined) {
+    return "";
+  }
+
+  if (typeof value === "string") {
+    const text = value.trim();
+    if (!text) {
+      return "\"\"";
+    }
+
+    if (text.startsWith("{") || text.startsWith("[") || text === "null") {
+      try {
+        return JSON.stringify(JSON.parse(text), null, 2);
+      } catch {
+        return value;
+      }
+    }
+
+    return value;
+  }
+
+  try {
+    const serialized = JSON.stringify(value, jsonReplacer, 2);
+    if (serialized !== undefined) {
+      return serialized;
+    }
+  } catch {
+    return String(value);
+  }
+
+  return String(value);
+}
+
+function printVerboseValue(label, value, writer) {
+  const serialized = stringifyVerboseValue(value);
+  if (!serialized) {
+    return;
+  }
+
+  const output = typeof writer === "function" ? writer : console.log;
+  const lines = serialized.split("\n");
+  if (lines.length === 1) {
+    output("  " + label + ": " + lines[0]);
+    return;
+  }
+
+  output("  " + label + ":");
+  lines.forEach(function eachLine(line) {
+    output("    " + line);
+  });
+}
 
 function createCatalogClient(options) {
   const defaultRequestId = normalizeRequestId(options.requestId) || generateRequestId();
+  const verbose = Boolean(options.verbose);
 
-  async function unary(methodName, body, extra) {
+  async function unaryForService(serviceName, methodName, body, extra) {
     const requestId = normalizeRequestId((extra && extra.requestId) || defaultRequestId);
     const operationName = humanizeApiMethodName(methodName) || methodName || "接口调用";
-    const requestUrl = String(buildServiceUrl(options.baseUrl, CATALOG_SERVICE, methodName));
+    const requestUrl = String(buildServiceUrl(options.baseUrl, serviceName, methodName));
+    const requestBody = JSON.stringify(body || {}, jsonReplacer);
     const headers = {
       "Connect-Protocol-Version": "1",
       "Content-Type": "application/json",
@@ -107,13 +162,17 @@ function createCatalogClient(options) {
     printTerminalOperationNotice(operationName, [
       requestId ? "request-id: " + requestId : ""
     ]);
+    if (verbose) {
+      printVerboseValue("请求地址", requestUrl);
+      printVerboseValue("入参", requestBody);
+    }
 
     let response;
     try {
       response = await fetch(requestUrl, {
         method: "POST",
         headers,
-        body: JSON.stringify(body || {}, jsonReplacer)
+        body: requestBody
       });
     } catch (error) {
       printTerminalOperationFailure(operationName, [
@@ -149,6 +208,9 @@ function createCatalogClient(options) {
         responseRequestId ? "request-id: " + responseRequestId : "",
         message
       ]);
+      if (verbose) {
+        printVerboseValue("接口返回", payload, console.error);
+      }
       throw new ApiError(message, {
         status: response.status,
         code: payload && payload.code,
@@ -162,6 +224,9 @@ function createCatalogClient(options) {
       "HTTP " + response.status,
       responseRequestId ? "request-id: " + responseRequestId : ""
     ]);
+    if (verbose) {
+      printVerboseValue("接口返回", payload);
+    }
 
     return {
       data: payload || {},
@@ -169,10 +234,17 @@ function createCatalogClient(options) {
     };
   }
 
+  async function unary(methodName, body, extra) {
+    return unaryForService(CATALOG_SERVICE, methodName, body, extra);
+  }
+
   return {
     searchAssets: function searchAssets(body, extra) {
       return unary("SearchAssets", body, extra);
     },
+    searchUsers: function searchUsers(body, extra) {
+      return unaryForService(IDENTITY_SERVICE, "SearchUsers", body, extra);
+    },
     listUserAssets: function listUserAssets(body, extra) {
       return unary("ListUserAssets", body, extra);
     },

package/lib/commands/help.js

@@ -19,6 +19,9 @@ const COMMAND_LOADERS = {
   search: function loadSearch() {
     return require("./search");
   },
+  users: function loadUsers() {
+    return require("./users");
+  },
   info: function loadInfo() {
     return require("./info");
   },

package/lib/commands/info.js

@@ -196,7 +196,8 @@ async function run(context) {
   const client = createCatalogClient({
     baseUrl: resolveConnectBaseUrl(parsed.options["base-url"]),
     cliVersion: context.cliVersion,
-    requestId
+    requestId,
+    verbose: Boolean(parsed.options.verbose)
   });
 
   const assetResponse = await client.getAsset({

package/lib/commands/install.js

@@ -246,7 +246,8 @@ async function run(context) {
     baseUrl: resolveConnectBaseUrl(parsed.options["base-url"]),
     token: loadedCredentials.credentials.token,
     cliVersion: context.cliVersion,
-    requestId
+    requestId,
+    verbose: Boolean(parsed.options.verbose)
   });
 
   if (parsed.options.verbose) {

package/lib/commands/search.js

@@ -138,6 +138,9 @@ function printSearchResult(item, index) {
   if (item.latestSemver) {
     console.log("   版本: " + item.latestSemver);
   }
+  if (item.assetId) {
+    console.log("   资产ID: " + item.assetId);
+  }
   if (item.name && item.name !== title) {
     console.log("   标识: " + item.name);
   }
@@ -167,7 +170,8 @@ async function run(context) {
   const client = createCatalogClient({
     baseUrl: resolveConnectBaseUrl(parsed.options["base-url"]),
     cliVersion: context.cliVersion,
-    requestId
+    requestId,
+    verbose: Boolean(parsed.options.verbose)
   });
 
   const response = await client.searchAssets({

package/lib/commands/users.js

@@ -0,0 +1,247 @@
+"use strict";
+
+const { parseOptions } = require("../cli-parser");
+const { createCatalogClient } = require("../api");
+const { CLI_NAME } = require("../cli-text");
+const { resolveApiBaseUrl, resolveConnectBaseUrl } = require("../config");
+const { generateRequestId } = require("../utils");
+
+const DEFAULT_PAGE_SIZE = 10;
+const DEFAULT_SORT_BY = "SEARCH_USERS_SORT_BY_BEST_MATCH";
+
+function printHelp() {
+  console.log(CLI_NAME + " users");
+  console.log("");
+  console.log("用法:");
+  console.log("  " + CLI_NAME + " users <keyword> [options]");
+  console.log("");
+  console.log("参数:");
+  console.log("  --page-size <number>       每页条数，默认 10");
+  console.log("  --page-token <token>       分页游标");
+  console.log("  --request-id <id>          手动指定 X-Request-ID");
+  console.log("  --verbose                  输出更多上下文");
+  console.log("  -h, --help                 查看帮助");
+  console.log("");
+  console.log("示例:");
+  console.log("  " + CLI_NAME + " users openclawmp.cc");
+  console.log("  " + CLI_NAME + " users 窦窦 --page-size 20");
+}
+
+function pickFirstText(values) {
+  return values.find(function findValue(value) {
+    return typeof value === "string" && value.trim();
+  }) || "";
+}
+
+function pickFirstScalar(values) {
+  return values.find(function findValue(value) {
+    if (typeof value === "string") {
+      return value.trim();
+    }
+    return typeof value === "number" && Number.isFinite(value);
+  });
+}
+
+function normalizePageSize(value) {
+  if (value === undefined) {
+    return DEFAULT_PAGE_SIZE;
+  }
+
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new Error("--page-size 需要是大于 0 的整数");
+  }
+
+  return value;
+}
+
+function formatCount(value) {
+  const numeric = Number(value);
+  if (Number.isFinite(numeric)) {
+    return numeric.toLocaleString("zh-CN");
+  }
+  return String(value || "0");
+}
+
+function resolveItems(data) {
+  if (Array.isArray(data.items)) {
+    return data.items;
+  }
+  if (Array.isArray(data.users)) {
+    return data.users;
+  }
+  return [];
+}
+
+function resolveTotalSize(data, items) {
+  const total = pickFirstScalar([
+    data.totalSize,
+    data.total_size,
+    data.totalCount,
+    data.total_count,
+    data.total,
+    data.count
+  ]);
+  if (total !== undefined) {
+    return String(total);
+  }
+  return String(items.length);
+}
+
+function resolveNextPageToken(data) {
+  return pickFirstText([data.nextPageToken, data.next_page_token]);
+}
+
+function resolveUser(item) {
+  if (!item || typeof item !== "object") {
+    return {};
+  }
+  if (item.user && typeof item.user === "object") {
+    return item.user;
+  }
+  if (item.profile && typeof item.profile === "object") {
+    return item.profile;
+  }
+  return item;
+}
+
+function resolveDisplayName(user) {
+  return pickFirstText([
+    user.displayName,
+    user.name,
+    user.nickname,
+    user.userId
+  ]) || "(未命名用户)";
+}
+
+function formatDescription(user) {
+  const raw = pickFirstText([
+    user.introduction,
+    user.description,
+    user.bio,
+    user.summary
+  ]);
+  const singleLine = raw.replace(/\s+/g, " ").trim();
+  if (!singleLine) {
+    return "(无描述)";
+  }
+  if (singleLine.length <= 120) {
+    return singleLine;
+  }
+  return singleLine.slice(0, 117) + "...";
+}
+
+function buildHomepageUrl(user, siteBaseUrl) {
+  const explicitUrl = pickFirstText([
+    user.homepageUrl,
+    user.homePageUrl,
+    user.profileUrl,
+    user.publicProfileUrl,
+    user.url,
+    user.link
+  ]);
+  if (explicitUrl) {
+    return String(new URL(explicitUrl, String(siteBaseUrl).replace(/\/+$/u, "") + "/"));
+  }
+
+  const userId = pickFirstText([user.userId, user.uid, user.id]);
+  if (!userId) {
+    return "(无主页链接)";
+  }
+
+  return String(siteBaseUrl).replace(/\/+$/u, "") + "/user/" + encodeURIComponent(userId);
+}
+
+function printUserSearchResult(item, index, siteBaseUrl) {
+  const user = resolveUser(item);
+
+  console.log(index + ". " + resolveDisplayName(user));
+  console.log("   描述: " + formatDescription(user));
+  console.log("   主页: " + buildHomepageUrl(user, siteBaseUrl));
+}
+
+async function run(context) {
+  const parsed = parseOptions(context.argv, {
+    "page-size": { type: "number" },
+    "page-token": { type: "string" },
+    "request-id": { type: "string" },
+    verbose: { type: "boolean" }
+  });
+
+  const query = parsed.positionals.join(" ").trim();
+  if (!query) {
+    throw new Error("users 命令缺少关键词");
+  }
+
+  const pageSize = normalizePageSize(parsed.options["page-size"]);
+  const requestId = parsed.options["request-id"] || generateRequestId();
+  const apiBaseUrl = resolveApiBaseUrl();
+  const client = createCatalogClient({
+    baseUrl: resolveConnectBaseUrl(),
+    cliVersion: context.cliVersion,
+    requestId,
+    verbose: Boolean(parsed.options.verbose)
+  });
+
+  const response = await client.searchUsers({
+    query,
+    sortBy: DEFAULT_SORT_BY,
+    pageSize,
+    pageToken: parsed.options["page-token"] || ""
+  });
+
+  const items = resolveItems(response.data);
+  const totalSize = resolveTotalSize(response.data, items);
+  const nextPageToken = resolveNextPageToken(response.data);
+
+  if (parsed.options.verbose) {
+    console.log("request-id: " + response.requestId);
+  }
+
+  if (items.length === 0) {
+    if (Number(totalSize) > 0) {
+      console.log("当前页没有可展示的用户结果。");
+    } else {
+      console.log("没有找到与 \"" + query + "\" 相关的用户。");
+    }
+    console.log("总结果数: " + formatCount(totalSize));
+
+    return {
+      items: [],
+      nextPageToken,
+      totalSize
+    };
+  }
+
+  console.log("用户搜索结果：共 " + formatCount(totalSize) + " 项，本页 " + items.length + " 项");
+  console.log("");
+
+  items.forEach(function eachItem(item, index) {
+    printUserSearchResult(item, index + 1, apiBaseUrl);
+    if (index < items.length - 1) {
+      console.log("");
+    }
+  });
+
+  if (nextPageToken) {
+    let nextPageCommand = "  " + CLI_NAME + " users " + JSON.stringify(query);
+    if (pageSize !== DEFAULT_PAGE_SIZE) {
+      nextPageCommand += " --page-size " + pageSize;
+    }
+    nextPageCommand += " --page-token " + nextPageToken;
+
+    console.log("");
+    console.log("下一页:");
+    console.log(nextPageCommand);
+  }
+
+  return {
+    items,
+    nextPageToken,
+    totalSize
+  };
+}
+
+module.exports = {
+  printHelp,
+  run
+};

package/lib/config.js

@@ -5,7 +5,7 @@ const path = require("node:path");
 const os = require("node:os");
 
 // const DEFAULT_API_BASE_URL = "https://seafood.c.stepfun-inc.net";
-const DEFAULT_API_BASE_URL = "https://openclawmp.stepfun.com";
+const DEFAULT_API_BASE_URL = "https://openclawmp.stepfun.com/";
 
 const projectRoot = path.resolve(__dirname, "..");
 const repoRoot = path.resolve(projectRoot, "..");

package/lib/help.js

@@ -28,6 +28,11 @@ const COMMAND_SECTIONS = [
     description: "搜索市场资产",
     usage: CLI_NAME + " search <query> [options]"
   },
+  {
+    name: "users",
+    description: "搜索用户",
+    usage: CLI_NAME + " users <keyword> [options]"
+  },
   {
     name: "info",
     description: "查看某个资产的详细信息",
@@ -76,6 +81,7 @@ function printGlobalHelp() {
   console.log("  " + CLI_NAME + " oauth <your-token>");
   console.log("  " + CLI_NAME + " publish ./my-asset --yes");
   console.log("  " + CLI_NAME + " search 天气");
+  console.log("  " + CLI_NAME + " users openclawmp.cc");
   console.log("  " + CLI_NAME + " info 6c476a36955a4270a3fa303beeeed5ee");
   console.log("  " + buildInstallCommand("skill", "7c19dc4c3244418096f1dcb59c93f795"));
   console.log("  " + buildInstallCommand("skill", "7c19dc4c3244418096f1dcb59c93f795", "1.0.3"));

package/lib/publish-flow.js

@@ -211,7 +211,8 @@ async function publishAsset(options) {
       baseUrl: connectBaseUrl,
       token: loadedCredentials.credentials.token,
       cliVersion: options.cliVersion,
-      requestId: options.requestId
+      requestId: options.requestId,
+      verbose: Boolean(options.verbose)
     });
 
     if (options.verbose) {
@@ -331,7 +332,8 @@ async function publishAsset(options) {
           baseUrl: resolveConnectBaseUrl(options.baseUrl),
           token: loadedCredentials.credentials.token,
           cliVersion: options.cliVersion,
-          requestId: options.requestId
+          requestId: options.requestId,
+          verbose: Boolean(options.verbose)
         });
         const abortUploadRequest = { uploadId };
         await client.abortUpload(abortUploadRequest);

package/lib/utils.js

@@ -197,6 +197,8 @@ function humanizeApiMethodName(methodName) {
       return "取消上传任务";
     case "SearchAssets":
       return "搜索资产";
+    case "SearchUsers":
+      return "搜索用户";
     case "ListUserAssets":
       return "查询用户资产";
     case "GetAsset":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclawmp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "OpenClaw Marketplace CLI client",
   "bin": {
     "openclawmp": "bin/openclawmp.js"
@@ -15,7 +15,8 @@
   },
   "scripts": {
     "start": "node bin/openclawmp.js",
-    "publish:dry-run": "node bin/openclawmp.js publish . --dry-run"
+    "publish:dry-run": "node bin/openclawmp.js publish . --dry-run",
+    "pack:local": "npm pack"
   },
   "directories": {
     "lib": "lib",