itismyskillmarket 1.3.0 → 1.3.2

package/src/commands/npm.ts

@@ -40,6 +40,14 @@ interface NpmPackage {
   /** 包描述信息 */
   description?: string;
   
+  /** npm 链接 */
+  links?: {
+    npm?: string;
+    homepage?: string;
+    repository?: string;
+    bugs?: string;
+  };
+  
   /**
    * SkillMarket 特有的元数据
    * 
@@ -146,7 +154,7 @@ export async function fetchNpmPackage(packageName: string): Promise<NpmRegistryR
       
       // 收集响应数据
       res.on('data', chunk => { data += chunk; });
-
+      
       res.on('end', () => {
         try {
           // 解析 JSON 响应
@@ -158,7 +166,7 @@ export async function fetchNpmPackage(packageName: string): Promise<NpmRegistryR
             resolve(null);
             return;
           }
-
+          
           // 成功解析，返回包信息
           resolve(parsed);
         } catch {
@@ -179,6 +187,58 @@ export async function fetchNpmPackage(packageName: string): Promise<NpmRegistryR
   });
 }
 
+// -----------------------------------------------------------------------------
+// 兼容的 Scope 列表
+// -----------------------------------------------------------------------------
+
+/**
+ * SkillMarket 支持的 npm scope 列表
+ * 按优先级排序，先尝试的 scope 排在前面
+ */
+const SKILL_SCOPES = [
+  '@wanxuchen',       // 原作者 scope
+  '@itismyskillmarket', // 当前包名 scope
+  '@thisisskillmarket', // 曾用 scope
+  '@this-is-skillmarket', // 曾用 scope (带横线)
+  '@skillmarket',     // 通用 scope
+];
+
+/**
+ * 将 skillId 转换为可能的包名列表
+ */
+function getPossiblePackageNames(skillId: string): string[] {
+  if (skillId.startsWith('@')) {
+    // 已经是 scoped 包，直接返回
+    return [skillId];
+  }
+  
+  // 生成所有可能的包名
+  return SKILL_SCOPES.map(scope => `${scope}/${skillId}`);
+}
+
+/**
+ * 尝试获取 npm 包信息，自动尝试多个可能的 scope
+ * 
+ * @param skillId - Skill ID（可以是短格式或完整格式）
+ * @returns 包信息，失败返回 null
+ */
+export async function fetchSkillPackage(skillId: string): Promise<NpmRegistryResponse | null> {
+  const packageNames = getPossiblePackageNames(skillId);
+  
+  for (const packageName of packageNames) {
+    try {
+      const info = await fetchNpmPackage(packageName);
+      if (info) {
+        return info;
+      }
+    } catch {
+      // 继续尝试下一个 scope
+    }
+  }
+  
+  return null;
+}
+
 // -----------------------------------------------------------------------------
 // 搜索包
 // -----------------------------------------------------------------------------
@@ -190,27 +250,37 @@ export async function fetchNpmPackage(packageName: string): Promise<NpmRegistryR
  * 
  * API 端点: GET https://registry.npmjs.org/-/v1/search
  * 
- * @returns {Promise<string[]>} 匹配的包名数组
+ * @param options - 搜索选项
+ * @param options.from - 起始位置（分页用）
+ * @param options.size - 返回结果数量
+ * @returns {Promise<{packages: string[], total: number}>} 匹配的包名数组和总数
  * 
  * @example
- * const packages = await searchSkillmarketPackages();
- * console.log(`找到 ${packages.length} 个 skill 包`);
+ * const { packages, total } = await searchSkillmarketPackages();
+ * console.log(`找到 ${total} 个 skill 包`);
  * packages.forEach(name => {
  *   console.log(`- ${name}`);
  * });
  */
-export async function searchSkillmarketPackages(): Promise<string[]> {
+export async function searchSkillmarketPackages(options: {
+  from?: number;
+  size?: number;
+  keyword?: string;
+} = {}): Promise<{ packages: string[]; total: number }> {
+  const { from = 0, size = 100, keyword } = options;
   const packages: string[] = [];
+  let total = 0;
   
   return new Promise((resolve, reject) => {
     // 构建 search API URL
     const url = new URL('https://registry.npmjs.org/-/v1/search');
     
     // 设置搜索参数
-    // text: 搜索关键字
-    // size: 返回结果数量上限
+    // 始终搜索 skillmarket 关键字的包
+    // 然后在本地进行精确过滤
     url.searchParams.set('text', 'keywords:skillmarket');
-    url.searchParams.set('size', '100');
+    url.searchParams.set('size', String(Math.max(size, 100))); // 获取更多结果用于本地过滤
+    url.searchParams.set('from', String(from));
     
     const req = https.get(url.toString(), { timeout: 10000 }, (res) => {
       let data = '';
@@ -223,18 +293,50 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
           // 解析搜索结果
           const result = JSON.parse(data);
           
-          // 提取所有匹配的包名
-          // npm search 返回结构: { objects: [{ package: { name: "..." } }] }
-          for (const item of result.objects || []) {
-            if (item?.package?.name) {
-              packages.push(item.package.name);
+          // 获取总数（基于过滤后的结果）
+          let filteredTotal = 0;
+          
+          // 提取所有匹配的包名，并进行本地精确过滤
+          // npm search 返回结构: { objects: [{ package: { name: "...", description: "..." } }] }
+          if (result.objects) {
+            for (const item of result.objects) {
+              if (item?.package?.name) {
+                const pkgName = item.package.name;
+                const pkgDesc = item.package.description || '';
+                
+                // 本地精确过滤：如果有关键字，检查包名或描述是否包含
+                if (keyword) {
+                  const lowerKeyword = keyword.toLowerCase();
+                  // 检查包名（处理 scoped 包名）
+                  const shortName = pkgName.includes('/') 
+                    ? pkgName.split('/')[1] 
+                    : pkgName;
+                  
+                  const nameMatch = shortName.toLowerCase().includes(lowerKeyword) ||
+                                   pkgName.toLowerCase().includes(lowerKeyword);
+                  const descMatch = pkgDesc.toLowerCase().includes(lowerKeyword);
+                  
+                  // 关键词匹配：包名或描述中包含搜索词
+                  if (nameMatch || descMatch) {
+                    packages.push(pkgName);
+                    filteredTotal++;
+                  }
+                } else {
+                  // 无关键字，返回所有
+                  packages.push(pkgName);
+                  filteredTotal++;
+                }
+              }
             }
           }
           
-          resolve(packages);
+          // 使用过滤后的总数
+          total = filteredTotal;
+          
+          resolve({ packages, total });
         } catch {
           // 解析失败返回空数组
-          resolve([]);
+          resolve({ packages: [], total: 0 });
         }
       });
     });

package/src/commands/search.ts

@@ -27,8 +27,8 @@ import {
  * search 命令选项接口
  */
 interface SearchOptions {
-  /** 搜索关键词 */
-  keyword?: string;
+  /** 最大结果数量 */
+  limit?: number;
 }
 
 // -----------------------------------------------------------------------------
@@ -47,15 +47,17 @@ interface SearchOptions {
  * 
  * @example
  * // 搜索包含 "test" 的 skills
- * await searchSkills('test', {});
+ * await searchSkills('test', { limit: 20 });
  */
-export async function searchSkills(keyword: string): Promise<void> {
+export async function searchSkills(keyword: string, options: SearchOptions = {}): Promise<void> {
+  const limit = options.limit ?? 20;
+  
   // 提示用户正在搜索
   console.log(`Searching for "${keyword}"...\n`);
   
   try {
     // 调用 npm search API 搜索 skillmarket 相关包
-    const packages = await searchSkillmarketPackages();
+    const { packages } = await searchSkillmarketPackages({ keyword });
     
     // 精确匹配：只返回包名包含关键词的 skill
     const filtered = packages.filter(pkg => 
@@ -68,11 +70,14 @@ export async function searchSkills(keyword: string): Promise<void> {
       return;
     }
     
+    // 限制结果数量
+    const results = filtered.slice(0, limit);
+    
     // 打印找到的包数量
-    console.log(`Found ${filtered.length} skill(s):\n`);
+    console.log(`Found ${filtered.length} skill(s) (showing ${results.length}):\n`);
     
     // 遍历每个包，获取详细信息并显示
-    for (const pkgName of filtered) {
+    for (const pkgName of results) {
       const info = await fetchNpmPackage(pkgName);
       
       if (info && info['dist-tags']?.latest) {

package/src/commands/sync.ts

@@ -43,7 +43,6 @@ import {
 
 import { loadRegistry } from './registry.js';
 
-import { getPlatformFromInput, type Platform } from '../utils/platform.js';
 import { PLATFORMS, LATEST_LINK } from '../constants.js';
 
 // -----------------------------------------------------------------------------
@@ -51,22 +50,18 @@ import { PLATFORMS, LATEST_LINK } from '../constants.js';
 // -----------------------------------------------------------------------------
 
 /**
- * 同步平台软链接
+ * 同步所有平台的软链接
  * 
- * 为每个已安装的 skill 在平台目录下创建软链接，
+ * 为每个已安装的 skill 在各平台目录下创建软链接，
  * 指向 skills 目录中对应的平台特定文件。
  * 
- * @param {string | Platform} [targetPlatform] - 目标平台（可选，不指定则同步所有平台）
  * @returns {Promise<void>}
  * 
  * @example
  * // 同步所有平台链接
  * await syncPlatformLinks();
- * 
- * // 仅同步到 opencode
- * await syncPlatformLinks('opencode');
  */
-export async function syncPlatformLinks(targetPlatform?: string): Promise<void> {
+export async function syncPlatformLinks(): Promise<void> {
   // ==========================================================================
   // 步骤 1: 准备
   // ==========================================================================
@@ -81,29 +76,13 @@ export async function syncPlatformLinks(targetPlatform?: string): Promise<void>
   // 加载注册表获取已安装的 skills
   const registry = await loadRegistry();
   
-  // 确定要同步的平台列表
-  let platformsToSync: Platform[];
-  
-  if (targetPlatform) {
-    const parsed = getPlatformFromInput(targetPlatform);
-    if (!parsed) {
-      console.warn(`Invalid platform: ${targetPlatform}, syncing all platforms`);
-      platformsToSync = PLATFORMS;
-    } else {
-      platformsToSync = [parsed];
-    }
-  } else {
-    platformsToSync = PLATFORMS;
-  }
-  
-  const targetDesc = targetPlatform ? targetPlatform : 'all platforms';
-  console.log(`Syncing platform links to ${targetDesc}...\n`);
+  console.log('Syncing platform links...\n');
   
   // ==========================================================================
-  // 步骤 2: 遍历指定平台
+  // 步骤 2: 遍历所有平台
   // ==========================================================================
   
-  for (const platform of platformsToSync) {
+  for (const platform of PLATFORMS) {
     // 创建平台的 skills 目录
     // 例如: ~/.skillmarket/platform-links/cursor/skills/
     const platformDir = path.join(platformLinksDir, platform, 'skills');