itismyskillmarket 1.2.1 → 1.2.3

package/src/cli.ts

@@ -14,10 +14,11 @@
  * - skm ls              列出可用的 skills
  * - skm ls --installed  列出已安装的 skills
  * - skm info <skill>    显示 skill 详情
- * - skm install <skill> 安装 skill
- * - skm uninstall <skill> 卸载 skill
+ * - skm install <skill> 安装 skill（支持 --platform）
+ * - skm uninstall <skill> 卸载 skill（支持 --platform）
  * - skm update [skill] 更新 skill(s)
  * - skm sync            同步平台链接
+ * - skm platforms       显示可用平台
  * 
  * @module cli
  */
@@ -37,6 +38,7 @@ import { installSkill } from './commands/install.js';   // 安装命令
 import { syncPlatformLinks } from './commands/sync.js';  // 同步命令
 import { updateSkill } from './commands/update.js';     // 更新命令
 import { uninstallSkill } from './commands/uninstall.js'; // 卸载命令
+import { detectPlatforms, getAllAdapters, OpenCodeAdapter, ClaudeAdapter, VSCodeAdapter } from './adapters/index.js'; // 平台适配器
 
 // -----------------------------------------------------------------------------
 // 创建命令程序实例
@@ -63,7 +65,7 @@ const program = new Command();
 program
   .name('skm')
   .description('SkillMarket - Cross-platform skill manager for AI coding tools')
-  .version('1.2.0');
+  .version('1.0.0');
 
 // -----------------------------------------------------------------------------
 // 帮助命令 (-h, --help)
@@ -74,38 +76,43 @@ program
  * 
  * 显示详细的使用说明和命令示例
  */
-const helpCmd = program.command('help').description('Display help information');
-helpCmd.action(() => {
-  console.log(`
+program
+  .hook('preAction', (thisCommand) => {
+    if (thisCommand.opts().help) {
+      console.log(`
 SkillMarket CLI
 
 Usage: skm <command> [options]
 
 Commands:
-  --help, -h          Display this help message
-  --ls [options]      List available skills
-                        --installed    Show only installed skills
-                        --updates      Check for updates
-  --info <skill-id>   Display skill information
-  --install <skill>   Install a skill (e.g., skm --install brainstorming)
-                        @version      Install specific version
-                        --all         Install all available skills
-  --uninstall <skill> Remove an installed skill
-  --update [options]  Update skills
-                        --all          Update all skills
-  --sync              Synchronize platform links
-  --platform <name>   Set target platform (${PLATFORMS.join(', ')})
+  ls [options]         List available skills
+                         --installed    Show only installed skills
+                         --updates      Check for updates
+  info <skill-id>      Display skill information
+  install <skill>      Install a skill
+                         @version      Install specific version
+                         --platform    Target platforms (opencode,claude,vscode)
+                         --force       Overwrite if already installed
+  uninstall <skill>    Remove an installed skill
+                         --platform    Target platforms
+  update [options]     Update skills
+                         --all          Update all skills
+  sync                 Synchronize platform links
+  platforms            Show available platforms
 
 Examples:
-  skm --ls                    List all available skills
-  skm --ls --installed        Show installed skills only
-  skm --info brainstorming     View skill details
-  skm --install brainstorming Install a skill
-  skm --install brainstorming@1.0.0 Install specific version
-  skm --update --all           Update all installed skills
-  skm --sync                  Sync platform links
-    `);
-});
+  skm ls                     List all available skills
+  skm ls --installed         Show installed skills only
+  skm info brainstorming     View skill details
+  skm install brainstorming  Install to all platforms
+  skm install brainstorming --platform opencode  Install to OpenCode only
+  skm install brainstorming --platform claude,vscode  Install to multiple
+  skm uninstall brainstorming
+  skm platforms              Show available platforms
+      `);
+      process.exit(0);
+    }
+  });
 
 // -----------------------------------------------------------------------------
 // 列表命令 (skm ls)
@@ -157,25 +164,36 @@ infoCmd
 /**
  * 安装命令
  * 
- * 从 npm 安装指定的 skill 到本地
+ * 从 npm 安装指定的 skill 到本地和跨平台目录
  * 
  * 用法:
- * - skm install <skill>         安装最新版本
+ * - skm install <skill>         安装到所有检测到的平台
  * - skm install <skill>@<ver>   安装指定版本
- * - skm install --all            安装所有可用 skills（预留）
+ * - skm install --platform opencode  安装到特定平台
+ * - skm install --platform claude,vscode  安装到多个平台
+ * - skm install --force         强制覆盖
  * 
  * @example
  * skm install brainstorming
  * skm install brainstorming@1.0.0
+ * skm install brainstorming --platform opencode
  */
-const installCmd = program.command('install').description('Install a skill');
+const installCmd = program.command('install').description('Install a skill to local and platform directories');
 installCmd
   .argument('<skill>', 'Skill ID to install (e.g., brainstorming or @scope/name)')
-  .option('--all', 'Install all available skills')
-  .option('-p, --platform <platform>', `Target platform (${PLATFORMS.join(', ')})`)
+  .option('-p, --platform <platforms>', 'Target platforms (comma-separated: opencode,claude,vscode)')
+  .option('-f, --force', 'Overwrite if already installed')
+  .option('-v, --version <version>', 'Specific version to install')
   .action(async (skill, opts) => {
     try {
-      await installSkill(skill, undefined, opts.platform);
+      const platforms = opts.platform 
+        ? opts.platform.split(',').map((p: string) => p.trim())
+        : undefined;
+      
+      await installSkill(skill, opts.version, {
+        platforms,
+        force: opts.force
+      });
     } catch (err) {
       console.error('Installation failed:', err);
       process.exit(1);
@@ -189,19 +207,27 @@ installCmd
 /**
  * 卸载命令
  * 
- * 移除本地已安装的 skill
+ * 移除本地已安装的 skill 及各平台的文件
  * 
- * 用法: skm uninstall <skill-id>
+ * 用法:
+ * - skm uninstall <skill>    卸载所有平台
+ * - skm uninstall <skill> --platform opencode  卸载特定平台
  * 
  * @example
  * skm uninstall brainstorming
+ * skm uninstall brainstorming --platform claude
  */
-const uninstallCmd = program.command('uninstall').description('Remove an installed skill');
+const uninstallCmd = program.command('uninstall').description('Remove an installed skill from local and platform directories');
 uninstallCmd
   .argument('<skill>', 'Skill ID to uninstall')
-  .action(async (skill) => {
+  .option('-p, --platform <platforms>', 'Target platforms (comma-separated)')
+  .action(async (skill, opts) => {
     try {
-      await uninstallSkill(skill);
+      const platforms = opts.platform 
+        ? opts.platform.split(',').map((p: string) => p.trim())
+        : undefined;
+      
+      await uninstallSkill(skill, { platforms });
     } catch (err) {
       console.error('Uninstall failed:', err);
       process.exit(1);
@@ -268,21 +294,46 @@ program
   });
 
 // -----------------------------------------------------------------------------
-// 平台命令 (skm platform)
+// 平台命令 (skm platforms)
 // -----------------------------------------------------------------------------
 
 /**
- * 平台命令（预留）
+ * 平台命令
  * 
- * 设置默认目标平台
+ * 显示所有支持的平台及其状态
  * 
- * 用法: skm platform <name>
+ * 用法: skm platforms
  */
-const platformCmd = program.command('platform').description('Set target platform');
-platformCmd
-  .argument('<name>', 'Platform name')
-  .action((name) => {
-    console.log('Platform command - name:', name);
+const platformsCmd = program.command('platforms').description('Show available platforms');
+platformsCmd
+  .action(async () => {
+    try {
+      const available = await detectPlatforms();
+      
+      console.log('\n📍 Available Platforms:\n');
+      
+      const allPlatforms = [
+        { name: 'OpenCode', adapter: new OpenCodeAdapter() },
+        { name: 'Claude Code', adapter: new ClaudeAdapter() },
+        { name: 'VSCode', adapter: new VSCodeAdapter() },
+      ];
+      
+      for (const { name, adapter } of allPlatforms) {
+        const isAvailable = available.find(a => a.id === adapter.id);
+        const installed = await adapter.listInstalled();
+        
+        if (isAvailable) {
+          console.log(`${name.padEnd(12)} ✅  Available (${installed.length} skills installed)`);
+        } else {
+          console.log(`${name.padEnd(12)} ❌  Not detected`);
+        }
+      }
+      
+      console.log('');
+    } catch (err) {
+      console.error('Failed to list platforms:', err);
+      process.exit(1);
+    }
   });
 
 // -----------------------------------------------------------------------------

package/src/commands/info.ts

@@ -19,7 +19,7 @@
 // 导入依赖
 // -----------------------------------------------------------------------------
 
-import { fetchNpmPackage } from './npm.js';    // npm registry 查询
+import { fetchSkillPackage } from './npm.js';    // npm registry 查询
 import { 
   isSkillInstalled,       // 检查 skill 是否已安装
   getInstalledSkills       // 获取已安装 skills 列表
@@ -49,25 +49,14 @@ export async function showSkillInfo(skillId: string): Promise<void> {
   // 处理包名格式
   // -------------------------------------------------------------------------
   
-  /**
-   * 转换 skillId 为完整的 npm 包名格式
-   * 
-   * 支持两种输入格式：
-   * 1. 短格式: "brainstorming" → "@skillmarket/brainstorming"
-   * 2. 完整格式: "@custom/skill" → "@custom/skill"
-   */
-  const packageName = skillId.startsWith('@') 
-    ? skillId                                          // 已经是 scoped 包名
-    : `@skillmarket/${skillId}`;                      // 转换为 scoped 包名
-  
-  console.log(`Fetching info for: ${packageName}\n`);
+  console.log(`Fetching info for: ${skillId}\n`);
   
   try {
     // -------------------------------------------------------------------------
-    // 从 npm 获取包信息
+    // 从 npm 获取包信息（自动尝试多个可能的 scope）
     // -------------------------------------------------------------------------
     
-    const info = await fetchNpmPackage(packageName);
+    const info = await fetchSkillPackage(skillId);
     
     // 包不存在
     if (!info) {

package/src/commands/install.ts

@@ -3,7 +3,7 @@
  * SkillMarket 安装命令模块
  * =============================================================================
  * 
- * 本模块实现 `skm install` 命令，用于安装 skill 到本地。
+ * 本模块实现 `skm install` 命令，用于安装 skill 到本地和跨平台目录。
  * 
  * 安装流程:
  * 1. 确保目录结构存在
@@ -11,7 +11,8 @@
  * 3. 下载包到缓存
  * 4. 解压并复制到 skills 目录
  * 5. 创建 latest 软链接
- * 6. 更新本地注册表
+ * 6. 安装到目标平台（OpenCode/Claude Code/VSCode）
+ * 7. 更新本地注册表
  * 
  * 安装后的目录结构:
  * ~/.skillmarket/
@@ -23,6 +24,11 @@
  * │           └── metadata.json
  * └── ...
  * 
+ * 跨平台安装:
+ * - OpenCode: ~/.config/opencode/skills/<skillId>/SKILL.md
+ * - Claude Code: ~/.claude/skills/<skillId>/SKILL.md
+ * - VSCode: ~/.copilot/skills/<skillId>/SKILL.md
+ * 
  * @module commands/install
  */
 
@@ -36,17 +42,29 @@ import { exec } from 'child_process'; // 执行 shell 命令
 import { promisify } from 'util';    // Promise 化工具
 
 // 模块导入
-import { fetchNpmPackage } from './npm.js';         // npm 查询
+import { fetchSkillPackage } from './npm.js';         // npm 查询
 import { loadRegistry, saveRegistry } from './registry.js';  // 注册表操作
 import { getCacheDir, getSkillsDir, ensureMarketDirs } from '../utils/dirs.js';  // 目录工具
-import { detectPlatform, getPlatformFromInput, isValidPlatform, type Platform } from '../utils/platform.js';  // 平台检测
-import { syncPlatformLinks } from './sync.js';  // 同步命令
-import { LATEST_LINK, PLATFORMS } from '../constants.js';       // 常量
+import { detectPlatforms, getAdapterByPlatform } from '../adapters/index.js';  // 平台适配器
+import { LATEST_LINK } from '../constants.js';       // 常量
 import type { InstalledSkill } from '../types.js';    // 类型定义
+import type { Platform } from '../constants.js';
+import type { PlatformAdapter } from '../types.js';
 
 // 将 exec 转为 Promise 形式
 const execAsync = promisify(exec);
 
+// -----------------------------------------------------------------------------
+// 安装选项接口
+// -----------------------------------------------------------------------------
+
+export interface InstallOptions {
+  /** 目标平台列表（留空则安装到所有可用平台） */
+  platforms?: string[];
+  /** 强制覆盖已安装的 skill */
+  force?: boolean;
+}
+
 // -----------------------------------------------------------------------------
 // 安装函数
 // -----------------------------------------------------------------------------
@@ -56,7 +74,7 @@ const execAsync = promisify(exec);
  * 
  * @param {string} skillId - Skill 标识符（支持短格式或 scoped 格式）
  * @param {string} [version] - 指定版本号（可选，不指定则安装最新版本）
- * @param {string} [targetPlatform] - 目标平台（可选，不指定则使用当前检测到的平台）
+ * @param {InstallOptions} [options] - 安装选项
  * @returns {Promise<void>}
  * 
  * @example
@@ -66,16 +84,16 @@ const execAsync = promisify(exec);
  * // 安装指定版本
  * await installSkill('brainstorming', '1.0.0');
  * 
- * // 安装到指定平台
- * await installSkill('brainstorming', undefined, 'opencode');
+ * // 安装到特定平台
+ * await installSkill('brainstorming', undefined, { platforms: ['opencode'] });
  * 
- * // 安装 scoped 包
- * await installSkill('@custom/skill');
+ * // 强制覆盖
+ * await installSkill('brainstorming', undefined, { force: true });
  */
 export async function installSkill(
   skillId: string, 
   version?: string,
-  targetPlatform?: string
+  options?: InstallOptions
 ): Promise<void> {
   // ==========================================================================
   // 步骤 0: 准备
@@ -84,23 +102,21 @@ export async function installSkill(
   // 确保所有必要的目录都已创建
   await ensureMarketDirs();
   
-  // 转换包名格式
-  const packageName = skillId.startsWith('@') 
-    ? skillId 
-    : `@skillmarket/${skillId}`;
-  
-  console.log(`Installing ${packageName}${version ? `@${version}` : ''}...`);
+  console.log(`Installing ${skillId}${version ? `@${version}` : ''}...`);
   
   // ==========================================================================
   // 步骤 1: 获取包信息
   // ==========================================================================
   
-  // 从 npm 查询包的元信息
-  const pkgInfo = await fetchNpmPackage(packageName);
+  // 从 npm 查询包的元信息（自动尝试多个可能的 scope）
+  const pkgInfo = await fetchSkillPackage(skillId);
   if (!pkgInfo) {
-    throw new Error(`Package ${packageName} not found`);
+    throw new Error(`Package ${skillId} not found`);
   }
   
+  // 获取实际找到的包名
+  const packageName = pkgInfo.name;
+  
   // 确定要安装的版本（用户指定版本 > 最新版本）
   const targetVersion = version || pkgInfo['dist-tags']?.latest;
   if (!targetVersion) {
@@ -211,56 +227,82 @@ export async function installSkill(
   }
   
   // ==========================================================================
-  // 步骤 5: 确定目标平台
+  // 步骤 5: 安装到目标平台 (NEW)
   // ==========================================================================
   
-  // 确定实际使用的平台
-  let finalPlatform: Platform;
-  
-  if (targetPlatform) {
-    // 验证用户指定的目标平台
-    const parsed = getPlatformFromInput(targetPlatform);
-    if (!parsed) {
-      throw new Error(`Invalid platform: ${targetPlatform}. Valid platforms: ${PLATFORMS.join(', ')}`);
+  let targetAdapters: PlatformAdapter[] = [];
+  
+  if (options?.platforms && options.platforms.length > 0) {
+    // 用户指定了平台
+    for (const platformStr of options.platforms) {
+      const platform = platformStr as Platform;
+      const adapter = getAdapterByPlatform(platform);
+      if (adapter) {
+        targetAdapters.push(adapter);
+      } else {
+        console.warn(`⚠️  Unknown platform: ${platformStr}`);
+      }
     }
-    finalPlatform = parsed;
   } else {
-    // 使用当前检测到的平台
-    finalPlatform = detectPlatform();
+    // 自动检测可用平台
+    targetAdapters = await detectPlatforms();
   }
   
-  console.log(`Target platform: ${finalPlatform}`);
+  if (targetAdapters.length === 0) {
+    console.log('No target platforms detected.');
+    console.log('Use --platform to specify platforms manually.');
+  } else {
+    console.log(`\nInstalling to ${targetAdapters.length} platform(s)...\n`);
+    
+    // 安装到每个平台
+    const results: { name: string; status: 'installed' | 'skipped' | 'failed'; error?: string }[] = [];
+    
+    for (const adapter of targetAdapters) {
+      try {
+        const isInstalled = await adapter.isInstalled(skillId);
+        
+        if (isInstalled && !options?.force) {
+          console.log(`${adapter.name.padEnd(12)} ⚠️  Already installed (use --force to overwrite)`);
+          results.push({ name: adapter.name, status: 'skipped' });
+          continue;
+        }
+        
+        // 安装 skill 到平台目录
+        await adapter.install(skillId, skillVersionDir);
+        console.log(`${adapter.name.padEnd(12)} ✅  Installed successfully`);
+        results.push({ name: adapter.name, status: 'installed' });
+      } catch (error) {
+        console.log(`${adapter.name.padEnd(12)} ❌  Failed: ${error}`);
+        results.push({ name: adapter.name, status: 'failed', error: String(error) });
+      }
+    }
+    
+    // 显示摘要
+    const installed = results.filter(r => r.status === 'installed').length;
+    const skipped = results.filter(r => r.status === 'skipped').length;
+    const failed = results.filter(r => r.status === 'failed').length;
+    
+    console.log(`\n📊 Summary: ${installed} installed, ${skipped} skipped, ${failed} failed`);
+  }
   
   // ==========================================================================
   // 步骤 6: 更新注册表
   // ==========================================================================
   
   const registry = await loadRegistry();
-  
-  // 获取现有平台列表（如果 skill 已安装）
-  const existingSkill = registry.skills[skillId];
-  const existingPlatforms = existingSkill?.platforms || [];
+  const installedPlatforms = targetAdapters.map(a => a.id);
   
   // 添加/更新注册表中的 skill 记录
   registry.skills[skillId] = {
     id: skillId,
     version: targetVersion,
     installedAt: new Date().toISOString(),
-    platforms: existingPlatforms.includes(finalPlatform as string) 
-      ? existingPlatforms 
-      : [...existingPlatforms, finalPlatform as string]
+    platforms: installedPlatforms
   } as InstalledSkill;
   
   // 保存注册表
   await saveRegistry(registry);
   
-  // ==========================================================================
-  // 步骤 7: 同步到指定平台
-  // ==========================================================================
-  
-  console.log(`Syncing to ${finalPlatform}...`);
-  await syncPlatformLinks(finalPlatform);
-  
   // ==========================================================================
   // 完成
   // ==========================================================================

package/src/commands/ls.ts

@@ -117,22 +117,49 @@ export async function listSkills(options: LsOptions): Promise<void> {
     
     // 遍历每个包，获取详细信息并显示
     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}`);
         
-        // 打印描述（如果有的话）
-        console.log(`    ${pkg?.description || 'No description'}`);
+        // 打印显示名称
+        const displayName = skillMeta?.displayName || info.name;
+        console.log(`   名称: ${displayName}`);
+        
+        // 打印描述
+        console.log(`   描述: ${pkg?.description || 'N/A'}`);
+        
+        // 打印支持平台
+        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();
       }
     }
   } catch (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;
+}
+
 // -----------------------------------------------------------------------------
 // 搜索包
 // -----------------------------------------------------------------------------
@@ -225,9 +285,11 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
           
           // 提取所有匹配的包名
           // 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);
+              }
             }
           }