openclawmp 1.0.3 → 1.0.4

package/README.md

@@ -147,6 +147,8 @@ openclawmp install skill/7c19dc4c3244418096f1dcb59c93f795
 openclawmp install skill/7c19dc4c3244418096f1dcb59c93f795@1.0.3
 ```
 
+默认安装根会优先跟随当前 OpenClaw/StepClaw state dir（`OPENCLAW_STATE_DIR`、`STEPCLAW_STATE_DIR` 或 `~/.stepclaw/stepclaw-install-state.json`），未检测到 StepClaw 时回退到 `~/.openclaw`。也可通过 `--target-dir <path>` 显式指定安装根。
+
 卸载示例：
 
 ```bash
@@ -187,3 +189,33 @@ openclawmp users openclawmp.cc
 - `--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/lib/commands/install.js

@@ -33,11 +33,12 @@ function printHelp() {
   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("    优先跟随当前 OpenClaw/StepClaw state dir（OPENCLAW_STATE_DIR、STEPCLAW_STATE_DIR 或 ~/.stepclaw）");
+  console.log("    未检测到 StepClaw 时回退到 ~/.openclaw");
+  console.log("    skill -> <state-dir>/skills 或 ~/.openclaw/skills");
+  console.log("    plugin/channel -> <state-dir>/extensions 或 ~/.openclaw/extensions");
+  console.log("    trigger -> <state-dir>/triggers 或 ~/.openclaw/triggers");
+  console.log("    experience -> <state-dir>/experiences 或 ~/.openclaw/experiences");
   console.log("");
   console.log("示例:");
   console.log("  " + buildInstallCommand("skill", "7c19dc4c3244418096f1dcb59c93f795"));

package/lib/config.js

@@ -17,6 +17,12 @@ const INSTALL_ROOT_BY_TYPE = {
     experience: ["experiences"],
     template: ["templates"],
 };
+const OPENCLAWMP_INSTALL_ROOT_ENV = "OPENCLAWMP_INSTALL_ROOT";
+const OPENCLAW_STATE_DIR_ENV = "OPENCLAW_STATE_DIR";
+const STEPCLAW_STATE_DIR_ENV = "STEPCLAW_STATE_DIR";
+const STEPCLAW_STATE_DIR_NAME = ".stepclaw";
+const STEPCLAW_INSTALL_STATE_FILE = "stepclaw-install-state.json";
+const STEPCLAW_RUNTIME_STATE_FILE = "stepclaw-state.json";
 
 function parseEnvFile(content) {
     const result = {};
@@ -68,6 +74,26 @@ function firstDefined(values) {
     });
 }
 
+function trimString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+
+function expandHomePath(value) {
+    const trimmed = trimString(value);
+    if (trimmed === "~") {
+        return os.homedir();
+    }
+    if (trimmed.startsWith("~/") || trimmed.startsWith("~\\")) {
+        return path.join(os.homedir(), trimmed.slice(2));
+    }
+    return trimmed;
+}
+
+function resolvePathValue(value) {
+    const expanded = expandHomePath(value);
+    return expanded ? path.resolve(expanded) : "";
+}
+
 function normalizeBaseUrl(value) {
     return String(value)
         .trim()
@@ -100,6 +126,51 @@ function getOpenClawHome() {
     return path.join(os.homedir(), ".openclaw");
 }
 
+function getDefaultStepClawStateDir() {
+    return path.join(os.homedir(), STEPCLAW_STATE_DIR_NAME);
+}
+
+function readJsonFileIfExists(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf8"));
+    } catch (error) {
+        return null;
+    }
+}
+
+function looksLikeStepClawStateDir(stateDir) {
+    return (
+        fs.existsSync(path.join(stateDir, "openclaw.json")) ||
+        fs.existsSync(path.join(stateDir, STEPCLAW_INSTALL_STATE_FILE)) ||
+        fs.existsSync(path.join(stateDir, "runtime", STEPCLAW_RUNTIME_STATE_FILE))
+    );
+}
+
+function resolveStepClawStateDir() {
+    const envStateDir = firstDefined([
+        process.env[OPENCLAW_STATE_DIR_ENV],
+        process.env[STEPCLAW_STATE_DIR_ENV],
+    ]);
+    if (envStateDir) {
+        return resolvePathValue(envStateDir);
+    }
+
+    const defaultStateDir = getDefaultStepClawStateDir();
+    const presence = readJsonFileIfExists(
+        path.join(defaultStateDir, STEPCLAW_INSTALL_STATE_FILE)
+    );
+    const redirectedStateDir = trimString(presence && presence.stateDir);
+    if (redirectedStateDir) {
+        return resolvePathValue(redirectedStateDir);
+    }
+
+    if (looksLikeStepClawStateDir(defaultStateDir)) {
+        return defaultStateDir;
+    }
+
+    return "";
+}
+
 function defaultCredentialsPath() {
     return path.join(getOpenClawHome(), "hub-credentials.json");
 }
@@ -109,7 +180,14 @@ function getLockfilePath() {
 }
 
 function getManagedAssetsRoot() {
-    return getOpenClawHome();
+    const explicitInstallRoot = firstDefined([
+        process.env[OPENCLAWMP_INSTALL_ROOT_ENV],
+    ]);
+    if (explicitInstallRoot) {
+        return resolvePathValue(explicitInstallRoot);
+    }
+
+    return resolveStepClawStateDir() || getOpenClawHome();
 }
 
 function getInstallRoot(assetType) {
@@ -126,6 +204,8 @@ module.exports = {
     resolveApiBaseUrl,
     resolveConnectBaseUrl,
     getOpenClawHome,
+    getDefaultStepClawStateDir,
+    resolveStepClawStateDir,
     defaultCredentialsPath,
     getLockfilePath,
     getManagedAssetsRoot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclawmp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "OpenClaw Marketplace CLI client",
   "bin": {
     "openclawmp": "bin/openclawmp.js"