@42ailab/42plugin 0.1.0-beta.1 → 0.1.2

package/src/commands/publish.ts

@@ -0,0 +1,121 @@
+/**
+ * publish 命令 - 发布插件到 42plugin
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { api } from '../api';
+import { config } from '../config';
+import { getSessionToken } from '../db';
+import { Publisher } from '../services/publisher';
+import { ValidationError, UploadError, AuthRequiredError } from '../errors';
+import { getTypeIcon } from '../utils';
+
+export const publishCommand = new Command('publish')
+  .description('发布插件到 42plugin')
+  .argument('[path]', '插件路径（文件或目录）', '.')
+  .option('--dry-run', '仅验证，不实际发布')
+  .option('-f, --force', '强制发布（即使内容未变化）')
+  .option('--public', '公开发布（默认仅自己可见）')
+  .option('-n, --name <name>', '覆盖插件名称')
+  .action(async (pluginPath, options) => {
+    try {
+      // 开发模式跳过认证检查
+      if (!config.devSkipAuth) {
+        // 检查登录状态
+        const token = await getSessionToken();
+        if (!token) {
+          throw new AuthRequiredError();
+        }
+        api.setSessionToken(token);
+
+        // 验证 session 有效性
+        try {
+          const session = await api.getSession();
+          if (!session.user.name) {
+            console.log(chalk.yellow('提示: 建议先设置用户名'));
+          }
+        } catch {
+          throw new AuthRequiredError('登录已过期，请重新登录: 42plugin auth');
+        }
+      } else {
+        console.log(chalk.cyan('[DEV] 跳过认证检查'));
+      }
+
+      // 执行发布
+      const publisher = new Publisher();
+      const result = await publisher.publish({
+        path: pluginPath,
+        dryRun: options.dryRun,
+        force: options.force,
+        visibility: options.public ? 'public' : 'self',
+        name: options.name,
+      });
+
+      // 显示结果
+      console.log();
+      if (result.action === 'unchanged') {
+        console.log(chalk.yellow('插件内容未变化，跳过发布'));
+      } else if (!options.dryRun) {
+        console.log(chalk.green('✓ 发布成功!'));
+        console.log();
+        console.log(`  ${getTypeIcon(result.type)} ${chalk.bold(result.fullName)}`);
+        console.log(`  版本: v${result.version}`);
+        console.log(`  类型: ${result.type}`);
+        console.log(`  状态: ${result.action === 'created' ? '新建' : '更新'}`);
+
+        if (!options.public) {
+          console.log();
+          console.log(chalk.gray('当前仅自己可见，使用 --public 参数公开发布'));
+        }
+
+        console.log();
+        console.log(chalk.gray(`安装: 42plugin install ${result.fullName}`));
+      }
+    } catch (error) {
+      handleError(error as Error);
+      process.exit(1);
+    }
+  });
+
+/**
+ * 错误处理
+ */
+function handleError(error: Error): void {
+  if (error instanceof AuthRequiredError) {
+    console.error(chalk.red(error.message));
+    return;
+  }
+
+  if (error instanceof ValidationError) {
+    console.error(chalk.red(`验证失败: ${error.message}`));
+
+    // 提供具体建议
+    if (error.code === 'PATH_NOT_FOUND') {
+      console.log(chalk.yellow('\n请检查路径是否正确'));
+    } else if (error.code === 'UNSUPPORTED_FILE_TYPE') {
+      console.log(chalk.yellow('\n支持的文件类型: .md, .yaml, .yml'));
+    }
+    return;
+  }
+
+  if (error instanceof UploadError) {
+    console.error(chalk.red(`上传失败: ${error.message}`));
+    if (error.statusCode === 413) {
+      console.log(chalk.yellow('\n文件过大，请压缩后重试'));
+    }
+    return;
+  }
+
+  // 通用错误处理
+  console.error(chalk.red(error.message));
+
+  // 常见错误提示
+  if (error.message.includes('ENOENT')) {
+    console.log(chalk.yellow('\n文件或目录不存在'));
+  } else if (error.message.includes('network') || error.message.includes('ECONNREFUSED')) {
+    console.log(chalk.yellow('\n网络连接失败，请检查网络'));
+  } else if (error.message.includes('401') || error.message.includes('unauthorized')) {
+    console.log(chalk.yellow('\n认证失败，请重新登录: 42plugin auth'));
+  }
+}

package/src/commands/search.ts

@@ -1,100 +1,104 @@
+/**
+ * search 命令 - 搜索插件
+ */
+
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { api } from '../services/api';
-
-interface SearchOptions {
-  type?: string;
-  limit?: string;
-  json?: boolean;
-}
+import ora from 'ora';
+import { checkbox } from '@inquirer/prompts';
+import { api } from '../api';
+import { getSessionToken } from '../db';
+import { getTypeIcon, getTypeLabel, parseTarget } from '../utils';
+import type { PluginType, SearchResult } from '../types';
 
 export const searchCommand = new Command('search')
   .description('搜索插件')
-  .argument('<query>', '搜索关键词')
-  .option('--type <type>', '筛选类型: skill | agent | command | hook | list')
-  .option('--limit <n>', '结果数量限制', '20')
-  .option('--json', 'JSON 格式输出')
-  .action(async (query: string, options: SearchOptions) => {
-    await search(query, options);
-  });
-
-async function search(query: string, options: SearchOptions) {
-  try {
-    // Map CLI type options to API type parameter
-    // API supports: capability | list | all
-    // CLI supports: skill | agent | command | hook | list
-    const capabilityTypes = ['skill', 'agent', 'command', 'hook'];
-    const apiType = options.type === 'list' ? 'list'
-      : capabilityTypes.includes(options.type || '') ? 'capability'
-      : undefined;
-
-    const results = await api.search(query, {
-      type: apiType,
-      per_page: Number(options.limit) || 20,
-    });
-
-    // Filter capabilities by specific type if requested
-    if (options.type && capabilityTypes.includes(options.type)) {
-      results.capabilities = results.capabilities.filter(cap => cap.type === options.type);
+  .argument('<keyword>', '搜索关键词')
+  .option('-t, --type <type>', '筛选类型 (skill, agent, command, hook, mcp)')
+  .option('-l, --limit <n>', '结果数量', '20')
+  .option('--json', '输出 JSON 格式')
+  .option('-i, --interactive', '交互式选择安装')
+  .action(async (keyword, options) => {
+    // 初始化 API token
+    const token = await getSessionToken();
+    if (token) {
+      api.setSessionToken(token);
     }
 
-    if (options.json) {
-      console.log(JSON.stringify(results, null, 2));
-      return;
-    }
+    const spinner = ora('搜索中...').start();
 
-    // Display capability results
-    if (results.capabilities.length > 0) {
-      console.log();
-      console.log(chalk.bold('插件:'));
-      console.log();
-
-      for (const cap of results.capabilities) {
-        const typeColor = getTypeColor(cap.type);
-        // Use short_name (author/slug) for display, making it easy to copy for install
-        const displayName = cap.short_name;
-        console.log(`  ${typeColor(cap.type.padEnd(7))} ${chalk.cyan(displayName)}`);
-        if (cap.description) {
-          console.log(`          ${chalk.gray(truncate(cap.description, 60))}`);
-        }
-        console.log(`          ${chalk.gray(`下载: ${cap.downloads}`)}  ${chalk.dim(`安装: 42plugin install ${displayName}`)}`);
-        console.log();
+    try {
+      const result = await api.search({
+        q: keyword,
+        pluginType: options.type,
+        perPage: parseInt(options.limit) || 20,
+      });
+
+      spinner.stop();
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
       }
-    }
 
-    // Display list results
-    if (results.lists.length > 0) {
-      console.log();
-      console.log(chalk.bold('列表:'));
-      console.log();
+      if (result.data.length === 0) {
+        console.log(chalk.yellow('未找到匹配的插件'));
+        return;
+      }
+
+      console.log(
+        chalk.gray(`找到 ${result.pagination.total} 个结果，显示第 1-${result.data.length} 个:\n`)
+      );
+
+      for (const item of result.data) {
+        const icon = getTypeIcon(item.type);
+        const typeLabel = getTypeLabel(item.type);
 
-      for (const list of results.lists) {
-        console.log(`  ${chalk.magenta('list')}    ${chalk.cyan(list.full_name)}`);
-        console.log(`          ${list.name}`);
-        console.log(`          ${chalk.gray(`${list.capability_count} 个插件 · 下载: ${list.downloads}`)}`);
+        console.log(`${icon} ${chalk.cyan.bold(item.fullName)} ${chalk.gray(`[${typeLabel}]`)}`);
+
+        if (item.title || item.slogan) {
+          console.log(`  ${item.title || item.slogan}`);
+        }
+
+        if (item.description) {
+          const desc = item.description.length > 80
+            ? item.description.slice(0, 80) + '...'
+            : item.description;
+          console.log(chalk.gray(`  ${desc}`));
+        }
+
+        console.log(chalk.gray(`  v${item.version} · ${item.downloads} 下载`));
         console.log();
       }
-    }
 
-    if (results.capabilities.length === 0 && results.lists.length === 0) {
-      console.log(chalk.yellow('未找到结果'));
+      // 交互式选择安装
+      if (options.interactive && result.data.length > 0) {
+        console.log();
+        const choices = result.data.map((item) => ({
+          name: `${getTypeIcon(item.type)} ${item.fullName} - ${item.title || item.slogan || item.description?.slice(0, 30) || ''}`,
+          value: item.fullName,
+        }));
+
+        const selected = await checkbox({
+          message: '选择要安装的插件 (空格选择，回车确认):',
+          choices,
+        });
+
+        if (selected.length > 0) {
+          console.log();
+          // 动态导入 install 命令以避免循环依赖
+          const { installPlugin } = await import('./install-helper');
+          for (const fullName of selected) {
+            await installPlugin(fullName);
+          }
+        }
+      } else {
+        // 提示
+        console.log(chalk.gray(`安装: 42plugin install <name>`));
+      }
+    } catch (error) {
+      spinner.fail('搜索失败');
+      console.error(chalk.red((error as Error).message));
+      process.exit(1);
     }
-  } catch (error) {
-    console.error(chalk.red(`搜索失败: ${(error as Error).message}`));
-    process.exit(1);
-  }
-}
-
-function getTypeColor(type: string): (text: string) => string {
-  const colors: Record<string, (text: string) => string> = {
-    skill: chalk.blue,
-    agent: chalk.green,
-    command: chalk.yellow,
-    hook: chalk.magenta,
-  };
-  return colors[type] || chalk.white;
-}
-
-function truncate(str: string, len: number): string {
-  return str.length > len ? str.slice(0, len - 3) + '...' : str;
-}
+  });

package/src/commands/setup.ts

@@ -0,0 +1,158 @@
+/**
+ * setup 命令 - 自动配置 CLI 环境
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { select, confirm } from '@inquirer/prompts';
+
+export const setupCommand = new Command('setup')
+  .description('配置 CLI 环境（Shell 补全等）')
+  .option('--completion', '仅配置 Shell 补全')
+  .action(async (options) => {
+    console.log(chalk.cyan.bold('\n42plugin CLI 环境配置\n'));
+
+    if (options.completion) {
+      await setupCompletion();
+    } else {
+      // 交互式菜单
+      const choice = await select({
+        message: '选择要配置的功能:',
+        choices: [
+          { name: 'Shell 自动补全', value: 'completion' },
+          { name: '退出', value: 'exit' },
+        ],
+      });
+
+      if (choice === 'completion') {
+        await setupCompletion();
+      }
+    }
+  });
+
+async function setupCompletion(): Promise<void> {
+  // 检测当前 Shell
+  const shell = detectShell();
+
+  if (!shell) {
+    console.log(chalk.yellow('无法检测当前 Shell 类型'));
+    console.log(chalk.gray('请手动运行: 42plugin completion <bash|zsh|fish>'));
+    return;
+  }
+
+  console.log(chalk.gray(`检测到 Shell: ${shell}`));
+
+  // 获取配置文件路径
+  const configFile = getShellConfigFile(shell);
+  if (!configFile) {
+    console.log(chalk.yellow(`不支持的 Shell: ${shell}`));
+    return;
+  }
+
+  // 检查是否已配置
+  const alreadyConfigured = await checkAlreadyConfigured(configFile);
+  if (alreadyConfigured) {
+    console.log(chalk.green('✓ Shell 补全已配置'));
+    return;
+  }
+
+  // 确认安装
+  const shouldInstall = await confirm({
+    message: `是否将补全脚本添加到 ${configFile}?`,
+    default: true,
+  });
+
+  if (!shouldInstall) {
+    console.log(chalk.gray('已取消'));
+    return;
+  }
+
+  // 生成并写入补全脚本
+  try {
+    await installCompletion(shell, configFile);
+    console.log(chalk.green(`\n✓ 补全脚本已添加到 ${configFile}`));
+    console.log(chalk.yellow(`\n请运行以下命令使配置生效:`));
+    console.log(chalk.cyan(`  source ${configFile}`));
+    console.log(chalk.gray(`\n或重新打开终端`));
+  } catch (error) {
+    console.error(chalk.red(`配置失败: ${(error as Error).message}`));
+  }
+}
+
+function detectShell(): string | null {
+  const shell = process.env.SHELL || '';
+  if (shell.includes('zsh')) return 'zsh';
+  if (shell.includes('bash')) return 'bash';
+  if (shell.includes('fish')) return 'fish';
+  return null;
+}
+
+function getShellConfigFile(shell: string): string | null {
+  const home = os.homedir();
+  switch (shell) {
+    case 'zsh':
+      return path.join(home, '.zshrc');
+    case 'bash':
+      // macOS 使用 .bash_profile，Linux 使用 .bashrc
+      return process.platform === 'darwin'
+        ? path.join(home, '.bash_profile')
+        : path.join(home, '.bashrc');
+    case 'fish':
+      return path.join(home, '.config', 'fish', 'config.fish');
+    default:
+      return null;
+  }
+}
+
+async function checkAlreadyConfigured(configFile: string): Promise<boolean> {
+  try {
+    const content = await fs.readFile(configFile, 'utf-8');
+    return content.includes('42plugin completion');
+  } catch {
+    return false;
+  }
+}
+
+async function installCompletion(shell: string, configFile: string): Promise<void> {
+  // 确保配置文件目录存在
+  await fs.mkdir(path.dirname(configFile), { recursive: true });
+
+  // 生成补全初始化脚本
+  const initScript = getCompletionInitScript(shell);
+
+  // 追加到配置文件
+  let content = '';
+  try {
+    content = await fs.readFile(configFile, 'utf-8');
+  } catch {
+    // 文件不存在，创建新文件
+  }
+
+  const newContent = content + '\n' + initScript + '\n';
+  await fs.writeFile(configFile, newContent);
+}
+
+function getCompletionInitScript(shell: string): string {
+  switch (shell) {
+    case 'bash':
+      return `
+# 42plugin CLI 补全
+eval "$(42plugin completion bash)"
+`;
+    case 'zsh':
+      return `
+# 42plugin CLI 补全
+eval "$(42plugin completion zsh)"
+`;
+    case 'fish':
+      return `
+# 42plugin CLI 补全
+42plugin completion fish | source
+`;
+    default:
+      return '';
+  }
+}

package/src/commands/uninstall.ts

@@ -1,58 +1,67 @@
+/**
+ * uninstall 命令 - 卸载插件
+ */
+
 import { Command } from 'commander';
-import fs from 'fs/promises';
 import chalk from 'chalk';
 import ora from 'ora';
-import { getProject, removeProjectPlugin } from '../services/project';
-import { removeFromCache } from '../services/cache';
-
-interface UninstallOptions {
-  purge?: boolean;
-}
+import { api } from '../api';
+import { getSessionToken, getInstallations, removeInstallation, removeLink, removeCache } from '../db';
+import { parseTarget } from '../utils';
 
 export const uninstallCommand = new Command('uninstall')
+  .alias('rm')
   .description('卸载插件')
-  .argument('<plugin>', '插件标识符')
-  .option('--purge', '同时删除缓存')
-  .action(async (plugin: string, options: UninstallOptions) => {
-    await uninstall(plugin, options);
-  });
+  .argument('<target>', '插件名 (author/name)')
+  .option('--purge', '同时清除缓存')
+  .action(async (target, options) => {
+    // 初始化 API token
+    const token = await getSessionToken();
+    if (token) {
+      api.setSessionToken(token);
+    }
 
-async function uninstall(plugin: string, options: UninstallOptions) {
-  const spinner = ora(`卸载 ${plugin}...`).start();
+    const spinner = ora(`卸载 ${target}...`).start();
 
-  try {
-    const projectPath = process.cwd();
-    const project = await getProject(projectPath);
+    try {
+      const parsed = parseTarget(target);
+      const projectPath = process.cwd();
 
-    if (!project) {
-      spinner.fail('当前目录不是 42plugin 项目');
-      return;
-    }
+      // 查找安装记录
+      const installations = await getInstallations(projectPath);
+      const installation = installations.find((i) => i.fullName === parsed.fullName);
 
-    // Get install record
-    const record = await removeProjectPlugin(project.id, plugin);
+      if (!installation) {
+        spinner.fail(`未找到已安装的插件: ${target}`);
+        process.exit(1);
+      }
 
-    if (!record) {
-      spinner.fail(`未找到已安装的插件: ${plugin}`);
-      return;
-    }
+      // 移除链接
+      await removeLink(installation.linkPath);
 
-    // Remove link (normalize path by removing trailing slash)
-    try {
-      const linkPath = record.link_path.replace(/\/+$/, '');
-      await fs.rm(linkPath, { recursive: true, force: true });
-    } catch {
-      // Ignore deletion errors
-    }
+      // 移除安装记录
+      await removeInstallation(projectPath, parsed.fullName);
 
-    // If --purge specified, also remove from cache
-    if (options.purge) {
-      await removeFromCache(plugin, record.version);
-    }
+      // 同步卸载记录（静默）
+      if (api.isAuthenticated()) {
+        api.removeInstallRecord(parsed.author, parsed.name).catch(() => {});
+      }
 
-    spinner.succeed(`${chalk.green('已卸载')} ${plugin}`);
-  } catch (error) {
-    spinner.fail(`卸载失败: ${(error as Error).message}`);
-    process.exit(1);
-  }
-}
+      // 清除缓存
+      if (options.purge) {
+        const removed = await removeCache(parsed.fullName, installation.version);
+        if (removed) {
+          spinner.succeed(`已卸载 ${target}（含缓存）`);
+        } else {
+          spinner.succeed(`已卸载 ${target}`);
+          console.log(chalk.gray('  缓存已不存在'));
+        }
+      } else {
+        spinner.succeed(`已卸载 ${target}`);
+      }
+    } catch (error) {
+      spinner.fail('卸载失败');
+      console.error(chalk.red((error as Error).message));
+      process.exit(1);
+    }
+  });

package/src/config.ts

@@ -1,44 +1,35 @@
+/**
+ * CLI 配置
+ */
+
 import path from 'path';
 import os from 'os';
-import fs from 'fs';
-
-let dataDir: string | null = null;
-
-export function getDataDir(): string {
-  if (dataDir) return dataDir;
-
-  if (process.platform === 'win32') {
-    dataDir = path.join(process.env.APPDATA || os.homedir(), '42plugin');
-  } else {
-    dataDir = path.join(os.homedir(), '.42plugin');
-  }
-
-  // Ensure directory exists
-  if (!fs.existsSync(dataDir)) {
-    fs.mkdirSync(dataDir, { recursive: true });
-  }
 
-  return dataDir;
-}
+// 数据目录
+const dataDir =
+  process.platform === 'win32'
+    ? path.join(process.env.APPDATA || os.homedir(), '42plugin')
+    : path.join(os.homedir(), '.42plugin');
 
-export function getCacheDir(): string {
-  const cacheDir = path.join(getDataDir(), 'cache');
-  if (!fs.existsSync(cacheDir)) {
-    fs.mkdirSync(cacheDir, { recursive: true });
-  }
-  return cacheDir;
-}
-
-export function getDbPath(): string {
-  return path.join(getDataDir(), 'local.db');
-}
+export const config = {
+  // 目录
+  dataDir,
+  cacheDir: path.join(dataDir, 'cache'),
+  globalDir: path.join(dataDir, 'global'),
+  dbPath: path.join(dataDir, 'local.db'),
 
-export function getSecretsPath(): string {
-  return path.join(getDataDir(), 'secrets.json');
-}
+  // API
+  apiBaseUrl: process.env.API_BASE_URL || 'https://api.42plugin.com',
+  webBaseUrl: process.env.WEB_BASE_URL || 'https://42plugin.com',
 
-export const config = {
-  apiBase: process.env.API_BASE_URL || 'https://api.42plugin.com',
-  cdnBase: process.env.CDN_BASE || 'https://cdn.42plugin.com',
+  // 调试
   debug: process.env.DEBUG === 'true',
+
+  // 开发模式跳过认证
+  devSkipAuth: process.env.DEV_SKIP_AUTH === 'true',
 };
+
+// 兼容旧 API
+export const getDataDir = () => config.dataDir;
+export const getCacheDir = () => config.cacheDir;
+export const getDbPath = () => config.dbPath;