itismyskillmarket 1.3.23 → 1.3.25

package/README.md

@@ -79,6 +79,13 @@ skm publish <skill-name> --version 1.0.1
 # Verify a skill
 skm verify <skill-name>
 
+# Manage configuration
+skm config                 # View all configuration values
+skm config get npmRegistry # Get a specific config value
+skm config set npmRegistry https://registry.npmmirror.com  # Set a value (persistent)
+skm config reset npmScope  # Reset a config to default
+skm config reset --all     # Reset all config to defaults
+
 # Start GUI (web interface)
 skm gui
 skm gui 18790              # Custom port
@@ -165,9 +172,27 @@ The `skm gui` web interface includes an **Admin** view with:
 skm gui
 ```
 
-## Environment Variables
+## Configuration
+
+SkillMarket supports three levels of configuration (priority: high → low):
+
+1. **Environment variables** — highest priority, override everything
+2. **Config file** (`~/.skillmarket/config.json`) — set via `skm config set`
+3. **Defaults** — sensible built-in values
+
+Use the `skm config` CLI commands to manage persistent configuration:
+
+```bash
+skm config                    # View all config with source indicators
+skm config set npmRegistry https://registry.npmmirror.com  # Set mirror registry
+skm config get npmRegistry    # View single config value
+skm config reset npmScope     # Reset to default
+skm config reset --all        # Reset all config
+```
+
+### Environment Variables
 
-SkillMarket reads configuration from environment variables:
+Environment variables override both config file and defaults:
 
 | Variable | Default | Description |
 |----------|---------|-------------|

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { Command } from "commander";
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { dirname as dirname2, resolve } from "path";
 
@@ -105,9 +105,24 @@ import https from "https";
 import { URL as URL2 } from "url";
 
 // src/config.ts
-var NPM_SCOPE = process.env.SKM_NPM_SCOPE || "@itismyskillmarket";
-var NPM_SCOPE_FALLBACK = process.env.SKM_NPM_SCOPE_FALLBACK || "@wanxuchen";
-var NPM_REGISTRY = process.env.SKM_NPM_REGISTRY || "https://registry.npmjs.org";
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import os2 from "os";
+var CONFIG_FILE_PATH = join(os2.homedir(), ".skillmarket", "config.json");
+function loadConfigFileSync() {
+  try {
+    if (existsSync(CONFIG_FILE_PATH)) {
+      const raw = readFileSync(CONFIG_FILE_PATH, "utf-8");
+      return JSON.parse(raw);
+    }
+  } catch {
+  }
+  return {};
+}
+var fileConfig = loadConfigFileSync();
+var NPM_SCOPE = process.env.SKM_NPM_SCOPE || fileConfig.npmScope || "@itismyskillmarket";
+var NPM_SCOPE_FALLBACK = process.env.SKM_NPM_SCOPE_FALLBACK || fileConfig.npmScopeFallback || "@wanxuchen";
+var NPM_REGISTRY = process.env.SKM_NPM_REGISTRY || fileConfig.npmRegistry || "https://registry.npmjs.org";
 var DEFAULT_SCOPES = [
   "@itismyskillmarket",
   "@wanxuchen",
@@ -115,8 +130,9 @@ var DEFAULT_SCOPES = [
   "@this-is-skillmarket",
   "@skillmarket"
 ];
-var SKILL_SCOPES = process.env.SKM_NPM_SCOPES ? process.env.SKM_NPM_SCOPES.split(",").map((s) => s.trim()).filter(Boolean) : DEFAULT_SCOPES;
-var SKM_URL = process.env.SKM_URL || `https://www.npmjs.com/package/${NPM_SCOPE}`;
+var fileScopes = fileConfig.npmScopes ? fileConfig.npmScopes.split(",").map((s) => s.trim()).filter(Boolean) : null;
+var SKILL_SCOPES = process.env.SKM_NPM_SCOPES ? process.env.SKM_NPM_SCOPES.split(",").map((s) => s.trim()).filter(Boolean) : fileScopes || DEFAULT_SCOPES;
+var SKM_URL = process.env.SKM_URL || fileConfig.skmUrl || `https://www.npmjs.com/package/${NPM_SCOPE}`;
 
 // src/commands/npm.ts
 async function fetchNpmPackage(packageName, retries = 1) {
@@ -505,18 +521,18 @@ var BaseAdapter = class {
 
 // src/adapters/opencode.ts
 import path3 from "path";
-import os2 from "os";
+import os3 from "os";
 import fs4 from "fs-extra";
 var OpenCodeAdapter = class extends BaseAdapter {
   id = "opencode";
   name = "OpenCode";
   get skillDir() {
-    const configDir = process.env.OPENCODE_CONFIG_DIR || path3.join(os2.homedir(), ".config", "opencode");
+    const configDir = process.env.OPENCODE_CONFIG_DIR || path3.join(os3.homedir(), ".config", "opencode");
     return path3.join(configDir, "skills");
   }
   async isAvailable() {
     if (process.env.OPENCODE) return true;
-    const configDir = process.env.OPENCODE_CONFIG_DIR || path3.join(os2.homedir(), ".config", "opencode");
+    const configDir = process.env.OPENCODE_CONFIG_DIR || path3.join(os3.homedir(), ".config", "opencode");
     try {
       await fs4.ensureDir(path3.join(configDir, "skills"));
       return true;
@@ -528,35 +544,35 @@ var OpenCodeAdapter = class extends BaseAdapter {
 
 // src/adapters/claude.ts
 import path4 from "path";
-import os3 from "os";
+import os4 from "os";
 import fs5 from "fs-extra";
 var ClaudeAdapter = class extends BaseAdapter {
   id = "claude";
   name = "Claude Code";
   get skillDir() {
-    return path4.join(os3.homedir(), ".claude", "skills");
+    return path4.join(os4.homedir(), ".claude", "skills");
   }
   async isAvailable() {
     if (process.env.CLAUDE_CODE) return true;
-    const claudeDir = path4.join(os3.homedir(), ".claude");
+    const claudeDir = path4.join(os4.homedir(), ".claude");
     return fs5.pathExists(claudeDir);
   }
 };
 
 // src/adapters/vscode.ts
 import path5 from "path";
-import os4 from "os";
+import os5 from "os";
 import fs6 from "fs-extra";
 var VSCodeAdapter = class extends BaseAdapter {
   id = "vscode";
   name = "VSCode";
   get skillDir() {
-    return path5.join(os4.homedir(), ".copilot", "skills");
+    return path5.join(os5.homedir(), ".copilot", "skills");
   }
   async isAvailable() {
     const possibleDirs = [
-      path5.join(os4.homedir(), ".copilot", "skills"),
-      path5.join(os4.homedir(), ".claude", "skills")
+      path5.join(os5.homedir(), ".copilot", "skills"),
+      path5.join(os5.homedir(), ".claude", "skills")
     ];
     for (const dir of possibleDirs) {
       try {
@@ -570,7 +586,7 @@ var VSCodeAdapter = class extends BaseAdapter {
   }
   async install(skillId, sourceDir) {
     await super.install(skillId, sourceDir);
-    const claudeSkillDir = path5.join(os4.homedir(), ".claude", "skills");
+    const claudeSkillDir = path5.join(os5.homedir(), ".claude", "skills");
     const targetPath = this.getSkillPath(skillId);
     const claudeTargetPath = path5.join(claudeSkillDir, skillId);
     try {
@@ -583,51 +599,51 @@ var VSCodeAdapter = class extends BaseAdapter {
 };
 
 // src/adapters/openclaw.ts
-import { readdirSync, existsSync, cpSync, rmSync } from "fs";
-import { join } from "path";
+import { readdirSync, existsSync as existsSync2, cpSync, rmSync } from "fs";
+import { join as join2 } from "path";
 import { homedir } from "os";
 import { ensureDirSync } from "fs-extra";
 var OpenClawAdapter = class {
   id = "openclaw";
   name = "OpenClaw";
-  skillDir = join(homedir(), ".openclaw", "skills");
+  skillDir = join2(homedir(), ".openclaw", "skills");
   async isAvailable() {
     try {
-      return existsSync(join(homedir(), ".openclaw"));
+      return existsSync2(join2(homedir(), ".openclaw"));
     } catch {
       return false;
     }
   }
   async isInstalled(skillId) {
     try {
-      const skillPath = join(this.skillDir, skillId);
-      return existsSync(skillPath);
+      const skillPath = join2(this.skillDir, skillId);
+      return existsSync2(skillPath);
     } catch {
       return false;
     }
   }
   async install(skillId, sourceDir) {
     ensureDirSync(this.skillDir);
-    const targetDir = join(this.skillDir, skillId);
-    if (existsSync(targetDir)) {
+    const targetDir = join2(this.skillDir, skillId);
+    if (existsSync2(targetDir)) {
       rmSync(targetDir, { recursive: true, force: true });
     }
     cpSync(sourceDir, targetDir, { recursive: true });
   }
   async uninstall(skillId) {
-    const targetDir = join(this.skillDir, skillId);
-    if (existsSync(targetDir)) {
+    const targetDir = join2(this.skillDir, skillId);
+    if (existsSync2(targetDir)) {
       rmSync(targetDir, { recursive: true, force: true });
     }
   }
   async listInstalled() {
     try {
-      if (!existsSync(this.skillDir)) {
+      if (!existsSync2(this.skillDir)) {
         return [];
       }
       return readdirSync(this.skillDir).filter((name) => {
-        const fullPath = join(this.skillDir, name);
-        return existsSync(fullPath) && name !== ".";
+        const fullPath = join2(this.skillDir, name);
+        return existsSync2(fullPath) && name !== ".";
       });
     } catch {
       return [];
@@ -636,17 +652,17 @@ var OpenClawAdapter = class {
 };
 
 // src/adapters/hermes.ts
-import { readdirSync as readdirSync2, existsSync as existsSync2, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
-import { join as join2 } from "path";
+import { readdirSync as readdirSync2, existsSync as existsSync3, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
+import { join as join3 } from "path";
 import { homedir as homedir2 } from "os";
 import { ensureDirSync as ensureDirSync2 } from "fs-extra";
 var HermesAdapter = class {
   id = "hermes";
   name = "Hermes Agent";
-  skillDir = join2(homedir2(), ".hermes", "skills");
+  skillDir = join3(homedir2(), ".hermes", "skills");
   async isAvailable() {
     try {
-      if (existsSync2(join2(homedir2(), ".hermes"))) {
+      if (existsSync3(join3(homedir2(), ".hermes"))) {
         return true;
       }
       return false;
@@ -656,34 +672,34 @@ var HermesAdapter = class {
   }
   async isInstalled(skillId) {
     try {
-      const skillPath = join2(this.skillDir, skillId);
-      return existsSync2(skillPath);
+      const skillPath = join3(this.skillDir, skillId);
+      return existsSync3(skillPath);
     } catch {
       return false;
     }
   }
   async install(skillId, sourceDir) {
     ensureDirSync2(this.skillDir);
-    const targetDir = join2(this.skillDir, skillId);
-    if (existsSync2(targetDir)) {
+    const targetDir = join3(this.skillDir, skillId);
+    if (existsSync3(targetDir)) {
       rmSync2(targetDir, { recursive: true, force: true });
     }
     cpSync2(sourceDir, targetDir, { recursive: true });
   }
   async uninstall(skillId) {
-    const targetDir = join2(this.skillDir, skillId);
-    if (existsSync2(targetDir)) {
+    const targetDir = join3(this.skillDir, skillId);
+    if (existsSync3(targetDir)) {
       rmSync2(targetDir, { recursive: true, force: true });
     }
   }
   async listInstalled() {
     try {
-      if (!existsSync2(this.skillDir)) {
+      if (!existsSync3(this.skillDir)) {
         return [];
       }
       return readdirSync2(this.skillDir).filter((name) => {
-        const fullPath = join2(this.skillDir, name);
-        return existsSync2(fullPath) && name !== ".";
+        const fullPath = join3(this.skillDir, name);
+        return existsSync3(fullPath) && name !== ".";
       });
     } catch {
       return [];
@@ -1154,13 +1170,13 @@ function parseGitHubUrl(input) {
       const repo = match[2].replace(/\.git$/, "");
       const branch = match[3] || "main";
       const commitOrPath = match[4] || match[3];
-      const path11 = match[5] || void 0;
+      const path12 = match[5] || void 0;
       return {
         owner,
         repo,
         branch: commitOrPath && !commitOrPath.includes("/") ? commitOrPath : branch,
         commit: commitOrPath?.match(/^[0-9a-f]{40}$/) ? commitOrPath : void 0,
-        path: path11
+        path: path12
       };
     }
   }
@@ -1403,15 +1419,15 @@ Installing to platforms: ${targetPlatforms.join(", ")}`);
 
 // src/commands/publish.ts
 import { execSync } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
 import { fileURLToPath } from "url";
 async function publishSkill(skillName, options) {
   const __dirname4 = fileURLToPath(new URL(".", import.meta.url));
-  const projectRoot = join3(__dirname4, "..", "..");
-  const skillDir = join3(projectRoot, "skills", skillName);
+  const projectRoot = join4(__dirname4, "..", "..");
+  const skillDir = join4(projectRoot, "skills", skillName);
   console.log(`Publishing ${skillName}...`);
-  if (!existsSync3(skillDir)) {
+  if (!existsSync4(skillDir)) {
     throw new Error(`Skill '${skillName}' not found in skills/ directory`);
   }
   if (!options?.skipInstall) {
@@ -1545,8 +1561,8 @@ async function verifySkill(skillName) {
 
 // src/commands/ui.ts
 import { createServer } from "http";
-import { readFileSync, existsSync as existsSync4 } from "fs";
-import { join as join4, extname, dirname } from "path";
+import { readFileSync as readFileSync2, existsSync as existsSync5 } from "fs";
+import { join as join5, extname, dirname } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/commands/admin.ts
@@ -2013,7 +2029,7 @@ async function adminAccess(skillId, level) {
 // src/commands/ui.ts
 var __filename2 = fileURLToPath3(import.meta.url);
 var __dirname2 = dirname(__filename2);
-var guiDir = join4(__dirname2, "..", "gui");
+var guiDir = join5(__dirname2, "..", "gui");
 var cache = /* @__PURE__ */ new Map();
 function getCached(key) {
   const entry = cache.get(key);
@@ -2270,8 +2286,8 @@ API_ROUTES.GET["/api/skill-info"] = async (_req, res, url) => {
 };
 API_ROUTES.GET["/api/version"] = async (_req, res, _url) => {
   try {
-    const pkgPath = join4(__dirname2, "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const pkgPath = join5(__dirname2, "..", "package.json");
+    const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
     jsonResponse(res, 200, { version: pkg.version || "1.0.0" });
   } catch {
     jsonResponse(res, 200, { version: "1.0.0" });
@@ -2508,12 +2524,12 @@ API_ROUTES.POST["/api/update"] = async (req, res, _url) => {
   }
 };
 function serveStaticFile(res, filePath) {
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     res.writeHead(404, { "Content-Type": "text/plain" });
     res.end("Not Found");
     return;
   }
-  const content = readFileSync(filePath);
+  const content = readFileSync2(filePath);
   const ext = extname(filePath);
   const mime = MIME_TYPES[ext] || "application/octet-stream";
   res.writeHead(200, {
@@ -2541,7 +2557,7 @@ async function handleRequest(req, res) {
     jsonResponse(res, 404, { error: `Unknown API endpoint: ${method} ${pathname}` });
     return;
   }
-  const filePath = join4(guiDir, pathname === "/" ? "index.html" : pathname);
+  const filePath = join5(guiDir, pathname === "/" ? "index.html" : pathname);
   if (filePath.startsWith(guiDir)) {
     serveStaticFile(res, filePath);
   } else {
@@ -2569,10 +2585,226 @@ Press Ctrl+C to stop
   });
 }
 
+// src/commands/config.ts
+import path11 from "path";
+import fs12 from "fs-extra";
+import os6 from "os";
+var CONFIG_DEFINITIONS = [
+  {
+    key: "npmScope",
+    envVar: "SKM_NPM_SCOPE",
+    defaultValue: "@itismyskillmarket",
+    description: "Primary npm scope for publishing and lookup"
+  },
+  {
+    key: "npmScopeFallback",
+    envVar: "SKM_NPM_SCOPE_FALLBACK",
+    defaultValue: "@wanxuchen",
+    description: "Fallback npm scope (backward compatibility)"
+  },
+  {
+    key: "npmRegistry",
+    envVar: "SKM_NPM_REGISTRY",
+    defaultValue: "https://registry.npmjs.org",
+    description: "npm registry URL (mirror/proxy support)"
+  },
+  {
+    key: "npmScopes",
+    envVar: "SKM_NPM_SCOPES",
+    defaultValue: "@itismyskillmarket,@wanxuchen,@thisisskillmarket,@this-is-skillmarket,@skillmarket",
+    description: "Comma-separated list of npm scopes to search"
+  },
+  {
+    key: "skmUrl",
+    envVar: "SKM_URL",
+    defaultValue: "https://www.npmjs.com/package/@itismyskillmarket",
+    description: "Base URL for skill links (publish output)"
+  }
+];
+function getConfigPath() {
+  return path11.join(os6.homedir(), ".skillmarket", "config.json");
+}
+async function readConfigFile() {
+  try {
+    const configPath = getConfigPath();
+    if (await fs12.pathExists(configPath)) {
+      const data = await fs12.readJson(configPath);
+      const valid = {};
+      for (const def of CONFIG_DEFINITIONS) {
+        if (data[def.key] !== void 0) {
+          valid[def.key] = String(data[def.key]);
+        }
+      }
+      return valid;
+    }
+  } catch {
+  }
+  return {};
+}
+async function writeConfigFile(updates) {
+  const configPath = getConfigPath();
+  await fs12.ensureDir(path11.dirname(configPath));
+  let existing = {};
+  try {
+    if (await fs12.pathExists(configPath)) {
+      existing = await fs12.readJson(configPath);
+    }
+  } catch {
+  }
+  const merged = { ...existing, ...updates };
+  for (const key of Object.keys(merged)) {
+    if (merged[key] === void 0) {
+      delete merged[key];
+    }
+  }
+  await fs12.writeJson(configPath, merged, { spaces: 2 });
+  return merged;
+}
+async function removeConfigKeys(keys) {
+  const configPath = getConfigPath();
+  if (!await fs12.pathExists(configPath)) return;
+  try {
+    const existing = await fs12.readJson(configPath);
+    for (const key of keys) {
+      delete existing[key];
+    }
+    await fs12.writeJson(configPath, existing, { spaces: 2 });
+  } catch {
+  }
+}
+async function removeConfigFile() {
+  const configPath = getConfigPath();
+  if (await fs12.pathExists(configPath)) {
+    await fs12.remove(configPath);
+  }
+}
+async function getAllConfig() {
+  const fileConfig2 = await readConfigFile();
+  return CONFIG_DEFINITIONS.map((def) => {
+    const envValue = process.env[def.envVar];
+    if (envValue !== void 0) {
+      return {
+        ...def,
+        value: envValue,
+        source: "env"
+      };
+    }
+    const fileValue = fileConfig2[def.key];
+    if (fileValue !== void 0) {
+      return {
+        ...def,
+        value: fileValue,
+        source: "file"
+      };
+    }
+    return {
+      ...def,
+      value: def.defaultValue,
+      source: "default"
+    };
+  });
+}
+async function getConfig(key) {
+  const all = await getAllConfig();
+  return all.find((c) => c.key === key) || null;
+}
+async function listConfig() {
+  const entries = await getAllConfig();
+  console.log("\n\u{1F527} SkillMarket Configuration\n");
+  const maxKeyLen = Math.max(...entries.map((e) => e.key.length));
+  for (const entry of entries) {
+    const key = entry.key.padEnd(maxKeyLen + 2);
+    const sourceBadge = getSourceBadge(entry.source);
+    console.log(`  ${sourceBadge}  ${key}${entry.value}`);
+  }
+  console.log("");
+  console.log("  \u6765\u6E90: \u{1F535} \u73AF\u5883\u53D8\u91CF  \u{1F7E2} \u914D\u7F6E\u6587\u4EF6  \u26AA \u9ED8\u8BA4\u503C");
+  console.log("  \u914D\u7F6E\u6587\u4EF6: " + getConfigPath());
+  console.log("");
+  console.log("  \u7528\u6CD5:");
+  console.log("    skm config get <key>      \u67E5\u770B\u914D\u7F6E\u503C");
+  console.log("    skm config set <key> <v>  \u8BBE\u7F6E\u914D\u7F6E\u503C");
+  console.log("    skm config reset <key>    \u91CD\u7F6E\u4E3A\u9ED8\u8BA4\u503C");
+  console.log("    skm config reset --all    \u5168\u90E8\u91CD\u7F6E");
+  console.log("");
+}
+function getSourceBadge(source) {
+  switch (source) {
+    case "env":
+      return "\u{1F535}";
+    case "file":
+      return "\u{1F7E2}";
+    case "default":
+      return "\u26AA";
+  }
+}
+async function getConfigValue(key) {
+  const entry = await getConfig(key);
+  if (!entry) {
+    console.error(`\u274C Unknown config key: "${key}"`);
+    console.log(`   Valid keys: ${CONFIG_DEFINITIONS.map((d) => d.key).join(", ")}`);
+    process.exit(1);
+  }
+  console.log(`
+\u{1F527} ${entry.key}`);
+  console.log(`   Value:       ${entry.value}`);
+  console.log(`   Source:      ${entry.source}`);
+  console.log(`   Env var:     ${entry.envVar}`);
+  console.log(`   Default:     ${entry.defaultValue}`);
+  console.log(`   Description: ${entry.description}`);
+  console.log("");
+}
+async function setConfigValue(key, value) {
+  const def = CONFIG_DEFINITIONS.find((d) => d.key === key);
+  if (!def) {
+    console.error(`\u274C Unknown config key: "${key}"`);
+    console.log(`   Valid keys: ${CONFIG_DEFINITIONS.map((d) => d.key).join(", ")}`);
+    process.exit(1);
+  }
+  await writeConfigFile({ [key]: value });
+  console.log(`
+\u2705 ${key} set to "${value}"`);
+  console.log(`   Stored in: ${getConfigPath()}`);
+  console.log("");
+  if (process.env[def.envVar] !== void 0) {
+    console.log(`   \u26A0\uFE0F  Currently overridden by environment variable ${def.envVar}=${process.env[def.envVar]}`);
+    console.log(`   To use the config file value, unset the environment variable.`);
+    console.log("");
+  }
+}
+async function resetConfig(key, all = false) {
+  if (all) {
+    await removeConfigFile();
+    console.log("\n\u2705 All configuration reset to defaults.");
+    console.log(`   Removed: ${getConfigPath()}`);
+    console.log("");
+    return;
+  }
+  if (key) {
+    const def = CONFIG_DEFINITIONS.find((d) => d.key === key);
+    if (!def) {
+      console.error(`\u274C Unknown config key: "${key}"`);
+      console.log(`   Valid keys: ${CONFIG_DEFINITIONS.map((d) => d.key).join(", ")}`);
+      process.exit(1);
+    }
+    await removeConfigKeys([key]);
+    const sourceNow = process.env[def.envVar] ? "env" : "default";
+    console.log(`
+\u2705 ${key} reset to ${sourceNow === "env" ? "environment variable" : "default"} value.`);
+    console.log(`   Effective value: "${sourceNow === "env" ? process.env[def.envVar] : def.defaultValue}"`);
+    console.log("");
+    return;
+  }
+  console.log("\n\u{1F527} Usage: skm config reset <key>");
+  console.log("         skm config reset --all");
+  console.log(`   Valid keys: ${CONFIG_DEFINITIONS.map((d) => d.key).join(", ")}`);
+  console.log("");
+}
+
 // src/cli.ts
 var __filename3 = fileURLToPath4(import.meta.url);
 var __dirname3 = dirname2(__filename3);
-var packageJson = JSON.parse(readFileSync2(resolve(__dirname3, "../package.json"), "utf-8"));
+var packageJson = JSON.parse(readFileSync3(resolve(__dirname3, "../package.json"), "utf-8"));
 var VERSION = packageJson.version || "1.3.1";
 var program = new Command();
 program.name("skm").description("SkillMarket - Cross-platform skill manager for AI coding tools").version(VERSION);
@@ -2584,45 +2816,81 @@ SkillMarket CLI
 Usage: skm <command> [options]
 
 Commands:
-  ls [options]         List available skills
-                          --installed    Show only installed skills
-                          --updates      Check for updates
-                          --page <n>     Page number (default: 1)
-                          --limit <n>    Items per page (default: 20)
-                          -s, --search   Search by keyword
-  info <skill-id>      Display skill information
-  install <skill>      Install a skill
-                          @version      Install specific version
-                          --platform    Target platforms (opencode,claude,vscode)
-                          --force       Overwrite if already installed
-  uninstall <skill>    Remove an installed skill
-                          --platform    Target platforms
-                          --all          Uninstall ALL installed skills
-                          --dry-run     Preview without deleting
-                          -y, --yes     Skip confirmation
-  update [options]     Update skills
-                          --all          Update all skills
-  sync                 Synchronize platform links
-  platforms            Show available platforms
+  ls [options]            List available skills
+                            --installed    Show only installed skills
+                            --updates      Check for updates
+                            --page <n>     Page number (default: 1)
+                            --limit <n>    Items per page (default: 20)
+                            -s, --search   Search by keyword
+  search <keyword>        Search skills from npm registry
+  info <skill>            Display skill information
+  install <skill>         Install a skill from npm or GitHub
+                            @<version>    Install specific version
+                            --platform    Target platforms (opencode,claude,...)
+                            --force       Overwrite if already installed
+                            -b, --branch  GitHub branch to install from
+                            -c, --commit  GitHub commit to install from
+  uninstall <skill>       Remove an installed skill
+                            --platform    Target platforms
+                            --all         Uninstall ALL installed skills
+                            --dry-run     Preview without deleting
+                            -y, --yes     Skip confirmation
+  update [skill]          Update installed skills (all if no skill specified)
+                            --all         Update all skills
+  publish <skill>         Publish a skill to npm
+                            -v, --version Specify version
+  verify <skill>          Verify skill integrity and format
+  sync [skill]            Synchronize platform links (or sync a skill to latest)
+  platforms               Show available platforms
+  gui [port]              Start SkillMarket GUI web interface
+  config                  View and manage configuration
+    config get <key>        Get a config value
+    config set <key> <val>  Set a config value
+    config reset [key]      Reset config to defaults
+  admin                   Admin: manage published skills
+    admin ls                List all published skills
+    admin info <skill>      Show detailed info for a published skill
+    admin search <keyword>  Search published skills
+    admin stats             Publishing statistics
+    admin verify <skill>    Verify a published skill
+    admin deprecate <skill> Deprecate a skill (--version, --message)
+    admin unpublish <skill> Unpublish a skill (--version, --force)
+    admin tag set/tag rm/tag ls  Manage dist-tags
+    admin owner add/rm      Manage package maintainers
+    admin access <skill>    Set package access (public|restricted)
 
 Examples:
-  skm ls                     List all available skills (page 1)
-  skm ls --page 2            Go to page 2
-  skm ls --limit 10          Show 10 items per page
-  skm ls --search brain      Search skills by keyword
-  skm ls -s brain           Search with short form
-  skm ls --installed         Show installed skills only
-  skm ls --installed --search test  Search installed skills
-  skm ls --installed --page 2
-  skm info brainstorming     View skill details
-  skm install brainstorming  Install to all platforms
-  skm install brainstorming --platform opencode  Install to OpenCode only
-  skm install brainstorming --platform claude,vscode  Install to multiple
-  skm uninstall brainstorming
-  skm uninstall --all        Uninstall all skills (with confirmation)
-  skm uninstall --all --yes  Force uninstall all without confirmation
-  skm uninstall brainstorming --dry-run  Preview uninstall
-  skm platforms              Show available platforms
+  skm ls                           List available skills
+  skm ls --page 2 --limit 10       Paginated listing
+  skm ls --installed               Show installed skills
+  skm ls -s brain                  Search skills by keyword
+  skm search test                  Search from registry
+  skm info brainstorming           View skill details
+  skm install brainstorming        Install to all detected platforms
+  skm install brainstorming@1.0.0  Install specific version
+  skm install owner/repo           Install from GitHub
+  skm install brainstorming --platform opencode  Install to specific platform
+  skm uninstall brainstorming      Uninstall skill
+  skm uninstall --all              Uninstall all skills
+  skm uninstall --all --yes        Force uninstall all without confirmation
+  skm uninstall --dry-run          Preview uninstall
+  skm update brainstorming         Update specific skill
+  skm update                       Update all skills
+  skm publish my-skill             Publish a skill
+  skm publish my-skill --version 1.0.1  Publish specific version
+  skm verify my-skill              Verify skill integrity
+  skm sync                         Sync platform links
+  skm sync brainstorming           Sync skill to latest version
+  skm platforms                    Show available platforms
+  skm gui                          Start GUI on default port 18770
+  skm gui 18790                    Start GUI on custom port
+  skm config                       View all configuration
+  skm config get npmRegistry       View specific config
+  skm config set npmRegistry https://registry.npmmirror.com  Set mirror registry
+  skm config reset npmScope        Reset config to default
+  skm config reset --all           Reset all config
+  skm admin ls                     List all published skills
+  skm admin deprecate my-skill --message "Use v2"  Deprecate a skill
        `);
     process.exit(0);
   }
@@ -2761,6 +3029,22 @@ program.command("verify <skill>").description("Verify skill integrity and format
     process.exit(1);
   }
 });
+var config = program.command("config").description("View and manage configuration");
+config.command("list").alias("ls").description("List all configuration values").action(async () => {
+  await listConfig();
+});
+config.action(async () => {
+  await listConfig();
+});
+config.command("get <key>").description("Get a specific configuration value").action(async (key) => {
+  await getConfigValue(key);
+});
+config.command("set <key> <value>").description("Set a configuration value (persisted to config file)").action(async (key, value) => {
+  await setConfigValue(key, value);
+});
+config.command("reset [key]").description("Reset configuration to default values").option("--all", "Reset all configuration values").action(async (key, opts) => {
+  await resetConfig(key, opts.all ?? false);
+});
 var admin = program.command("admin").description("Admin: manage published skills (cloud)");
 admin.command("ls").description("List all published skills").action(async () => {
   try {

package/gui/app.js

@@ -66,10 +66,21 @@ const translations = {
     // 搜索
     'search.placeholder': '🔍 Search skills...',
     
+    // 排序
+    'sort.nameAsc': 'Name A-Z',
+    'sort.nameDesc': 'Name Z-A',
+    'sort.recentlyUpdated': 'Recently Updated',
+    'sort.leastUpdated': 'Least Recently Updated',
+    
+    // 筛选
+    'filter.allPlatforms': 'All Platforms',
+    
     // 分页
     'pagination.prev': '← Prev',
     'pagination.next': 'Next →',
     'pagination.pageInfo': 'Page {page} of {totalPages}',
+    'pagination.goTo': 'Go to',
+    'pagination.go': 'Go',
     
     // 每页数量
     'pageSize.10': '10 per page',
@@ -81,6 +92,11 @@ const translations = {
     'status.unavailable': '❌ Not detected',
     'status.skillsInstalled': '{count} skills installed',
     
+    // Platform 详情
+    'platform.id': 'Platform ID',
+    'platform.installedSkills': 'Installed Skills ({count})',
+    'platform.noSkills': 'No skills installed on this platform.',
+    
     // 详情视图
     'detail.description': 'Description',
     'detail.details': 'Details',
@@ -237,10 +253,21 @@ const translations = {
     // 搜索
     'search.placeholder': '🔍 搜索技能...',
     
+    // 排序
+    'sort.nameAsc': '名称 A-Z',
+    'sort.nameDesc': '名称 Z-A',
+    'sort.recentlyUpdated': '最近更新',
+    'sort.leastUpdated': '最早更新',
+    
+    // 筛选
+    'filter.allPlatforms': '所有平台',
+    
     // 分页
     'pagination.prev': '← 上一页',
     'pagination.next': '下一页 →',
     'pagination.pageInfo': '第 {page} 页 / 共 {totalPages} 页',
+    'pagination.goTo': '跳转到',
+    'pagination.go': '跳转',
     
     // 每页数量
     'pageSize.10': '每页 10 条',
@@ -252,6 +279,11 @@ const translations = {
     'status.unavailable': '❌ 未检测到',
     'status.skillsInstalled': '已安装 {count} 个技能',
     
+    // Platform 详情
+    'platform.id': '平台 ID',
+    'platform.installedSkills': '已安装技能（{count} 个）',
+    'platform.noSkills': '该平台未安装任何技能',
+    
     // 详情视图
     'detail.description': '描述',
     'detail.details': '详细信息',
@@ -460,6 +492,28 @@ function applyI18nToStaticElements() {
     `;
   }
   
+  // sort-select 排序选项
+  const sortSelect = document.getElementById('sort-select');
+  if (sortSelect) {
+    const currentSort = sortSelect.value || state.sortBy;
+    sortSelect.innerHTML = `
+      <option value="name"${currentSort === 'name' ? ' selected' : ''}>${t('sort.nameAsc')}</option>
+      <option value="-name"${currentSort === '-name' ? ' selected' : ''}>${t('sort.nameDesc')}</option>
+      <option value="-updated"${currentSort === '-updated' ? ' selected' : ''}>${t('sort.recentlyUpdated')}</option>
+      <option value="updated"${currentSort === 'updated' ? ' selected' : ''}>${t('sort.leastUpdated')}</option>
+    `;
+  }
+  
+  // platform-filter 默认选项（后续由 updatePlatformFilterOptions 补充完整列表）
+  const platformFilter = document.getElementById('platform-filter');
+  if (platformFilter && platformFilter.options.length <= 1) {
+    const currentFilter = platformFilter.value;
+    platformFilter.innerHTML = `
+      <option value="">${t('filter.allPlatforms')}</option>
+    `;
+    if (currentFilter) platformFilter.value = currentFilter;
+  }
+  
   // 按钮文本
   const refreshSkills = document.getElementById('refresh-skills');
   const refreshAdmin = document.getElementById('refresh-admin');
@@ -806,13 +860,14 @@ function updatePlatformFilterOptions(skills) {
   const currentVal = select.value;
   const sortedPlatforms = [...allPlatforms].sort();
 
-  // 只有当平台列表有变化时才重新渲染
+  // 当平台列表或当前语言变化时才重新渲染
   const currentOptions = Array.from(select.options).slice(1).map(o => o.value).sort().join(',');
   const newOptions = sortedPlatforms.join(',');
-  if (currentOptions === newOptions) return;
+  const currentAllText = select.options[0]?.textContent || '';
+  if (currentOptions === newOptions && currentAllText === t('filter.allPlatforms')) return;
 
   select.innerHTML = `
-    <option value="">All Platforms</option>
+    <option value="">${t('filter.allPlatforms')}</option>
     ${sortedPlatforms.map(p => `<option value="${p}"${currentVal === p ? ' selected' : ''}>${p}</option>`).join('')}
   `;
   select.value = currentVal && allPlatforms.has(currentVal) ? currentVal : '';
@@ -833,10 +888,10 @@ function renderPagination(currentPage, totalPages) {
     <button ${currentPage <= 1 ? 'disabled' : ''} onclick="changePage(${currentPage - 1})">${t('pagination.prev')}</button>
     <span class="page-info">${t('pagination.pageInfo', { page: currentPage, totalPages: totalPages })}</span>
     <span class="page-jump">
-      <label>Go to</label>
+      <label>${t('pagination.goTo')}</label>
       <input type="number" id="page-jump-input" min="1" max="${totalPages}" value="${currentPage}"
         onkeydown="if(event.key==='Enter')jumpToPage()">
-      <button onclick="jumpToPage()">Go</button>
+      <button onclick="jumpToPage()">${t('pagination.go')}</button>
     </span>
     <button ${currentPage >= totalPages ? 'disabled' : ''} onclick="changePage(${currentPage + 1})">${t('pagination.next')}</button>
   `;
@@ -899,7 +954,7 @@ function renderPlatforms(platforms, container) {
         </div>
       </div>
       <div>
-        ${platform.installedCount ? `<span>${t('status.skillsInstalled', { count: platform.installedCount })}</span>` : '<span style="color: var(--text-muted); font-size: 0.85rem;">0 installed</span>'}
+        ${platform.installedCount ? `<span>${t('status.skillsInstalled', { count: platform.installedCount })}</span>` : `<span style="color: var(--text-muted); font-size: 0.85rem;">${t('status.skillsInstalled', { count: 0 })}</span>`}
       </div>
     </div>
   `).join('');
@@ -945,13 +1000,13 @@ async function showPlatformDetail(platformId) {
           </div>
         </div>
         <div class="admin-skill-row" style="background: var(--bg-card); padding: 10px 16px; margin-bottom: 12px;">
-          <span style="color: var(--text-muted); font-size: 0.85rem;">Platform ID</span>
+          <span style="color: var(--text-muted); font-size: 0.85rem;">${t('platform.id')}</span>
           <span style="color: var(--text-secondary); font-size: 0.9rem; font-family: monospace;">${platform.id}</span>
         </div>
         <h3 style="color: var(--text-secondary); margin-bottom: 10px; font-size: 1rem;">
-          Installed Skills (${skills.length})
+          ${t('platform.installedSkills', { count: skills.length })}
         </h3>
-        ${skills.length === 0 ? '<div class="loading" style="padding: 20px;">No skills installed on this platform.</div>' : `
+        ${skills.length === 0 ? `<div class="loading" style="padding: 20px;">${t('platform.noSkills')}</div>` : `
           <div style="display: flex; flex-direction: column; gap: 6px;">
             ${skills.map((skill, i) => `
               <div class="admin-skill-row" style="cursor: pointer;" onclick="showSkillDetail('${skill.id}')">
@@ -1035,9 +1090,20 @@ skm publish &lt;skill-name&gt; --version 1.0.1</pre>
       </div>
     </div>
 
+    <div class="help-section">
+      <h3>⚙️ 配置管理</h3>
+      <p>使用 <code>skm config</code> 命令可查看和修改配置（持久化到 <code>~/.skillmarket/config.json</code>）：</p>
+      <pre>skm config                    # 查看所有配置
+skm config get &lt;key&gt;          # 查看指定配置
+skm config set &lt;key&gt; &lt;value&gt;  # 设置配置值
+skm config reset &lt;key&gt;        # 恢复默认值
+skm config reset --all         # 全部恢复默认</pre>
+      <p class="help-note">⚠ 环境变量优先级高于配置文件。如需环境变量生效，unset 后可重开终端。</p>
+    </div>
+
     <div class="help-section">
       <h3>⚙️ 环境变量配置</h3>
-      <p>设置以下环境变量可覆盖默认配置：</p>
+      <p>设置以下环境变量可覆盖配置文件和默认值（最高优先级）：</p>
       <table class="help-table">
         <thead>
           <tr><th>变量</th><th>当前值</th><th>说明</th></tr>
@@ -1061,14 +1127,32 @@ skm publish &lt;skill-name&gt; --version 1.0.1</pre>
         <tbody>
           <tr><td><code>skm ls</code></td><td>列出可用 skills</td></tr>
           <tr><td><code>skm ls --installed</code></td><td>列出已安装 skills</td></tr>
+          <tr><td><code>skm search &lt;keyword&gt;</code></td><td>搜索 skills</td></tr>
+          <tr><td><code>skm info &lt;skill&gt;</code></td><td>查看 skill 详情</td></tr>
           <tr><td><code>skm install &lt;skill&gt;</code></td><td>安装 skill 到所有平台</td></tr>
+          <tr><td><code>skm install &lt;skill&gt;@&lt;ver&gt;</code></td><td>安装指定版本</td></tr>
           <tr><td><code>skm install &lt;skill&gt; --platform opencode</code></td><td>安装到指定平台</td></tr>
+          <tr><td><code>skm install &lt;skill&gt; --force</code></td><td>强制覆盖安装</td></tr>
+          <tr><td><code>skm install owner/repo</code></td><td>从 GitHub 安装</td></tr>
           <tr><td><code>skm uninstall &lt;skill&gt;</code></td><td>卸载 skill</td></tr>
-          <tr><td><code>skm update &lt;skill&gt;</code></td><td>更新 skill</td></tr>
+          <tr><td><code>skm uninstall --all</code></td><td>卸载所有 skills</td></tr>
+          <tr><td><code>skm update [skill]</code></td><td>更新 skill（不指定则更新全部）</td></tr>
           <tr><td><code>skm update --all</code></td><td>更新所有 skills</td></tr>
+          <tr><td><code>skm publish &lt;skill&gt;</code></td><td>发布 skill 到 npm</td></tr>
+          <tr><td><code>skm verify &lt;skill&gt;</code></td><td>验证 skill 完整性</td></tr>
           <tr><td><code>skm platforms</code></td><td>查看可用平台</td></tr>
+          <tr><td><code>skm sync</code></td><td>同步平台链接</td></tr>
+          <tr><td><code>skm sync &lt;skill&gt;</code></td><td>同步指定 skill 到最新</td></tr>
           <tr><td><code>skm gui</code></td><td>启动图形界面</td></tr>
           <tr><td><code>skm gui 18790</code></td><td>指定端口启动 GUI</td></tr>
+          <tr><td><code>skm config</code></td><td>查看所有配置项</td></tr>
+          <tr><td><code>skm config get &lt;key&gt;</code></td><td>查看指定配置</td></tr>
+          <tr><td><code>skm config set &lt;key&gt; &lt;value&gt;</code></td><td>设置配置值</td></tr>
+          <tr><td><code>skm config reset [key]</code></td><td>恢复配置为默认值</td></tr>
+          <tr><td><code>skm admin ls</code></td><td>列出所有已发布 skills</td></tr>
+          <tr><td><code>skm admin info &lt;skill&gt;</code></td><td>查看已发布 skill 详情</td></tr>
+          <tr><td><code>skm admin deprecate &lt;skill&gt;</code></td><td>废弃 skill</td></tr>
+          <tr><td><code>skm admin unpublish &lt;skill&gt;</code></td><td>取消发布 skill</td></tr>
         </tbody>
       </table>
     </div>

package/gui/index.html

@@ -37,15 +37,8 @@
           <h2>Available Skills</h2>
           <div class="controls">
             <input type="text" id="search-input" placeholder="🔍 Search skills...">
-            <select id="sort-select">
-              <option value="name">Name A-Z</option>
-              <option value="-name">Name Z-A</option>
-              <option value="-updated">Recently Updated</option>
-              <option value="updated">Least Recently Updated</option>
-            </select>
-            <select id="platform-filter">
-              <option value="">All Platforms</option>
-            </select>
+            <select id="sort-select"></select>
+            <select id="platform-filter"></select>
             <select id="page-size">
               <option value="10">10 per page</option>
               <option value="20" selected>20 per page</option>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itismyskillmarket",
-  "version": "1.3.23",
+  "version": "1.3.25",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
   "bin": {