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

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));
+    }
+  }
+}