专为德语学习者与歌德（A1–C1）/ 德福（TestDaF）/ DSH 备考打造的下一代学术级伴读与句法剖析系统。
融合歌德 A1 全真听说读写考场工坊、德语伴读宠物（Eule & 伙伴）、Atelier 落地页画册台账、拓扑五场域、AST 从句语法树、内联 IDE 写作工坊与FSRS 现代认知记忆排程。
✅ v5.9.2 A1 取数统一（ADR-0014）+ 词表富字段回填修复（2026-09-17）：A1 首装改走服务端 API（API 优先 + 内联降级为
file://离线 fallback + 本地缓存），输出契约 11→12 字段（+letter）；A2/B1 词库同步由 append-only 升级为「只增 + 只补空字段」，根治「只有部分词有例句」（进 A2/B1 档即自愈）；A1 早退闸修复——已以server落盘的设备每次启动重新合并 A1 富字段，修「anbieten/allein 等存量 A1 条目无例句无音标」。测试基线 987 passed + 1 skipped；Android 需覆盖安装生效（改动含 static）。 ✅ v5.9.1 词库等级标签补齐 + 入口文档瘦身（2026-09-16）：工作台词库补 A1 等级标签a1（此前只有core，词库「全部标签」筛不出 A1）；修reader谓词的custom兜底（22 条补缺词误入精读生词档）；README 瘦身 433→131 行，版本历史迁出为CHANGELOG.md。测试基线 973 passed + 1 skipped；Android 需覆盖安装生效（改动含 static）。 ✅ v5.9.0 词库富字段与主干分层正式发布（2026-09-16）：ADR-0012 词汇主干 lexicon 落地 + 官方歌德 A1/A2/B1 词表迁入；ADR-0013 输出契约 9→11 字段（新增ipa与中文例句），A2/B1 卡片首次具备音标与双语例句；A1 卡片补齐名词性别/复数（97.67%）。测试基线 972 passed + 1 skipped。📱 Android 用户注意：改动含
static/的版本（如 v5.8.0 / v5.9.0）需覆盖安装才生效。 📜 完整版本历史见 CHANGELOG.md。
| 平台 | 版本 | 说明 | 下载通道 |
|---|---|---|---|
| 🪟 Windows x64 | v5.9.2 |
免安装 Python / 零环境依赖，解压双击 DeLector.exe 即可秒开 |
下载 ZIP 包 (GitHub Releases) |
| 🍎 macOS | v5.9.2 |
解压运行 start 脚本，全自动启动服务与默认浏览器 |
下载 TAR.GZ 包 (GitHub Releases) |
| 🐧 Linux x64 | v5.9.2 |
全发行版通用，解压运行 start 即可使用 |
下载 TAR.GZ 包 (GitHub Releases) |
| 📱 Android | v5.9.2 |
内嵌 Python 运行时与 spaCy 离线模型，单机独立运行；支持 arm64-v8a，CI 钉死签名 keystore 并验签（可覆盖升级）。（CI 自动构建 APK；v4.9.0 新增背词台核心词模式（235 词 / 704 词一键切换）与导入按归一词头去重，老设备幂等回填、FSRS 进度零丢失。） | 下载 APK 安装包 (GitHub Releases) |
| 需要什么 | 去哪 |
|---|---|
| 项目状态 / 红线 / 待办 | WORKMEMORY/PROJECT_OVERVIEW.md |
| AI Agent 入口（纯路由） | AGENTS.md |
| 产品特性全览 | FEATURES.md |
| 架构细节（技术栈 / NLP / DB / API / 前端拓扑） | docs/agents/architecture.md |
| 安全守卫 / 本机环境 / 打包 / 工作惯例 | docs/agents/ops.md |
| 设计与实施计划 | docs/specs/、docs/plans/ |
| 版本历史 | CHANGELOG.md |
| 架构决策记录（ADR） | Obsidian Vault 08-Projects/DeLector/01-ADR/ |
- 德语精读工作台：CEFR 词阶热力图 + 0ms 歌德离线词库 + 荧光便签、AI 导读与打印级《精读指南》导出。
- 句法拓扑与 AST：经典五场域（VF/LK/MF/RK/NF）色谱条切分 + 5 大从句抽象语法树 + 一键制 Anki 语法卡。
- FSRS 卡盒与背词工作台：3D 拟真翻牌 + FSRS 现代自适应排程（消解 Ease Hell）；A1/A2/B1 多档背词台（
VOKABELN）与介词矩阵视图。 - 备考域 A1–B1：歌德全真听说读写考场工坊（写作 / 听力 / 阅读 / 口语 / 词表）+ 德福 C-Test + 听力微训 / 长难句精读工坊。
- 遇见区分级阅读：i+1 阅读桥 + 逐词注解 + 生词一键进卡，配套桌面→手机局域网 P2P 静默同步。
- 内联 IDE 写作工坊 & 伴读宠物：行内实时语法诊断 + VSCode 级 Inlay Hints；Eule & 伙伴混合双模伴读。
完整功能清单见 FEATURES.md。
| 领域 | 核心技术 | 说明 |
|---|---|---|
| 后端框架 | FastAPI + Uvicorn |
异步高性能 REST API |
| 自然语言处理 | spaCy (de_core_news_md / sm) |
本地高精德语分词、词性标注、形态分析与五场域句法依存 |
| 形态学引擎 | delector/nlp_engine/linguistics.py |
556+ 不规则动词三态表 + 复合词动态规划递归拆解 |
| 拓扑句法树 | delector/nlp_engine/syntax_tree.py |
Vorfeld/LK/MF/RK/NF 五场域切分 + 5 大从句 AST 抽象语法树 |
| 持久化存储 | SQLite 3 (delector.db + progress.db) |
核心文库与时序台账双库解耦存储 |
| 语音合成 | Edge-TTS (Microsoft Neural Voice) |
神经级纯正德语离线本地缓存与 Web Speech 回退 |
| 前端架构 | ES Modules / Modern CSS / Vanilla JS |
零 Node 构建依赖、模块化架构、原生 3D CSS 渲染 |
| 记忆同步 | genanki |
离线生成标准 .apkg 记忆库 |
| 自动化测试 | pytest + httpx |
全套单元与集成测试用例（数量见顶部 Tests 徽章，100% Green），CI 覆盖 md 加载路径与 Android 构建验签 |
pip install -r requirements.txt # 安装 Python 依赖
python -m spacy download de_core_news_md # 下载德语 NLP 模型
python start.py # 或 Windows 双击 start.bat —— 一键启动并打开浏览器
docker compose up -d --build # 或 Docker 容器化一键部署开发者首次启用提交前密钥扫描（每个克隆都要做一次）：
git config core.hooksPath .githooks📖 Windows 分支 / Docker 细节 / 环境变量 / 打包 / 安全守卫等完整说明见 docs/agents/ops.md。
DeLector/
├── delector/ # 后端包：server.py(app 工厂) + core/(DB·安全) + nlp_engine/(spaCy·拓扑·AST) + routes/ + services/ + data/
├── static/ # 前端零构建 ES 模块（index.html + js/ 11 模块 + german/ 背词台 + css/ tokens）
├── android/ # Android 独立离线单机版工程 (Chaquopy + Gradle)
├── agent/ # Phase 2 Go Agent Runtime（CLI + DAG + 工具注册，预览通道）
├── tests/ # 60+ 测试模块 + 迁移哨兵（pytest）
├── docs/ # 文档：agents/(架构·运维) · specs/(设计) · plans/(实施计划)
├── start.py # 跨平台智能启动脚本（Android 回环 / 桌面 0.0.0.0）
├── package_windows.py # Windows 绿色免安装便携版打包脚本
├── Dockerfile # 容器化构建
├── docker-compose.yml # Compose 编排
└── requirements.txt # Python 依赖清单
📖 逐目录 / 逐模块详情（含 js 模块清单、后端子包分层）见 docs/agents/architecture.md。
- v5.9.2（2026-09-17）：A1 取数统一（ADR-0014：首装 API 化 + 内联降级为离线 fallback + 契约 11→12 字段
+letter）+ A2/B1 富字段回填（修「只有部分词有例句」）+ A1 早退闸修复（已 server 落盘设备每启动重新合并富字段，修存量 A1 裸条目无例句无音标）。测试 987 passed + 1 skipped。 - v5.9.1（2026-09-16）：词库等级标签补齐（A1 补
a1、修reader谓词 custom 兜底）+ 入口文档瘦身（README 433→131 行，版本历史迁出为CHANGELOG.md）。测试 973 passed + 1 skipped。 - v5.9.0（2026-09-16）：词库富字段与主干分层——ADR-0012 词汇主干 lexicon + 官方歌德 A1/A2/B1 词表迁入；ADR-0013 输出契约 9→11 字段（新增音标
ipa与中文例句），A2/B1 卡片首次具备音标与双语例句；A1 卡片补齐名词性别/复数（97.67%）。测试 972 passed + 1 skipped。
📜 完整版本历史（含全部 70+ 版本）见 CHANGELOG.md。
本项目采用 MIT License 开源许可证。欢迎提 PR 或 Issue 参与共建！