DailyGerman

日常德语，一站就够了。

一款面向中文学习者的开源德语学习网站，从零基础出发，围绕真实生活场景覆盖 A1–B1 的课程、词汇和听说读写练习。

🌐 在线学习： https://hughyau.com/learn_german/

你可以学什么

• 34 个场景单元、64 节渐进课程
• 740 张课程词卡与间隔重复复习
• 语法手册、实用短语和生活任务
• A1–B1 听力材料与阅读练习
• 每日学习计划、进度记录和数据备份
• 浏览器德语朗读与可选 AI 陪练

开始使用

在线版本发布后，直接打开上方网站即可学习，无需注册。学习进度保存在当前浏览器中，也可以在设置页导出备份。

本地运行：

python server.py

然后打开 http://127.0.0.1:8420。

Docker 部署

在项目目录运行：

docker compose up -d --build

然后在局域网内打开 http://<主机局域网 IP>:8420。停止服务：

docker compose down

该部署没有认证，仅适合可信的局域网环境。

装到手机上

手机浏览器里选「添加到主屏幕」。打开过一次之后离线也能用（AI 陪练除外）。缓存在 sw.js，发新版时把 VERSION 加一。

隐私与 AI

• 学习进度、收藏、设置、API 端点和 Key 都保存在当前浏览器的本地存储中。
• 使用 AI 陪练时，对话会直接发送到用户自己配置的 API 端点，DailyGerman 不设中转服务器，也不会集中保存这些内容。
• 导出备份默认不包含 API Key。请勿在公共或不受信任的设备上保存个人 Key。
• 公开版需要 API 服务商允许浏览器跨域请求（CORS）；如果不支持，可改用兼容的代理端点。
• 公开站点用 Google Analytics 统计页面访问量，不涉及学习数据；localhost 不加载。

参与贡献

欢迎提交 Issue 或 Pull Request，帮助改进课程内容、练习设计、界面体验或程序功能。

提交前请运行：

npm run check

该命令会校验课程、词卡、听力、阅读等内容，并运行核心学习逻辑测试。

课程规划详见 CURRICULUM.md。