skillgo 1.0.0 → 1.0.1

package/README.md

@@ -23,4 +23,5 @@ skillgo update --all        # 更新所有已安装技能
 
 ## 环境变量
 
-- `SKILLGO_API`: API 地址，默认 `http://localhost:3100`，线上使用 `https://skillgo.cn`
+- `SKILLGO_API`: API 地址，默认 `http://skillgo.cn`
+- `SKILLGO_DEBUG`: 设为 `1` 启用调试模式，或使用 `--debug` / `-d` 参数

package/bin/skillgo.js

@@ -1,20 +1,53 @@
 #!/usr/bin/env node
 'use strict'
 
-const API_BASE = process.env.SKILLGO_API || 'http://localhost:3100'
+const isDebug = () => process.env.SKILLGO_DEBUG === '1' || process.env.SKILLGO_DEBUG === 'true'
+const API_BASE = process.env.SKILLGO_API || 'http://skillgo.cn'
 
-const fetchJson = async (path) => {
-  const res = await fetch(`${API_BASE}${path}`)
-  if (!res.ok) throw new Error(`请求失败: ${res.status}`)
-  return res.json()
+const debug = (...args) => {
+  if (isDebug()) console.error('[skillgo]', ...args)
 }
 
-const fetchText = async (path) => {
-  const res = await fetch(`${API_BASE}${path}`)
-  if (!res.ok) throw new Error(`请求失败: ${res.status}`)
-  return res.text()
+const wrapFetch = (fn) => async (...args) => {
+  try {
+    return await fn(...args)
+  } catch (e) {
+    if (isDebug()) {
+      console.error('[skillgo] 请求失败:', e.message)
+      if (e.cause) console.error('[skillgo] cause:', e.cause)
+      if (e.stack) console.error('[skillgo] stack:', e.stack)
+    }
+    const msg = e.message || ''
+    const isNetworkErr = msg.includes('fetch failed') || e.cause?.code === 'ECONNREFUSED' || e.cause?.code === 'ENOTFOUND'
+    if (isNetworkErr) {
+      throw new Error(
+        `无法连接 SkillGo API (${API_BASE})。请检查网络或设置 SKILLGO_API`
+      )
+    }
+    throw e
+  }
 }
 
+const fetchJson = wrapFetch(async (path) => {
+  const url = `${API_BASE}${path}`
+  debug('GET', url)
+  const start = Date.now()
+  const res = await fetch(url)
+  debug('响应', res.status, `${Date.now() - start}ms`)
+  if (!res.ok) throw new Error(`请求失败: ${res.status} ${res.statusText}`)
+  return res.json()
+})
+
+const fetchText = wrapFetch(async (path) => {
+  const url = `${API_BASE}${path}`
+  debug('GET', url)
+  const start = Date.now()
+  const res = await fetch(url)
+  debug('响应', res.status, `${Date.now() - start}ms`)
+  if (!res.ok) throw new Error(`请求失败: ${res.status} ${res.statusText}`)
+  return res.text()
+})
+
 const search = async (keyword) => {
   const data = await fetchJson(`/api/skills?status=published&q=${encodeURIComponent(keyword)}&pageSize=20`)
   const items = data.items || []
@@ -30,12 +63,15 @@ const search = async (keyword) => {
 }
 
 const install = async (slug, version, cwd) => {
+  debug('install', { slug, version, cwd })
   let data
   if (version) {
     data = await fetchJson(`/api/skills?status=published&slug=${encodeURIComponent(slug)}&version=${encodeURIComponent(version)}`)
   } 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)
     if (!skill) {
       console.error(`未找到技能: ${slug}`)
@@ -51,9 +87,11 @@ const install = async (slug, version, cwd) => {
     return
   }
   const items = data.items || []
+  debug('查询结果:', items.length, '条')
   const skill = items[0]
   if (!skill) {
-    console.error(`未找到技能: ${slug}${ver ? '@' + ver : ''}`)
+    debug('未找到匹配技能，slug=', slug, 'version=', version)
+    console.error(`未找到技能: ${slug}${version ? '@' + version : ''}`)
     process.exit(1)
   }
   if (skill.review_tier === 'none' || !skill.review_tier) {
@@ -119,7 +157,15 @@ const update = async (cwd) => {
 }
 
 const main = async () => {
-  const args = process.argv.slice(2)
+  let args = process.argv.slice(2)
+  if (args.includes('--debug') || args.includes('-d')) {
+    args = args.filter((a) => a !== '--debug' && a !== '-d')
+    process.env.SKILLGO_DEBUG = '1'
+  }
+  if (isDebug()) {
+    debug('API_BASE:', process.env.SKILLGO_API || '(默认)', '->', API_BASE)
+    debug('命令:', args[0], '参数:', args.slice(1))
+  }
   const cmd = args[0]
   const cwd = process.cwd()
 
@@ -166,12 +212,21 @@ SkillGo CLI - 技能管理工具 (https://skillgo.cn)
   skillgo list                列出已安装技能
   skillgo update --all        更新所有已安装技能
 
+选项:
+  --debug, -d  调试模式，输出请求详情和错误堆栈
+
 环境变量:
-  SKILLGO_API  API 地址，默认 http://localhost:3100
+  SKILLGO_API   API 地址，默认 http://skillgo.cn
+  SKILLGO_DEBUG 设为 1 启用调试模式
 `)
 }
 
 main().catch((e) => {
-  console.error(e.message)
+  if (isDebug()) {
+    console.error('[skillgo] 错误:', e.message)
+    if (e.stack) console.error(e.stack)
+  } else {
+    console.error(e.message)
+  }
   process.exit(1)
 })

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "skillgo",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "SkillGo 命令行工具 - 搜索、安装、管理 Agent 技能 (https://skillgo.cn)",
   "bin": {
     "skillgo": "bin/skillgo.js"
   },
-  "keywords": ["skillgo", "cli", "skill", "agent", "skillgo.cn"],
+  "keywords": [
+    "skillgo",
+    "cli",
+    "skill",
+    "agent",
+    "skillgo.cn"
+  ],
   "author": "",
   "license": "Apache-2.0",
   "repository": {