72 lines
1.6 KiB
Markdown
72 lines
1.6 KiB
Markdown
# 所有回答请使用中文
|
|
|
|
# 项目信息
|
|
|
|
- **项目名称**: 食谱翻译工具
|
|
- **类型**: 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 -->
|