itismyskillmarket 1.3.22 → 1.3.24

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);
@@ -2151,7 +2167,9 @@ API_ROUTES.GET["/api/skills"] = async (_req, res, url) => {
     });
     const filteredTotal = skills.length;
     const totalPages = Math.ceil(filteredTotal / limit) || 1;
-    jsonResponse(res, 200, { skills, page, totalPages, total: filteredTotal, fetchErrors });
+    const start = (page - 1) * limit;
+    const pagedSkills = skills.slice(start, start + limit);
+    jsonResponse(res, 200, { skills: pagedSkills, page, totalPages, total: filteredTotal, fetchErrors });
   } catch (err) {
     jsonResponse(res, 500, {
       error: String(err),
@@ -2268,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" });
@@ -2506,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, {
@@ -2539,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 {
@@ -2567,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);
@@ -2602,6 +2836,10 @@ Commands:
                           --all          Update all skills
   sync                 Synchronize platform links
   platforms            Show available platforms
+  config               View all configuration
+      config get <key>  Get a config value
+      config set <key>  Set a config value
+      config reset [key] Reset config to defaults
 
 Examples:
   skm ls                     List all available skills (page 1)
@@ -2621,6 +2859,11 @@ Examples:
   skm uninstall --all --yes  Force uninstall all without confirmation
   skm uninstall brainstorming --dry-run  Preview uninstall
   skm platforms              Show available platforms
+  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
        `);
     process.exit(0);
   }
@@ -2759,6 +3002,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',
@@ -832,6 +843,12 @@ function renderPagination(currentPage, totalPages) {
   let html = `
     <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>
+      <input type="number" id="page-jump-input" min="1" max="${totalPages}" value="${currentPage}"
+        onkeydown="if(event.key==='Enter')jumpToPage()">
+      <button onclick="jumpToPage()">Go</button>
+    </span>
     <button ${currentPage >= totalPages ? 'disabled' : ''} onclick="changePage(${currentPage + 1})">${t('pagination.next')}</button>
   `;
 
@@ -844,6 +861,17 @@ function changePage(page) {
   loadSkills();
 }
 
+function jumpToPage() {
+  const input = document.getElementById('page-jump-input');
+  if (!input) return;
+  const page = parseInt(input.value);
+  if (isNaN(page) || page < 1 || page > state.totalPages) {
+    input.value = state.currentPage;
+    return;
+  }
+  changePage(page);
+}
+
 // -----------------------------------------------------------------------------
 // Platforms
 // -----------------------------------------------------------------------------
@@ -1018,9 +1046,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>
@@ -1052,6 +1091,8 @@ skm publish &lt;skill-name&gt; --version 1.0.1</pre>
           <tr><td><code>skm platforms</code></td><td>查看可用平台</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 set npmRegistry https://...</code></td><td>设置 registry 镜像</td></tr>
         </tbody>
       </table>
     </div>

package/gui/style.css

@@ -366,6 +366,54 @@ body {
   font-size: 0.85rem;
 }
 
+.pagination .page-jump {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  color: var(--text-muted);
+  font-size: 0.85rem;
+}
+
+.pagination .page-jump input {
+  width: 50px;
+  padding: 5px 6px;
+  background: var(--bg-secondary);
+  border: 1px solid var(--border-color);
+  color: var(--text-secondary);
+  border-radius: 4px;
+  font-size: 0.85rem;
+  text-align: center;
+}
+
+.pagination .page-jump input:focus {
+  outline: none;
+  border-color: var(--accent);
+}
+
+.pagination .page-jump button {
+  padding: 5px 10px;
+  background: var(--bg-card);
+  border: 1px solid var(--border-color);
+  color: var(--text-secondary);
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 0.8rem;
+}
+
+.pagination .page-jump button:hover {
+  background: var(--bg-hover);
+}
+
+/* Hide spinner for number input */
+.pagination .page-jump input::-webkit-outer-spin-button,
+.pagination .page-jump input::-webkit-inner-spin-button {
+  -webkit-appearance: none;
+  margin: 0;
+}
+.pagination .page-jump input[type=number] {
+  -moz-appearance: textfield;
+}
+
 /* -----------------------------------------------------------------------------
    Skill 详情视图
    ----------------------------------------------------------------------------- */

package/package.json

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