itismyskillmarket 1.3.10 → 1.3.12

package/dist/index.js

@@ -103,6 +103,22 @@ async function isSkillInstalled(skillId) {
 // src/commands/npm.ts
 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";
+var DEFAULT_SCOPES = [
+  "@itismyskillmarket",
+  "@wanxuchen",
+  "@thisisskillmarket",
+  "@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}`;
+
+// src/commands/npm.ts
 async function fetchNpmPackage(packageName, retries = 1) {
   for (let attempt = 0; attempt <= retries; attempt++) {
     try {
@@ -165,18 +181,6 @@ async function fetchNpmPackageOnce(packageName) {
     });
   });
 }
-var SKILL_SCOPES = [
-  "@wanxuchen",
-  // 原作者 scope
-  "@itismyskillmarket",
-  // 当前包名 scope
-  "@thisisskillmarket",
-  // 曾用 scope
-  "@this-is-skillmarket",
-  // 曾用 scope (带横线)
-  "@skillmarket"
-  // 通用 scope
-];
 function getPossiblePackageNames(skillId) {
   if (skillId.startsWith("@")) {
     return [skillId];
@@ -903,7 +907,7 @@ async function syncSkill(skillId) {
 // src/commands/update.ts
 async function updateSkill(skillId) {
   if (skillId) {
-    const pkgInfo = await fetchNpmPackage(`@itismyskillmarket/${skillId}`);
+    const pkgInfo = await fetchNpmPackage(`${NPM_SCOPE}/${skillId}`);
     if (pkgInfo) {
       const latestVersion = pkgInfo["dist-tags"]?.latest;
       console.log(`Updating ${skillId} to ${latestVersion}...`);
@@ -920,7 +924,7 @@ async function updateSkill(skillId) {
 `);
   let hasUpdates = false;
   for (const skill of installed) {
-    const pkgInfo = await fetchNpmPackage(`@wanxuchen/${skill.id}`);
+    const pkgInfo = await fetchNpmPackage(`${NPM_SCOPE_FALLBACK}/${skill.id}`);
     if (pkgInfo) {
       const latestVersion = pkgInfo["dist-tags"]?.latest;
       if (latestVersion && latestVersion !== skill.version) {
@@ -1443,7 +1447,7 @@ async function publishSkill(skillName, options) {
   }
   console.log(`
 \u2705 ${skillName} published successfully!`);
-  console.log(`   View at: https://www.npmjs.com/package/@itismyskillmarket/${skillName}`);
+  console.log(`   View at: ${SKM_URL}/${skillName}`);
 }
 
 // src/commands/verify.ts
@@ -1746,6 +1750,15 @@ API_ROUTES.GET["/api/skill-info"] = async (_req, res, url) => {
     jsonResponse(res, 500, { error: String(err) });
   }
 };
+API_ROUTES.GET["/api/config"] = async (_req, res, _url) => {
+  jsonResponse(res, 200, {
+    npmScope: NPM_SCOPE,
+    npmScopeFallback: NPM_SCOPE_FALLBACK,
+    npmRegistry: NPM_REGISTRY,
+    skmUrl: SKM_URL,
+    skillScopes: SKILL_SCOPES
+  });
+};
 API_ROUTES.POST["/api/install"] = async (req, res, _url) => {
   try {
     const body = await parseBody(req);
@@ -1856,6 +1869,336 @@ Press Ctrl+C to stop
   });
 }
 
+// src/commands/admin.ts
+async function fetchScopePackages() {
+  const all = /* @__PURE__ */ new Set();
+  for (const scope of SKILL_SCOPES) {
+    try {
+      const { packages } = await searchSkillmarketPackages({ from: 0, size: 100, keyword: scope });
+      for (const p of packages) {
+        if (p.startsWith(scope)) all.add(p);
+      }
+    } catch {
+    }
+  }
+  return [...all].sort();
+}
+async function adminList() {
+  console.log("\n\u{1F50D} Fetching all published skills...\n");
+  const packages = await fetchScopePackages();
+  if (packages.length === 0) {
+    console.log("No published skills found.");
+    return;
+  }
+  const details = await Promise.all(
+    packages.map(async (pkg) => {
+      try {
+        const info = await fetchNpmPackage(pkg);
+        if (!info) return null;
+        const ver = info["dist-tags"]?.latest || "?";
+        const p = info.versions?.[ver];
+        return {
+          name: info.name,
+          version: ver,
+          description: p?.description || "",
+          hasSkillmarket: !!p?.skillmarket,
+          platforms: (p?.skillmarket?.platforms || []).join(", "),
+          updated: info.time?.[ver] || ""
+        };
+      } catch {
+        return null;
+      }
+    })
+  );
+  const valid = details.filter(Boolean);
+  console.log(`\u{1F4E6} ${valid.length} published skill(s):
+`);
+  valid.sort((a, b) => a.name.localeCompare(b.name));
+  for (const d of valid) {
+    const flag = d.hasSkillmarket ? "\u2705" : "\u{1F4E6}";
+    console.log(`  ${flag}  ${d.name}@${d.version}`);
+    if (d.description) console.log(`       ${d.description.slice(0, 80)}`);
+    if (d.platforms) console.log(`       Platforms: ${d.platforms}`);
+    console.log();
+  }
+}
+async function adminInfo(skillId) {
+  console.log(`
+\u{1F50D} Fetching detailed info for "${skillId}"...
+`);
+  const info = await fetchSkillPackage(skillId);
+  if (!info) {
+    console.error(`\u274C Skill "${skillId}" not found in any configured scope.`);
+    console.log(`   Scopes checked: ${SKILL_SCOPES.join(", ")}`);
+    process.exit(1);
+  }
+  const latestVer = info["dist-tags"]?.latest || "unknown";
+  const latestPkg = info.versions?.[latestVer];
+  const meta = latestPkg?.skillmarket;
+  const allVersions = Object.keys(info.versions || {});
+  console.log(`\u{1F4E6} ${info.name}`);
+  console.log(`   Description: ${info.description || "N/A"}`);
+  console.log(`   Latest: ${latestVer}`);
+  console.log(`   Total versions: ${allVersions.length}`);
+  console.log(`   Modified: ${info.time?.modified || "N/A"}`);
+  console.log(`   Author: ${info.author?.name || latestPkg?.author?.name || "N/A"}`);
+  console.log(`   License: ${info.license || latestPkg?.license || "N/A"}`);
+  if (meta) {
+    console.log(`
+\u{1F4CB} SkillMarket Metadata:`);
+    if (meta.id) console.log(`   ID: ${meta.id}`);
+    if (meta.displayName) console.log(`   Display Name: ${meta.displayName}`);
+    if (meta.description) console.log(`   Description: ${meta.description}`);
+    if (meta.platforms && meta.platforms.length > 0) {
+      console.log(`   Platforms: ${meta.platforms.join(", ")}`);
+      const unknown = meta.platforms.filter((p) => !PLATFORMS.includes(p));
+      if (unknown.length > 0) {
+        console.log(`   \u26A0\uFE0F  Unknown platforms: ${unknown.join(", ")}`);
+      }
+    }
+  } else {
+    console.log(`
+\u26A0\uFE0F  No SkillMarket metadata (not a skillmarket skill)`);
+  }
+  console.log(`
+\u{1F4C5} Version History:`);
+  for (const ver of allVersions.slice().reverse()) {
+    const v = info.versions?.[ver];
+    const time = info.time?.[ver] ? new Date(info.time[ver]).toLocaleDateString() : "?";
+    const size = v?.dist?.unpackedSize ? ` (${(v.dist.unpackedSize / 1024).toFixed(1)} KB)` : "";
+    const tag = ver === latestVer ? " \u2190 latest" : "";
+    console.log(`   ${ver}${tag} \u2014 ${time}${size}`);
+  }
+  const tags = info["dist-tags"] || {};
+  const otherTags = Object.entries(tags).filter(([k]) => k !== "latest");
+  if (otherTags.length > 0) {
+    console.log(`
+\u{1F3F7}\uFE0F  dist-tags:`);
+    for (const [tag, ver] of otherTags) {
+      console.log(`   ${tag}: ${ver}`);
+    }
+  }
+  console.log(`
+\u{1F517} Registry:`);
+  console.log(`   ${NPM_REGISTRY}/${info.name}`);
+  console.log();
+}
+async function adminSearch(keyword, limit = 20) {
+  console.log(`
+\u{1F50D} Searching published skills for "${keyword}"...
+`);
+  const scopePackages = await fetchScopePackages();
+  const matched = scopePackages.filter(
+    (p) => p.toLowerCase().includes(keyword.toLowerCase())
+  );
+  if (matched.length === 0) {
+    const { packages } = await searchSkillmarketPackages({ keyword });
+    const filtered = packages.filter((p) => p.toLowerCase().includes(keyword.toLowerCase())).slice(0, limit);
+    if (filtered.length === 0) {
+      console.log(`No skills found matching "${keyword}".`);
+      return;
+    }
+    console.log(`Found ${filtered.length} skill(s) (from npm keyword search):
+`);
+    for (const pkg of filtered) {
+      const info = await fetchNpmPackage(pkg);
+      const ver = info?.["dist-tags"]?.latest || "?";
+      const p = info?.versions?.[ver];
+      console.log(`   ${pkg}@${ver}`);
+      if (p?.description) console.log(`   ${p.description.slice(0, 80)}`);
+      console.log();
+    }
+    return;
+  }
+  console.log(`Found ${matched.length} skill(s) in configured scopes:
+`);
+  const show = matched.slice(0, limit);
+  for (const pkg of show) {
+    const info = await fetchNpmPackage(pkg);
+    const ver = info?.["dist-tags"]?.latest || "?";
+    const p = info?.versions?.[ver];
+    console.log(`   ${pkg}@${ver}`);
+    if (p?.skillmarket) {
+      console.log(`   \u{1F4CB} ${p.skillmarket.displayName || ""} \u2014 Platforms: ${(p.skillmarket.platforms || []).join(", ") || "none"}`);
+    }
+    if (p?.description) console.log(`   ${p.description.slice(0, 80)}`);
+    console.log();
+  }
+  if (matched.length > limit) {
+    console.log(`   ... and ${matched.length - limit} more (use --limit to show more)`);
+  }
+}
+async function adminStats() {
+  console.log("\n\u{1F4CA} SkillMarket Publishing Statistics\n");
+  const packages = await fetchScopePackages();
+  if (packages.length === 0) {
+    console.log("No published skills found.");
+    return;
+  }
+  const infos = (await Promise.all(
+    packages.map(async (pkg) => {
+      try {
+        const info = await fetchNpmPackage(pkg);
+        return info ? { name: pkg, info } : null;
+      } catch {
+        return null;
+      }
+    })
+  )).filter(Boolean);
+  const totalSkills = infos.length;
+  let totalVersions = 0;
+  let totalSize = 0;
+  const platformSet = /* @__PURE__ */ new Set();
+  let withMetadata = 0;
+  let mostVersions = { name: "", count: 0 };
+  let mostRecent = { name: "", date: "" };
+  for (const { name, info } of infos) {
+    const versions = Object.keys(info.versions || {});
+    totalVersions += versions.length;
+    if (versions.length > mostVersions.count) {
+      mostVersions = { name, count: versions.length };
+    }
+    const latestVer = info["dist-tags"]?.latest;
+    const latestPkg = latestVer ? info.versions?.[latestVer] : void 0;
+    const meta = latestPkg?.skillmarket;
+    if (meta) {
+      withMetadata++;
+      if (meta.platforms) {
+        for (const p of meta.platforms) platformSet.add(p);
+      }
+    }
+    if (latestPkg?.dist?.unpackedSize) {
+      totalSize += latestPkg.dist.unpackedSize;
+    }
+    const modTime = info.time?.modified || "";
+    if (modTime && modTime > mostRecent.date) {
+      mostRecent = { name, date: modTime };
+    }
+  }
+  console.log(`\u{1F4E6} Total published skills: ${totalSkills}`);
+  console.log(`\u{1F4DD} Total versions: ${totalVersions}`);
+  console.log(`   Avg versions/skill: ${(totalVersions / totalSkills).toFixed(1)}`);
+  console.log(`\u{1F4CB} Skills with skillmarket metadata: ${withMetadata}/${totalSkills}`);
+  console.log(`\u{1F4BE} Total unpacked size: ${(totalSize / 1024 / 1024).toFixed(2)} MB`);
+  console.log(`\u{1F527} Platforms covered: ${platformSet.size} (${[...platformSet].join(", ")})`);
+  console.log(`\u{1F3C6} Most versions: ${mostVersions.name} (${mostVersions.count})`);
+  if (mostRecent.date) {
+    console.log(`\u{1F550} Most recent update: ${mostRecent.name} (${new Date(mostRecent.date).toLocaleDateString()})`);
+  }
+  console.log(`\u{1F517} Registry: ${NPM_REGISTRY}`);
+  console.log(`
+Configured scopes: ${SKILL_SCOPES.join(", ")}`);
+  console.log();
+}
+async function adminVerify(skillId) {
+  console.log(`
+\u{1F50D} Verifying published skill "${skillId}"...
+`);
+  const info = await fetchSkillPackage(skillId);
+  if (!info) {
+    console.error(`\u274C Skill "${skillId}" not found.`);
+    process.exit(1);
+  }
+  let passed = 0;
+  let failed = 0;
+  let warnings = 0;
+  const nameValid = /^@[^/]+\/[^/]+$/.test(info.name);
+  if (nameValid) {
+    console.log(`\u2705 Package name format: ${info.name}`);
+    passed++;
+  } else {
+    console.log(`\u26A0\uFE0F  Package name format unusual: ${info.name}`);
+    warnings++;
+  }
+  const tags = info["dist-tags"] || {};
+  if (tags.latest) {
+    console.log(`\u2705 dist-tags.latest: ${tags.latest}`);
+    passed++;
+  } else {
+    console.log(`\u274C dist-tags.latest missing`);
+    failed++;
+  }
+  const latestVer = tags.latest;
+  const latestPkg = latestVer ? info.versions?.[latestVer] : void 0;
+  if (latestPkg) {
+    console.log(`\u2705 Latest version ${latestVer} exists in versions`);
+    passed++;
+  } else {
+    console.log(`\u274C Latest version ${latestVer} not found in versions object`);
+    failed++;
+  }
+  const meta = latestPkg?.skillmarket;
+  if (meta) {
+    console.log(`\u2705 Has skillmarket metadata`);
+    const checks = [
+      { name: "id", ok: !!meta.id },
+      { name: "displayName", ok: !!meta.displayName },
+      { name: "platforms (array)", ok: Array.isArray(meta.platforms) && meta.platforms.length > 0 }
+    ];
+    for (const c of checks) {
+      if (c.ok) {
+        console.log(`   \u2705 skillmarket.${c.name}`);
+        passed++;
+      } else {
+        console.log(`   \u26A0\uFE0F  skillmarket.${c.name} missing or empty`);
+        warnings++;
+      }
+    }
+    if (meta.platforms) {
+      const unknown = meta.platforms.filter(
+        (p) => !PLATFORMS.includes(p)
+      );
+      if (unknown.length > 0) {
+        console.log(`   \u26A0\uFE0F  Unknown platforms: ${unknown.join(", ")}`);
+        warnings++;
+      } else {
+        console.log(`   \u2705 All platforms recognized`);
+        passed++;
+      }
+    }
+  } else {
+    console.log(`\u26A0\uFE0F  No skillmarket metadata (not a skillmarket-formatted skill)`);
+    warnings++;
+  }
+  if (latestPkg?.description) {
+    console.log(`\u2705 Has description (${latestPkg.description.length} chars)`);
+    passed++;
+  } else {
+    console.log(`\u26A0\uFE0F  No description`);
+    warnings++;
+  }
+  if (info.license || latestPkg?.license) {
+    console.log(`\u2705 License: ${info.license || latestPkg?.license}`);
+    passed++;
+  } else {
+    console.log(`\u26A0\uFE0F  No license specified`);
+    warnings++;
+  }
+  if (latestPkg?.dist?.unpackedSize) {
+    const sizeKB = (latestPkg.dist.unpackedSize / 1024).toFixed(1);
+    console.log(`\u2705 Package size: ${sizeKB} KB (unpacked)`);
+    passed++;
+  }
+  const versionCount = Object.keys(info.versions || {}).length;
+  console.log(`\u2139\uFE0F  Total versions: ${versionCount}`);
+  const total = passed + failed;
+  console.log(`
+\u{1F4CA} Verification Result:`);
+  console.log(`   \u2705 Passed: ${passed}`);
+  console.log(`   \u26A0\uFE0F  Warnings: ${warnings}`);
+  console.log(`   \u274C Failed: ${failed}`);
+  if (failed === 0) {
+    console.log(`
+\u2705 Skill "${skillId}" is valid!
+`);
+  } else {
+    console.log(`
+\u26A0\uFE0F  Skill "${skillId}" has issues that need attention.
+`);
+    process.exitCode = 1;
+  }
+}
+
 // src/cli.ts
 var __filename3 = fileURLToPath4(import.meta.url);
 var __dirname3 = dirname2(__filename3);
@@ -2048,4 +2391,45 @@ program.command("verify <skill>").description("Verify skill integrity and format
     process.exit(1);
   }
 });
+var admin = program.command("admin").description("Admin: manage published skills (cloud)");
+admin.command("ls").description("List all published skills").action(async () => {
+  try {
+    await adminList();
+  } catch (err) {
+    console.error("Admin ls failed:", err);
+    process.exit(1);
+  }
+});
+admin.command("info <skill>").description("Show detailed info for a published skill").action(async (skill) => {
+  try {
+    await adminInfo(skill);
+  } catch (err) {
+    console.error("Admin info failed:", err);
+    process.exit(1);
+  }
+});
+admin.command("search <keyword>").description("Search across published skills").option("-l, --limit <number>", "Max results (default: 20)", parseInt).action(async (keyword, opts) => {
+  try {
+    await adminSearch(keyword, opts.limit ?? 20);
+  } catch (err) {
+    console.error("Admin search failed:", err);
+    process.exit(1);
+  }
+});
+admin.command("stats").description("Show publishing statistics").action(async () => {
+  try {
+    await adminStats();
+  } catch (err) {
+    console.error("Admin stats failed:", err);
+    process.exit(1);
+  }
+});
+admin.command("verify <skill>").description("Verify a published skill structure and metadata").action(async (skill) => {
+  try {
+    await adminVerify(skill);
+  } catch (err) {
+    console.error("Admin verify failed:", err);
+    process.exit(1);
+  }
+});
 program.parse();

package/gui/app.js

@@ -68,6 +68,9 @@ function switchView(view) {
     case 'platforms':
       loadPlatforms();
       break;
+    case 'help':
+      loadHelp();
+      break;
   }
 }
 
@@ -284,9 +287,101 @@ function renderPlatforms(platforms, container) {
 }
 
 // -----------------------------------------------------------------------------
-// 操作函数
+// Help 视图
 // -----------------------------------------------------------------------------
 
+async function loadHelp() {
+  const container = document.getElementById('help-content');
+  container.innerHTML = '<div class="loading">Loading...</div>';
+
+  try {
+    const response = await fetch('/api/config');
+    const config = await response.json();
+    renderHelp(config, container);
+  } catch (err) {
+    container.innerHTML = `<div class="loading">Error: ${err.message}</div>`;
+  }
+}
+
+function renderHelp(config, container) {
+  const envVars = [
+    { var: 'SKM_NPM_SCOPE', default: config.npmScope, desc: '主要 npm scope，用于发布/查找 skill' },
+    { var: 'SKM_NPM_SCOPE_FALLBACK', default: config.npmScopeFallback, desc: '回退 scope（兼容旧安装）' },
+    { var: 'SKM_NPM_SCOPES', default: config.skillScopes.join(', '), desc: '搜索时尝试的 scope 列表（逗号分隔）' },
+    { var: 'SKM_NPM_REGISTRY', default: config.npmRegistry, desc: 'npm registry 地址' },
+    { var: 'SKM_URL', default: config.skmUrl, desc: '个人链接前缀（publish 输出用）' },
+  ];
+
+  container.innerHTML = `
+    <div class="help-section">
+      <h3>📖 GitHub Actions — Publish Skill</h3>
+      <p>在 GitHub 仓库页面操作：</p>
+      <div class="help-steps">
+        <div class="help-step">
+          <strong>发布主包（SkillMarket CLI）</strong>
+          <ol>
+            <li>GitHub → <strong>Releases</strong> → Create a new release</li>
+            <li>输入 Tag (如 v1.3.11)，点击 Publish release</li>
+            <li>Action <code>Publish to npm</code> 自动触发 → 构建 → npm publish</li>
+          </ol>
+        </div>
+        <div class="help-step">
+          <strong>发布独立 Skill</strong>
+          <ol>
+            <li>GitHub → <strong>Actions</strong> → Publish Skill → Run workflow</li>
+            <li>输入 <code>skill_name</code>（skills/ 下的目录名）和可选 <code>version</code></li>
+            <li>自动执行：npm install → npm version → npm publish</li>
+          </ol>
+          <p class="help-note">⚠ 需要 GitHub Secrets 中配置 <code>NPM_TOKEN</code></p>
+        </div>
+        <div class="help-step">
+          <strong>本地发布</strong>
+          <pre>skm publish &lt;skill-name&gt;
+skm publish &lt;skill-name&gt; --version 1.0.1</pre>
+        </div>
+      </div>
+    </div>
+
+    <div class="help-section">
+      <h3>⚙️ 环境变量配置</h3>
+      <p>设置以下环境变量可覆盖默认配置：</p>
+      <table class="help-table">
+        <thead>
+          <tr><th>变量</th><th>当前值</th><th>说明</th></tr>
+        </thead>
+        <tbody>
+          ${envVars.map(v => `
+            <tr>
+              <td><code>${v.var}</code></td>
+              <td><code>${v.default}</code></td>
+              <td>${v.desc}</td>
+            </tr>
+          `).join('')}
+        </tbody>
+      </table>
+    </div>
+
+    <div class="help-section">
+      <h3>🔧 常用命令</h3>
+      <table class="help-table">
+        <thead><tr><th>命令</th><th>说明</th></tr></thead>
+        <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 install &lt;skill&gt;</code></td><td>安装 skill 到所有平台</td></tr>
+          <tr><td><code>skm install &lt;skill&gt; --platform opencode</code></td><td>安装到指定平台</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 update --all</code></td><td>更新所有 skills</td></tr>
+          <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>
+        </tbody>
+      </table>
+    </div>
+  `;
+}
+
 async function installSkill(skillId) {
   try {
     showToast(`Installing ${skillId}...`, 'info');

package/gui/index.html

@@ -23,9 +23,12 @@
         <button class="nav-btn" data-view="platforms">
           <span class="icon">💻</span> Platforms
         </button>
+        <button class="nav-btn" data-view="help">
+          <span class="icon">📖</span> Help
+        </button>
       </nav>
       <div class="sidebar-footer">
-        <span class="version" id="gui-version">v1.3.10</span>
+        <span class="version" id="gui-version">v1.3.12</span>
       </div>
     </aside>
 
@@ -65,6 +68,14 @@
         </div>
         <div id="platforms-list" class="platforms-list"></div>
       </div>
+
+      <!-- Help 视图 -->
+      <div id="view-help" class="view">
+        <div class="view-header">
+          <h2>Help &amp; Configuration</h2>
+        </div>
+        <div id="help-content"></div>
+      </div>
     </main>
 
     <!-- Skill 详情模态框 -->

package/gui/style.css

@@ -435,6 +435,105 @@ nav {
   color: var(--text-muted);
 }
 
+/* -----------------------------------------------------------------------------
+   Help 视图
+   ----------------------------------------------------------------------------- */
+
+.help-section {
+  background: var(--bg-secondary);
+  border: 1px solid var(--border-color);
+  border-radius: 10px;
+  padding: 24px;
+  margin-bottom: 20px;
+}
+
+.help-section h3 {
+  color: var(--accent);
+  font-size: 1.15rem;
+  margin-bottom: 12px;
+}
+
+.help-section > p {
+  color: var(--text-secondary);
+  font-size: 0.9rem;
+  margin-bottom: 16px;
+}
+
+.help-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.help-step {
+  background: var(--bg-card);
+  border-radius: 8px;
+  padding: 16px;
+}
+
+.help-step > strong {
+  color: var(--text-secondary);
+  font-size: 0.95rem;
+  display: block;
+  margin-bottom: 8px;
+}
+
+.help-step ol {
+  margin: 0;
+  padding-left: 20px;
+  color: var(--text-secondary);
+  font-size: 0.9rem;
+  line-height: 1.8;
+}
+
+.help-step pre {
+  background: var(--bg-primary);
+  color: var(--text-secondary);
+  padding: 12px;
+  border-radius: 6px;
+  font-size: 0.85rem;
+  overflow-x: auto;
+  margin: 8px 0 0;
+}
+
+.help-note {
+  color: #ffcc00;
+  font-size: 0.85rem;
+  margin-top: 8px;
+}
+
+.help-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.9rem;
+}
+
+.help-table th {
+  text-align: left;
+  padding: 10px 12px;
+  background: var(--bg-card);
+  color: var(--text-secondary);
+  border-bottom: 2px solid var(--border-color);
+}
+
+.help-table td {
+  padding: 10px 12px;
+  color: var(--text-secondary);
+  border-bottom: 1px solid var(--border-color);
+  vertical-align: top;
+}
+
+.help-table code {
+  background: var(--bg-card);
+  padding: 2px 6px;
+  border-radius: 3px;
+  font-size: 0.85rem;
+}
+
+.help-table tr:hover td {
+  background: var(--bg-hover);
+}
+
 /* -----------------------------------------------------------------------------
    滚动条
    ----------------------------------------------------------------------------- */

package/package.json

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