Cursor/plugins：解锁 AI 编程新维度的官方插件生态 🛠️

// 插件接口的核心定义
interface CursorPlugin {
  name: string;
  version: string;
  
  // 在代码生成前触发，用于注入上下文
  beforeGenerate(context: GenerationContext): Promise<void>;
  
  // 在代码生成后触发，用于格式化或增强
  afterGenerate(result: GenerationResult): Promise<GenerationResult>;
  
  // 提供额外的代码片段库
  snippets?: SnippetProvider;
}

// 自动检测项目中的框架
class FrameworkDetectorPlugin implements CursorPlugin {
  async beforeGenerate(context: GenerationContext) {
    const files = await context.readProjectFiles();
    
    if (files.some(f => f.path.endsWith('pom.xml'))) {
      context.setMetadata('framework', 'spring-boot');
      context.addSnippetContext('spring-boot-annotations');
    }
    
    if (files.some(f => f.path.endsWith('package.json'))) {
      const pkg = JSON.parse(files.find(f => f.path.endsWith('package.json'))!.content);
      if (pkg.dependencies?.react) {
        context.setMetadata('framework', 'react');
        context.addSnippetContext('react-hooks');
      }
    }
  }
}

class DatabasePlugin implements CursorPlugin {
  snippets: SnippetProvider = {
    async getSnippets(context: SnippetContext) {
      // 根据数据库类型动态生成连接配置
      if (context.metadata.framework === 'spring-boot') {
        return {
          'datasource-config': {
            prefix: 'datasource',
            body: [
              spring.datasource.url=jdbc:${context.metadata.dbType}://localhost:3306/${context.metadata.projectName},
              'spring.datasource.username=${1:root}',
              'spring.datasource.password=${2:password}',
              'spring.datasource.driver-class-name=${3:com.mysql.cj.jdbc.Driver}'
            ],
            description: 'Generate datasource configuration'
          }
        };
      }
    }
  }
}

class PrettierPlugin implements CursorPlugin {
  async afterGenerate(result: GenerationResult): Promise<GenerationResult> {
    // 使用 Prettier 格式化生成的代码
    const formattedCode = await prettier.format(result.code, {
      parser: result.language === 'typescript' ? 'typescript' : 'babel',
      singleQuote: true,
      trailingComma: 'all'
    });
    
    return {
      ...result,
      code: formattedCode,
      // 记录格式化的变更
      metadata: {
        ...result.metadata,
        formatted: true,
        originalLength: result.code.length,
        formattedLength: formattedCode.length
      }
    };
  }
}

// AI 生成的原始代码
@RestController
public class UserController {
    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        // 业务逻辑...
    }
}

// 经过 api-doc-generator 插件处理后的代码
@RestController
@Tag(name = "用户管理", description = "用户相关接口")
public class UserController {
    @GetMapping("/users/{id}")
    @Operation(summary = "根据ID获取用户信息")
    @ApiResponse(responseCode = "200", description = "成功返回用户信息")
    @ApiResponse(responseCode = "404", description = "用户不存在")
    public User getUser(@PathVariable Long id) {
        // 业务逻辑...
    }
}

// my-team-plugin.ts
import { CursorPlugin, GenerationContext, GenerationResult } from '@cursor/plugin-sdk';

export class MyTeamFrameworkPlugin implements CursorPlugin {
  name = 'my-team-framework';
  version = '1.0.0';
  
  async beforeGenerate(context: GenerationContext) {
    // 注入团队自定义的注解
    context.addSnippetContext('team-annotations');
    
    // 设置代码生成模板
    context.setMetadata('codeTemplate', {
      controller: 'team-controller-template',
      service: 'team-service-template',
      repository: 'team-repository-template'
    });
  }
  
  async afterGenerate(result: GenerationResult): Promise<GenerationResult> {
    // 添加团队统一的版权声明
    return {
      ...result,
      code: // Copyright (c) 2026 My Team. All rights reserved.\n// This code is generated with Cursor AI\n\n${result.code}
    };
  }
}