openclawmp 1.0.2 → 1.0.3

package/README.md

@@ -21,6 +21,9 @@ openclawmp oauth <your-token>
 # 搜索市场资产
 openclawmp search 天气
 
+# 搜索用户
+openclawmp users 张三
+
 # 根据 assetId 查看资产详情
 openclawmp info 6c476a36955a4270a3fa303beeeed5ee
 
@@ -40,6 +43,7 @@ openclawmp publish ./my-asset --yes
 ## 功能概览
 
 - `search`：搜索市场资产，按类型、作者、安装量、标签和简介格式化输出。
+- `users`：搜索用户，默认展示前 10 条，并显示总结果数与下一页游标。
 - `oauth`：将 token 写入本地凭证文件。
 - `info`：根据 `assetId` 查看资产详情与版本信息。
 - `install`：根据 `assetId` 和可选 `semver` 下载归档并安装到本地 OpenClaw 目录。
@@ -154,6 +158,7 @@ openclawmp uninstall skill/demo-skill
 
 ```bash
 openclawmp search 天气 --page-size 10
+openclawmp users openclawmp.cc
 ```
 
 ## 命令结构
@@ -163,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`。
 
 ## 发布命令参数
 
@@ -181,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` 由上传完成后自动生成，登录态始终必需
-- 默认不打印请求预览或请求头明细；加 `--verbose` 会额外输出接口 URL、入参与返回详情
-
-## 默认配置来源
-
-`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) {
@@ -136,10 +137,10 @@ 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",
@@ -233,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/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/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/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.2",
+  "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",