SoundScape AI - 项目规则与开发指南

# SoundScape AI - 项目规则与开发指南

## 🌍 核心原则：海外市场定位
这是一个面向海外市场的环境音效网站，目标是与 A Soft Murmur 竞争。

## 📝 语言与内容规则

### 🌍 用户界面内容（纯英文）
- **所有用户可见的文字必须使用地道英文**
- **UI组件、标签、用户消息中严禁出现中文**
- **使用专业、自然的英文文案**
- **目标受众：英语母语用户（美国、英国、加拿大、澳大利亚市场）**

### 🔧 开发沟通（中文可以）
- **代码注释可以使用中文，便于内部团队沟通**
- **开发者之间的对话可以用中文**
- **错误日志和调试信息可以用中文**
- **开发者文档可以双语或中文**

### 📋 明确区分
- **前端/UI = 英文**（用户看到的）
- **后端/代码 = 中文可以**（开发者看到的）

## 🎯 目标受众
- **主要用户：** 寻求专注/放松音效的英语用户
- **人群特征：** 远程工作者、学生、冥想练习者
- **竞争对手：** A Soft Murmur、MyNoise.net、Noisli

## 🛠️ 技术栈
- **前端：** Next.js 14 + TypeScript + Tailwind CSS
- **音频：** Howler.js 音频管理
- **图标：** Lucide React
- **部署：** 静态导出，便于托管

## 🎨 设计原则
- **现代、简洁的UI，超越 A Soft Murmur**
- **基于渐变的色彩方案**
- **响应式设计（移动端优先）**
- **专业外观，吸引付费用户**

## 🚀 开发优先级
1. **第一阶段：** 完成前端，配备智能关键词匹配
2. **第二阶段：** 真实AI集成（OpenAI/Claude API）
3. **第三阶段：** 高级功能（分享、预设、分析）

## 📁 音频资源
- **格式：** `/public/sounds/` 目录下的 MP3/mp4/wav 文件
- **命名：** kebab-case 格式（rain.mp3, white-noise.mp3）
- **质量：** 高质量、可循环的环境音效

## 🎵 音效分类
1. **自然音效：** 雨声、雷声、风声、鸟鸣、蟋蟀、海浪
2. **城市音效：** 咖啡厅、键盘敲击、白噪音
3. **火焰音效：** 壁炉噼啪声

## 💰 盈利策略
- **免费增值模式：** 基础音效免费，高级功能付费
- **目标关键词：** "white noise generator"、"ambient sounds"、"focus sounds"
- **SEO优化：** 针对海外流量获取进行优化

## 🔧 代码标准
- **TypeScript严格模式：** false（便于快速开发）
- **组件结构：** 使用 hooks 的函数式组件
- **状态管理：** React hooks + localStorage 持久化
- **错误处理：** 音频加载的优雅降级
- **注释：** 中文可以，便于团队理解
- **控制台日志：** 中文可以，便于调试

## 📊 成功指标
- **流量目标：** 获取 A Soft Murmur 月访问量 31.5万 的显著份额
- **用户参与度：** 会话时长、回访率
- **转化率：** 免费到付费的升级率

---
**牢记：每个功能都应该比 A Soft Murmur 更优秀，以证明用户切换的合理性**