eskill 1.2.0 → 1.2.2

package/cli.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.2.0')
+  .version('1.2.2')
   .option('-g, --global', '使用全局技能目录（~/.eskill/skills/），否则使用当前目录（./.claude/skills/）', false);
 
 // 安装命令
@@ -67,17 +67,34 @@ program
 
       const location = global ? '~/.eskill/skills/' : './.claude/skills/';
       console.log(`\n已安装的技能 (${location}):\n`);
+
+      // 来源类型显示映射
+      const sourceLabels = {
+        'symlink': '🔗 软链',
+        'copied-from-global': '📋 复制',
+        'github': '📥 GitHub',
+        'local': '👤 本地',
+        'unknown': '❓ 未知'
+      };
+
       skills.forEach(skill => {
         const displayName = skill.author ? `${skill.name}@${skill.author}` : skill.name;
         const versionInfo = skill.version || (skill.commitHash ? `#${skill.commitHash.substring(0, 7)}` : '');
-        const localMark = !skill.gitUrl ? ' [本地]' : '';
+        const sourceLabel = sourceLabels[skill.source] || sourceLabels['unknown'];
 
-        console.log(`  • ${displayName}${localMark}`);
+        console.log(`  • ${displayName} [${sourceLabel}]`);
         if (versionInfo) {
           console.log(`    版本: ${versionInfo}`);
         }
       });
       console.log(`\n总计: ${skills.length} 个技能\n`);
+
+      // 显示来源说明
+      console.log('来源说明:');
+      console.log('  🔗 软链    - 指向全局仓库的软链接');
+      console.log('  📋 复制   - 从全局仓库复制到本地');
+      console.log('  📥 GitHub - 从 GitHub 直接下载');
+      console.log('  👤 本地    - 用户手动创建\n');
     } catch (error) {
       console.error(`错误: ${error.message}`);
       process.exit(1);
@@ -109,7 +126,7 @@ program
 program
   .command('link')
   .description('将全局技能软链接到本地')
-  .argument('<name>', '技能名称（不需要 @作者）')
+  .argument('<name>', '技能名称（支持 name@author 格式）')
   .action(async (name) => {
     try {
       const result = await linkSkill(name);

package/lib/installer.js

@@ -1,5 +1,5 @@
 import { execSync } from 'child_process';
-import { existsSync, mkdirSync, symlinkSync, rmSync, readdirSync, writeFileSync, readFileSync, copyFileSync } from 'fs';
+import { existsSync, mkdirSync, symlinkSync, rmSync, readdirSync, writeFileSync, readFileSync, copyFileSync, lstatSync } from 'fs';
 import { join, basename, dirname } from 'path';
 import { tmpdir, homedir } from 'os';
 import { fileURLToPath } from 'url';
@@ -398,6 +398,21 @@ async function copyFromGlobal(skillName, options = {}) {
   const sourcePath = join(globalSkillsDir, skillName);
   const targetPath = join(localSkillsDir, skillName);
 
+  // 检查本地技能目录是否存在
+  if (!existsSync(localSkillsDir)) {
+    console.log(`\n📁 本地技能目录不存在`);
+    console.log(`  需要创建: ${localSkillsDir}\n`);
+
+    const createDir = await confirmAction('是否创建本地技能目录？');
+    if (!createDir) {
+      console.log('\n已取消安装\n');
+      return { success: false, cancelled: true };
+    }
+
+    mkdirSync(localSkillsDir, { recursive: true });
+    console.log(`✓ 已创建目录: ${localSkillsDir}\n`);
+  }
+
   // 检查本地是否已存在同名技能
   if (existsSync(targetPath)) {
     if (!force) {
@@ -421,10 +436,23 @@ async function copyFromGlobal(skillName, options = {}) {
 
   execSync(`cp -r "${sourcePath}" "${targetPath}"`, { stdio: 'inherit' });
 
-  // 复制元数据
+  // 复制元数据，并标记来源
   const globalMeta = getSkillMeta(skillName, true);
   if (globalMeta) {
-    saveSkillMeta(skillName, globalMeta, false);
+    saveSkillMeta(skillName, {
+      ...globalMeta,
+      source: 'copied-from-global',
+      installedAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString()
+    }, false);
+  } else {
+    // 如果全局没有元数据，创建基础元数据
+    saveSkillMeta(skillName, {
+      name: skillName,
+      source: 'copied-from-global',
+      installedAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString()
+    }, false);
   }
 
   console.log(`\n✓ 技能已从全局仓库复制到本地`);
@@ -504,9 +532,19 @@ export async function installFromGitUrl(gitUrl, options = {}) {
     console.log(`路径: ${parsed.path}`);
   }
 
-  // 确保技能目录存在
+  // 检查技能目录是否存在
   if (!existsSync(skillsDir)) {
+    console.log(`\n📁 技能目录不存在`);
+    console.log(`  需要创建: ${skillsDir}\n`);
+
+    const createDir = await confirmAction('是否创建技能目录？');
+    if (!createDir) {
+      console.log('\n已取消安装\n');
+      return { success: false, cancelled: true };
+    }
+
     mkdirSync(skillsDir, { recursive: true });
+    console.log(`✓ 已创建目录: ${skillsDir}\n`);
   }
 
   // 检查是否已存在同名技能
@@ -585,6 +623,7 @@ export async function installFromGitUrl(gitUrl, options = {}) {
       branch: parsed.branch,
       commitHash,
       version,
+      source: global ? 'github' : 'github',
       installedAt: new Date().toISOString(),
       updatedAt: new Date().toISOString()
     }, global);
@@ -614,22 +653,71 @@ export function listSkills(agent = 'claude', global = false) {
 
   // 读取目录中的技能
   const skillDirs = readdirSync(skillDir, { withFileTypes: true })
-    .filter(dirent => dirent.isDirectory());
+    .filter(dirent => dirent.isDirectory() || dirent.isSymbolicLink());
 
   // 读取所有元数据
   const allMeta = getAllSkillsMeta(global);
 
+  // 获取全局技能目录（用于检测是否从全局复制）
+  const globalSkillsDir = getSkillsDir(true);
+  const globalSkillsExists = existsSync(globalSkillsDir);
+  const globalSkillNames = globalSkillsExists
+    ? readdirSync(globalSkillsDir, { withFileTypes: true })
+        .filter(dirent => dirent.isDirectory())
+        .map(dirent => dirent.name)
+    : [];
+
   return skillDirs.map(dirent => {
-    const skillPath = join(skillDir, dirent.name);
-    const meta = allMeta.find(m => m.name === dirent.name);
+    const skillName = dirent.name;
+    const skillPath = join(skillDir, skillName);
+    const meta = allMeta.find(m => m.name === skillName);
+
+    // 优先使用元数据中的 source 字段
+    let source = meta?.source || null;
+    let isSymlink = false;
+
+    // 如果元数据中没有 source，则进行检测
+    if (!source) {
+      try {
+        const stat = lstatSync(skillPath);
+        isSymlink = stat.isSymbolicLink();
+
+        if (isSymlink) {
+          source = 'symlink';
+        } else if (meta?.gitUrl) {
+          // 有 gitUrl，判断是否从全局复制
+          if (!global && globalSkillNames.includes(skillName)) {
+            source = 'copied-from-global';
+          } else {
+            source = 'github';
+          }
+        } else {
+          // 没有 gitUrl，是用户自己创建的
+          source = 'local';
+        }
+      } catch (error) {
+        // 检测失败，默认为 local
+        source = 'local';
+      }
+    } else {
+      // 从元数据中读取是否为符号链接
+      try {
+        isSymlink = lstatSync(skillPath).isSymbolicLink();
+      } catch (error) {
+        isSymlink = false;
+      }
+    }
+
     return {
-      name: dirent.name,
+      name: skillName,
       path: skillPath,
       author: meta?.author || null,
       version: meta?.version || null,
       commitHash: meta?.commitHash || null,
       installedAt: meta?.installedAt || null,
-      gitUrl: meta?.gitUrl || null
+      gitUrl: meta?.gitUrl || null,
+      source: source,
+      isSymlink: isSymlink
     };
   });
 }
@@ -654,30 +742,47 @@ export function removeSkill(skillName, agent = 'claude', global = false) {
  * 链接全局技能到本地
  */
 export async function linkSkill(skillName) {
+  // 解析 skill-name@author 格式，提取实际技能名
+  let actualSkillName = skillName;
+  const match = skillName.match(/^([^@]+)@([^@]+)$/);
+  if (match) {
+    actualSkillName = match[1];
+  }
+
   const globalSkillsDir = getSkillsDir(true);
   const localSkillsDir = getSkillsDir(false);
 
-  const globalSkillPath = join(globalSkillsDir, skillName);
-  const localSkillPath = join(localSkillsDir, skillName);
+  const globalSkillPath = join(globalSkillsDir, actualSkillName);
+  const localSkillPath = join(localSkillsDir, actualSkillName);
 
   // 检查全局是否存在该技能
   if (!existsSync(globalSkillPath)) {
-    console.log(`\n❌ 全局仓库中不存在技能: ${skillName}`);
-    console.log(`   位置: ~/.eskill/skills/${skillName}\n`);
+    console.log(`\n❌ 全局仓库中不存在技能: ${actualSkillName}`);
+    console.log(`   位置: ~/.eskill/skills/${actualSkillName}\n`);
     console.log(`💡 提示:`);
     console.log(`   - 使用 "eskill install -g ${skillName}" 先安装到全局仓库`);
     console.log(`   - 或使用 "eskill install" 直接安装到本地\n`);
-    throw new Error(`全局仓库中不存在技能: ${skillName}`);
+    throw new Error(`全局仓库中不存在技能: ${actualSkillName}`);
   }
 
-  // 确保本地技能目录存在
+  // 检查本地技能目录是否存在
   if (!existsSync(localSkillsDir)) {
+    console.log(`\n📁 本地技能目录不存在`);
+    console.log(`  需要创建: ${localSkillsDir}\n`);
+
+    const createDir = await confirmAction('是否创建本地技能目录？');
+    if (!createDir) {
+      console.log('\n已取消链接\n');
+      return { success: false, cancelled: true };
+    }
+
     mkdirSync(localSkillsDir, { recursive: true });
+    console.log(`✓ 已创建目录: ${localSkillsDir}\n`);
   }
 
   // 检查本地是否已存在同名技能
   if (existsSync(localSkillPath)) {
-    console.log(`\n⚠️  本地已存在同名技能: ${skillName}`);
+    console.log(`\n⚠️  本地已存在同名技能: ${actualSkillName}`);
     console.log(`  位置: ${localSkillPath}\n`);
 
     const overwrite = await confirmAction('是否删除本地技能并创建软链接？');
@@ -699,11 +804,30 @@ export async function linkSkill(skillName) {
     symlinkSync(globalSkillPath, localSkillPath, 'dir');
 
     console.log(`✓ 软链接创建成功`);
-    console.log(`  技能: ${skillName}`);
+    console.log(`  技能: ${actualSkillName}`);
     console.log(`  本地路径: ${localSkillPath}`);
     console.log(`  全局路径: ${globalSkillPath}`);
     console.log(`  说明: 本地技能指向全局仓库，全局更新会自动同步\n`);
 
+    // 保存元数据，标记来源为软链接
+    const globalMeta = getSkillMeta(actualSkillName, true);
+    if (globalMeta) {
+      saveSkillMeta(actualSkillName, {
+        ...globalMeta,
+        source: 'symlink',
+        installedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString()
+      }, false);
+    } else {
+      // 如果全局没有元数据，创建基础元数据
+      saveSkillMeta(actualSkillName, {
+        name: actualSkillName,
+        source: 'symlink',
+        installedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString()
+      }, false);
+    }
+
     return { success: true, path: localSkillPath };
   } catch (error) {
     throw new Error(`创建软链接失败: ${error.message}`);
@@ -728,6 +852,15 @@ export function cleanupAllSkills(global = false) {
     console.error(`清理失败: ${error.message}`);
     throw error;
   }
+
+  // 清空元数据文件
+  try {
+    saveAllSkillsMeta([], global);
+    const metaLocation = global ? '~/.eskill/skills/.eskill-meta.json' : './.eskill-meta.json';
+    console.log(`✓ 已清空元数据: ${metaLocation}`);
+  } catch (error) {
+    console.error(`清空元数据失败: ${error.message}`);
+  }
 }
 
 /**

package/package.json

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