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

package/src/commands/auth.ts

@@ -1,114 +1,128 @@
+/**
+ * auth 命令 - 认证管理
+ */
+
 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';
+import ora from 'ora';
+import open from 'open';
+import { api } from '../api';
+import { getSessionToken, saveSessionToken, clearSessionToken } from '../db';
 
 export const authCommand = new Command('auth')
-  .description('登录 / 授权账户')
-  .option('--status', '查看当前登录状态')
-  .option('--logout', '登出并清除本地凭证')
+  .description('登录/登出 42plugin')
+  .option('--status', '查看登录状态')
+  .option('--logout', '登出')
   .action(async (options) => {
-    if (options.status) {
-      await showStatus();
-      return;
-    }
-
     if (options.logout) {
       await logout();
-      return;
+    } else if (options.status) {
+      await status();
+    } else {
+      await login();
     }
-
-    await login();
   });
 
-async function login() {
-  const spinner = ora('正在初始化登录...').start();
+async function login(): Promise<void> {
+  // 检查是否已登录
+  const existingToken = await getSessionToken();
+  if (existingToken) {
+    api.setSessionToken(existingToken);
+    try {
+      const session = await api.getSession();
+      console.log(chalk.yellow(`已登录为 ${session.user.name || session.user.email}`));
+      console.log(chalk.gray('如需切换账号，请先执行 42plugin auth --logout'));
+      return;
+    } catch {
+      // Token 无效，继续登录流程
+    }
+  }
+
+  const spinner = ora('正在请求设备授权码...').start();
 
   try {
-    // 1. Get authorization code
-    const { code, auth_url, expires_at } = await api.startAuth();
+    const deviceCode = await api.requestDeviceCode();
     spinner.stop();
 
     console.log();
-    console.log(chalk.cyan('正在打开浏览器进行授权...'));
+    console.log(chalk.cyan('请在浏览器中完成登录：'));
     console.log();
-    console.log('如果浏览器没有自动打开，请访问：');
-    console.log(chalk.underline(auth_url));
+    console.log(`  ${chalk.bold('验证码')}: ${chalk.yellow.bold(deviceCode.userCode)}`);
+    console.log(`  ${chalk.bold('链接')}: ${deviceCode.verificationUri}`);
     console.log();
 
-    // 2. Open browser
-    await open(auth_url);
+    // 尝试打开浏览器
+    if (deviceCode.verificationUriComplete) {
+      await open(deviceCode.verificationUriComplete).catch(() => {});
+    }
 
-    // 3. Poll for authorization completion
-    spinner.start('等待浏览器授权...');
+    // 轮询等待授权
+    const pollSpinner = ora('等待授权...').start();
+    const interval = (deviceCode.interval || 5) * 1000;
+    const expiresAt = Date.now() + deviceCode.expiresIn * 1000;
 
-    const pollInterval = 2000; // 2 seconds
-    const expiresTime = new Date(expires_at).getTime();
+    while (Date.now() < expiresAt) {
+      await new Promise((r) => setTimeout(r, interval));
 
-    while (Date.now() < expiresTime) {
-      const result = await api.pollAuth(code);
+      const tokenResponse = await api.pollDeviceToken(deviceCode.deviceCode);
 
-      if (result.status === 'completed') {
-        // 4. Save credentials
-        await saveSecrets({
-          access_token: result.access_token!,
-          refresh_token: result.refresh_token!,
-          created_at: new Date().toISOString(),
-        });
+      if (tokenResponse.accessToken && tokenResponse.user) {
+        pollSpinner.succeed('授权成功！');
 
-        // Update API client token
-        api.setToken(result.access_token!);
+        // 保存 token
+        await saveSessionToken(tokenResponse.accessToken);
+        api.setSessionToken(tokenResponse.accessToken);
 
-        spinner.succeed(chalk.green('登录成功！'));
         console.log();
-        console.log(`欢迎，${chalk.cyan(result.user!.display_name || result.user!.username)}！`);
+        console.log(chalk.green(`欢迎，${tokenResponse.user.name || tokenResponse.user.username || tokenResponse.user.email}！`));
         return;
       }
 
-      await sleep(pollInterval);
+      if (tokenResponse.error === 'expired_token') {
+        pollSpinner.fail('授权码已过期，请重新执行 42plugin auth');
+        process.exit(1);
+      }
+
+      if (tokenResponse.error === 'access_denied') {
+        pollSpinner.fail('授权被拒绝');
+        process.exit(1);
+      }
+
+      // authorization_pending 继续等待
     }
 
-    spinner.fail('授权超时，请重试');
+    pollSpinner.fail('授权超时，请重试');
+    process.exit(1);
   } catch (error) {
-    spinner.fail(`登录失败: ${(error as Error).message}`);
+    spinner.fail('登录失败');
+    console.error(chalk.red((error as Error).message));
     process.exit(1);
   }
 }
 
-async function showStatus() {
-  const secrets = await loadSecrets();
+async function logout(): Promise<void> {
+  await clearSessionToken();
+  api.setSessionToken(null);
+  console.log(chalk.green('已登出'));
+}
 
-  if (!secrets) {
+async function status(): Promise<void> {
+  const token = await getSessionToken();
+
+  if (!token) {
     console.log(chalk.yellow('未登录'));
-    console.log('使用 42plugin auth 登录');
+    console.log(chalk.gray('执行 42plugin auth 登录'));
     return;
   }
 
+  api.setSessionToken(token);
+
   try {
-    const user = await api.getMe();
+    const session = await api.getSession();
     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()}`);
-    }
+    console.log(`  用户: ${session.user.name || session.user.email}`);
   } catch {
-    console.log(chalk.yellow('Token 已过期，请重新登录'));
-    console.log('使用 42plugin auth 重新登录');
+    console.log(chalk.yellow('登录已过期'));
+    console.log(chalk.gray('请执行 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/check.ts

@@ -0,0 +1,118 @@
+/**
+ * check 命令 - 检查插件格式（发布前检查）
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { PluginValidator } from '../validators/plugin-validator';
+import type { ValidationResult } from '../types';
+
+export const checkCommand = new Command('check')
+  .description('检查插件格式（发布前检查）')
+  .argument('[path]', '插件路径（文件或目录）', '.')
+  .option('--json', 'JSON 格式输出')
+  .option('-q, --quiet', '仅显示错误')
+  .action(async (pluginPath: string, options: { json?: boolean; quiet?: boolean }) => {
+    const validator = new PluginValidator();
+
+    try {
+      const result = await validator.validateFull(pluginPath);
+
+      // JSON 输出
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(result.valid ? 0 : 1);
+      }
+
+      // 常规输出
+      displayResult(result, pluginPath, options.quiet);
+
+      process.exit(result.valid ? 0 : 1);
+    } catch (error) {
+      if (options.json) {
+        console.log(
+          JSON.stringify(
+            {
+              valid: false,
+              errors: [{ code: 'E000', message: (error as Error).message }],
+              warnings: [],
+            },
+            null,
+            2
+          )
+        );
+      } else {
+        console.error(chalk.red((error as Error).message));
+      }
+      process.exit(1);
+    }
+  });
+
+/**
+ * 显示检查结果
+ */
+function displayResult(result: ValidationResult, pluginPath: string, quiet?: boolean): void {
+  console.log();
+  console.log(chalk.bold(`📋 检查: ${pluginPath}`));
+  console.log();
+
+  // 元信息（非静默模式）
+  if (!quiet) {
+    const { metadata } = result;
+    console.log(`  名称: ${metadata.name || chalk.gray('(未指定)')}`);
+    console.log(`  类型: ${metadata.type}`);
+    console.log(`  路径: ${metadata.sourcePath}`);
+
+    if (metadata.description) {
+      const desc =
+        metadata.description.length > 60
+          ? metadata.description.slice(0, 60) + '...'
+          : metadata.description;
+      console.log(`  描述: ${desc}`);
+    }
+
+    if (metadata.tags && metadata.tags.length > 0) {
+      console.log(`  标签: ${metadata.tags.join(', ')}`);
+    }
+  }
+
+  // 错误
+  if (result.errors.length > 0) {
+    console.log();
+    console.log(chalk.red.bold(`❌ 错误 (${result.errors.length})：`));
+    for (const error of result.errors) {
+      console.log(chalk.red(`  [${error.code}] ${error.message}`));
+      if (error.suggestion) {
+        console.log(chalk.gray(`       💡 ${error.suggestion}`));
+      }
+    }
+  }
+
+  // 警告（非静默模式）
+  if (result.warnings.length > 0 && !quiet) {
+    console.log();
+    console.log(chalk.yellow.bold(`⚠️  警告 (${result.warnings.length})：`));
+    for (const warning of result.warnings) {
+      console.log(chalk.yellow(`  [${warning.code}] ${warning.message}`));
+      if (warning.suggestion) {
+        console.log(chalk.gray(`       💡 ${warning.suggestion}`));
+      }
+    }
+  }
+
+  // 总结
+  console.log();
+  if (result.valid) {
+    if (result.warnings.length > 0) {
+      console.log(chalk.green(`✅ 检查通过 (${result.warnings.length} 个警告)`));
+    } else {
+      console.log(chalk.green('✅ 检查通过'));
+    }
+    console.log();
+    console.log(chalk.gray('可以执行 42plugin publish 发布插件'));
+  } else {
+    console.log(chalk.red('❌ 检查失败'));
+    console.log();
+    console.log(chalk.gray('请修复上述错误后重试'));
+  }
+}

package/src/commands/completion.ts

@@ -0,0 +1,210 @@
+/**
+ * completion 命令 - 生成 shell 自动补全脚本
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export const completionCommand = new Command('completion')
+  .description('生成 shell 自动补全脚本')
+  .argument('<shell>', 'shell 类型 (bash, zsh, fish)')
+  .action((shell: string) => {
+    switch (shell.toLowerCase()) {
+      case 'bash':
+        console.log(generateBashCompletion());
+        break;
+      case 'zsh':
+        console.log(generateZshCompletion());
+        break;
+      case 'fish':
+        console.log(generateFishCompletion());
+        break;
+      default:
+        console.error(chalk.red(`不支持的 shell: ${shell}`));
+        console.log(chalk.gray('支持的 shell: bash, zsh, fish'));
+        process.exit(1);
+    }
+  });
+
+function generateBashCompletion(): string {
+  return `# 42plugin bash completion
+# 添加到 ~/.bashrc:
+#   eval "$(42plugin completion bash)"
+# 或:
+#   42plugin completion bash >> ~/.bashrc
+#
+# 注意: 动态补全插件名需要安装 jq (可选)
+# 未安装 jq 时仍可使用命令和选项补全
+
+_42plugin_completions() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  case "\${prev}" in
+    42plugin)
+      COMPREPLY=( $(compgen -W "auth search install list uninstall version completion" -- "\${cur}") )
+      return 0
+      ;;
+    install|uninstall)
+      # 动态补全插件名 (需要 jq)
+      if command -v jq &>/dev/null; then
+        if [[ "\${cur}" == */* ]]; then
+          local plugins=$(42plugin list --json 2>/dev/null | jq -r '.[].fullName' 2>/dev/null)
+          COMPREPLY=( $(compgen -W "\${plugins}" -- "\${cur}") )
+        else
+          local authors=$(42plugin list --json 2>/dev/null | jq -r '.[].fullName' 2>/dev/null | cut -d'/' -f1 | sort -u)
+          COMPREPLY=( $(compgen -W "\${authors}" -- "\${cur}") )
+        fi
+      fi
+      return 0
+      ;;
+    search)
+      # 类型补全
+      if [[ "\${cur}" == -* ]]; then
+        COMPREPLY=( $(compgen -W "-t --type -l --limit --json -i --interactive" -- "\${cur}") )
+      fi
+      return 0
+      ;;
+    -t|--type)
+      COMPREPLY=( $(compgen -W "skill agent command hook mcp" -- "\${cur}") )
+      return 0
+      ;;
+    auth)
+      COMPREPLY=( $(compgen -W "--status --logout" -- "\${cur}") )
+      return 0
+      ;;
+    list|ls)
+      if [[ "\${cur}" == -* ]]; then
+        COMPREPLY=( $(compgen -W "-t --type --json" -- "\${cur}") )
+      fi
+      return 0
+      ;;
+    completion)
+      COMPREPLY=( $(compgen -W "bash zsh fish" -- "\${cur}") )
+      return 0
+      ;;
+  esac
+}
+
+complete -F _42plugin_completions 42plugin
+`;
+}
+
+function generateZshCompletion(): string {
+  return `#compdef 42plugin
+# 42plugin zsh completion
+# 添加到 ~/.zshrc:
+#   eval "$(42plugin completion zsh)"
+# 或:
+#   42plugin completion zsh >> ~/.zshrc
+#
+# 注意: 动态补全插件名需要安装 jq (可选)
+
+_42plugin() {
+  local -a commands
+  commands=(
+    'auth:登录/登出/查看状态'
+    'search:搜索插件'
+    'install:安装插件或套包'
+    'list:查看已安装插件'
+    'uninstall:卸载插件'
+    'version:显示版本'
+    'completion:生成补全脚本'
+  )
+
+  _arguments -C \\
+    '1: :->command' \\
+    '*: :->args'
+
+  case $state in
+    command)
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[2] in
+        install|uninstall)
+          # 插件名补全 (需要 jq)
+          if (( $+commands[jq] )); then
+            local plugins
+            plugins=(\${(f)"$(42plugin list --json 2>/dev/null | jq -r '.[].fullName' 2>/dev/null)"})
+            _describe 'plugin' plugins
+          fi
+          ;;
+        search)
+          _arguments \\
+            '-t[筛选类型]:type:(skill agent command hook mcp)' \\
+            '--type[筛选类型]:type:(skill agent command hook mcp)' \\
+            '-l[结果数量]:limit:' \\
+            '--limit[结果数量]:limit:' \\
+            '--json[JSON 输出]' \\
+            '-i[交互式安装]' \\
+            '--interactive[交互式安装]'
+          ;;
+        auth)
+          _arguments \\
+            '--status[查看登录状态]' \\
+            '--logout[登出]'
+          ;;
+        list)
+          _arguments \\
+            '-t[筛选类型]:type:(skill agent command hook mcp)' \\
+            '--type[筛选类型]:type:(skill agent command hook mcp)' \\
+            '--json[JSON 输出]'
+          ;;
+        completion)
+          _describe 'shell' '(bash zsh fish)'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_42plugin
+`;
+}
+
+function generateFishCompletion(): string {
+  return `# 42plugin fish completion
+# 添加到 ~/.config/fish/config.fish:
+#   42plugin completion fish | source
+# 或:
+#   42plugin completion fish > ~/.config/fish/completions/42plugin.fish
+
+complete -c 42plugin -f
+
+# Commands
+complete -c 42plugin -n '__fish_use_subcommand' -a auth -d '登录/登出/查看状态'
+complete -c 42plugin -n '__fish_use_subcommand' -a search -d '搜索插件'
+complete -c 42plugin -n '__fish_use_subcommand' -a install -d '安装插件或套包'
+complete -c 42plugin -n '__fish_use_subcommand' -a list -d '查看已安装插件'
+complete -c 42plugin -n '__fish_use_subcommand' -a uninstall -d '卸载插件'
+complete -c 42plugin -n '__fish_use_subcommand' -a version -d '显示版本'
+complete -c 42plugin -n '__fish_use_subcommand' -a completion -d '生成补全脚本'
+
+# auth options
+complete -c 42plugin -n '__fish_seen_subcommand_from auth' -l status -d '查看登录状态'
+complete -c 42plugin -n '__fish_seen_subcommand_from auth' -l logout -d '登出'
+
+# search options
+complete -c 42plugin -n '__fish_seen_subcommand_from search' -s t -l type -d '筛选类型' -a 'skill agent command hook mcp'
+complete -c 42plugin -n '__fish_seen_subcommand_from search' -s l -l limit -d '结果数量'
+complete -c 42plugin -n '__fish_seen_subcommand_from search' -l json -d 'JSON 输出'
+complete -c 42plugin -n '__fish_seen_subcommand_from search' -s i -l interactive -d '交互式安装'
+
+# list options
+complete -c 42plugin -n '__fish_seen_subcommand_from list' -s t -l type -d '筛选类型' -a 'skill agent command hook mcp'
+complete -c 42plugin -n '__fish_seen_subcommand_from list' -l json -d 'JSON 输出'
+
+# install options
+complete -c 42plugin -n '__fish_seen_subcommand_from install' -s g -l global -d '安装到全局目录'
+complete -c 42plugin -n '__fish_seen_subcommand_from install' -s f -l force -d '强制重新下载'
+complete -c 42plugin -n '__fish_seen_subcommand_from install' -l no-cache -d '跳过缓存检查'
+complete -c 42plugin -n '__fish_seen_subcommand_from install' -l optional -d '安装套包时包含可选插件'
+
+# uninstall options
+complete -c 42plugin -n '__fish_seen_subcommand_from uninstall' -l purge -d '同时清除缓存'
+
+# completion argument
+complete -c 42plugin -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish' -d 'Shell 类型'
+`;
+}

package/src/commands/index.ts

@@ -0,0 +1,13 @@
+/**
+ * 命令导出
+ */
+
+export { authCommand } from './auth';
+export { installCommand } from './install';
+export { searchCommand } from './search';
+export { listCommand } from './list';
+export { uninstallCommand } from './uninstall';
+export { completionCommand } from './completion';
+export { setupCommand } from './setup';
+export { publishCommand } from './publish';
+export { checkCommand } from './check';

package/src/commands/install-helper.ts

@@ -0,0 +1,71 @@
+/**
+ * 安装辅助函数 - 用于从其他命令调用安装功能
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import { api, QuotaExceededError } from '../api';
+import {
+  getOrCreateProject,
+  addInstallation,
+  createLink,
+  resolveCachePath,
+} from '../db';
+import { parseTarget, getTypeIcon } from '../utils';
+import { TargetType } from '../types';
+
+/**
+ * 安装单个插件（简化接口，用于交互式安装）
+ * 注意：调用方应提前初始化 API token
+ */
+export async function installPlugin(fullName: string): Promise<void> {
+  const parsed = parseTarget(fullName);
+  const spinner = ora(`安装 ${fullName}...`).start();
+
+  try {
+    const pluginDownload = await api.getPluginDownload(parsed.author, parsed.name);
+    const downloadInfo = pluginDownload.download;
+
+    // 解析缓存
+    const { cachePath, fromCache } = await resolveCachePath(downloadInfo, false, true);
+
+    // 链接到项目
+    const projectPath = process.cwd();
+    const project = await getOrCreateProject(projectPath);
+    const linkPath = path.join(projectPath, downloadInfo.installPath);
+
+    await createLink(cachePath, linkPath);
+
+    await addInstallation({
+      projectId: project.id,
+      fullName: downloadInfo.fullName,
+      type: downloadInfo.type,
+      version: downloadInfo.version,
+      cachePath,
+      linkPath,
+      source: 'direct',
+    });
+
+    // 同步安装记录（静默）
+    if (api.isAuthenticated()) {
+      api.recordInstall(downloadInfo.fullName).catch(() => {});
+    }
+
+    spinner.succeed(
+      `${getTypeIcon(downloadInfo.type)} ${downloadInfo.fullName} v${downloadInfo.version}` +
+        (fromCache ? chalk.gray(' (from cache)') : '')
+    );
+    console.log(chalk.gray(`  → ${downloadInfo.installPath}`));
+  } catch (error) {
+    spinner.fail(`安装失败: ${fullName}`);
+    if (error instanceof QuotaExceededError) {
+      console.error(chalk.red(error.message));
+      if (error.isGuestQuota()) {
+        console.log(chalk.yellow('提示: 登录后可获得更高配额'));
+      }
+    } else {
+      console.error(chalk.red((error as Error).message));
+    }
+  }
+}