synthia-ai-system/README.md

Synthia Engine AI - 集成LLM的智能构建优化建议

# synthia-ai

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

## 功能特性

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

## 安装

```bash
npm install synthia-ai
```

## 快速上手

```ts
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