@42ailab/42plugin 0.1.0-beta.0

package/README.md

@@ -0,0 +1,104 @@
+# 42plugin CLI
+
+Claude Code 插件管理器，支持搜索、安装、管理来自 42plugin 平台的能力、插件与插件列表。
+
+## 前提条件
+- 需要安装 [Bun](https://bun.sh)（用于运行与构建）。
+- Node.js/npm 非必需；依赖通过 `bun install` 处理。
+
+## 安装依赖
+```bash
+bun install
+```
+
+## 本地开发与运行
+- 直接运行入口（便于调试）：
+  ```bash
+  bun run src/index.ts <command> [options]
+  ```
+- 或使用脚本（等同于上方）：
+  ```bash
+  bun run dev -- <command> [options]
+  ```
+- 构建跨平台可执行文件：
+  ```bash
+  bun run build
+  # 输出位于 dist/ 下，如 dist/42plugin-darwin-arm64、dist/42plugin-linux-x64 等
+  ```
+  构建后二进制即可直接执行，例如 `./dist/42plugin-darwin-arm64 search claude`。
+
+## CLI 使用
+### 登录
+- 浏览器授权登录：`42plugin auth`
+- 查看状态：`42plugin auth --status`
+- 登出并清理凭证：`42plugin auth --logout`
+
+### 搜索插件/能力/列表
+```bash
+42plugin search <关键词> [--type skill|agent|command|hook|list] [--limit 50] [--json]
+```
+
+### 安装
+支持的安装目标格式：
+- 能力：`owner/repo:plugin:type:name`
+- 插件（带插件名）：`owner/repo:plugin`
+- 简化插件：`owner/plugin`
+- 列表：`owner/list/<slug>`
+
+常用示例：
+```bash
+42plugin install user/repo:cool-plugin
+42plugin install user/repo:cool-plugin:command:deploy
+42plugin install user/list/tools              # 安装列表（默认只装必选项）
+42plugin install user/list/tools --optional   # 包含列表中的可选项
+```
+
+选项：
+- `-g, --global`：仅下载到缓存，不链接到当前项目。
+- `--force`：忽略缓存，强制重新下载。
+- `--no-cache`：跳过缓存命中检查。
+- `--optional`：安装列表时包含可选能力（默认只安装必选）。
+
+安装会将包解压到本地缓存，再在当前工作目录创建链接到具体安装路径（例如 `.claude/` 下），同时在本地数据库记录。请在项目根目录执行。
+
+### 查看已安装
+```bash
+42plugin list [--type <type>] [--json]
+```
+
+### 卸载
+```bash
+42plugin uninstall <full_name> [--purge]
+```
+`--purge` 会同时删除缓存内容。
+
+### 查看版本
+```bash
+42plugin version
+```
+
+## 数据存储位置
+- 配置与数据库：`~/.42plugin/local.db`（Windows 为 `%APPDATA%/42plugin/local.db`）
+- 缓存：`~/.42plugin/cache`
+- 登录凭证：`~/.42plugin/secrets.json`（权限 600）
+
+## 环境变量
+- `API_BASE`：替换默认的 API 地址（默认 `https://api.42plugin.com`）。
+- `CDN_BASE`：替换默认的 CDN 地址（默认 `https://cdn.42plugin.com`）。
+- `DEBUG=true`：输出调试信息与原始错误。
+- `CLI_DB_DRIVER=postgres`：让 CLI 使用 Postgres 而非默认的本地 SQLite（`~/.42plugin/local.db`）。配合 `CLI_DATABASE_URL` 或 `LOCAL_DATABASE_URL` 指定连接串，例如 `postgresql://postgres:password@localhost:5432/42plugin_cli_dev`。
+
+## 项目结构速览
+- `src/cli.ts`：命令定义与统一入口。
+- `src/commands/*`：各子命令实现（auth、install、search、list、uninstall、version）。
+- `src/services/*`：API、缓存、下载、项目记录、链接创建等核心逻辑。
+- `src/db/client.ts`：本地 SQLite 初始化与连接（基于 @libsql/client）。
+- `tests/`：命令与服务的测试用例。
+
+## 常用开发命令
+```bash
+bun test              # 运行测试
+bun run lint          # ESLint
+bun run format        # Prettier
+bun run typecheck     # TypeScript 类型检查
+```

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@42ailab/42plugin",
+  "version": "0.1.0-beta.0",
+  "description": "Claude Code 插件管理器",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "42plugin": "./src/index.ts"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun run scripts/build.ts",
+    "test": "bun test",
+    "lint": "eslint src/",
+    "format": "prettier --write src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "plugin",
+    "cli",
+    "ai",
+    "anthropic"
+  ],
+  "author": "42ailab <y@42ailab.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/42ailab/42plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/42ailab/42plugin/issues"
+  },
+  "homepage": "https://github.com/42ailab/42plugin#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@libsql/client": "^0.14.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.0.0",
+    "nanoid": "^5.0.9",
+    "open": "^10.1.0",
+    "ora": "^8.1.1",
+    "pg": "^8.12.0",
+    "tar": "^7.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/tar": "^6.1.13",
+    "typescript": "^5.7.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+import { authCommand } from './commands/auth';
+import { installCommand } from './commands/install';
+import { searchCommand } from './commands/search';
+import { listCommand } from './commands/list';
+import { uninstallCommand } from './commands/uninstall';
+import { versionCommand } from './commands/version';
+
+export const program = new Command();
+
+program
+  .name('42plugin')
+  .description('Claude Code 插件管理器')
+  .version('0.1.0', '-v, --version', '显示版本号')
+  .option('--verbose', '详细输出')
+  .option('--no-color', '禁用颜色输出');
+
+// Register commands
+program.addCommand(authCommand);
+program.addCommand(installCommand);
+program.addCommand(searchCommand);
+program.addCommand(listCommand);
+program.addCommand(uninstallCommand);
+program.addCommand(versionCommand);
+
+// Default help
+program.showHelpAfterError();

package/src/commands/auth.ts

@@ -0,0 +1,114 @@
+import { Command } from 'commander';
+import open from 'open';
+import ora from 'ora';
+import chalk from 'chalk';
+import { api } from '../services/api';
+import { saveSecrets, loadSecrets, clearSecrets } from '../services/auth';
+
+export const authCommand = new Command('auth')
+  .description('登录 / 授权账户')
+  .option('--status', '查看当前登录状态')
+  .option('--logout', '登出并清除本地凭证')
+  .action(async (options) => {
+    if (options.status) {
+      await showStatus();
+      return;
+    }
+
+    if (options.logout) {
+      await logout();
+      return;
+    }
+
+    await login();
+  });
+
+async function login() {
+  const spinner = ora('正在初始化登录...').start();
+
+  try {
+    // 1. Get authorization code
+    const { code, auth_url, expires_at } = await api.startAuth();
+    spinner.stop();
+
+    console.log();
+    console.log(chalk.cyan('正在打开浏览器进行授权...'));
+    console.log();
+    console.log('如果浏览器没有自动打开，请访问：');
+    console.log(chalk.underline(auth_url));
+    console.log();
+
+    // 2. Open browser
+    await open(auth_url);
+
+    // 3. Poll for authorization completion
+    spinner.start('等待浏览器授权...');
+
+    const pollInterval = 2000; // 2 seconds
+    const expiresTime = new Date(expires_at).getTime();
+
+    while (Date.now() < expiresTime) {
+      const result = await api.pollAuth(code);
+
+      if (result.status === 'completed') {
+        // 4. Save credentials
+        await saveSecrets({
+          access_token: result.access_token!,
+          refresh_token: result.refresh_token!,
+          created_at: new Date().toISOString(),
+        });
+
+        // Update API client token
+        api.setToken(result.access_token!);
+
+        spinner.succeed(chalk.green('登录成功！'));
+        console.log();
+        console.log(`欢迎，${chalk.cyan(result.user!.display_name || result.user!.username)}！`);
+        return;
+      }
+
+      await sleep(pollInterval);
+    }
+
+    spinner.fail('授权超时，请重试');
+  } catch (error) {
+    spinner.fail(`登录失败: ${(error as Error).message}`);
+    process.exit(1);
+  }
+}
+
+async function showStatus() {
+  const secrets = await loadSecrets();
+
+  if (!secrets) {
+    console.log(chalk.yellow('未登录'));
+    console.log('使用 42plugin auth 登录');
+    return;
+  }
+
+  try {
+    const user = await api.getMe();
+    console.log(chalk.green('已登录'));
+    console.log();
+    console.log(`用户名: ${chalk.cyan(user.username)}`);
+    console.log(`显示名: ${user.display_name || '-'}`);
+    console.log(`角色:   ${user.role}`);
+
+    if (user.role === 'vip' && user.vip_expires_at) {
+      console.log(`VIP 到期: ${new Date(user.vip_expires_at).toLocaleDateString()}`);
+    }
+  } catch {
+    console.log(chalk.yellow('Token 已过期，请重新登录'));
+    console.log('使用 42plugin auth 重新登录');
+  }
+}
+
+async function logout() {
+  await clearSecrets();
+  api.resetToken();
+  console.log(chalk.green('已登出'));
+}
+
+function sleep(ms: number) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}

package/src/commands/install.ts

@@ -0,0 +1,323 @@
+import { Command } from 'commander';
+import path from 'path';
+import ora, { type Ora } from 'ora';
+import chalk from 'chalk';
+import { api } from '../services/api';
+import { downloadAndExtract } from '../services/download';
+import { getOrCreateProject, addProjectPlugin } from '../services/project';
+import { getCachedPlugin, cachePlugin } from '../services/cache';
+import { createLink } from '../services/link';
+import { parseTarget, TargetType } from '../utils/target';
+
+interface DownloadInfo {
+  type: string;
+  install_path: string;
+  full_name: string;
+  version: string;
+}
+
+interface InstallOptions {
+  global?: boolean;
+  optional?: boolean;
+  force?: boolean;
+  noCache?: boolean;
+}
+
+export const installCommand = new Command('install')
+  .description('安装插件或列表')
+  .argument('<target>', '插件或列表标识符')
+  .option('-g, --global', '全局安装')
+  .option('--optional', '仅安装列表中的可选项')
+  .option('--force', '强制重新安装')
+  .option('--no-cache', '不使用缓存')
+  .action(async (target: string, options: InstallOptions) => {
+    await install(target, options);
+  });
+
+async function install(target: string, options: InstallOptions) {
+  const spinner = ora('解析安装目标...').start();
+
+  try {
+    // 1. Parse target
+    const parsed = parseTarget(target);
+
+    // 2. Handle based on type
+    switch (parsed.type) {
+      case TargetType.Capability:
+        await installCapability(parsed.fullName, options, spinner);
+        break;
+
+      case TargetType.CapabilitySlug:
+        await installCapabilityBySlug(parsed.author!, parsed.slug!, options, spinner);
+        break;
+
+      case TargetType.Plugin:
+        await installPlugin(parsed.fullName, options, spinner);
+        break;
+
+      case TargetType.List:
+        await installList(parsed.fullName, options, spinner);
+        break;
+
+      default:
+        spinner.fail(`无法识别的安装目标: ${target}`);
+        process.exit(1);
+    }
+  } catch (error) {
+    spinner.fail(`安装失败: ${(error as Error).message}`);
+    process.exit(1);
+  }
+}
+
+async function installCapability(
+  fullName: string,
+  options: InstallOptions,
+  spinner: Ora
+) {
+  spinner.text = `获取 ${fullName} 的安装信息...`;
+
+  // Get download info
+  const downloadInfo = await api.getCapabilityDownload(fullName);
+
+  // Check permissions
+  if (downloadInfo.requires_auth && !api.isAuthenticated()) {
+    spinner.fail('此插件需要登录才能安装');
+    console.log('使用 42plugin auth 登录');
+    process.exit(1);
+  }
+
+  // Check cache
+  if (!options.force && options.noCache !== true) {
+    const cached = await getCachedPlugin(fullName, downloadInfo.version);
+    if (cached && cached.checksum === downloadInfo.checksum) {
+      spinner.text = '使用缓存...';
+      await linkToProject(cached.cache_path, downloadInfo, options);
+      spinner.succeed(`${chalk.green('已安装')} ${fullName}`);
+      return;
+    }
+  }
+
+  // Download
+  spinner.text = `下载 ${fullName}...`;
+  const cachePath = await downloadAndExtract(
+    downloadInfo.download_url,
+    downloadInfo.checksum,
+    fullName,
+    downloadInfo.version
+  );
+
+  // Update cache record
+  await cachePlugin({
+    full_name: fullName,
+    type: downloadInfo.type,
+    version: downloadInfo.version,
+    cache_path: cachePath,
+    checksum: downloadInfo.checksum,
+  });
+
+  // Link to project
+  await linkToProject(cachePath, downloadInfo, options);
+
+  spinner.succeed(`${chalk.green('已安装')} ${fullName}`);
+}
+
+async function installCapabilityBySlug(
+  author: string,
+  slug: string,
+  options: InstallOptions,
+  spinner: Ora
+) {
+  const displayName = `${author}/${slug}`;
+  spinner.text = `获取 ${displayName} 的安装信息...`;
+
+  // Get download info by slug
+  const downloadInfo = await api.getCapabilityDownloadBySlug(author, slug);
+
+  // Check permissions
+  if (downloadInfo.requires_auth && !api.isAuthenticated()) {
+    spinner.fail('此插件需要登录才能安装');
+    console.log('使用 42plugin auth 登录');
+    process.exit(1);
+  }
+
+  // Check cache
+  if (!options.force && options.noCache !== true) {
+    const cached = await getCachedPlugin(downloadInfo.full_name, downloadInfo.version);
+    if (cached && cached.checksum === downloadInfo.checksum) {
+      spinner.text = '使用缓存...';
+      await linkToProject(cached.cache_path, downloadInfo, options);
+      spinner.succeed(`${chalk.green('已安装')} ${displayName}`);
+      return;
+    }
+  }
+
+  // Download
+  spinner.text = `下载 ${displayName}...`;
+  const cachePath = await downloadAndExtract(
+    downloadInfo.download_url,
+    downloadInfo.checksum,
+    downloadInfo.full_name,
+    downloadInfo.version
+  );
+
+  // Update cache record
+  await cachePlugin({
+    full_name: downloadInfo.full_name,
+    type: downloadInfo.type,
+    version: downloadInfo.version,
+    cache_path: cachePath,
+    checksum: downloadInfo.checksum,
+  });
+
+  // Link to project
+  await linkToProject(cachePath, downloadInfo, options);
+
+  spinner.succeed(`${chalk.green('已安装')} ${displayName}`);
+}
+
+async function installPlugin(
+  fullName: string,
+  options: InstallOptions,
+  spinner: Ora
+) {
+  spinner.text = `获取插件 ${fullName} 的信息...`;
+
+  // Get plugin details - for simple plugins, use the download endpoint
+  const [owner, plugin] = fullName.split('/');
+
+  // Try to get as a simple plugin first
+  const downloadInfo = await api.getPluginDownload(owner, plugin);
+
+  // Check permissions
+  if (downloadInfo.requires_auth && !api.isAuthenticated()) {
+    spinner.fail('此插件需要登录才能安装');
+    console.log('使用 42plugin auth 登录');
+    process.exit(1);
+  }
+
+  // Check cache
+  if (!options.force && options.noCache !== true) {
+    const cached = await getCachedPlugin(fullName, downloadInfo.version);
+    if (cached && cached.checksum === downloadInfo.checksum) {
+      spinner.text = '使用缓存...';
+      await linkToProject(cached.cache_path, downloadInfo, options);
+      spinner.succeed(`${chalk.green('已安装')} ${fullName}`);
+      return;
+    }
+  }
+
+  // Download
+  spinner.text = `下载 ${fullName}...`;
+  const cachePath = await downloadAndExtract(
+    downloadInfo.download_url,
+    downloadInfo.checksum,
+    fullName,
+    downloadInfo.version
+  );
+
+  // Update cache record
+  await cachePlugin({
+    full_name: fullName,
+    type: downloadInfo.type,
+    version: downloadInfo.version,
+    cache_path: cachePath,
+    checksum: downloadInfo.checksum,
+  });
+
+  // Link to project
+  await linkToProject(cachePath, downloadInfo, options);
+
+  spinner.succeed(`${chalk.green('已安装')} ${fullName}`);
+}
+
+async function installList(
+  fullName: string,
+  options: InstallOptions,
+  spinner: Ora
+) {
+  // Parse list identifier
+  const [username, , slugOrId] = fullName.split('/');
+  spinner.text = `获取列表 ${fullName}...`;
+
+  // Get list download info
+  const listDownload = await api.getListDownload(username, slugOrId);
+
+  console.log();
+  console.log(`列表: ${chalk.cyan(listDownload.list.name)}`);
+  console.log(`能力: ${listDownload.capabilities.length} 个`);
+  console.log();
+
+  // Filter optional items
+  let capabilities = listDownload.capabilities;
+  if (!options.optional) {
+    capabilities = capabilities.filter(c => c.required);
+  }
+
+  // Install each capability
+  let installed = 0;
+  for (const cap of capabilities) {
+    try {
+      spinner.text = `安装 ${cap.name}...`;
+
+      const cachePath = await downloadAndExtract(
+        cap.download_url,
+        cap.checksum,
+        cap.full_name,
+        cap.version
+      );
+
+      await cachePlugin({
+        full_name: cap.full_name,
+        type: cap.type,
+        version: cap.version,
+        cache_path: cachePath,
+        checksum: cap.checksum,
+      });
+
+      await linkToProject(cachePath, cap as DownloadInfo, options, {
+        source: 'list',
+        source_list: fullName,
+      });
+
+      installed++;
+    } catch (error) {
+      console.log(chalk.yellow(`  跳过 ${cap.name}: ${(error as Error).message}`));
+    }
+  }
+
+  spinner.succeed(`${chalk.green('已安装')} ${installed}/${capabilities.length} 个能力`);
+}
+
+async function linkToProject(
+  cachePath: string,
+  info: { type: string; install_path: string; full_name: string; version: string },
+  options: InstallOptions,
+  extra?: { source?: string; source_list?: string }
+) {
+  if (options.global) {
+    // Global install doesn't link to project
+    return;
+  }
+
+  // Get or create project
+  const projectPath = process.cwd();
+  const project = await getOrCreateProject(projectPath);
+
+  // Target path
+  const targetPath = path.join(projectPath, info.install_path);
+
+  // Create link
+  await createLink(cachePath, targetPath);
+
+  // Record in database
+  await addProjectPlugin({
+    project_id: project.id,
+    full_name: info.full_name,
+    type: info.type,
+    version: info.version,
+    cache_path: cachePath,
+    link_path: targetPath,
+    source: extra?.source || 'direct',
+    source_list: extra?.source_list,
+  });
+}

package/src/commands/list.ts

@@ -0,0 +1,80 @@
+import { Command } from 'commander';
+import path from 'path';
+import chalk from 'chalk';
+import { getProject, getProjectPlugins } from '../services/project';
+import type { ProjectPlugin } from '../types/db';
+
+interface ListOptions {
+  type?: string;
+  json?: boolean;
+}
+
+export const listCommand = new Command('list')
+  .description('查看当前项目已安装的插件')
+  .option('--type <type>', '筛选类型')
+  .option('--json', 'JSON 格式输出')
+  .action(async (options: ListOptions) => {
+    await list(options);
+  });
+
+async function list(options: ListOptions) {
+  const projectPath = process.cwd();
+  const project = await getProject(projectPath);
+
+  if (!project) {
+    console.log(chalk.yellow('当前目录不是 42plugin 项目'));
+    console.log('使用 42plugin install <plugin> 安装第一个插件');
+    return;
+  }
+
+  let plugins = await getProjectPlugins(project.id);
+
+  if (options.type) {
+    plugins = plugins.filter(p => p.type === options.type);
+  }
+
+  if (options.json) {
+    console.log(JSON.stringify(plugins, null, 2));
+    return;
+  }
+
+  if (plugins.length === 0) {
+    console.log(chalk.yellow('当前项目没有安装任何插件'));
+    return;
+  }
+
+  console.log();
+  console.log(`项目: ${chalk.cyan(path.basename(projectPath))}`);
+  console.log(`路径: ${projectPath}`);
+  console.log();
+  console.log(`已安装 ${plugins.length} 个插件:`);
+  console.log();
+
+  // Group by type
+  const grouped = groupBy(plugins, 'type');
+
+  for (const [type, items] of Object.entries(grouped)) {
+    console.log(chalk.bold(`${type}:`));
+
+    for (const plugin of items) {
+      const relativePath = path.relative(projectPath, plugin.link_path);
+      console.log(`  ${chalk.cyan(plugin.full_name)}`);
+      console.log(`    版本: ${plugin.version}`);
+      console.log(`    路径: ${chalk.gray(relativePath)}`);
+
+      if (plugin.source === 'list') {
+        console.log(`    来源: ${chalk.gray(plugin.source_list)}`);
+      }
+
+      console.log();
+    }
+  }
+}
+
+function groupBy<T>(arr: T[], key: keyof T): Record<string, T[]> {
+  return arr.reduce((acc, item) => {
+    const k = String(item[key]);
+    (acc[k] = acc[k] || []).push(item);
+    return acc;
+  }, {} as Record<string, T[]>);
+}