DeLector 是面向德语精读与歌德（Goethe-Zertifikat A1–C1）、德福（TestDaF）、DSH 备考者的下一代本地优先（Local-First & Offline-First）学术级德语伴读与记忆工具箱。
单文件后端（FastAPI + spaCy + SQLite + FSRS 引擎）+ 零构建原生前端（ES Modules + PWA），开箱即用，数据 100% 掌握在自己手中。
┌─────────────────────────────────────────────────────────┐
│ DeLector 工作站核心矩阵 │
└────────────────────────────┬────────────────────────────┘
│
┌───────────────────┬────────────────────┼───────────────────┬───────────────────┬───────────────────┬───────────────────┐
▼ ▼ ▼ ▼ ▼ ▼ ▼
📖 学术级精读台 ⚡ 德语形态学引擎 🌳 句法拓扑与从句树 📰 外刊 RSS 与管理 🎴 FSRS 卡盒与 Anki 🦉 伴读宠物双模系统 📊 Atelier 落地台账
- CEFR 词阶热力图 - 556+ 强变化三态 - 经典五场域色谱条 - Tagesschau/DW - 3D 物理翻转盒 - 4大内置矢量角色 - 0.85:1.15 Hero展台
- 0ms 歌德核心词库 - 复合词智能拆解 - 5大核心从句 AST 树 - DLF/Spiegel/Zeit - FSRS 认知自适应排程 - 自定义 SVG 上传消毒 - 双行反向动态走字带
- 荧光便签与 AI 导读 - 框形可分动词联动 - 一键制 Anki 语法卡 - 文章一键极速删除 - 消除 Ease Hell 死锁 - 9大场景德语 TTS - 欧标矩阵与30天走势
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| CEFR 全文词阶热力谱 | 自动对德语全文进行 NLP 词法解析，生成 A1–C1 词阶占比热力条，推荐阅读级别与耗时。 | 3 秒评估文章难度，精准定位生词区间。 |
| 一键 CEFR 色谱聚焦 | 点击热力条特定级别（如 B2），正文中该级别词汇即刻高亮并滤除其他视觉干扰。 | 阶梯式攻克生词，告别地毯式查词焦虑。 |
| 0ms 歌德核心离线词库 | 内置 4300+ 歌德 A1–C1 核心词汇（DeepSeek 批量生成中文释义），点击词汇 0 毫秒即出中文释义、冠词（der/die/das）与复数。 | 离线纯血运行，查词毫无延迟与网络依赖。 |
| AI 语法深度剖析 | 结合句子上下文，AI 深度解析目标短语语法考点（从句框形、虚拟式、四格介词搭配等）。 | 攻克德语复杂从句与固定搭配难关。 |
| 四色荧光笔与便签系统 | 自由选取句子片段，使用黄/绿/蓝/粉四色高亮标注，并支持 AI 辅助一键生成精读笔记。 | 沉淀个人语料库与长难句剖析库。 |
| 打印级《精读指南》导出 | 一键将整篇文章连同生词表、语法重点、个人笔记打包生成学术排版 HTML 学习指南。 | 方便纸质打印、iPad 批注或考前归纳复习。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 556+ 强变化动词三态表 | 完整覆盖歌德 A1–C1 常用不规则动词四元组（Infinitiv — Präteritum — Partizip II — Hilfsverb haben/ist）。 |
ging）还是分词（genommen），自动反查原形与助动词。 |
| 长复合词智能递归拆解 | 动态规划算法自动将德语复合词拆解为基础词根，精准剥离 -s-, -es-, -en-, -n-, -er-, -e- 等连接词素。 |
化繁为简：长词不再难记，点击子词胶囊即可就地查看子词释义并单独制卡。 |
| 固定介词搭配表（Präpositionen） | 动词/形容词的固定介词搭配及其支配的格，一词多义分条并列（bestehen auf 坚持 / aus 由…组成 / in 在于），每条带例句；531 词条 / 660 条搭配（AI 批量生成 + 人工 seed 兜底，含介词与冠词缩合 am/im/zum 等）。 |
介词+格是歌德考试高频失分点：查词时就地看到，并可只把想背的那一条存成词汇卡。 |
| 框形可分动词双向联动 (Satzklammer) | 基于 spaCy 依存句法树，将跨句变位动词与句末前缀（如 steigt ... ein）双向绑定并同步微光高亮。 |
告别读到句末才发现是可分动词的困扰，自动呈现合成原形 einsteigen。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 经典五场域色谱展开条 | 精确切分 前场 (VF)、左框 (LK)、中场 (MF)、右框 (RK) 与 后场 (NF)，点击句末 🌳 句法 即可展开。 |
彻底吃透德语动词二位 (V2) 与动词置后 (VL) 语序规律。 |
| 5 大核心从句 AST 抽象语法树 | 自动识别并分类 状语从句（原因/让步/条件/时间/目的/结果）、关系从句、带 zu 不定式、被动与虚拟式框形及 主句核心干。 | 直观理清德语长难句嵌套从句层级关系。 |
| 正文聚焦微光光圈联动 | 抽屉内点击从句节点，正文中对应从句词汇即刻触发橙色脉冲光圈高亮。 | 视觉直观定位从句边界。 |
| 一键转制 Anki 语法卡 | 从句类型、引导词、变位谓语与句式公式一键沉淀进卡盒与 Anki 牌组。 | 快速积累语法考点库。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 精选权威德语信源 | 内置 Tagesschau、DW 德国之声、Deutschlandfunk、Der Spiegel、Die Zeit 等一手德语主流源。 | 紧跟德语国家每日焦点，拓宽德福/歌德写作素材。 |
| 全格式通用解析 | 标准库无缝解析 RSS 2.0、Atom 1.0 与 RDF 1.0 协议，智能识别并提取最新刊物列表。 | 无需复杂爬虫，点开即读最新德语资讯。 |
| 正文智能抽取与清洗 | 过滤网站导航、广告、页脚等冗余信息，纯净提取德语正文并直接载入精读解析台。 | 一键将真实新闻转为互动式精读语篇。 |
| 文库极速删除与联级清理 | 文稿库支持一键安全删除文章，后端事务联级清理关联笔记与缓存。 | 保持文稿库井然有序。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 4 大内嵌矢量角色 | 🦉 歌德猫头鹰 Eule、🐱 学者猫 Katze、🦊 灵动狐 Fuchs、🤖 包豪斯机甲 Roboter。 | 研读旅程专属学术化生动伴读伙伴。 |
| 自定义 SVG 角色上传 | 支持上传 DOMParser 白名单消毒（彻底防 XSS）。 |
打造千人千面的个性化伴读形象。 |
| 混合双模展示架构 | 台账首屏嵌入大「研读工坊展台」控制板 + 全局右下角常驻微型伴读浮层气泡。 | 深度控制与沉浸阅读兼得，自动避让 Dock 与抽屉。 |
| 9 大场景实时语音鼓励 | 覆盖制词汇卡、制语法卡、FSRS 复习、完形填空 |
持续正向情绪反馈，保持备考自驱力。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 3D 纸质触感翻转盒 | 拟真卡盒设计，支持词汇卡（含冠词性别、复数、例句）与语法卡（含公式、规则、例句）3D 翻转。 | 沉浸式复习体验，手感与仪式感兼备。 |
| 现代 FSRS 认知排程器 | 基于 DSR（难度/稳定性/可提取性）幂律遗忘数学模型，按 |
消除 Ease Hell 死锁，减少 20%~30% 无效复习量。 |
| 4 级动态预计算绑定 | 按钮动态显示精准下一轮排程天数（1 重来、2 困难、3 良好、4 简单），前后端绝对一致。 | 复习节奏一清二楚，梯度科学渐进。 |
| 一键导出 Anki APKG | 一键将生词/语法卡片打包为 .apkg 文件，内置 DeLector 专有学术版排版样式。 |
无缝导入 Anki Desktop / AnkiMobile / AnkiDroid。 |
| 歌德 A1 官方考纲词表与 15 大主题过滤 | 完整收录 702 官方考纲词汇（带词性、性属色条、复数、中文释义与官方双语考纲例句），支持 15 大真实生活主题一键切片筛选与模糊秒搜。 | 零遗漏突击官方核心词汇，一键收录进个人 FSRS 复习盒。 |
| 歌德 A1 口语 Teil 2 主题抽词对练 | 34+ 组真实考场 Thema 关键词抽卡，考场任务呈现 + 3D 翻转对照标准 W-Frage 与 Ja/Nein-Frage 提问与满分应答。 | 考场口试高保真模拟，彻底消除开口紧张感。 |
| 歌德 A1 口语 Teil 3 物品请求情景卡 | 20+ 组真实考场物品图标与情景（🚪 关门、☕ 点咖啡、📱 留号码等），3D 翻转对照 Imperativ 祈使句与礼貌请求句型及标准应答。 | 考场手卡实战演练，掌握标准礼貌交际用语。 |
| 一键导出歌德 A1 官方定制 Anki 牌组 | 一键打包 702 考纲词为专属 .apkg（性属三色高亮、例句高亮、音标与释义排版）。 |
离线随身刷词，多端同步。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 语法完形填空模式 | 智能挖掘介词格搭配、从句连词、虚拟式与被动式助动词空白。 | 专项攻克欧标考试语法完形填空题。 |
| 核心词汇完形填空模式 | 针对 A2–C1 级别核心名词与动词挖空考查。 | 深度巩固高频重点生词的语境运用。 |
| 标准德福 C-Test 模拟 | 严格遵循德福/DSH 规范（第 2 句起每隔 1 词截断后半部）。 | 原汁原味德福 C-Test 备考模拟演练。 |
| 服务端安全防作弊 | 答案绝不暴露在前端 DOM 属性中，提交后由服务端判定得分并生成详细解析。 | 真实测验环境，杜绝 F12 偷看答案。 |
| 首字母温和提示系统 | 卡壳时可一键揭示首字母提示，辅助思维唤醒而不直接破坏做题成就感。 | 循序渐进搭建做题脚手架。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 0.85:1.15 不对称 Hero 展台 | 融合德式名言箴言卡、6 核心 Ring Badges 环形指标大展盘与四角 + 定位标点。 |
气势恢宏的学术画册开篇，告别拖滑倦怠。 |
| 双行反向 Wire Marquee 走字带 | 硬件加速匀速滚动名家引文与实时战报脉冲，两端带纸面渐变羽化遮罩，悬停平滑暂停。 | 浓郁现代社论杂志质感与实时成就反馈。 |
| 并排双面板紧凑罗盘 | A1–C1 掌握度阶梯矩阵、30 天墨线留存折线图、重点易错词汇攻坚账本与学术火漆印章展台。 | 掌握度、轨迹、弱项与成就一屏尽览。 |
| 一键数据备份与还原 | 整库 JSON 导出／还原：文章、卡片（含 SRS 复习进度）、笔记、学习统计与界面偏好；全量真往返（v3.10.0 堵住三处静默丢数据，含 API Key 被吞）。还原为整体覆盖语义。 | 换机或重装可完整迁移。注意还原会清空现有数据，导出的 JSON 不含 API Key。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| Edge Neural 神经网络语音 | 接入微软 Edge TTS 高品质原生德语发音（女声 KatjaNeural / 男声 ConradNeural）。 |
告别机械音，享受地道德语母语级听感。 |
| 本地音频高速缓存 | 生成的音频分句自动缓存至本地 .cache/audio/，二次播放零延迟且完全离线。 |
节省网络开销，支持离线反复跟读磨耳朵。 |
| 单句循坏影子跟读 | 精读视图下支持句子级定位播放、循环朗读、波形动效与语速微调。 | 德福听力与口语发音影子跟读（Shadowing）利器。 |
| Web Speech 离线兜底 | 无网络环境下自动平滑降级至浏览器内置 TTS 引擎，确保发音功能永不断流。 | 真正 Local-First，无网环境依然可用。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 全局一键呼出弹窗 | 无论在桌面端顶部导航栏还是移动端底部 Dock，点击 ⚙️ 设置 均可在最高层级（z-index: 99999）呼出。 |
随时调整偏好，无需跳出当前精读页面。 |
| DeepSeek 官方直连 | 默认集成官方 https://api.deepseek.com 接口与 deepseek-v4-flash 极速低延迟模型。 |
响应迅速，费用极低，零代码门槛。 |
| 毫秒级连通性测试 | 实时发送 1-token 测试探测，就地反馈 API Key 有效性与网络延迟数值。 | 排除配置疑障，心中有数。 |
| 平台版本 | 技术方案 | 特性与优势 |
|---|---|---|
| Windows x64 绿色便携版 | PyInstaller 独立编译打包（DeLector-v3.10.0-Windows-x64-Portable.zip） |
包含 Python 3.11、spaCy 模型、FastAPI 与前端资源，双击 DeLector.exe 秒级启动。 |
| macOS 免安装包 | PyInstaller + M系列/Intel 通用支持（DeLector-v3.10.0-macOS.tar.gz） |
解压运行 start 即可，零环境门槛。 |
| Linux x64 便携版 | Ubuntu / Debian / Arch 通用打包（DeLector-v3.10.0-Linux-x64.tar.gz） |
解压即用，支持服务器与工作站环境。 |
| Android 独立单机版 APK | Chaquopy 嵌入式 Python 运行时 + 原生离线 TTS 桥接（android/，APK 56.7 MB） |
嵌入式 Python 与 spaCy 离线模型，脱离电脑 100% 独立离线单机运行（arm64-v8a）；CI 钉死签名 keystore 并验签，可覆盖升级。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 内联 IDE 编辑器与实时规则诊断 | 原生 contenteditable 零依赖，TreeWalker 字符偏移光标记忆，输入停顿 400ms 防抖实时重分析；本地规则引擎跑冠词/格位一致 + 介词支配格与动词固定搭配检测，行内彩色波浪线标出错误，零误报准则。 |
沉浸式边写边诊，即时反馈，打字光标稳定不跳动。 |
| VSCode 级真实 Inline Inlay Hints | 介词支配格（如 [Dat] / [Dat/Akk]）与名词短语实际性数格（如 [Neut·Dat]）以 CSS ::before 伪元素内联排版（DOM 无 text node），打字时光标与后续文本自然推开绝不遮挡，TreeWalker 提取纯净正文 0 字符污染，工具栏支持一键即时开关。 |
真实 IDE 级内联体验，打字丝滑无重叠，直观对照介词要求格与名词实际格。 |
| Problems 全篇问题清单面板 (v4.3.0) | VSCode 式问题面板在 Android/移动端以 bottom-sheet 呈现，支持点按错误详情、定位与修正；桌面端继续使用侧栏。 | 手机写作时保留全篇错误/提醒清单与一键纠错能力。 |
| 悬浮诊断气泡与一键替换修正 | 鼠标悬停波浪线弹出诊断气泡；点击错误在侧栏查看成因详解与建议，支持「✨ 一键应用修正」直接替换编辑器内错误词句。 | 快速纠错，知其然并知其所以然。 |
| 句子导航索引与 Anki 存卡 | 侧栏提供全文句子导航索引，点击平滑滚动并高亮闪烁目标句；一键将错误存成 Anki 语法卡（带 corrected_form/error_type）。 |
你的错误变成你的复习卡——FSRS 间隔复习闭环，实现针对性弱项攻坚。 |
| 类 Git 完整版本快照管理 | 支持手动保存快照与 AI 润色自动快照；提供只读预览弹窗（浏览历史不产生多余检查点）、单项快照删除与可逆恢复检查点（恢复到版本 N 之前）。 |
自由试错，写作版本留痕且安全可逆。 |
| CEFR 词汇频率估测 | 复用词阶热力统计，给作文标定 A1–C1 词阶分布与建议等级。 | 一眼评估作文词汇丰富度与用词层级。 |
| essays 作文草稿库 | 保存/列表/回访/删除，作文改动与恢复版本自动重分析入库。 | 本地安全持久化，长期归档。 |
| 句子级 AI 润色并排审查 | DeepSeek 全文句子级 diff 改写，左右并排逐 hunk 审查，支持单条采纳/拒绝与一键全部采纳。 | 逐句精修，拒绝黑盒全量覆盖，自主决策每一处改动。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 6 位短码免复制握手 | A 设备生成 6 位大字短码，B 设备手机端直接输入 6 位短码即可完成 WebRTC SDP 交换，彻底告别 2-3KB SDP 跨设备手动复制粘贴。 | 手机与电脑间极速同步，体验丝滑。 |
| 端到端加密点对点传输 | WebRTC DataChannel 纯局域网直连传输，数据不经公网第三方中转，服务端 SDP 临时缓存 5 分钟 TTL 且一次性消费即毁。 | 隐私安全，零数据泄露风险。 |
| FSRS 学习进度双向自动合并 | 跨设备自动比对双方卡片复习状态、新增词汇与错题记录，以最新复习时间戳为准双向增量合并。 | 电脑备考、手机背词无缝衔接，进度绝不丢失。 |
| 镜像静默同步（Stage A） | 配对一次、长期静默：配对面板展示 32 位配对密钥与局域网 IP，手机填 host+key 保存后 wbsync 每 5s 带 X-WB-Key 静默对账（applyMerge 静默合并、不弹 toast）；清除配对后推送 403、只读拉取不破；公共 Origin 跨域一律被浏览器拦截。 |
地铁背词 → 回家打开桌面进度自动合并且全程零手动操作，隐私不流出公网。 |
| 自动化 WebRTC 静默同步（Stage B） | 在 Stage A 之上升级为 P2P 加密通道：配对凭证可长期保存并支持一键撤销（重新生成密钥使旧 key 立即 403）；两端经 /api/wb/rtc/signal 中继自动建连（DTLS 加密、无 CORS 约束），角色由「是否已配对」决定无需协商；断线自动去抖重建，连续失败即降级回 HTTP 轮询兜底；全程 applyMerge 静默合并。 |
配对一次后彻底无感：通勤路上背的词，回到桌面打开页面就已躺在进度里，且同 Wi-Fi 抓包读不到内容。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 三模式微训 | L 精听/影子跟读（句子队列逐句播 + 变速 0.75x–1.25x / 重复 / 循环 + 跟读停顿）、D 听写诊断（隐藏文本逐句听写 → 词级 LCS 逐字归因六色胶囊反馈）、C 听力填空（动词/名词启发式挖空 → 听后填答校验）。 | 碎片时间 3-5 分钟短会话，日常听力补位，告别"只靠考试"训练。 |
| 分级材料源复用 | 材料直接复用遇见区 A1/A2 分级短文（encounter）+ A1 听力音频句库（a1_hoeren audio_text_de），按 level 过滤，不建独立听力库。 |
与背词/分级短文同源，跨功能协同，零新资产投入。 |
| 逐字诊断归因 | diagnose_diktat 词级 LCS 对齐：正确 / 变音（ü→u）/ 大小写（der→Der）/ 词尾屈折（-en→-e）/ 缺漏 / 多余，不惩罚大小写与变音（分类提示而非判错）。 |
精准定位听错原因，针对性补弱。 |
| 会话成绩落盘 | 每会话汇总（正确词数 / 总词数 / 分数 / 耗时）落 listen_trials，历史可回看（对齐 exam_trials 模式，随备份还原）。 |
训练轨迹留痕，备考复盘有据。 |
| 离线本地优先 | 诊断与填空校验为本地纯函数（零网络）；播放复用 playGermanAudio 三层 TTS 兜底（Android Native → /api/audio/tts → Web Speech）。 |
无网可练，真正 Local-First。 |
| 功能特性 | 功能描述 | 备考/学习价值 |
|---|---|---|
| 句子级难度评分引擎 | syntax_score 7 维加权评分 0–100（从句深度/从句复合度/被动/虚拟式/VL 句框/关系从句/句长）+ estimate_level CEFR 带估算；双路径分析并带 path 标注（spaCy/纯 Python，红线 1 降级仅作参考）。 |
精准定位"哪句最难、难在哪"，句卡带难度分与级别标签。 |
| 跨语料挑选 | GET /api/syntax/hard-sentences 按 source（article/encounter/all）× level × min_score × limit 挑句，进程内存缓存 + limit 护栏。 |
从现成语料随时派生长难句，无需独立题库。 |
| 拆解→揭示句法树 | 句卡先"尝试拆解"（默认隐藏句法树，先找主句/从句）→ 揭示渲染 clause_tree/topology（复用 ADR-0007 抽屉形态）+ 查词链路逐词释义（/api/lookup/vocab）。 |
定向攻坚嵌套从句，先思考后揭示，拆解不剧透。 |
| 入复习盒 + 成绩落盘 | 「加入复习盒」复用 saveGrammar 语义写 grammar_cards（不新建卡种表，同句已入盒显示"已加入"）；会话成绩 POST /api/syntax/hard-sentence/trials 落 hard_sentence_trials。 |
长难句进 FSRS 复习闭环，训练轨迹有据可查。 |
| 等级门控适配过渡期 | 默认 A2+ 门控（可切全部）；path="pure" 句显示"近似分析"提示，评分仅参考，不碾压 A1/A2 过渡用户。 |
精读脚手架而非虐题，按级别温柔进阶。 |
| 版本号 | 发布日期 | 核心交付内容 | 状态 |
|---|---|---|---|
| v3.5.0 | 2026-08-18 | 拓扑五场域与从句 AST 引擎 + 556+ 三态表 + 复合词拆解 + 全局设置 | 🟢 已发布 |
| v3.5.2 | 2026-08-19 | Android Native TTS 离线桥接 + 国内免翻墙语音兜底 + 移动端底部 Dock 优化 | 🟢 已发布 |
| v3.6.2 | 2026-08-19 | Atelier 呼吸感落地页台账 (Hero 展台 + 双行反向 Marquee + 紧凑双面板) | 🟢 已发布 |
| v3.7.1 | 2026-08-19 | 德语伴读宠物（Eule & 伙伴）+ 自定义 SVG 上传消毒 + 4 平台 CI/CD 矩阵 | 🟢 已发布 |
| v3.8.0 | 2026-08-19 | 现代 FSRS 认知排程器升级（DSR 状态机原生零依赖数学模型，消解 Ease Hell） | 🟢 已发布 |
| v3.9.0 | 2026-08-19 | 离线词库 443→4300 词（DeepSeek 批量生成中文释义）+ 查词链 lemma 优先 / 形态学接线 / 现在时反查 / UX 诚实显示 | 🟢 已发布 |
| v3.9.1 | 2026-08-19 | 安卓真机修复：TTS 无声（stdlib 版 Edge TTS 客户端）、倍速点不到（三行布局）、抽屉白色遮挡（55vh + 阅读区全宽） | 🟢 已发布 |
| v3.10.0 | 2026-08-20 | 固定介词搭配（531 词条 / 660 搭配，查词抽屉第四卡可存词卡）+ 备份全量真往返（堵三处静默丢数据）+ 安卓签名迁移（钉死 keystore + CI keytool 验签闸、显式 v1、versionCode 规则修正） | 🟢 已发布 |
| v3.11.0 | 2026-08-21 | 德语写作润色台：本地规则引擎（冠词/格位一致 + 介词支配格，零误报准则）+ 行内下划线侧栏纠错 + 错误一键存 Anki 卡（corrected_form/error_type）+ essays 草稿库 + CEFR 估测 + 显式 AI 润色全文 | 🟢 已发布 |
| v3.12.0 | 2026-08-21 | 写作台 IDE 化：句子级 difflib 引擎 + AI 润色逐 hunk 并排审查（接受/拒绝）+ essay_versions 类 git 快照管理（手动保存 + AI 自动快照 + 可逆恢复检查点）+ 侧栏双 Tab 联动 | 🟢 已发布 |
| v4.0.0 | 2026-08-21 | 德语写作台内联 IDE 编辑器（contenteditable 零依赖行内实时波浪线诊断 + TreeWalker 光标记忆 + 防抖 400ms 规则诊断 + 悬浮提示气泡 + 一键修正替换 + 句子导航）+ Git 版本管理完善（只读预览不产生检查点 + 版本快照单项删除）+ 动词固定介词搭配规则优先匹配 | 🟢 已发布 |
| v4.1.0 | 2026-08-21 | 德语写作台 Inlay Hints 语法内联提示（介词支配格 mit [Dat] / in [Dat/Akk] + 名词短语实际性数格 [Neut·Dat] 独立 #ide-hint-layer 覆盖层装饰渲染、pointer-events: none 绝不抢光标、工具栏全局开关 toggleInlayHints()、与波浪线错误并存呈现矛盾教学高光） |
🟢 已发布 |
| v4.1.1 | 2026-08-21 | 德语写作台 Inlay Hints 架构升级为 VSCode 级真实 Inline 布局：CSS ::before 伪元素（DOM 无 text node）+ contenteditable="false" 内联排版，打字时后续文本自然平移推开绝不遮挡，TreeWalker 提取纯净正文 0 字符污染，光标自然跃迁 |
🟢 已发布 |
| v4.2.0 | 2026-08-21 | 德语写作台 Problems 问题清单面板（全篇错误/提醒清单 + severity 分级 + error 错误优先与双格介词 warning 提醒 + 联动滚动定位/波浪线高亮/一键修正） | 🟢 已发布 |
| v4.3.0 | 2026-08-22 | Android/移动端写作台适配（bottom-sheet、触屏纠错、Android 默认关闭 Inlay Hints）+ 安全加固：存储型 XSS 全量修复（jsAttr 9 处注入点）、SSRF 加固、TTS 长度闸 |
🟢 已发布 |
| v4.4.0 | 2026-08-22 | 可靠性与安全收口——敏感设置/备份仅回环可写（局域网 403）、pre-commit 编码 keystore 拦截、CI 真 Gradle 构建与验签闸、写作零误报加固、备份/AI 失败回归；测试 230 全绿，词库 110 词缺口盘点（30 缓存待合入，80 需 API，401 暂缓） | 🟢 已发布 |
| v4.4.1–v4.4.4 | 2026-08-22 | 写作台移动端面板交互与 dock 遮挡修复（z-index 120→1100）、Service Worker 强制刷新所有页面、版本号改为从 git tag 自动推导 | 🟢 已发布 |
| v4.4.5 | 2026-08-23 | 安卓资产解包版本闸 + 写作台交互统一——按 versionCode 比对标记文件决定是否重解包前端资产（覆盖安装不清 filesDir，而 copyAssetFile 见文件已存在即跳过，旧文件永不被覆盖、新文件照常拷入，设备停在「新旧混合」状态，此前只能卸载重装）；服务端补 Cache-Control: no-cache，退役从未真正生效的 ?v= 查询串与 sw.js 死清单；整行点击 = 定位/预览、行内按钮 = 破坏性操作、结果落在编辑器时自动收起移动端面板；测试 238 全绿 |
🟢 已发布 |
| v4.4.6 | 2026-08-23 | 修顶栏版本指示灯 + 移动端写作台面板位移/底部滚不到根治——① 顶栏 System · vX.Y.Z Online 由 v4.4.5 漏 bump 导致修好的升级链路看起来像没生效（拆 APK 已验证包内前端全是新的，仅该字面量是旧的），版本自洽测试新增该标签断言；② 移动端 .writer-sidebar position: fixed + bottom 锚点 + 只用 max-height 没有 height 导致每次切 tab、填错误卡、清单从空变 N 条顶边一路跳（三个 Tab 都在跳，诊断分析最明显），改用 height: min(76vh, 680px) 固定几何；内层三个列表（220/460/320px）原本各自开滚动区在 600px sheet 里几乎占满可见区域、吃掉外层滚动，统一 max-height: none; overflow-y: visible 归 sheet 一人管；.writer-pane 补 flex-shrink: 0 防父容器压扁。测试 239 全绿 |
🟢 已发布 |
| v4.4.7 | 2026-08-24 | 桌面端侧栏几何收口 + 三行触屏按压反馈——v4.4.6 移动端修复的同族另一半：.writer-sidebar 基规则是 position: sticky; top: 4.5rem，在 align-items: start 的 grid 列里高度跟内容走，既无 max-height 也无 overflow-y，内容一长就整列溢出、底部滚不到；改为 max-height: calc(100vh - 6rem) + 内部滚动、tab 条 sticky 吸顶。三种可点击行（错误卡/清单项/版本行）补 :active 按压反馈——触屏没有 hover，此前按下去毫无回馈。测试 242 全绿 |
🟢 已发布 |
| v4.4.8 | 2026-08-25 | 离线词库补齐 + SSRF 闸判定修正——① 两处「AI 不作答」其实 AI 每次都答了：提示词要求反身动词 wort 不带 sich，而匹配器按 lemma not in asked 把返回值丢掉（缓存里 collocations 与 none 双空即为铁证）；单词请求会让模型「纠正」成词元（问 zustände 答 Zustand）而词库按表层形查，于是任何屈折形必然连丢 3 轮。改为把答案回映射到请求键：搭配 531/660 → 552/691（零 API 花费），词库尾缺口 110 → 0（core_dict_ext 3859 → 3969）。刻意不做变音折叠——drucken/drücken、vertraglich/verträglich 会互相领走搭配，张冠李戴比漏检更糟。② SSRF 闸拿外层 IPv6 旗标判定，而 IPv4-mapped/6to4/Teredo 的真实目的主机是内嵌的 IPv4，两个方向同时错：2002:c0a8:0101::1 外层 is_global 为真却路由到 192.168.1.1（旧写法一路放行，能真打进内网），而 Teredo 落在 2001::/23 私有段清单里使开着隧道的 Windows 用户 URL 导入对所有站点全废。改为先归一到「包真正会打到的目的地」再判定；两条依赖真实 DNS 的测试也一并钉住。③ 首次打 tag 时 CI Linux job 红、Release 被跳过：新加的断言在本机（3.11.8）靠 ipaddress 私有段表一条粗粒度的 2001::/23 条目顺手兜住才绿，CI（3.11.16）换成细粒度条目后 2001:20::/28(ORCHIDv2) 掉了出来 —— 同一份代码、同一个 3.11 大版本、判定相反，正是②在修的那个错的另一种形态。改法是在代码里自己钉住那些段，不是删断言。测试 266 全绿 |
🟢 已发布 |
| v4.4.9 | 2026-08-27 | 按钮 token 体系 + 移动端 sheet 几何修正 + 重复键棘轮（280 全绿） | 🟢 已发布 |
| v4.5.0 | 2026-08-27 | Präpositionen-Matrix 介词矩阵视图（552 词 / 691 条固定搭配，21 组按大小降序，298 全绿） | 🟢 已发布 |
| v4.6.0 | 2026-08-28 | 德语背词工作台集成（684 词，FSRS-6，iframe 嵌入）+ 服务端 GET /api/audio/tts 解决移动端发音（314 全绿） | 🟢 已发布 |
| v4.6.1 | 2026-08-28 | 背词台 TTS 修复（去掉 playWord cleanup 的 load()，加 _ttsAttemptId 全局守卫防 stale 冲突，316 全绿） | 🟢 已发布 |
| v4.6.2 | 2026-08-28 | 卡盒交互修复 + 伴读宠物 + 自测范围（316 全绿） | 🟢 已发布 |
| v4.6.3 | 2026-08-28 | 工作台 Android 导出修复（走 /api/wb/backup 服务端通道）+ 卡盒 swipe 拦截（316 全绿） | 🟢 已发布 |
| v4.6.4 | 2026-08-28 | 介词矩阵已存搭配服务端持久化（prep_saved 表与 /api/prep/saved 端点，随备份导出恢复，319 全绿） | 🟢 已发布 |
| v4.6.5 | 2026-08-28 | 局域网 WebRTC 6 位短码免复制同步（POST /api/wb/sync/store + GET /api/wb/sync/fetch/{code}，大字码展示 + 6 位码输入，322 全绿） | 🟢 已发布 |
| v4.7.0 | 2026-08-29 | 歌德 A1 备考工坊全面落地：702 官方考纲词汇（15 大真实主题、全量地道例句、准确复数）+ 8 套填表真题 (Schreiben Teil 1) + 10 套短电邮工坊 (Schreiben Teil 2 导向点诊断与满分范文) + 口语 Teil 2/3 考场题卡 + 3D 纸牌堆叠控制栏居中与响应式 UI 抛光（350 全绿） | 🟢 已发布 |
DeLector 遵循严谨的学术伴读工具演进路线，以下功能正在持续规划与研发中：
| 版本里程碑 | 计划新增功能 | 核心预期价值 | 状态 |
|---|---|---|---|
| v3.10.0 | 智能介词搭配数据集（原 v3.6.0 规划的 Präpositionen 落地） | 动词/形容词+固定介词格（如 achten auf + Akk）的高频索引，531 词条 / 660 搭配，查词抽屉逐条展示可存卡 | 🟢 已发布 |
| v3.11.0 | 德语写作润色台（Schreibwerkstatt） | 本地规则诊断（冠词/格位/介词格）+ 错误一键存 Anki 复习卡 + essays 草稿库 + 显式 AI 润色 | 🟢 已发布 |
| v3.12.0 | 写作台 IDE 化与版本快照 | AI 润色逐 hunk 并排审查 + 类 git 提交快照与可逆恢复 | 🟢 已发布 |
| v4.0.0 | IDE 式内联写作编辑器 | 行内波浪线诊断 + TreeWalker 光标记忆 + hover 气泡 + 一键替换修正 + 句子导航 + 只读快照预览与单项删除 | 🟢 已发布 |
| v4.1.1 | VSCode 级真实 Inline Inlay Hints | CSS 伪元素无 text node 内联排版 + 随文本推开不遮挡 + TreeWalker 纯净正文 0 污染 | 🟢 已发布 |
| v4.2.0 | Problems 全篇问题清单面板 | VSCode 式错误/提醒集中清单 + severity 分级与双格介词方向提示 + 一键定位与修正 | 🟢 已发布 |
| v4.3.0 | Android/移动端写作台 + 安全加固 | bottom-sheet、触屏纠错 + 存储型 XSS/SSRF/TTS 长度闸 | 🟢 已发布 |
| v4.4.0 | 可靠性与安全收口 | 敏感设置/备份仅回环可写、编码 keystore 拦截、CI 真构建与验签、写作零误报、备份/AI 失败回归（230 全绿） | 🟢 已发布 |
| v4.4.5 | 安卓资产解包版本闸 + 写作台交互统一 | 升级后前端立刻生效（不必卸载重装）、缓存闸移到服务端、三 Tab 点击语义一致（238 全绿） | 🟢 已发布 |
| v4.4.6 | 顶栏版本指示灯自洽 + 移动端 sheet 几何稳定 | 升级是否生效有了可信的肉眼指标；切 tab/填内容不再让面板整块跳；sheet 底部能滚到了（239 全绿） | 🟢 已发布 |
| v4.4.7 | 桌面端侧栏几何收口 + 三行触屏按压反馈 | 侧栏内容再长也能滚到底、tab 条吸顶；三种可点击行按下即有反馈（242 全绿） | 🟢 已发布 |
| v4.4.8 | 离线词库补齐 + SSRF 闸判定修正 | 45 个词头与 110 词尾缺口其实 AI 早就答了，是匹配器不认自己规定的格式；SSRF 闸改判内嵌目的 IPv4，堵住 6to4 走私内网地址；IPv6 保留段自己钉住，不外包给会随 Python 补丁版本变的 ipaddress 私有段表（266 全绿） |
🟢 已发布 |
| v4.4.9 | 按钮 token 体系 + 移动端 sheet 几何修正 + 重复键棘轮 | .btn-xs/.btn-del/.btn-secondary 三条缺失规则补上并分出 --danger token；.btn-sm 补 min-height: 30px 重置；移动端 sheet 闭包几何从 bottom: 4.75rem + translate(100% + 1rem) 改为 bottom: 0 + translate(100%) 沿用 reader drawer 同构模式，消除 60px 闭包条带遮 dock 的 bug；show() 切视图时清 writer mobile panel scrim + body lock；加「← 返回文库」与 reader 对称；全仓库 dict 字面量重复键棘轮（280 全绿） |
🟢 已发布 |
| v4.5.0 | Präpositionen-Matrix 介词矩阵视图 | 552 词 / 691 条固定搭配按介词分组浏览（21 组，按搭配数降序）：Dat/Akk/Gen 过滤、即时子串搜索、CEFR 标签、逐条一键入 FSRS 卡盒；数据一次拉完后全本地过滤（首版不带「已入卡」持久化标记，重进该段按钮回到未存态）（298 全绿） | 🟢 已发布 |
| v4.6.0 | 德语背词工作台集成 + 移动端语音修复 | 684 词背词工作台（FSRS-6 / 卡片复习 / 自测 / 统计 / 词库）iframe 嵌入 DeLector；GET /api/audio/tts 服务端 edge-tts 成为最高优先级音频源，攻克 iOS/Android 浏览器 file:// 协议禁 TTS 与设备缺德语语音包两大无声根因；备份覆盖 wb.* 学习进度键（314 全绿） |
🟢 已发布 |
| v4.6.1 | 背词台 TTS 修复 | 修 v4.6.0 报告的音频 bug：1) playWord 入口 cleanup 去掉 _ttsAudio.load()，避免 removeAttribute 后排队的异步 error 事件干扰 tryServer 的 onerror；2) 加 _ttsAttemptId 全局守卫，stale 的超时/onerror/onplaying handler 检测 ID 不匹配直接 return，不再交叉干扰后续点击；3) tryServer 超时从 6s 降到 3s，桌面 localhost edge-tts 通常 <1s；发版后补 2 条回归测试钉住前两条（入口清理无 .load() / 每个共享 _ttsAudio 的异步回调都有 attempt 守卫）（316 全绿） |
🟢 已发布 |
| v4.6.2 | 卡盒交互修复 + 伴读宠物 + 自测范围 | 1) 伴读宠物在背词台视图自动隐藏（不盖住设置按钮）；2) 自测新增「复习不认识（评过 Again）」范围，addWrong 写入 rv 标记；3) 卡盒翻转 onclick 从容器移到正面，背面评分按钮加 stopPropagation，Android 3D 变换下不再误触翻转；4) toggleDeckFlip 加 200ms 防抖，阻断 Android 双击事件抖动导致的「翻了又翻回来」（316 全绿） |
🟢 已发布 |
| v4.6.3 | 工作台导出修复 + 卡盒 swipe 拦截 | 1) 工作台导出 Android 静默失败（blob: URL 在 Android WebView 不触发下载），改为走服务端 /api/wb/backup/prepare → /api/wb/backup/download/{token} 通道；2) 卡盒背面评分按钮被 swipe 手势吞掉，deckFlipped 时跳过 swipe 监听器（316 全绿） |
🟢 已发布 |
| v4.6.4 | 介词矩阵已存状态持久化 | 新增 prep_saved 表与 GET/POST /api/prep/saved 端点，介词矩阵搭配「已入卡」状态服务端持久化与随备份导出恢复，重进该段/刷新页面状态保持（319 全绿） |
🟢 已发布 |
| v4.6.5 | 局域网 WebRTC 6 位短码免复制同步 | 替代 2-3KB SDP 手动复制粘贴，A 生成 6 位大字码、B 手机端直接输入即可快速 P2P 握手与双向学习进度自动合并（322 全绿） | 🟢 已发布 |
| v4.7.0 | 歌德 A1 备考工坊 (Goethe-Zertifikat A1 Werkstatt) | 702 官方考纲词汇（15 大真实主题、全量地道例句、准确复数、0 模板句）+ 8 套填表真题 (Schreiben Teil 1) + 10 套短电邮工坊 (Schreiben Teil 2 导向点诊断与满分范文) + 口语 Teil 2/3 考场题卡 + 3D 纸牌堆叠控制栏居中与响应式 UI 抛光（350 全绿） | 🟢 已发布 |
| v4.8+ | 歌德 / 德福历年真题语料库预置 | 内置官方样题语料，支持按话题分类一键载入工作台 | ⚪ 筹备中 |
- Python 3.10+
- spaCy 德语模型 (
de_core_news_sm或de_core_news_md)
# 启动本地工作站
python start.py
# 或 Windows 直接双击 start.bat
# 打开浏览器访问
http://localhost:8000DeLector — 让德语精读与应试备考，变得清晰、深刻、从容。