eskill 1.0.20 → 1.0.23

package/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import ora from 'ora';
-import { installFromGitUrl, listSkills, removeSkill, cleanupAllSkills, cleanupAll } from './lib/installer.js';
+import { installFromGitUrl, listSkills, removeSkill, cleanupAllSkills, cleanupAll, updateSkill, updateAllSkills } from './lib/installer.js';
 import { AGENTS, getDefaultAgent } from './lib/agent-config.js';
 import { bashCompletionScript, zshCompletionScript, listSkillsForCompletion } from './lib/completion.js';
 import { searchSkills, formatSkillList } from './lib/search.js';
@@ -13,7 +13,7 @@ const program = new Command();
 program
   .name('eskill')
   .description('Unified AI Agent Skills Management - Install skills from Git URLs')
-  .version('1.0.11');
+  .version('1.0.23');
 
 // 安装命令
 program
@@ -59,7 +59,13 @@ program
       console.log(`\n已安装的技能:\n`);
       skills.forEach(skill => {
         const displayName = skill.author ? `${skill.name}@${skill.author}` : skill.name;
-        console.log(`  • ${displayName}`);
+        const versionInfo = skill.version || (skill.commitHash ? `#${skill.commitHash.substring(0, 7)}` : '');
+        const localMark = !skill.gitUrl ? ' [本地]' : '';
+
+        console.log(`  • ${displayName}${localMark}`);
+        if (versionInfo) {
+          console.log(`    版本: ${versionInfo}`);
+        }
       });
       console.log(`\n总计: ${skills.length} 个技能\n`);
     } catch (error) {
@@ -85,6 +91,38 @@ program
     }
   });
 
+// 更新命令
+program
+  .command('update')
+  .description('更新技能')
+  .argument('[name]', '技能名称（不指定则更新所有）')
+  .option('-f, --force', '强制更新（即使版本相同）', false)
+  .action(async (name, options) => {
+    try {
+      if (name) {
+        // 更新单个技能
+        console.log(`\n检查技能: ${name}`);
+        const result = await updateSkill(name, options);
+
+        if (result.local) {
+          console.log('\n⚠️  本地技能无法自动更新，请手动更新\n');
+        } else if (result.updated === false) {
+          console.log(`\n✓ 已是最新版本 (${result.currentVersion})\n`);
+        } else if (result.updated) {
+          console.log(`\n✓ 更新成功:`);
+          console.log(`  旧版本: ${result.currentVersion}`);
+          console.log(`  新版本: ${result.newVersion}\n`);
+        }
+      } else {
+        // 更新所有技能
+        await updateAllSkills(options);
+      }
+    } catch (error) {
+      console.error(`\n❌ 更新失败: ${error.message}\n`);
+      process.exit(1);
+    }
+  });
+
 // 搜索命令
 program
   .command('search')

package/lib/installer.js

@@ -1,13 +1,52 @@
 import { execSync } from 'child_process';
 import { existsSync, mkdirSync, symlinkSync, rmSync, readdirSync, writeFileSync, readFileSync, copyFileSync } from 'fs';
-import { join, basename, dirname, homedir } from 'path';
-import { tmpdir } from 'os';
+import { join, basename, dirname } from 'path';
+import { tmpdir, homedir } from 'os';
 import { fileURLToPath } from 'url';
 import { parseGitUrl } from './git-url-parser.js';
 import { AGENTS, expandHomePath } from './agent-config.js';
 import { searchSkills, formatSkillList } from './search.js';
 import readline from 'readline';
 
+/**
+ * 获取 Git 仓库的当前 commit hash
+ */
+function getGitCommitHash(repoPath) {
+  try {
+    return execSync('git rev-parse HEAD', { cwd: repoPath, encoding: 'utf-8' }).trim();
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * 获取 Git 仓库的当前版本（tag 或 branch）
+ */
+function getGitVersion(repoPath) {
+  try {
+    // 尝试获取最新的 tag
+    const tag = execSync('git describe --tags --abbrev=0 2>/dev/null || echo ""', {
+      cwd: repoPath,
+      encoding: 'utf-8',
+      shell: '/bin/bash'
+    }).trim();
+
+    if (tag) {
+      return tag;
+    }
+
+    // 如果没有 tag，返回 branch
+    const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+      cwd: repoPath,
+      encoding: 'utf-8'
+    }).trim();
+
+    return branch;
+  } catch (error) {
+    return 'unknown';
+  }
+}
+
 /**
  * 获取 eskill 包的安装目录
  * 技能安装在这里，卸载时会自动删除
@@ -79,29 +118,73 @@ function migrateOldSkills() {
 }
 
 /**
- * 保存技能元数据
+ * 读取所有技能元数据
  */
-function saveSkillMeta(skillPath, meta) {
-  const metaPath = join(skillPath, '.eskill-meta.json');
-  writeFileSync(metaPath, JSON.stringify(meta, null, 2));
-}
+function getAllSkillsMeta() {
+  const skillDir = getSkillsStorageDir();
+  const metaPath = join(skillDir, '.eskill-meta.json');
 
-/**
- * 读取技能元数据
- */
-function getSkillMeta(skillPath) {
-  const metaPath = join(skillPath, '.eskill-meta.json');
   if (!existsSync(metaPath)) {
-    return null;
+    return [];
   }
+
   try {
     const content = readFileSync(metaPath, 'utf-8');
     return JSON.parse(content);
   } catch (error) {
-    return null;
+    return [];
   }
 }
 
+/**
+ * 保存所有技能元数据
+ */
+function saveAllSkillsMeta(metaArray) {
+  const skillDir = getSkillsStorageDir();
+
+  // 确保目录存在
+  if (!existsSync(skillDir)) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+
+  const metaPath = join(skillDir, '.eskill-meta.json');
+  writeFileSync(metaPath, JSON.stringify(metaArray, null, 2));
+}
+
+/**
+ * 保存单个技能元数据
+ */
+function saveSkillMeta(skillName, meta) {
+  const allMeta = getAllSkillsMeta();
+
+  // 查找并更新或添加
+  const index = allMeta.findIndex(m => m.name === skillName);
+  if (index >= 0) {
+    allMeta[index] = { ...allMeta[index], ...meta };
+  } else {
+    allMeta.push(meta);
+  }
+
+  saveAllSkillsMeta(allMeta);
+}
+
+/**
+ * 读取单个技能元数据
+ */
+function getSkillMeta(skillName) {
+  const allMeta = getAllSkillsMeta();
+  return allMeta.find(m => m.name === skillName) || null;
+}
+
+/**
+ * 删除技能元数据
+ */
+function removeSkillMeta(skillName) {
+  const allMeta = getAllSkillsMeta();
+  const newMeta = allMeta.filter(m => m.name !== skillName);
+  saveAllSkillsMeta(newMeta);
+}
+
 /**
  * 检测并处理 name@author 格式
  * 返回解析后的 GitHub URL，如果不是该格式则返回原 URL
@@ -275,15 +358,22 @@ export async function installFromGitUrl(gitUrl, options = {}) {
     console.log(`  存储位置: ~/.eskill/skills/`);
     console.log(`  说明: 技能永久保存，更新 eskill 不会丢失`);
 
-    // 保存技能元数据（作者、Git URL 等）
-    saveSkillMeta(targetPath, {
+    // 获取 git 版本信息
+    const commitHash = getGitCommitHash(sourcePath);
+    const version = getGitVersion(sourcePath);
+
+    // 保存技能元数据（作者、Git URL、版本等）
+    saveSkillMeta(skillName, {
       name: skillName,
       author: parsed.owner,
       gitUrl: gitUrl,
       platform: parsed.platform,
       repo: parsed.repo,
       branch: parsed.branch,
-      installedAt: new Date().toISOString()
+      commitHash,
+      version,
+      installedAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString()
     });
 
     return { success: true, path: targetPath };
@@ -310,18 +400,25 @@ export function listSkills(agent = 'claude') {
   }
 
   // 读取目录中的技能
-  return readdirSync(skillDir, { withFileTypes: true })
-    .filter(dirent => dirent.isDirectory())
-    .map(dirent => {
-      const skillPath = join(skillDir, dirent.name);
-      const meta = getSkillMeta(skillPath);
-      return {
-        name: dirent.name,
-        path: skillPath,
-        author: meta?.author || null,
-        installedAt: meta?.installedAt || null
-      };
-    });
+  const skillDirs = readdirSync(skillDir, { withFileTypes: true })
+    .filter(dirent => dirent.isDirectory());
+
+  // 读取所有元数据
+  const allMeta = getAllSkillsMeta();
+
+  return skillDirs.map(dirent => {
+    const skillPath = join(skillDir, dirent.name);
+    const meta = allMeta.find(m => m.name === dirent.name);
+    return {
+      name: dirent.name,
+      path: skillPath,
+      author: meta?.author || null,
+      version: meta?.version || null,
+      commitHash: meta?.commitHash || null,
+      installedAt: meta?.installedAt || null,
+      gitUrl: meta?.gitUrl || null
+    };
+  });
 }
 
 /**
@@ -336,6 +433,7 @@ export function removeSkill(skillName, agent = 'claude') {
   }
 
   rmSync(targetPath, { recursive: true, force: true });
+  removeSkillMeta(skillName);
   console.log(`✓ 已删除技能: ${skillName}`);
 }
 
@@ -385,3 +483,194 @@ export function cleanupAll() {
 export function getSkillsDir() {
   return getSkillsStorageDir();
 }
+
+/**
+ * 更新单个技能
+ */
+export async function updateSkill(skillName, options = {}) {
+  const { force = false } = options;
+  const skillDir = getSkillsStorageDir();
+  const targetPath = join(skillDir, skillName);
+
+  // 检查技能是否存在
+  if (!existsSync(targetPath)) {
+    throw new Error(`技能不存在: ${skillName}`);
+  }
+
+  // 读取元数据
+  const meta = getSkillMeta(skillName);
+
+  // 如果没有 gitUrl，说明是本地技能，无法更新
+  if (!meta || !meta.gitUrl) {
+    return { success: false, local: true, skill: skillName };
+  }
+
+  const currentVersion = meta.version || meta.commitHash?.substring(0, 7) || 'unknown';
+
+  // 重新安装技能（使用内部的 installFromGitUrl，但不打印）
+  try {
+    const parsed = parseGitUrl(meta.gitUrl);
+
+    // 确定技能名称
+    const skillNameFromUrl = parsed.path ? basename(parsed.path) : parsed.repo;
+
+    // 创建临时目录
+    const tempDir = join(tmpdir(), `eskill-update-${Date.now()}`);
+
+    try {
+      // 克隆仓库（静默模式）
+      const cloneUrl = parsed.cloneUrl;
+      execSync(
+        `git clone --depth 1 --branch ${parsed.branch} --single-branch "${cloneUrl}" "${tempDir}"`,
+        { stdio: 'inherit' }
+      );
+
+      // 确定源路径
+      const sourcePath = parsed.path ? join(tempDir, parsed.path) : tempDir;
+
+      // 验证源路径存在
+      if (!existsSync(sourcePath)) {
+        throw new Error(`路径不存在: ${sourcePath}`);
+      }
+
+      // 检查 SKILL.md 是否存在
+      const skillManifestPath = join(sourcePath, 'SKILL.md');
+      if (!existsSync(skillManifestPath)) {
+        throw new Error(`无效的技能包：未找到 SKILL.md 文件`);
+      }
+
+      // 获取新版本信息
+      const newCommitHash = getGitCommitHash(sourcePath);
+      const newVersion = getGitVersion(sourcePath);
+      const newVersionDisplay = newVersion || newCommitHash?.substring(0, 7) || 'unknown';
+
+      // 检查是否有更新
+      if (!force && newCommitHash === meta.commitHash) {
+        // 删除临时目录
+        rmSync(tempDir, { recursive: true, force: true });
+        return { success: true, skill: skillName, updated: false, currentVersion };
+      }
+
+      // 删除旧技能
+      rmSync(targetPath, { recursive: true, force: true });
+
+      // 复制新技能
+      if (process.platform === 'win32') {
+        execSync(`xcopy "${sourcePath}" "${targetPath}" /E /I /H /Y`, { stdio: 'inherit' });
+      } else {
+        execSync(`cp -r "${sourcePath}" "${targetPath}"`, { stdio: 'inherit' });
+      }
+
+      // 更新元数据
+      saveSkillMeta(skillName, {
+        ...meta,
+        commitHash: newCommitHash,
+        version: newVersion,
+        updatedAt: new Date().toISOString()
+      });
+
+      return {
+        success: true,
+        skill: skillName,
+        updated: true,
+        currentVersion,
+        newVersion: newVersionDisplay
+      };
+    } finally {
+      // 清理临时目录
+      if (existsSync(tempDir)) {
+        rmSync(tempDir, { recursive: true, force: true });
+      }
+    }
+  } catch (error) {
+    throw new Error(`更新失败: ${error.message}`);
+  }
+}
+
+/**
+ * 更新所有技能
+ */
+export async function updateAllSkills(options = {}) {
+  const { force = false } = options;
+
+  // 自动迁移旧位置的技能
+  migrateOldSkills();
+
+  const skillDir = getSkillsStorageDir();
+
+  if (!existsSync(skillDir)) {
+    console.log('未安装任何技能');
+    return [];
+  }
+
+  // 读取所有技能
+  const skills = readdirSync(skillDir, { withFileTypes: true })
+    .filter(dirent => dirent.isDirectory())
+    .map(dirent => {
+      const skillPath = join(skillDir, dirent.name);
+      const meta = getSkillMeta(dirent.name);
+      return {
+        name: dirent.name,
+        path: skillPath,
+        meta
+      };
+    });
+
+  if (skills.length === 0) {
+    console.log('未安装任何技能');
+    return [];
+  }
+
+  console.log(`\n检查 ${skills.length} 个技能的更新...\n`);
+
+  const results = {
+    updated: [],
+    skipped: [],
+    failed: []
+  };
+
+  for (const skill of skills) {
+    try {
+      // 如果没有 gitUrl，跳过
+      if (!skill.meta || !skill.meta.gitUrl) {
+        console.log(`⊘ ${skill.name} - 本地技能`);
+        results.skipped.push({ name: skill.name, reason: 'local' });
+        continue;
+      }
+
+      // 更新技能
+      const result = await updateSkill(skill.name, { force });
+
+      if (result.success && result.updated) {
+        console.log(`✓ ${skill.name} - ${result.currentVersion} → ${result.newVersion}`);
+        results.updated.push({ name: skill.name, oldVersion: result.currentVersion, newVersion: result.newVersion });
+      } else if (result.success && !result.updated) {
+        console.log(`• ${skill.name} - 已是最新`);
+        results.skipped.push({ name: skill.name, reason: 'latest' });
+      } else if (result.local) {
+        results.skipped.push({ name: skill.name, reason: 'local' });
+      }
+    } catch (error) {
+      console.log(`✗ ${skill.name} - 失败: ${error.message}`);
+      results.failed.push({ name: skill.name, error: error.message });
+    }
+  }
+
+  // 显示总结
+  console.log(`\n${'─'.repeat(50)}`);
+  console.log(`更新完成:`);
+  console.log(`  ✓ 成功: ${results.updated.length}`);
+  console.log(`  ⊘ 跳过: ${results.skipped.length}`);
+  console.log(`  ✗ 失败: ${results.failed.length}`);
+  console.log(`${'─'.repeat(50)}\n`);
+
+  if (results.failed.length > 0) {
+    console.log('失败的技能:');
+    results.failed.forEach(({ name, error }) => {
+      console.log(`  - ${name}: ${error}`);
+    });
+    console.log('');
+  }
+
+  return results;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eskill",
-  "version": "1.0.20",
+  "version": "1.0.23",
   "description": "Unified AI Agent Skills Management - Install skills from Git URLs",
   "main": "index.js",
   "type": "module",