ilaandClaude Opus 4.8
b9bcbf7e6b
新增（Codex 起草，本次纳入并校对）： - AGENTS.md：仓库级 AI 强约束入口 - docs/00-ai-start-here.md：AI 开发入口与导航 - docs/api.md：账号/生词本/进度 API 合约草案 - docs/routes.md：go-app 页面路由与组件归属 - docs/current-state.md：当前实现状态 补充与对齐： - 验证命令补 bash（WSL/Linux 为主，PowerShell 为备）：00-ai-start-here、AGENTS - 04-architecture：新增第六节"项目结构（包布局）"+ 3.2 建表 SQL 草案 - docs/README 导航补 06-tasks；CLAUDE 目录树补 AGENTS/scripts/design_mockups - 00-ai-start-here 去除已过时的"需要补齐"段 - 06-tasks：Phase 2/3/4/5 交叉引用 api.md / routes.md / 包布局 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
走遍美国 · 英语学习 PWA
一个用 Go (go-app + WebAssembly) 构建的渐进式 Web 应用 (PWA)，基于「走遍美国 (Family Album, U.S.A.)」素材，帮助用户通过音频 + 同步字幕进行沉浸式英语听力学习。
本主页汇总项目的核心文档，按"为什么 → 要什么 → 用什么 → 怎么搭 → 怎么写"分层。
📌 一句话定位
大屏手机 / 平板优先，可安装、可离线，账号化的「走遍美国」音频精听学习工具。
🗂 文档导航
- AI 开发入口 — AI coding agent 的阅读顺序、任务领取规则、验证命令
- 项目愿景 — 为什么 / 为谁 / 产品原则 / 不做什么
- 需求 — 要什么 + 验收标准（产品语言，无技术词）
- 技术栈 — 用什么：框架 / 数据库 / UI / 状态管理 / 部署（速查）
- 架构设计 — 怎么搭：系统结构、职责划分、数据模型、技术难点
- API 合约草案 — 账号、生词本、进度 API 的目标形状
- 路由与页面结构 — go-app 页面路由、页面职责、组件归属
- 当前实现状态 — 仓库现实状态、当前可做任务、维护规则
- 编码规则 — 怎么写：AI 写代码前必读的硬约束
- 任务看板 — 做哪一步：MVP 任务拆解、依赖、状态（AI 的 Jira）
⚡ 当前阶段
第一版 (MVP) 最小闭环：课程列表 + 音频播放 + 字幕同步 + 生词本 + 账号同步。后续迭代加入测验与打卡。
🛠 技术栈速览
- 前端：go-app (Go → WebAssembly)，PWA 可安装 / 离线
- 后端：Go
net/http+ SQLite - 素材：26 集英文文稿 + 逐句时间戳（音频覆盖 ep1–17，ep18–26 待补）
🤖 AI coding 入口
仓库级 AI 规则见根目录 ../AGENTS.md；更详细的项目开发导航见 AI 开发入口。