# 所有回答请使用中文

# 项目信息

- **项目名称**: 食谱翻译工具
- **类型**: Next.js 16 Web 应用
- **系统**: Windows / Linux / macOS
- **Shell**: PowerShell / Bash

# 技术栈

- Next.js 16 (App Router)
- TypeScript
- Tailwind CSS + shadcn/ui
- MySQL 8.0
- AI (OpenAI / GLM)

# 开发规范

## 代码规范

- 使用 TypeScript，严格类型检查
- 组件使用 "use client" 指令
- 样式优先使用 Tailwind CSS
- 配置文件存储在 `config.json`

## Git 提交规范

```
feat: 新功能
fix: 修复bug
docs: 文档更新
refactor: 重构
chore: 构建/工具
```

## 配置管理

- **config.json**: 应用配置（数据库、AI、导出设置）
- **环境变量**: 仅首次启动时初始化 config.json
- **API**: `/api/config` 用于前端读写配置

## 目录结构

```
app/
├── api/           # API 路由（后端逻辑）
├── settings/      # 设置页面
└── page.tsx      # 首页

lib/
├── config.ts     # 配置读写
├── database.ts   # MySQL 连接
└── ai-translate.ts  # AI 翻译

config/           # 配置文件
data/            # 上传文件
```

## 关键约束

1. **配置分离**: 数据库配置、AI配置、导出设置分离存储
2. **API 优先**: 导出时先调用 API 获取最新配置
3. **防抖**: 搜索等高频操作需添加防抖
4. **Docker**: 应用容器化，数据库使用外部服务

<!-- BEGIN:nextjs-agent-rules -->
# Next.js 16 注意事项

本项目使用 Next.js 16，部分 API 可能有破坏性变更。编写代码前查阅 `node_modules/next/dist/docs/` 中的文档。
<!-- END:nextjs-agent-rules -->