itismyskillmarket 1.3.9 → 1.3.11

package/dist/index.js

@@ -103,7 +103,37 @@ async function isSkillInstalled(skillId) {
 // src/commands/npm.ts
 import https from "https";
 import { URL as URL2 } from "url";
-async function fetchNpmPackage(packageName) {
+
+// 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 {
+      const result = await fetchNpmPackageOnce(packageName);
+      if (result !== null) return result;
+    } catch {
+      if (attempt === retries) return null;
+    }
+    if (attempt < retries) {
+      await new Promise((r) => setTimeout(r, 500));
+    }
+  }
+  return null;
+}
+async function fetchNpmPackageOnce(packageName) {
   return new Promise((resolve2, reject) => {
     const isScoped = packageName.startsWith("@");
     let encodedName;
@@ -123,6 +153,11 @@ async function fetchNpmPackage(packageName) {
     const url = new URL2(`https://registry.npmjs.org/${encodedName}`);
     const req = https.get(url.toString(), { timeout: 1e4 }, (res) => {
       let data = "";
+      if (res.statusCode && res.statusCode >= 400) {
+        res.resume();
+        resolve2(null);
+        return;
+      }
       res.on("data", (chunk) => {
         data += chunk;
       });
@@ -146,18 +181,6 @@ async function fetchNpmPackage(packageName) {
     });
   });
 }
-var SKILL_SCOPES = [
-  "@wanxuchen",
-  // 原作者 scope
-  "@itismyskillmarket",
-  // 当前包名 scope
-  "@thisisskillmarket",
-  // 曾用 scope
-  "@this-is-skillmarket",
-  // 曾用 scope (带横线)
-  "@skillmarket"
-  // 通用 scope
-];
 function getPossiblePackageNames(skillId) {
   if (skillId.startsWith("@")) {
     return [skillId];
@@ -884,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}...`);
@@ -901,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) {
@@ -1424,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
@@ -1607,6 +1630,7 @@ API_ROUTES.GET["/api/skills"] = async (_req, res, url) => {
       setCache(cacheKey, searchResult, 3e4);
     }
     const { packages, total } = searchResult;
+    let fetchErrors = 0;
     const skillDetails = await throttledMap(packages, async (pkgName) => {
       try {
         const pkgCacheKey = `pkg:${pkgName}`;
@@ -1615,7 +1639,10 @@ API_ROUTES.GET["/api/skills"] = async (_req, res, url) => {
           info = await fetchNpmPackage(pkgName);
           if (info) setCache(pkgCacheKey, info, 3e4);
         }
-        if (!info) return null;
+        if (!info) {
+          fetchErrors++;
+          return null;
+        }
         const latestVersion = info["dist-tags"]?.latest || "unknown";
         const pkg = info.versions?.[latestVersion];
         const meta = pkg?.skillmarket;
@@ -1631,12 +1658,13 @@ API_ROUTES.GET["/api/skills"] = async (_req, res, url) => {
           repository: pkg?.repository?.url || ""
         };
       } catch {
+        fetchErrors++;
         return null;
       }
     }, 3);
     const skills = skillDetails.filter(Boolean);
     const totalPages = Math.ceil(total / limit) || 1;
-    jsonResponse(res, 200, { skills, page, totalPages, total });
+    jsonResponse(res, 200, { skills, page, totalPages, total, fetchErrors });
   } catch (err) {
     jsonResponse(res, 500, {
       error: String(err),
@@ -1722,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);
@@ -1779,7 +1816,12 @@ function serveStaticFile(res, filePath) {
   const content = readFileSync(filePath);
   const ext = extname(filePath);
   const mime = MIME_TYPES[ext] || "application/octet-stream";
-  res.writeHead(200, { "Content-Type": mime });
+  res.writeHead(200, {
+    "Content-Type": mime,
+    "Cache-Control": "no-cache, no-store, must-revalidate",
+    "Pragma": "no-cache",
+    "Expires": "0"
+  });
   res.end(content);
 }
 async function handleRequest(req, res) {

package/gui/app.js

@@ -68,6 +68,9 @@ function switchView(view) {
     case 'platforms':
       loadPlatforms();
       break;
+    case 'help':
+      loadHelp();
+      break;
   }
 }
 
@@ -135,6 +138,7 @@ async function loadSkills() {
     
     renderSkills(data.skills || data, container);
     renderPagination(data.page, data.totalPages || 1);
+    renderFetchWarning(data.fetchErrors);
   } catch (err) {
     container.innerHTML = `<div class="loading">Error: ${err.message}</div>`;
   }
@@ -191,6 +195,23 @@ function createSkillCard(skill, isInstalled) {
   `;
 }
 
+// -----------------------------------------------------------------------------
+// 网络错误提示
+// -----------------------------------------------------------------------------
+
+function renderFetchWarning(fetchErrors) {
+  const existing = document.getElementById('fetch-warning');
+  if (existing) existing.remove();
+
+  if (!fetchErrors || fetchErrors === 0) return;
+
+  const warning = document.createElement('div');
+  warning.id = 'fetch-warning';
+  warning.style.cssText = 'background: #664400; color: #ffcc00; padding: 8px 16px; border-radius: 6px; margin-bottom: 16px; font-size: 0.9rem;';
+  warning.textContent = `⚠ ${fetchErrors} skill(s) failed to load details from npm registry. Refresh to retry.`;
+  document.querySelector('.view-header').after(warning);
+}
+
 // -----------------------------------------------------------------------------
 // 分页
 // -----------------------------------------------------------------------------
@@ -266,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.9</span>
+        <span class="version" id="gui-version">v1.3.11</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.9",
+  "version": "1.3.11",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
   "bin": {