skill-base-cli 1.0.0

package/README.md

@@ -0,0 +1,86 @@
+# Skill Base CLI
+
+命令行工具，用于搜索、安装、更新和发布 AI Agent Skills。
+
+## 安装
+
+```bash
+npm install -g skill-base-cli
+```
+
+或使用 npx 直接运行：
+
+```bash
+npx skill-base-cli <command>
+```
+
+## 环境配置
+
+CLI 默认连接 `http://localhost:8000`，可通过环境变量修改：
+
+```bash
+export SKB_BASE_URL=https://your-skill-base-server.com
+```
+
+## 命令
+
+### 认证
+
+```bash
+# 登录
+skb login
+
+# 登出
+skb logout
+```
+
+### Skill 管理
+
+```bash
+# 搜索 Skill
+skb search <keyword>
+
+# 安装 Skill
+skb install <skill_id>
+skb install <skill_id>@<version>
+skb install <skill_id> -d ./target-dir
+
+# 更新 Skill
+skb update <skill_id>
+skb update <skill_id> -d ./target-dir
+
+# 发布 Skill
+skb publish <directory>
+skb publish <directory> --name "Skill Name" --description "Description"
+skb publish <directory> --changelog "版本说明"
+```
+
+## 快速开始
+
+```bash
+# 1. 登录
+skb login
+
+# 2. 搜索
+skb search vue
+
+# 3. 安装
+skb install vue-best-practices
+
+# 4. 发布自己的 Skill
+skb publish ./my-skill --changelog "初始版本"
+```
+
+## 发布要求
+
+- 目录必须包含 `SKILL.md` 文件
+- 文件夹名称将作为 `skill_id`
+- `name` 和 `description` 可从 SKILL.md 自动提取
+
+## 系统要求
+
+- Node.js >= 18.0.0
+
+## License
+
+MIT

package/bin/skb.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import login from '../lib/commands/login.js';
+import logout from '../lib/commands/logout.js';
+import search from '../lib/commands/search.js';
+import install from '../lib/commands/install.js';
+import update from '../lib/commands/update.js';
+import publish from '../lib/commands/publish.js';
+
+const program = new Command();
+
+program
+  .name('skb')
+  .description('Skill Base CLI - 命令行管理工具')
+  .version('1.0.0');
+
+program
+  .command('login')
+  .description('登录获取访问令牌')
+  .action(login);
+
+program
+  .command('logout')
+  .description('登出并清除本地凭证')
+  .action(logout);
+
+program
+  .command('search <keyword>')
+  .description('搜索 Skill')
+  .action(search);
+
+program
+  .command('install <target>')
+  .description('安装 Skill（支持 name@version 格式）')
+  .option('-d, --dir <directory>', '指定解压目标目录', process.cwd())
+  .action(install);
+
+program
+  .command('update <skill_id>')
+  .description('更新 Skill 到最新版本')
+  .option('-d, --dir <directory>', '指定解压目标目录', process.cwd())
+  .action(update);
+
+program
+  .command('publish <directory>')
+  .description('发布新版本（指定 Skill 文件夹）')
+  .option('--name <name>', 'Skill 名称（默认从 SKILL.md 提取）')
+  .option('--description <desc>', 'Skill 描述（默认从 SKILL.md 提取）')
+  .option('--changelog <log>', '版本变更日志', '更新版本')
+  .action(publish);
+
+program.parse();

package/lib/api.js

@@ -0,0 +1,89 @@
+import { getConfig } from './config.js';
+import { loadCredentials } from './auth.js';
+
+async function handleResponse(response) {
+  if (!response.ok) {
+    let message = `HTTP ${response.status}`;
+    try {
+      const data = await response.json();
+      if (data.detail) {
+        message = data.detail;
+      }
+    } catch (e) {
+      // 无法解析 JSON，使用默认消息
+    }
+    throw new Error(message);
+  }
+  return response.json();
+}
+
+function getAuthHeaders() {
+  const credentials = loadCredentials();
+  const headers = {};
+  if (credentials?.token) {
+    headers['Authorization'] = `Bearer ${credentials.token}`;
+  }
+  return headers;
+}
+
+export function createClient() {
+  const { apiUrl } = getConfig();
+
+  return {
+    async get(path) {
+      const response = await fetch(`${apiUrl}${path}`, {
+        method: 'GET',
+        headers: {
+          ...getAuthHeaders()
+        }
+      });
+      return handleResponse(response);
+    },
+
+    async post(path, body) {
+      const response = await fetch(`${apiUrl}${path}`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          ...getAuthHeaders()
+        },
+        body: JSON.stringify(body)
+      });
+      return handleResponse(response);
+    },
+
+    async postForm(path, formData) {
+      // 使用原生 FormData，让 fetch 自动设置 Content-Type（含 boundary）
+      const response = await fetch(`${apiUrl}${path}`, {
+        method: 'POST',
+        headers: {
+          ...getAuthHeaders()
+        },
+        body: formData
+      });
+      return handleResponse(response);
+    },
+
+    async download(path) {
+      const response = await fetch(`${apiUrl}${path}`, {
+        method: 'GET',
+        headers: {
+          ...getAuthHeaders()
+        }
+      });
+      if (!response.ok) {
+        let message = `HTTP ${response.status}`;
+        try {
+          const data = await response.json();
+          if (data.detail) {
+            message = data.detail;
+          }
+        } catch (e) {
+          // 无法解析 JSON，使用默认消息
+        }
+        throw new Error(message);
+      }
+      return response;
+    }
+  };
+}

package/lib/auth.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getConfig } from './config.js';
+
+export function loadCredentials() {
+  const { credentialsPath } = getConfig();
+  
+  try {
+    const content = fs.readFileSync(credentialsPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (err) {
+    // 文件不存在时返回 null
+    return null;
+  }
+}
+
+export function saveCredentials({ token, username }) {
+  const { credentialsDir, credentialsPath } = getConfig();
+  
+  // 创建目录（recursive）
+  fs.mkdirSync(credentialsDir, { recursive: true });
+  
+  // 写入 JSON
+  fs.writeFileSync(credentialsPath, JSON.stringify({ token, username }, null, 2));
+}
+
+export function removeCredentials() {
+  const { credentialsPath } = getConfig();
+  
+  try {
+    fs.unlinkSync(credentialsPath);
+  } catch (err) {
+    // 不存在时静默忽略
+  }
+}

package/lib/commands/install.js

@@ -0,0 +1,82 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import chalk from 'chalk';
+import ora from 'ora';
+import extract from 'extract-zip';
+import { createClient } from '../api.js';
+
+/**
+ * 下载并解压 Skill 到指定目录
+ * @param {string} skillId - Skill ID
+ * @param {string} version - 版本号（或 'latest'）
+ * @param {string} targetDir - 目标目录
+ * @returns {Promise<{skillId: string, version: string, targetDir: string}>}
+ */
+export async function downloadAndExtract(skillId, version, targetDir) {
+  const client = createClient();
+
+  // 先获取 Skill 信息确认存在
+  const skillInfo = await client.get(`/skills/${encodeURIComponent(skillId)}`);
+
+  // 如果是 latest，使用实际版本号
+  const actualVersion = version === 'latest' ? skillInfo.latest_version : version;
+
+  if (!actualVersion) {
+    throw new Error(`Skill ${skillId} 没有可用版本`);
+  }
+
+  // 下载 zip
+  const response = await client.download(
+    `/skills/${encodeURIComponent(skillId)}/versions/${encodeURIComponent(actualVersion)}/download`
+  );
+
+  // 获取 ArrayBuffer 并写入临时文件
+  const arrayBuffer = await response.arrayBuffer();
+  const buffer = Buffer.from(arrayBuffer);
+  
+  const tmpZip = path.join(os.tmpdir(), `skb-${skillId}-${actualVersion}-${Date.now()}.zip`);
+  fs.writeFileSync(tmpZip, buffer);
+
+  // 确保目标目录存在
+  fs.mkdirSync(targetDir, { recursive: true });
+
+  // 解压
+  await extract(tmpZip, { dir: path.resolve(targetDir) });
+
+  // 清理临时文件
+  try {
+    fs.unlinkSync(tmpZip);
+  } catch (e) {
+    // 忽略清理失败
+  }
+
+  return { skillId, version: actualVersion, targetDir };
+}
+
+export default async function install(target, options) {
+  // 解析 target: skillId@version 或 skillId
+  let skillId, version;
+  if (target.includes('@')) {
+    const parts = target.split('@');
+    skillId = parts[0];
+    version = parts[1];
+  } else {
+    skillId = target;
+    version = 'latest';
+  }
+
+  // 目标目录：选项指定或当前目录
+  // 由于 zip 包内已包含 skillId 文件夹，我们解压到当前目录即可
+  const targetDir = options?.dir || process.cwd();
+
+  const spinner = ora(`正在下载 ${skillId}${version !== 'latest' ? '@' + version : ''}...`).start();
+
+  try {
+    const result = await downloadAndExtract(skillId, version, targetDir);
+    spinner.succeed(chalk.green(`已安装 ${result.skillId} ${result.version} 到 ${path.join(result.targetDir, skillId)}`));
+  } catch (err) {
+    spinner.fail(chalk.red(`安装失败：${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/commands/login.js

@@ -0,0 +1,54 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { getConfig } from '../config.js';
+import { saveCredentials } from '../auth.js';
+import { createClient } from '../api.js';
+
+export default async function login() {
+  const { baseUrl } = getConfig();
+  const client = createClient();
+
+  console.log(chalk.cyan('\n📋 登录指引：'));
+  console.log(`   1. 在浏览器中打开 ${chalk.underline(baseUrl + '/login?from=cli')}`);
+  console.log('   2. 登录后获取 CLI 验证码');
+  console.log('   3. 在下方输入验证码\n');
+
+  const response = await prompts({
+    type: 'text',
+    name: 'code',
+    message: '请输入 8 位验证码（如 8A2B-9C4F）:',
+    validate: value => {
+      const pattern = /^[A-Z0-9]{4}-[A-Z0-9]{4}$/i;
+      return pattern.test(value) ? true : '验证码格式错误，请输入 8 位验证码（如 8A2B-9C4F）';
+    }
+  });
+
+  // 用户取消输入
+  if (!response.code) {
+    console.log(chalk.yellow('\n已取消登录'));
+    process.exit(0);
+  }
+
+  const spinner = ora('正在验证...').start();
+
+  try {
+    const result = await client.post('/auth/cli-code/verify', {
+      code: response.code.toUpperCase()
+    });
+
+    if (result.ok && result.token && result.user) {
+      saveCredentials({
+        token: result.token,
+        username: result.user.username
+      });
+      spinner.succeed(chalk.green(`登录成功，当前账号：${result.user.username}`));
+    } else {
+      spinner.fail(chalk.red('验证失败，请检查验证码是否正确'));
+      process.exit(1);
+    }
+  } catch (err) {
+    spinner.fail(chalk.red(`登录失败：${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/commands/logout.js

@@ -0,0 +1,7 @@
+import chalk from 'chalk';
+import { removeCredentials } from '../auth.js';
+
+export default async function logout() {
+  removeCredentials();
+  console.log(chalk.green('✅ 已登出，本地凭证已清除'));
+}

package/lib/commands/publish.js

@@ -0,0 +1,151 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { randomBytes } from 'node:crypto';
+import chalk from 'chalk';
+import ora from 'ora';
+import archiver from 'archiver';
+import { loadCredentials } from '../auth.js';
+import { createClient } from '../api.js';
+
+/**
+ * 从 SKILL.md 提取 name 和 description
+ * - name: 取第一个 # 标题
+ * - description: 取标题后的第一段非空文本（前 200 字符）
+ */
+function parseSkillMd(content) {
+  const lines = content.split('\n');
+  let name = null;
+  let description = null;
+  let foundTitle = false;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    
+    // 匹配 # 标题
+    if (!foundTitle && trimmed.startsWith('# ')) {
+      name = trimmed.slice(2).trim();
+      foundTitle = true;
+      continue;
+    }
+    
+    // 找标题后的第一段非空文本
+    if (foundTitle && trimmed && !trimmed.startsWith('#')) {
+      description = trimmed.slice(0, 200);
+      break;
+    }
+  }
+
+  return { name, description };
+}
+
+/**
+ * 将文件夹打包为 zip
+ * @param {string} dirPath - 要打包的目录路径
+ * @param {string} outputPath - 输出的 zip 文件路径
+ * @param {string} dirName - zip 包内的目录名称（顶层文件夹）
+ */
+function zipDirectory(dirPath, outputPath, dirName) {
+  return new Promise((resolve, reject) => {
+    const output = fs.createWriteStream(outputPath);
+    const archive = archiver('zip', { zlib: { level: 9 } });
+
+    output.on('close', () => resolve(archive.pointer()));
+    archive.on('error', reject);
+
+    archive.pipe(output);
+    // 使用 dirName 作为 zip 包内的顶层文件夹名称
+    archive.directory(dirPath, dirName);
+    archive.finalize();
+  });
+}
+
+export default async function publish(directory, options) {
+  // 1. 验证凭证
+  const credentials = loadCredentials();
+  if (!credentials?.token) {
+    console.log(chalk.red('❌ 请先登录：skb login'));
+    process.exit(1);
+  }
+
+  // 2. 验证目录存在
+  const resolvedDir = path.resolve(directory);
+  if (!fs.existsSync(resolvedDir)) {
+    console.log(chalk.red(`❌ 目录不存在：${resolvedDir}`));
+    process.exit(1);
+  }
+
+  const stat = fs.statSync(resolvedDir);
+  if (!stat.isDirectory()) {
+    console.log(chalk.red(`❌ 路径不是目录：${resolvedDir}`));
+    process.exit(1);
+  }
+
+  // 3. 验证 SKILL.md 存在
+  const skillMdPath = path.join(resolvedDir, 'SKILL.md');
+  if (!fs.existsSync(skillMdPath)) {
+    console.log(chalk.red(`❌ 目录内缺少 SKILL.md 文件：${skillMdPath}`));
+    process.exit(1);
+  }
+
+  // 4. 从文件夹名提取 skill_id
+  const skillId = path.basename(resolvedDir);
+
+  // 5. 从 SKILL.md 提取 name 和 description
+  const skillMdContent = fs.readFileSync(skillMdPath, 'utf-8');
+  const parsed = parseSkillMd(skillMdContent);
+
+  const name = options.name || parsed.name || skillId;
+  const description = options.description || parsed.description || '';
+  const changelog = options.changelog;
+
+  console.log(chalk.cyan(`📦 准备发布 Skill: ${skillId}`));
+  console.log(chalk.gray(`   名称: ${name}`));
+  console.log(chalk.gray(`   描述: ${description || '(无)'}`));
+  console.log(chalk.gray(`   更新说明: ${changelog}`));
+
+  // 6. 打包为 zip
+  const spinner = ora('正在打包...').start();
+  const tmpZipPath = path.join(os.tmpdir(), `skb-${randomBytes(8).toString('hex')}.zip`);
+
+  try {
+    const size = await zipDirectory(resolvedDir, tmpZipPath, skillId);
+    spinner.text = `打包完成 (${(size / 1024).toFixed(1)} KB)，正在上传...`;
+
+    // 7. 上传
+    const client = createClient();
+    
+    // 读取 zip 文件内容
+    const zipBuffer = fs.readFileSync(tmpZipPath);
+    const zipBlob = new Blob([zipBuffer], { type: 'application/zip' });
+    
+    // 使用原生 FormData
+    const formData = new FormData();
+    formData.append('zip_file', zipBlob, 'skill.zip');
+    formData.append('skill_id', skillId);
+    formData.append('name', name);
+    formData.append('description', description);
+    formData.append('changelog', changelog || '');
+
+    const result = await client.postForm('/skills/publish', formData);
+
+    if (result.ok) {
+      spinner.succeed(chalk.green(`发布成功！Skill: ${result.skill_id}, 版本: ${result.version}`));
+    } else {
+      spinner.fail(chalk.red('发布失败'));
+      process.exit(1);
+    }
+  } catch (err) {
+    spinner.fail(chalk.red(`发布失败：${err.message}`));
+    process.exit(1);
+  } finally {
+    // 8. 清理临时文件
+    try {
+      if (fs.existsSync(tmpZipPath)) {
+        fs.unlinkSync(tmpZipPath);
+      }
+    } catch {
+      // 忽略清理错误
+    }
+  }
+}

package/lib/commands/search.js

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient } from '../api.js';
+
+export default async function search(keyword) {
+  const client = createClient();
+  const spinner = ora('正在搜索...').start();
+
+  try {
+    const result = await client.get(`/skills?q=${encodeURIComponent(keyword)}`);
+    spinner.stop();
+
+    if (!result.skills || result.skills.length === 0) {
+      console.log(chalk.yellow('未找到匹配的 Skill'));
+      return;
+    }
+
+    // 表格展示
+    const skills = result.skills;
+    
+    // 计算列宽
+    const idWidth = Math.max(4, ...skills.map(s => s.id.length));
+    const nameWidth = Math.max(6, ...skills.map(s => s.name.length));
+    const versionWidth = Math.max(8, ...skills.map(s => (s.latest_version || '-').length));
+    const descWidth = 40;
+
+    // 表头
+    const header = [
+      'ID'.padEnd(idWidth),
+      '名称'.padEnd(nameWidth),
+      '最新版本'.padEnd(versionWidth),
+      '描述'
+    ].join('  ');
+
+    const separator = '-'.repeat(idWidth + nameWidth + versionWidth + descWidth + 6);
+
+    console.log(chalk.cyan(`\n找到 ${result.total || skills.length} 个 Skill:\n`));
+    console.log(chalk.bold(header));
+    console.log(separator);
+
+    for (const skill of skills) {
+      // 截断描述到 40 字符
+      let desc = skill.description || '';
+      if (desc.length > descWidth) {
+        desc = desc.slice(0, descWidth - 3) + '...';
+      }
+
+      const row = [
+        skill.id.padEnd(idWidth),
+        skill.name.padEnd(nameWidth),
+        (skill.latest_version || '-').padEnd(versionWidth),
+        desc
+      ].join('  ');
+
+      console.log(row);
+    }
+
+    console.log('');
+  } catch (err) {
+    spinner.fail(chalk.red(`搜索失败：${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/commands/update.js

@@ -0,0 +1,31 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { createClient } from '../api.js';
+import { downloadAndExtract } from './install.js';
+
+export default async function update(skillId, options) {
+  const client = createClient();
+  const targetDir = options?.dir || process.cwd();
+
+  const spinner = ora(`正在检查 ${skillId} 的最新版本...`).start();
+
+  try {
+    // 获取 Skill 信息
+    const skillInfo = await client.get(`/skills/${encodeURIComponent(skillId)}`);
+    const latestVersion = skillInfo.latest_version;
+
+    if (!latestVersion) {
+      spinner.fail(chalk.red(`Skill ${skillId} 没有可用版本`));
+      process.exit(1);
+    }
+
+    spinner.text = `正在下载 ${skillId}@${latestVersion}...`;
+
+    // 直接下载最新版本（由于没有本地版本跟踪，每次都执行更新）
+    const result = await downloadAndExtract(skillId, latestVersion, targetDir);
+    spinner.succeed(chalk.green(`已更新 ${result.skillId} 到 ${result.version}`));
+  } catch (err) {
+    spinner.fail(chalk.red(`更新失败：${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/config.js

@@ -0,0 +1,17 @@
+import os from 'node:os';
+import path from 'node:path';
+
+export function getConfig() {
+  let baseUrl = process.env.SKB_BASE_URL || 'http://localhost:8000';
+  // 去除末尾斜杠
+  baseUrl = baseUrl.replace(/\/+$/, '');
+  
+  const credentialsDir = path.join(os.homedir(), '.skill-base');
+  
+  return {
+    baseUrl,
+    apiUrl: `${baseUrl}/api/v1`,
+    credentialsDir,
+    credentialsPath: path.join(credentialsDir, 'credentials.json')
+  };
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "skill-base-cli",
+  "version": "1.0.0",
+  "description": "Skill Base CLI - 命令行工具，用于搜索、安装、更新和发布 AI Agent Skills",
+  "type": "module",
+  "bin": {
+    "skb": "./bin/skb.js"
+  },
+  "keywords": [
+    "skill",
+    "agent",
+    "ai",
+    "cli",
+    "skill-base"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "homepage": "",
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "dependencies": {
+    "archiver": "^7.0.0",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2",
+    "form-data": "^4.0.0",
+    "extract-zip": "^2.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}