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 更优秀，以证明用户切换的合理性