itismyskillmarket 1.2.2 → 1.2.4

package/src/commands/ls.ts

@@ -37,6 +37,12 @@ interface LsOptions {
   
   /** 检查更新（预留功能） */
   updates?: boolean;
+  
+  /** 页码（从 1 开始） */
+  page?: number;
+  
+  /** 每页数量 */
+  limit?: number;
 }
 
 // -----------------------------------------------------------------------------
@@ -60,25 +66,33 @@ interface LsOptions {
  * await listSkills({ installed: true });
  */
 export async function listSkills(options: LsOptions): Promise<void> {
-  const { installed, updates } = options;
+  const { installed, updates, page = 1, limit = 20 } = options;
   
   // -------------------------------------------------------------------------
   // 模式1: 显示已安装的 skills
   // -------------------------------------------------------------------------
   if (installed) {
     const skills = await getInstalledSkills();
+    const total = skills.length;
+    const totalPages = Math.ceil(total / limit) || 1;
+    const currentPage = Math.min(Math.max(1, page), totalPages);
     
     // 无已安装 skills 时给出提示
     if (skills.length === 0) {
-      console.log('No skills installed yet. Run "skm --ls" to see available skills.');
+      console.log('No skills installed yet. Run "skm ls" to see available skills.');
       return;
     }
     
+    // 计算分页范围
+    const start = (currentPage - 1) * limit;
+    const end = Math.min(start + limit, total);
+    const pageSkills = skills.slice(start, end);
+    
     // 打印表头
-    console.log('Installed Skills:\n');
+    console.log(`Installed Skills (${total}):\n`);
     
     // 遍历并打印每个 skill 的详细信息
-    for (const skill of skills) {
+    for (const skill of pageSkills) {
       // skill 名称和版本
       console.log(`  ${skill.id}@${skill.version}`);
       
@@ -92,6 +106,9 @@ export async function listSkills(options: LsOptions): Promise<void> {
       console.log();
     }
     
+    // 打印分页信息
+    console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
+    
     return;
   }
   
@@ -103,8 +120,17 @@ export async function listSkills(options: LsOptions): Promise<void> {
   console.log('Searching npm registry...\n');
   
   try {
+    // 计算分页偏移量
+    const offset = (page - 1) * limit;
+    
     // 调用 npm search API 搜索 skillmarket 相关包
-    const packages = await searchSkillmarketPackages();
+    const { packages, total } = await searchSkillmarketPackages({
+      from: offset,
+      size: limit
+    });
+    
+    const totalPages = Math.ceil(total / limit) || 1;
+    const currentPage = Math.min(Math.max(1, page), totalPages);
     
     // 无搜索结果时
     if (packages.length === 0) {
@@ -113,28 +139,58 @@ export async function listSkills(options: LsOptions): Promise<void> {
     }
     
     // 打印找到的包数量
-    console.log(`Found ${packages.length} skill(s):\n`);
+    console.log(`Found ${total} skill(s):\n`);
     
     // 遍历每个包，获取详细信息并显示
     for (const pkgName of packages) {
-      const info = await fetchNpmPackage(pkgName);
-      
-      if (info && info['dist-tags']?.latest) {
-        const latestVersion = info['dist-tags'].latest;
+      try {
+        const info = await fetchNpmPackage(pkgName);
+        
+        if (!info) {
+          // 如果获取失败，仍然显示包名
+          console.log(`📦 ${pkgName} (信息获取失败)`);
+          console.log();
+          continue;
+        }
+        
+        // 获取最新版本号
+        const latestVersion = info['dist-tags']?.latest || 'unknown';
         
         // 获取该版本的详细信息
         const pkg = info.versions?.[latestVersion];
         
+        // 获取 skillmarket 元数据
+        const skillMeta = pkg?.skillmarket;
+        
         // 打印包名和版本
-        console.log(`  ${info.name}@${latestVersion}`);
+        console.log(`📦 ${info.name}@${latestVersion}`);
+        
+        // 打印显示名称
+        const displayName = skillMeta?.displayName || info.name;
+        console.log(`   名称: ${displayName}`);
+        
+        // 打印描述
+        console.log(`   描述: ${pkg?.description || 'N/A'}`);
         
-        // 打印描述（如果有的话）
-        console.log(`    ${pkg?.description || 'No description'}`);
+        // 打印支持平台
+        const platforms = skillMeta?.platforms || [];
+        console.log(`   平台: ${platforms.length > 0 ? platforms.join(', ') : 'N/A'}`);
+        
+        // 打印 npm 链接
+        const npmLink = pkg?.links?.npm || `https://www.npmjs.com/package/${info.name}`;
+        console.log(`   链接: ${npmLink}`);
         
         // 空行分隔
         console.log();
+      } catch (e) {
+        // 错误时仍显示包名
+        console.log(`📦 ${pkgName} (获取失败: ${e})`);
+        console.log();
       }
     }
+    
+    // 打印分页信息
+    console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
   } catch (error) {
     // 网络错误处理
     console.log(`Error fetching skills: ${error}`);

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,17 +250,25 @@ 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;
+} = {}): Promise<{ packages: string[]; total: number }> {
+  const { from = 0, size = 100 } = options;
   const packages: string[] = [];
+  let total = 0;
   
   return new Promise((resolve, reject) => {
     // 构建 search API URL
@@ -209,8 +277,10 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
     // 设置搜索参数
     // text: 搜索关键字
     // size: 返回结果数量上限
+    // from: 起始位置（分页用）
     url.searchParams.set('text', 'keywords:skillmarket');
-    url.searchParams.set('size', '100');
+    url.searchParams.set('size', String(size));
+    url.searchParams.set('from', String(from));
     
     const req = https.get(url.toString(), { timeout: 10000 }, (res) => {
       let data = '';
@@ -223,18 +293,23 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
           // 解析搜索结果
           const result = JSON.parse(data);
           
+          // 获取总数
+          total = result.total || 0;
+          
           // 提取所有匹配的包名
           // npm search 返回结构: { objects: [{ package: { name: "..." } }] }
-          for (const item of result.objects || []) {
-            if (item?.package?.name) {
-              packages.push(item.package.name);
+          if (result.objects) {
+            for (const item of result.objects) {
+              if (item?.package?.name) {
+                packages.push(item.package.name);
+              }
             }
           }
           
-          resolve(packages);
+          resolve({ packages, total });
         } catch {
           // 解析失败返回空数组
-          resolve([]);
+          resolve({ packages: [], total: 0 });
         }
       });
     });

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

package/src/commands/uninstall.ts

@@ -7,9 +7,10 @@
  * 
  * 卸载流程:
  * 1. 检查 skill 是否已安装
- * 2. 删除 skill 主目录（包含所有版本和软链接）
- * 3. 删除各平台的软链接
- * 4. 从注册表中移除记录
+ * 2. 从目标平台卸载
+ * 3. 删除 skill 主目录（包含所有版本和软链接）
+ * 4. 删除各平台的软链接
+ * 5. 从注册表中移除记录
  * 
  * @module commands/uninstall
  */
@@ -23,6 +24,18 @@ import path from 'path';                 // 路径处理
 import { loadRegistry, saveRegistry } from './registry.js';  // 注册表操作
 import { getSkillsDir, getPlatformLinksDir } from '../utils/dirs.js';  // 目录工具
 import { PLATFORMS } from '../constants.js';  // 平台常量
+import { detectPlatforms, getAdapterByPlatform } from '../adapters/index.js';  // 平台适配器
+import type { Platform } from '../constants.js';
+import type { PlatformAdapter } from '../types.js';
+
+// -----------------------------------------------------------------------------
+// 卸载选项接口
+// -----------------------------------------------------------------------------
+
+export interface UninstallOptions {
+  /** 目标平台列表（留空则卸载所有平台） */
+  platforms?: string[];
+}
 
 // -----------------------------------------------------------------------------
 // 卸载函数
@@ -32,13 +45,20 @@ import { PLATFORMS } from '../constants.js';  // 平台常量
  * 卸载指定的 skill
  * 
  * @param {string} skillId - Skill 标识符
+ * @param {UninstallOptions} [options] - 卸载选项
  * @returns {Promise<void>}
  * 
  * @example
  * // 卸载 brainstorming
  * await uninstallSkill('brainstorming');
+ * 
+ * // 从特定平台卸载
+ * await uninstallSkill('brainstorming', { platforms: ['opencode'] });
  */
-export async function uninstallSkill(skillId: string): Promise<void> {
+export async function uninstallSkill(
+  skillId: string,
+  options?: UninstallOptions
+): Promise<void> {
   // ==========================================================================
   // 步骤 1: 检查是否已安装
   // ==========================================================================
@@ -57,7 +77,40 @@ export async function uninstallSkill(skillId: string): Promise<void> {
   console.log(`Uninstalling ${skillId}@${skillInfo.version}...`);
   
   // ==========================================================================
-  // 步骤 2: 删除 skill 主目录
+  // 步骤 2: 从平台卸载 (NEW)
+  // ==========================================================================
+  
+  let targetAdapters: (PlatformAdapter | undefined)[] = [];
+  
+  if (options?.platforms && options.platforms.length > 0) {
+    // 用户指定了平台
+    for (const platformStr of options.platforms) {
+      const platform = platformStr as Platform;
+      targetAdapters.push(getAdapterByPlatform(platform));
+    }
+  } else {
+    // 自动检测可用平台
+    targetAdapters = await detectPlatforms();
+  }
+  
+  // 过滤掉 undefined（无效平台）
+  const validAdapters = targetAdapters.filter((a): a is PlatformAdapter => a !== undefined);
+  
+  if (validAdapters.length > 0) {
+    console.log(`\nUninstalling from ${validAdapters.length} platform(s)...\n`);
+    
+    for (const adapter of validAdapters) {
+      try {
+        await adapter.uninstall(skillId);
+        console.log(`${adapter.name.padEnd(12)} ✅  Uninstalled`);
+      } catch (error) {
+        console.log(`${adapter.name.padEnd(12)} ❌  Failed: ${error}`);
+      }
+    }
+  }
+  
+  // ==========================================================================
+  // 步骤 3: 删除 skill 主目录
   // ==========================================================================
   
   // skill 主目录包含所有版本和 latest 软链接
@@ -68,7 +121,7 @@ export async function uninstallSkill(skillId: string): Promise<void> {
   await fs.remove(skillDir);
   
   // ==========================================================================
-  // 步骤 3: 删除平台软链接
+  // 步骤 4: 删除平台软链接
   // ==========================================================================
   
   const platformLinksDir = getPlatformLinksDir();
@@ -85,7 +138,7 @@ export async function uninstallSkill(skillId: string): Promise<void> {
   }
   
   // ==========================================================================
-  // 步骤 4: 更新注册表
+  // 步骤 5: 更新注册表
   // ==========================================================================
   
   // 从注册表中删除该 skill 的记录

package/src/commands/update.ts

@@ -47,7 +47,7 @@ export async function updateSkill(skillId?: string): Promise<void> {
   
   if (skillId) {
     // 查询 npm 获取最新版本
-    const pkgInfo = await fetchNpmPackage(`@skillmarket/${skillId}`);
+    const pkgInfo = await fetchNpmPackage(`@itismyskillmarket/${skillId}`);
     
     if (pkgInfo) {
       const latestVersion = pkgInfo['dist-tags']?.latest;
@@ -81,7 +81,7 @@ export async function updateSkill(skillId?: string): Promise<void> {
   // 遍历每个已安装的 skill
   for (const skill of installed) {
     // 查询 npm 获取最新版本信息
-    const pkgInfo = await fetchNpmPackage(`@skillmarket/${skill.id}`);
+    const pkgInfo = await fetchNpmPackage(`@wanxuchen/${skill.id}`);
     
     if (pkgInfo) {
       const latestVersion = pkgInfo['dist-tags']?.latest;

package/src/index.ts

@@ -5,6 +5,24 @@
  * 
  * 本文件是 SkillMarket CLI 工具的入口点。
  * 
+ * Shebang (#!) 说明:
+ * - #!/usr/bin/env node 表示使用系统中的 node 解释器执行
+ * - 这使得脚本可以作为可执行文件直接运行
+ * 
+ * 包配置 (package.json):
+ * {
+ *   "bin": {
+ *     "skm": "./dist/index.js"
+ *   }
+ * }
+ * 
+ * 安装后:
+ * - 全局安装: npm install -g skillmarket
+ *   会将 skm 命令链接到系统 PATH
+ * 
+ * - 本地运行: npx skillmarket
+ *   使用 npx 直接运行而不安装
+ * 
  * 执行流程:
  * 1. Node.js 根据 shebang 启动
  * 2. 导入 cli.ts 中的命令行解析器
@@ -22,6 +40,15 @@
  * node dist/index.js --help
  */
 
+// -----------------------------------------------------------------------------
+// Shebang - 在 tsup.config.ts 的 banner 中配置
+// -----------------------------------------------------------------------------
+
+/**
+ * 注意: shebang (#!/usr/bin/env node) 现在由 tsup.config.ts 的 banner 配置添加，
+ * 不再直接写在此文件中。这确保了跨平台兼容性。
+ */
+
 // -----------------------------------------------------------------------------
 // 导入 CLI 模块
 // -----------------------------------------------------------------------------

package/src/types.ts

@@ -135,3 +135,38 @@ export interface RegistryData {
    */
   lastUpdated: string;
 }
+
+// -----------------------------------------------------------------------------
+// Platform Adapter 接口
+// -----------------------------------------------------------------------------
+
+/**
+ * Platform adapter interface for cross-platform skill installation
+ * 
+ * @interface PlatformAdapter
+ */
+export interface PlatformAdapter {
+  /** Unique platform identifier */
+  readonly id: string;
+  
+  /** Human-readable platform name */
+  readonly name: string;
+  
+  /** Platform's skill directory path */
+  readonly skillDir: string;
+  
+  /** Check if this platform is available on the current system */
+  isAvailable(): Promise<boolean>;
+  
+  /** Check if a skill is installed on this platform */
+  isInstalled(skillId: string): Promise<boolean>;
+  
+  /** Install a skill to this platform */
+  install(skillId: string, sourceDir: string): Promise<void>;
+  
+  /** Uninstall a skill from this platform */
+  uninstall(skillId: string): Promise<void>;
+  
+  /** List all skills installed on this platform */
+  listInstalled(): Promise<string[]>;
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  }
+}

package/tsup.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  banner: {
+    /**
+     * 添加 shebang 到编译后的输出
+     * 
+     * 注意: tsup 的 banner 选项会在模块内容前添加字符串，
+     * 这里用 JSON 格式传递以确保正确处理
+     */
+    js: '#!/usr/bin/env node'
+  },
+  /**
+   * 禁用 shims 以避免潜在的兼容性问题
+   * shims 会自动为某些 Node.js 模块提供垫片，
+   * 但可能与我们的场景不兼容
+   */
+  shims: false
+});