synthia-ai

Synthia Engine AI - 集成 LLM 的智能构建优化建议与代码分析。

功能特性

• 🤖 AI 驱动优化: 集成 OpenAI（默认模型 gpt-4）进行智能分析
• 📊 代码分析: 支持按项目上下文进行代码质量与依赖分析
• 💡 智能建议: 基于分析结果生成结构化优化建议
• 🔧 自动应用: 支持将建议批量应用到项目
• 🧮 默认配置: 提供 DEFAULT_AI_OPTIMIZER_CONFIG 便于开箱即用

安装

npm install synthia-ai

快速上手

import {
  createAIOptimizer,
  DEFAULT_AI_OPTIMIZER_CONFIG,
  type OptimizationContext,
} from 'synthia-ai';

const optimizer = createAIOptimizer({
  ...DEFAULT_AI_OPTIMIZER_CONFIG,
  openai: {
    ...DEFAULT_AI_OPTIMIZER_CONFIG.openai,
    apiKey: process.env.OPENAI_API_KEY || '',
  },
  analysis: {
    ...DEFAULT_AI_OPTIMIZER_CONFIG.analysis,
    depth: 'medium',
  },
  optimization: {
    ...DEFAULT_AI_OPTIMIZER_CONFIG.optimization,
    autoApply: false,
  },
  cache: {
    ...DEFAULT_AI_OPTIMIZER_CONFIG.cache,
    enabled: true,
  },
});

const context: OptimizationContext = {
  projectType: 'react',
  buildTool: 'vite',
  packageManager: 'npm',
  target: 'browser',
  performance: { bundleSize: 0, buildTime: 0, runtimePerformance: 0 },
  constraints: {
    browserSupport: ['defaults'],
    nodeVersion: '>=18',
    memoryLimit: 4096,
    timeLimit: 60000,
  },
};

// 1) 分析项目并得到初步建议集合
const analysis = await optimizer.analyzeProject('./src', context);

// 2) 基于分析生成（或再次生成）优化建议
const suggestions = await optimizer.generateSuggestions(analysis, context);

// 3) 应用优化建议到项目
const results = await optimizer.applyOptimizations(suggestions, './src');

导出

• AIOptimizer 类
• createAIOptimizer(config) 工厂函数
• DEFAULT_AI_OPTIMIZER_CONFIG 默认配置对象
• 类型：AIOptimizerConfig、ProjectAnalysisResult、OptimizationSuggestion、OptimizationResult、OptimizationContext 等

配置选项

OpenAI 配置

• apiKey: OpenAI API 密钥
• baseURL: 自定义 OpenAI 兼容服务地址（可选）
• model: 使用的模型 (默认: gpt-4)
• maxTokens: 最大 token 数
• temperature: 温度参数

分析配置

• enableCodeAnalysis: 启用代码分析
• enableDependencyAnalysis: 启用依赖分析
• enablePerformanceAnalysis: 启用性能分析
• depth: 分析深度 (shallow|medium|deep)

优化配置

• autoApply: 自动应用优化
• level: 优化级别 (conservative|moderate|aggressive)
• createBackup: 创建备份
• maxSuggestions: 最大建议数

缓存配置

• enabled: 是否启用缓存
• directory: 缓存目录（默认 .synthia-ai-cache）
• ttl: 缓存过期时间（毫秒，默认 24 小时）

环境变量

• OPENAI_API_KEY: OpenAI API 密钥

许可证

MIT