DeLector · 德语欧标沉浸精读与考点剖析工作台

专为德语学习者与歌德（A1–C1）/ 德福（TestDaF）/ DSH 备考打造的下一代学术级伴读与句法剖析系统。
融合歌德 A1 全真听说读写考场工坊、德语伴读宠物（Eule & 伙伴）、Atelier 落地页画册台账、拓扑五场域、AST 从句语法树、内联 IDE 写作工坊与FSRS 现代认知记忆排程。

📦 多平台下载发布包 (Downloads)

平台	版本	说明	下载通道
🪟 Windows x64	`v4.8.0` 绿色便携版	免安装 Python / 零环境依赖，解压双击 `DeLector.exe` 即可秒开	下载 ZIP 包 (GitHub Releases)
🍎 macOS	`v4.8.0` 免安装包	解压运行 `start` 脚本，全自动启动服务与默认浏览器	下载 TAR.GZ 包 (GitHub Releases)
🐧 Linux x64	`v4.8.0` 便携版	全发行版通用，解压运行 `start` 即可使用	下载 TAR.GZ 包 (GitHub Releases)
📱 Android	`v4.8.0` 独立单机版	内嵌 Python 运行时与 spaCy 离线模型，单机独立运行；支持 arm64-v8a，CI 钉死签名 keystore 并验签（可覆盖升级）	下载 APK 安装包 (GitHub Releases)

🌟 核心特性 (Features)

🦉 1. 德语伴读宠物（Companion Mascot）「Eule & 伙伴」混合双模系统

4 大内置矢量角色 + 自定义 SVG 上传：猫头鹰 Eule、学者猫 Katze、灵动狐 Fuchs、包豪斯机甲 Roboter，支持上传任意 $\le 64\text{KB}$ 自定义 SVG 矢量角色（内置严格 DOMParser XML 白名单消毒防 XSS）。
3 层离线/在线 TTS 发声：原生离线发声桥接 + Edge Neural TTS 纯正德语母语发音，8s 防噪音冷却。
研读工坊与全局悬浮双挂载：在台账首屏 Hero 嵌入研习大工坊，全局各处提供右下角轻量伴读气泡，在生词制卡、语法提炼、FSRS 间隔复习、完形填空 $\ge 80%$ 与连续打卡时触发实时德语鼓励。

📊 2. Atelier 呼吸感落地页台账 (Continuous Exhibition Folio)

0.85:1.15 不对称 Hero 大展台：融合德式名言箴言卡、6 核心 Ring Badges 环形指标大展盘与四角 + 定位标点。
双行反向 Wire Marquee 动态走字带：硬件加速匀速滚动名家引文与实时战报脉冲，两端带纸面渐变羽化遮罩，悬停平滑暂停。
并排双面板紧凑罗盘：A1–C1 掌握度阶梯矩阵、30 天墨线留存折线图、重点易错词汇攻坚账本与学术火漆印章展台。

🌳 3. 德语拓扑五场域与 AST 从句树句法引擎 (Topological Felder-Modell & Syntax Tree)

经典拓扑五场域色谱条：精准切分 前场 (VF)、左框 (LK)、中场 (MF)、右框 (RK) 与 后场 (NF)，点击句末 🌳 句法 即可就地平滑展开。
5 大核心从句抽象语法树 (AST)：自动识别并分类 状语从句（原因/让步/条件/时间/目的/结果）、关系从句（关系代词/介词+关系词）、带 zu 不定式（um/ohne/anstatt...zu）、被动与虚拟式框形及 主句核心干。
双向联动与一键制卡：抽屉内点击从句节点即可触发正文脉冲光圈聚焦高亮，支持一键将从句规则公式保存至 Anki 语法卡。

⚡ 4. 深度德语形态学与词法引擎 (Morphology & Lexicon)

556+ 强变化动词三态表：无论是动词变位词干（ging）还是过去分词（genommen），$O(1)$ 秒级反查原形、过去时、分词与助动词（haben/ist）。
复合词递归智能拆解：自动拆解长复合名词并精准剥离 -s-, -es-, -en-, -n-, -er-, -e- 等连接词素。
框形可分动词双向高亮：将跨句变位动词与句末前缀（如 steigt ... ein）双向绑定并同步微光高亮。
固定介词搭配（Präpositionen）：动词/形容词 + 固定介词 + 支配的格，552 词条 / 691 条搭配（DeepSeek 批量生成 + 人工 seed 兜底），查词抽屉第四张卡片逐条展示并可直接存成词汇卡（bestehen auf 坚持 / aus 由…组成 / in 在于）。
Präpositionen-Matrix 介词矩阵视图 (v4.5.0)：把同一份数据集倒过来按介词分组浏览（21 组，按搭配数降序）—— 想复习 auf 支配的全部搭配时不必逐词查。支持 Dat/Akk/Gen 过滤、即时子串搜索、CEFR 标签，逐条一键入 FSRS 卡盒；数据一次拉完后全本地过滤，切换零延迟。

📰 5. 德语外刊 RSS 一键订阅与文库管理 (Curated RSS & Library)

一键解析并抓取 Tagesschau、Deutsche Welle (DW)、Deutschlandfunk (DLF)、Der Spiegel、Die Zeit 最新德语外刊与原声音频，正文自动去噪清洗入库；支持文章一键安全删除与级联清理。

⚙️ 6. 全局应用内设置面板 (In-App Settings & Connectivity Tester)

零代码 Key 配置：在界面右上角或移动端导航点击 ⚙️ 设置 即可直接填入 API Key；
现代大模型支持：默认集成 deepseek-v4-flash（极速低延迟）与 https://api.deepseek.com 官方直连；
毫秒级连通性测试：一键检测 API 连接状态与响应延迟。

🎴 7. 3D 物理拟真卡盒与 FSRS 现代认知记忆排程 (3D Flashcard Deck & FSRS)

3D 拟真物理翻转：空格键或点击卡片触发 rotateY(180deg) 3D 翻牌，支持左右飞牌手势；
FSRS 现代自适应排程：基于 DSR 三维状态机科学排程，彻底消解「沉沦死锁 (Ease Hell)」，实时预计算 4 级下一轮间隔，支持一键导出标准 Anki .apkg 牌组。

✍️ 8. 歌德完形填空 & 德福 C-Test 实战引擎 (Cloze & C-Test Engine)

提供 语法考点完形、高频词汇完形 与 标准德福 C-Test 三大实战模式，答案仅在服务端保留并防作弊智能判分。

🖋️ 9. 德语内联 IDE 写作工坊 (Schreibwerkstatt)

行内 IDE 编辑器与实时规则诊断：原生 contenteditable 零依赖，TreeWalker 字符偏移光标记忆，输入停顿 400ms 防抖实时重分析；本地规则引擎跑冠词/格位一致 + 介词支配格与动词固定搭配检测，行内彩色波浪线标出错误，零误报准则。
VSCode 级真实 Inline Inlay Hints：介词支配格（如 [Dat] / [Dat/Akk]）与名词短语实际性数格（如 [Neut·Dat]）以 CSS ::before 伪元素内联排版（DOM 无 text node），打字时光标与后续文本自然推开绝不遮挡，TreeWalker 提取纯净正文 0 字符污染，工具栏支持一键即时开关。
Problems 全篇问题清单面板 (v4.2.0)：侧栏新增 VSCode 式问题面板，集中汇总全篇 error（高置信语法错误）与 warning（双格介词方向提醒）；按 severity 分组排列，点击任意问题即刻联动平滑滚动定位、高亮波浪线并呼出纠错建议。
悬浮气泡与一键替换修正：鼠标悬停波浪线弹出诊断气泡；点击错误在侧栏查看成因详解与建议，支持「✨ 一键应用修正」直接替换编辑器内文本。
句子导航索引与 Anki 存卡：侧栏句子列表点击平滑滚动并高亮闪烁目标句；一键将错误存成 Anki 语法卡 —— 你的错误变成你的复习卡。
类 Git 完整版本快照管理：支持手动保存快照与 AI 润色自动快照；提供只读预览弹窗（浏览历史不产生多余检查点）、单项快照删除与可逆恢复检查点（恢复到版本 N 之前）。
句子级 AI 润色审查：DeepSeek 全文句子级 diff 改写，并排逐 hunk 审查采纳/拒绝。

📚 10. 德语背词工作台 (Vokabeltrainer, v4.6.0)

684 词独立背词台：FSRS-6 排程 + 卡片复习 + 自测 + 学习统计 + 词库浏览，以 iframe 嵌入主应用（导航栏 VOKABELN / 移动端 📚 背词）。同源即共享 localStorage 与 /api/，零 CORS；同时与主应用的 CSS/JS/DOM 完全隔离。
攻克手机浏览器无声：单文件 HTML 直接在 iOS/Android 上打开是放不出声的，两个根因叠在一起 —— file:// 协议下 Web Speech 被禁，以及设备根本没装德语语音包。修法是把服务端 GET /api/audio/tts（edge-tts 神经语音）设为最高优先级音频源，设备本地 TTS 退成兜底，于是有网就一定有正宗德语发音。
进度纳入备份：wb.* 学习进度键已并入 DeLector 的全量备份/还原链路，跨设备迁移不会静默丢掉背词进度。
类 Git 完整版本快照管理：支持手动保存快照与 AI 润色自动快照；提供只读预览弹窗（浏览历史不产生多余检查点）、单项快照删除与可逆恢复检查点（恢复到版本 N 之前）。
句子级 AI 润色审查：DeepSeek 全文句子级 diff 改写，并排逐 hunk 审查采纳/拒绝。

🎓 11. 歌德 A1 备考工坊 (Goethe-Zertifikat A1 Werkstatt, v4.7.0)

702 官方考纲词汇 (15 大交际主题)：覆盖歌德官方 15 大真实交际主题（Persönliche Angaben, Essen/Trinken, Einkaufen, Wohnen, Freizeit, Gesundheit, Reisen, Zeit, Arbeit, Schule, Post/Bank/Behörden, Wetter, Urlaub/Feste, Medien, Wichtige Wendungen）；全量替换机械模板句为地道 A1 考纲例句（严格修复 denn 零位语序与 durch/für + Akk. 格位一致），修复全部德语变音与不规则名词复数。
8 篇官方填表真题 (Schreiben Teil 1)：语言班/酒店/图书卡/就医等 8 大高频场景，每篇严格 5 空；评卷引擎支持德语日期格式（15.08. / 15. August）与标点大小写容错。
10 篇 30 词短电邮工坊 (Schreiben Teil 2)：严格 3 个 Leitpunkte 导向要点，实时检测称呼语逗号后首词小写、结语禁逗号、25~35 词区间与导向点覆盖，配套标准满分范文。
口语 Teil 2/3 考场题卡：34+ 主题抽词问答卡 + 20+ 考场物品与情景请求卡（Imperativ mit Sie / Können Sie bitte… 满分请求与礼貌应答）。
3D 纸牌堆叠词卡与网格双视图：词卡「牌盒/目录」双模一键切换，逐词一键入 FSRS 复习盒并实时标记「已在复习盒」；安卓卡片段标签栏窄屏下可横向滑动直达（v4.7.2）。

🚀 快速启动指南 (Quick Start)

方式一：本机 Python 运行（推荐）

1. 克隆仓库

git clone https://github.com/your-username/DeLector.git
cd DeLector

2. 安装依赖并下载德语 NLP 模型

pip install -r requirements.txt
python -m spacy download de_core_news_md

3. 一键启动

# Windows
start.bat
# 或通用平台
python start.py

脚本将自动检测局域网 IP 与空闲端口，秒开默认浏览器访问 http://localhost:8000，同 Wi-Fi 局域网下的手机或平板亦可直接扫码/输入 IP 访问。

方式二：Docker 容器化一键部署

无需手动安装 Python 环境与 NLP 依赖：

docker compose up -d --build

容器启动后，直接在浏览器中打开 http://localhost:8000 即可使用。数据库与缓存将自动持久化至本地宿主机目录。

开发者：启用提交前密钥扫描（必做一次）

core.hooksPath 是本地配置，不随 clone 生效，每个克隆都要手动开一次：

git config core.hooksPath .githooks

启用后 .githooks/pre-commit 会在每次提交前扫描暂存内容，拦下 OpenAI/AWS/GitHub/Google/Slack token、JWT 与私钥 PEM 块，以及 .env、*.pem、*.secret 这类文件名。占位符（sk-xxx、test-key）不会误报；确属误报时在该行加注释 delector:allow-secret，不要用 git commit --no-verify 整体跳过。

🏗️ 技术栈架构 (Tech Stack)

领域	核心技术	说明
后端框架	`FastAPI` + `Uvicorn`	异步高性能 REST API
自然语言处理	`spaCy` (`de_core_news_md` / `sm`)	本地高精德语分词、词性标注、形态分析与五场域句法依存
形态学引擎	`linguistics.py`	556+ 不规则动词三态表 + 复合词动态规划递归拆解
拓扑句法树	`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`	353 单元与集成测试用例保障 (100% Green)，CI 覆盖 md 加载路径与 Android 构建验签

📁 目录结构 (Project Layout)

DeLector/
├── android/ # Android 独立离线单机版工程 (Chaquopy + Gradle)
├── static/ # 前端纯静态 ES 模块化资源 (Zero-Build ESM)
│ ├── index.html # 单页应用骨架 (含 3D 卡盒、句法拓扑与台账)
│ ├── german/ # 684 词背词工作台 (workbench.html，iframe 嵌入)
│ ├── style.css # 德式报刊风格与 3D 翻转样式 (169KB)
│ └── js/ # 11 大独立原生 ES 模块
│ ├── core.js # API 请求与全局状态（含 XSS 防护 jsAttr）
│ ├── main.js # 路由调度、设置弹窗与 RSS 订阅
│ ├── reader.js # 文本渲染、五场域拓扑条与 AST 树抽屉
│ ├── cards.js # 3D 卡牌翻转盒与 FSRS 自适应记忆排程算法（调度 A1 卡）
│ ├── a1_cards.js # 歌德 A1 词卡/口语卡（702 词 + Teil 2/3 抽卡）
│ ├── writer.js # 写作润色台（行内标注 + Problems + 版本快照）
│ ├── a1_writer.js # A1 填表真题与 30 词短电邮工坊
│ ├── folio.js # Leporello 三折页台账与墨线图
│ ├── companion.js # 伴读宠物状态机与自定义 SVG 角色工坊
│ ├── cloze.js # 完形填空 & 德福 C-Test 考试
│ └── player.js # 神经影子跟读与 TTS 播放器
├── .githooks/ # 提交前密钥扫描钩子 (pre-commit，含编码 keystore)
├── linguistics.py # 556+ 不规则动词三态表与复合词拆解引擎
├── core_dict.py # 歌德 A1-B2 离线核心词库 (0ms 查词，4411 词)
├── core_dict_ext.py # 3969 词库扩展（DeepSeek 批量生成中文释义，v4.4.8 起缺口 0）
├── a1_dict.py # 歌德 A1 官方 702 词 + 口语 Teil 2/3 题卡数据集
├── a1_writing_dict.py # A1 填表真题与短电邮题库
├── prep_dict.py # 固定介词搭配数据集 552 词 / 691 条（生成物，源在 tools/build_prep.py）
├── writing_rules.py # 写作润色台本地规则引擎（冠词一致 + 介词格，零误报，含 Inlay Hints/Problems）
├── syntax_tree.py # 拓扑五场域与 AST 从句树句法引擎
├── routes_a1.py # A1 考纲路由（词卡/口语/写作/Anki 导出）
├── routes_sync.py # WebRTC 局域网 6 位短码同步路由
├── server.py # FastAPI 后端服务与核心 NLP/API 路由（敏感设置仅回环可写）
├── start.py # 跨平台智能启动脚本（Android 回环 / 桌面 0.0.0.0）
├── package_windows.py # Windows 绿色免安装便携版打包脚本
├── Dockerfile # Docker 镜像构建文件
├── docker-compose.yml # Docker Compose 编排文件
├── requirements.txt # Python 依赖清单（无新增运行时依赖）
├── tools/ # 构建/生成工具（build_dict.py 词库 + build_prep.py 介词 + 缓存）
├── test_server.py # 后端与安全/CI/备份/AI 回归 (180 用例)
├── test_writing_rules.py # 写作规则引擎，含零误报反例 (31 用例)
├── test_writer_mobile.py # 写作台移动端几何与触屏契约 + 版本一致性 (28 用例)
├── test_syntax_tree.py # 拓扑五场域与 AST 从句树 (15 用例)
├── test_german_workbench.py # 背词工作台音频补丁与接入契约 (19 用例)
├── test_essay_diff.py # 句子级 diff 引擎 (13 用例)
├── test_prep_matrix.py # 介词矩阵纯函数/前端/端点 (12 用例)
├── test_goethe_a1.py # A1 考纲词库/口语卡/前端契约 + 段标签栏窄屏滚动 (10 用例)
├── test_dict_pipeline.py # 词库生成流水线 (10 用例)
├── test_edge_tts_mini.py # stdlib 版 TTS 兜底客户端 (10 用例)
├── test_goethe_a1_writing.py # A1 填表与电邮诊断/范文契约 (8 用例)
├── test_core_dict_ext.py # 词库扩展数据契约 (5 用例)
├── test_frontend_security.py # 前端 XSS 注入点棘轮 (4 用例)
├── test_start.py # 启动器 Android/桌面绑定 (4 用例)
├── test_frontend_module_graph.py # 前端 ES module 图解析（具名 import 可达性） (2 用例)
└── test_source_hygiene.py # 源码卫生（重复键等）棘轮 (2 用例)

🗺️ 路线图 (Roadmap)

📄 许可证 (License)

本项目采用 MIT License 开源许可证。欢迎提 PR 或 Issue 参与共建！

Navigation Menu

Repository files navigation

DeLector · 德语欧标沉浸精读与考点剖析工作台

📦 多平台下载发布包 (Downloads)

🌟 核心特性 (Features)

🦉 1. 德语伴读宠物（Companion Mascot）「Eule & 伙伴」混合双模系统

📊 2. Atelier 呼吸感落地页台账 (Continuous Exhibition Folio)

🌳 3. 德语拓扑五场域与 AST 从句树句法引擎 (Topological Felder-Modell & Syntax Tree)

⚡ 4. 深度德语形态学与词法引擎 (Morphology & Lexicon)

📰 5. 德语外刊 RSS 一键订阅与文库管理 (Curated RSS & Library)

⚙️ 6. 全局应用内设置面板 (In-App Settings & Connectivity Tester)

🎴 7. 3D 物理拟真卡盒与 FSRS 现代认知记忆排程 (3D Flashcard Deck & FSRS)

✍️ 8. 歌德完形填空 & 德福 C-Test 实战引擎 (Cloze & C-Test Engine)

🖋️ 9. 德语内联 IDE 写作工坊 (Schreibwerkstatt)

📚 10. 德语背词工作台 (Vokabeltrainer, v4.6.0)

🎓 11. 歌德 A1 备考工坊 (Goethe-Zertifikat A1 Werkstatt, v4.7.0)

🚀 快速启动指南 (Quick Start)

方式一：本机 Python 运行（推荐）

1. 克隆仓库

2. 安装依赖并下载德语 NLP 模型

3. 一键启动

方式二：Docker 容器化一键部署

开发者：启用提交前密钥扫描（必做一次）

🏗️ 技术栈架构 (Tech Stack)

📁 目录结构 (Project Layout)

🗺️ 路线图 (Roadmap)

📄 许可证 (License)

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.githooks		.githooks
.github/workflows		.github/workflows
android		android
docs		docs
static		static
tools		tools
.agent-context.md		.agent-context.md
.agent-rules.md		.agent-rules.md
.cursorrules		.cursorrules
.env.example		.env.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
FEATURES.md		FEATURES.md
LICENSE		LICENSE
README.md		README.md
a1_dict.py		a1_dict.py
a1_hoeren_dict.py		a1_hoeren_dict.py
a1_lesen_dict.py		a1_lesen_dict.py
a1_writing_dict.py		a1_writing_dict.py
core_dict.py		core_dict.py
core_dict_ext.py		core_dict_ext.py
corpus_dict.py		corpus_dict.py
database.py		database.py
docker-compose.yml		docker-compose.yml
edge_tts_mini.py		edge_tts_mini.py
essay_diff.py		essay_diff.py
front.jpg		front.jpg
linguistics.py		linguistics.py
nlp.py		nlp.py
package_windows.py		package_windows.py
prep_dict.py		prep_dict.py
requirements.txt		requirements.txt
routes_a1.py		routes_a1.py
routes_a1_hoeren.py		routes_a1_hoeren.py
routes_a1_lesen.py		routes_a1_lesen.py
routes_corpus.py		routes_corpus.py
routes_sync.py		routes_sync.py
security.py		security.py
server.py		server.py
start.bat		start.bat
start.py		start.py
start.sh		start.sh
syntax_tree.py		syntax_tree.py
test_core_dict_ext.py		test_core_dict_ext.py
test_corpus.py		test_corpus.py
test_dict_pipeline.py		test_dict_pipeline.py
test_edge_tts_mini.py		test_edge_tts_mini.py
test_essay_diff.py		test_essay_diff.py
test_frontend_module_graph.py		test_frontend_module_graph.py
test_frontend_security.py		test_frontend_security.py
test_german_workbench.py		test_german_workbench.py
test_goethe_a1.py		test_goethe_a1.py
test_goethe_a1_hoeren.py		test_goethe_a1_hoeren.py
test_goethe_a1_lesen.py		test_goethe_a1_lesen.py
test_goethe_a1_writing.py		test_goethe_a1_writing.py
test_prep_matrix.py		test_prep_matrix.py
test_server.py		test_server.py
test_source_hygiene.py		test_source_hygiene.py
test_start.py		test_start.py
test_syntax_tree.py		test_syntax_tree.py
test_writer_mobile.py		test_writer_mobile.py
test_writing_rules.py		test_writing_rules.py
writing_rules.py		writing_rules.py

Latest commit

History

Folders and files

Repository files navigation

DeLector · 德语欧标沉浸精读与考点剖析工作台

📦 多平台下载发布包 (Downloads)

🌟 核心特性 (Features)

🦉 1. 德语伴读宠物（Companion Mascot）「Eule & 伙伴」混合双模系统

📊 2. Atelier 呼吸感落地页台账 (Continuous Exhibition Folio)

🌳 3. 德语拓扑五场域与 AST 从句树句法引擎 (Topological Felder-Modell & Syntax Tree)

⚡ 4. 深度德语形态学与词法引擎 (Morphology & Lexicon)

📰 5. 德语外刊 RSS 一键订阅与文库管理 (Curated RSS & Library)

⚙️ 6. 全局应用内设置面板 (In-App Settings & Connectivity Tester)

🎴 7. 3D 物理拟真卡盒与 FSRS 现代认知记忆排程 (3D Flashcard Deck & FSRS)

✍️ 8. 歌德完形填空 & 德福 C-Test 实战引擎 (Cloze & C-Test Engine)

🖋️ 9. 德语内联 IDE 写作工坊 (Schreibwerkstatt)

📚 10. 德语背词工作台 (Vokabeltrainer, v4.6.0)

🎓 11. 歌德 A1 备考工坊 (Goethe-Zertifikat A1 Werkstatt, v4.7.0)

🚀 快速启动指南 (Quick Start)

方式一：本机 Python 运行（推荐）

1. 克隆仓库

2. 安装依赖并下载德语 NLP 模型

3. 一键启动

方式二：Docker 容器化一键部署

开发者：启用提交前密钥扫描（必做一次）

🏗️ 技术栈架构 (Tech Stack)

📁 目录结构 (Project Layout)

🗺️ 路线图 (Roadmap)

📄 许可证 (License)

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages