itismyskillmarket 1.3.10 → 1.3.11

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);

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.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.10",
+  "version": "1.3.11",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
   "bin": {