Vibesafe4j：使用 AI 自动生成 Java 接口实现的革命性框架

vibesafe4j/
├── src/main/java/vibesafe4j/
│   ├── Func.java                    # @Func 注解定义
│   ├── Vibesafe4j.java              # 核心工厂类和代码生成逻辑
│   ├── InProcessJavaCompiler.java   # 内存中 Java 编译器
│   └── spring/
│       ├── Vibesafe4jAutoConfiguration.java  # Spring Boot 自动配置
│       └── AiClient.java             # AI 客户端接口
└── src/test/java/test/
    ├── Greeting.java                 # 示例接口
    └── Vibesafe4jTest.java          # 测试用例

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Func {
    String value() default "";
}

package test;

import vibesafe4j.Func;

interface Greeting {
    
    @Func("""
        return a greeting String
        
        >>> greet("Alice")
        'Hello, Alice!'
        
        >>> greet("Chandra")
        'Hello, Chandra!'
        """)
    String greet(String name);
}

import org.springframework.ai.chat.client.ChatClient;
import vibesafe4j.Vibesafe4j;

@Test
void build(@Autowired ChatClient ai) throws Exception {
    // 使用 Spring AI 的 ChatClient 作为 AI 回调
    var greetingsInstance = Vibesafe4j.build(
        prompt -> ai.prompt(prompt).call().content(), 
        Greeting.class
    );
    
    // 调用生成的方法
    var strResult = greetingsInstance.greet("world").toLowerCase();
    
    // 验证结果
    Assertions.assertTrue(strResult.contains("hello"));
    Assertions.assertTrue(strResult.contains("world"));
    System.out.println(strResult);
}

@SpringBootTest(classes = App.class)
class Vibesafe4jTest {
    
    @Test
    void auto(@Autowired Greeting greeting) {
        // 直接注入，框架已自动生成实现
        var response = greeting.greet("vibesafe4j");
        System.out.println("response: " + response);
    }
}

@Test
void atoms(@Autowired ChatClient ai) throws Exception {
    // 生成源代码（不编译）
    var result = Vibesafe4j.sourceFor(
        prompt -> ai.prompt(prompt).call().content(), 
        Greeting.class
    );
    
    // 查看生成的代码
    System.out.println(result.code());
    // 输出类似：
    // package test;
    // public class GreetingImpl implements Greeting {
    //     public String greet(String name) {
    //         return "Hello, " + name + "!";
    //     }
    // }
    
    // 编译并加载类
    var clzz = Vibesafe4j.classFor(result);
    
    // 创建实例并调用
    var instance = clzz.getDeclaredConstructors()[0].newInstance();
    var greetings = clzz.getMethod("greet", String.class)
                         .invoke(instance, "world");
    
    Assertions.assertEquals("Hello, world!", greetings);
}

interface MathOperations {
    
    @Func("""
        Calculate the factorial of a number.
        Factorial of n (n!) is the product of all positive integers <= n.
        
        >>> factorial(5)
        120
        
        >>> factorial(0)
        1
        
        >>> factorial(1)
        1
        """)
    long factorial(int n);
    
    @Func("""
        Check if a number is prime.
        A prime number is greater than 1 and has no divisors other than 1 and itself.
        
        >>> isPrime(7)
        true
        
        >>> isPrime(10)
        false
        
        >>> isPrime(2)
        true
        """)
    boolean isPrime(int number);
    
    @Func("""
        Calculate the greatest common divisor (GCD) of two numbers.
        Use Euclidean algorithm.
        
        >>> gcd(48, 18)
        6
        
        >>> gcd(17, 13)
        1
        """)
    int gcd(int a, int b);
}

@Configuration
@AutoConfigureAfter(OpenAiChatAutoConfiguration.class)
class Vibesafe4jAutoConfiguration {
    
    @Bean
    static FuncBeanRegistrar funcBeanRegistrar() {
        return new FuncBeanRegistrar();
    }
    
    @Bean
    @ConditionalOnClass(ChatClient.class)
    @ConditionalOnBean(ChatClient.class)
    @ConditionalOnMissingBean(AiClient.class)
    AiClient defaultSpringAiAiClient(ChatClient.Builder builder) {
        var ai = builder.build();
        return prompt -> ai.prompt(prompt).call().content();
    }
}

<properties>
    <java.version>25</java.version>
    <spring-ai.version>1.0.3</spring-ai.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-model-openai</artifactId>
    </dependency>
</dependencies>

# OpenAI 配置
spring.ai.openai.api-key=your-api-key-here
spring.ai.openai.chat.options.model=gpt-4
spring.ai.openai.chat.options.temperature=0.7

# Azure OpenAI
spring.ai.azure.openai.api-key=your-key
spring.ai.azure.openai.endpoint=https://your-resource.openai.azure.com/

# Anthropic Claude
spring.ai.anthropic.api-key=your-key
spring.ai.anthropic.chat.options.model=claude-3-sonnet-20240229

@Func("""
    Convert temperature from Celsius to Fahrenheit.
    Formula: F = (C * 9/5) + 32
    
    >>> celsiusToFahrenheit(0)
    32.0
    
    >>> celsiusToFahrenheit(100)
    212.0
    
    >>> celsiusToFahrenheit(-40)
    -40.0
    """)
double celsiusToFahrenheit(double celsius);

@Func("convert temperature")  // 太模糊，缺少示例
double celsiusToFahrenheit(double celsius);

@Func("""
    Parse a date string in format "YYYY-MM-DD" to LocalDate.
    Throw IllegalArgumentException if format is invalid.
    
    >>> parseDate("2024-01-15")
    LocalDate.of(2024, 1, 15)
    
    >>> parseDate("2024-12-31")
    LocalDate.of(2024, 12, 31)
    
    >>> parseDate("invalid")
    throws IllegalArgumentException
    """)
LocalDate parseDate(String dateStr);

@Func("""
    Create a User object with given name and age.
    User should have: name (String), age (int), createdAt (LocalDateTime).
    Set createdAt to current time.
    
    >>> createUser("Alice", 30)
    User{name="Alice", age=30, createdAt=...}
    """)
User createUser(String name, int age);

@Func("""
    Divide two numbers. 
    Throw ArithmeticException if divisor is zero.
    
    >>> divide(10, 2)
    5.0
    
    >>> divide(10, 0)
    throws ArithmeticException
    """)
double divide(double dividend, double divisor);