skillgo 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # SkillGo CLI
 
-SkillGo 命令行工具 - 搜索、安装、管理 Agent 技能。https://skillgo.cn
+SkillGo 命令行工具 - 搜索、安装、管理 Agent 技能。安装时会递归下载 SKILL.md 及同目录、子目录下的所有代码文件。支持中文技能名，若 slug 未匹配会自动按名称搜索。https://skillgo.cn
 
 ## 安装
 

package/bin/skillgo.js

@@ -62,48 +62,121 @@ const search = async (keyword) => {
   })
 }
 
+const fetchRepoDir = async (project, relPath, localDir, branch, isGitee, fs, path) => {
+  const apiPath = relPath || (isGitee ? '.' : '')
+  let contents = []
+  if (isGitee) {
+    const apiUrl = `https://gitee.com/api/v5/repos/${project}/contents/${apiPath}`
+    debug('获取目录', apiUrl)
+    try {
+      contents = await fetch(apiUrl).then((r) => (r.ok ? r.json() : []))
+    } catch {
+      return 0
+    }
+  } else {
+    const apiUrl = `https://api.github.com/repos/${project}/contents/${apiPath}`
+    debug('获取目录', apiUrl)
+    try {
+      contents = await fetch(apiUrl).then((r) => (r.ok ? r.json() : []))
+    } catch {
+      return 0
+    }
+  }
+  if (!Array.isArray(contents)) contents = [contents]
+  let count = 0
+  const filePath = (p, name) => (p ? `${p}/${name}` : name)
+  for (const f of contents) {
+    const name = f.name
+    if (f.type === 'dir') {
+      const subRelPath = filePath(relPath, name)
+      const subLocalDir = path.join(localDir, name)
+      await fs.mkdir(subLocalDir, { recursive: true })
+      count += await fetchRepoDir(project, subRelPath, subLocalDir, branch, isGitee, fs, path)
+    } else if (f.type === 'file') {
+      if (name === 'SKILL.md') continue
+      const fullPath = filePath(relPath, name)
+      const rawUrl = isGitee
+        ? `https://gitee.com/${project}/raw/${branch}/${fullPath}`
+        : `https://raw.githubusercontent.com/${project}/${branch}/${fullPath}`
+      try {
+        const content = await fetch(rawUrl).then((r) => (r.ok ? r.text() : null))
+        if (content !== null) {
+          await fs.writeFile(path.join(localDir, name), content, 'utf-8')
+          debug('已下载', fullPath)
+          count += 1
+        }
+      } catch {}
+    }
+  }
+  return count
+}
+
+const fetchRepoFiles = async (repoUrl, sourcePath, dir, fs, path) => {
+  const m = repoUrl.match(/github\.com\/([^/]+\/[^/]+?)(?:\/|\.git)?$/i) || repoUrl.match(/gitee\.com\/([^/]+\/[^/]+?)(?:\/|\.git)?$/i)
+  if (!m) return 0
+  const project = m[1]
+  const dirPath = sourcePath.replace(/\/SKILL\.md$/i, '').replace(/^\/+/, '')
+  if (!dirPath) return 0
+  const isGitee = /gitee\.com/i.test(repoUrl)
+  let branch = isGitee ? 'master' : 'main'
+  if (!isGitee) {
+    try {
+      const repoInfo = await fetch(`https://api.github.com/repos/${project}`).then((r) => (r.ok ? r.json() : null))
+      if (repoInfo?.default_branch) branch = repoInfo.default_branch
+    } catch {}
+  }
+  return fetchRepoDir(project, dirPath, dir, branch, isGitee, fs, path)
+}
+
 const install = async (slug, version, cwd) => {
   debug('install', { slug, version, cwd })
-  let data
+  const fs = await import('fs/promises')
+  const path = await import('path')
+  let skill
   if (version) {
-    data = await fetchJson(`/api/skills?status=published&slug=${encodeURIComponent(slug)}&version=${encodeURIComponent(version)}`)
+    let data = await fetchJson(`/api/skills?status=published&slug=${encodeURIComponent(slug)}&version=${encodeURIComponent(version)}`)
+    let items = data.items || []
+    if (items.length === 0) {
+      debug('slug 未匹配，尝试按名称搜索')
+      data = await fetchJson(`/api/skills?status=published&q=${encodeURIComponent(slug)}&pageSize=50`)
+      items = (data.items || []).filter((s) => s.version === version)
+    }
+    debug('查询结果:', items.length, '条')
+    skill = items[0]
+    if (!skill) {
+      debug('未找到匹配技能，slug=', slug, 'version=', version)
+      console.error(`未找到技能: ${slug}${version ? '@' + version : ''}`)
+      process.exit(1)
+    }
   } else {
     debug('从 MCP 获取技能列表')
     const all = await fetchJson('/mcp/skills?latest=true')
     const skills = all.skills || []
     debug('MCP 返回', skills.length, '个技能')
-    const skill = skills.find((s) => s.slug === slug)
+    skill = skills.find((s) => s.slug === slug || s.name === slug)
     if (!skill) {
       console.error(`未找到技能: ${slug}`)
       process.exit(1)
     }
-    const text = await fetchText(`/api/skills/${skill.id}/skill`)
-    const fs = await import('fs/promises')
-    const path = await import('path')
-    const dir = path.join(cwd, 'skills', skill.slug)
-    await fs.mkdir(dir, { recursive: true })
-    await fs.writeFile(path.join(dir, 'SKILL.md'), text, 'utf-8')
-    console.log(`已安装 ${skill.slug}@${skill.version} 到 ${dir}/SKILL.md`)
-    return
-  }
-  const items = data.items || []
-  debug('查询结果:', items.length, '条')
-  const skill = items[0]
-  if (!skill) {
-    debug('未找到匹配技能，slug=', slug, 'version=', version)
-    console.error(`未找到技能: ${slug}${version ? '@' + version : ''}`)
-    process.exit(1)
   }
   if (skill.review_tier === 'none' || !skill.review_tier) {
     console.warn('警告：该技能未经审核，使用前请自行评估安全风险。')
   }
   const text = await fetchText(`/api/skills/${skill.id}/skill`)
-  const fs = await import('fs/promises')
-  const path = await import('path')
   const dir = path.join(cwd, 'skills', skill.slug)
   await fs.mkdir(dir, { recursive: true })
   await fs.writeFile(path.join(dir, 'SKILL.md'), text, 'utf-8')
-  console.log(`已安装 ${skill.slug}@${skill.version} 到 ${dir}/SKILL.md`)
+  let extra = 0
+  if (skill.repo_url && skill.source_path) {
+    const detail = await fetchJson(`/api/skills/${skill.id}`)
+    const repoUrl = detail.repo_url || skill.repo_url
+    const sourcePath = detail.source_path || skill.source_path
+    if (repoUrl && sourcePath) {
+      extra = await fetchRepoFiles(repoUrl, sourcePath, dir, fs, path)
+    }
+  }
+  const files = extra > 0 ? ` (含 ${extra} 个代码文件)` : ''
+  console.log(`已安装 ${skill.slug}@${skill.version} 到 ${dir}${files}`)
 }
 
 const list = async (cwd) => {
@@ -208,7 +281,7 @@ SkillGo CLI - 技能管理工具 (https://skillgo.cn)
 用法:
   skillgo search <keyword>    搜索技能
   skillgo install <slug>      安装技能到当前目录 skills/
-  skillgo install <slug>@<ver> 安装指定版本
+  skillgo install <slug>@<ver> 安装指定版本（支持中文名/slug）
   skillgo list                列出已安装技能
   skillgo update --all        更新所有已安装技能
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillgo",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "SkillGo 命令行工具 - 搜索、安装、管理 Agent 技能 (https://skillgo.cn)",
   "bin": {
     "skillgo": "bin/skillgo.js"