Repository navigation
🌟 DeLector v5.17.0 正式发布
面向德语精读与歌德（Goethe A1–C1）、德福（TestDaF）、DSH 备考者的本地优先学术级伴读工作台。三种形态共用同一后端：原生桌面窗口 / 便携版（Windows · macOS · Linux）/ Android 独立单机版。
📜 逐版完整变更（含门禁与回滚说明）见仓库
CHANGELOG.md；完整能力清单见FEATURES.md。
📦 多平台下载与安装
- 🪟 Windows x64 便携版：
DeLector-v5.17.0-Windows-x64-Portable.zip—— 解压双击DeLector.exe打开原生桌面窗口 + 系统托盘（无浏览器标签）。⚠️ 需 Win10+ 与 WebView2 运行时（Win11 自带）；学习数据默认落在%LOCALAPPDATA%\DeLector（升级时请勿删除该目录）。 - 🍎 macOS 免安装包：
DeLector-v5.17.0-macOS.tar.gz—— 解压运行start，自动起服务并打开默认浏览器。 - 🐧 Linux x64 便携版：
DeLector-v5.17.0-Linux-x64.tar.gz—— 解压运行start，全发行版通用。 - 📱 Android 独立单机版：
DeLector-v5.17.0-Android.apk—— 内嵌 Python 运行时 + spaCy 离线模型 + 原生离线 TTS 桥接，arm64-v8a；CI 钉死签名 keystore 并验签（可覆盖升级）。
🚀 核心能力
- 📖 学术级精读台：CEFR 词阶热力谱 · 0ms 歌德核心离线词库 · 四色荧光笔与便签 · AI 语法剖析 · 打印级《精读指南》导出
- ⚡ 形态学引擎：556+ 强变化动词三态表 · 复合词递归拆解 · 552 词 / 691 条固定介词搭配 · 可分动词框形双向联动
- 🌳 句法引擎：德语拓扑五场域（VF/LK/MF/RK/NF）色谱条 · 5 大从句 AST 抽象语法树 · 正文微光光圈联动 · 一键制 Anki 语法卡
- 🔍 全库检索：词条 / 例句 / 介词搭配 / 语料 四组检索（变音折叠 + 中文子串 + 加权排序）
- 🎴 卡盒与记忆：3D 物理翻转盒 · FSRS（DSR）自适应排程 · 背词工作台（VOKABELN，与主背词共享统一池）· Anki
.apkg一键导出 - 🎯 备考工坊：歌德 A1 读写听说（702 考纲词 / 真题 / 口语题卡）· 德福 C-Test 与完形填空（服务端判分防作弊）· 听力微训（精听 / 听写 / 填空）· 长难句精读工坊
- 📚 遇见区分级阅读：7 篇 A1–B1 预置短文 · 已背词高亮 · i+1 就近选材 · 已读队列
- ✍️ 写作润色台：内联 IDE 实时诊断（零误报准则）+ Inlay Hints · 类 Git 版本快照 · 句子级 AI 润色并排审查
- 📰 外刊 RSS 与文库：Tagesschau / DW / DLF / Spiegel / Zeit 订阅 · 正文智能抽取 · 一键联级删除
- 🦉 伴读宠物与台账：Eule & 伙伴（4 款内嵌矢量角色 + 自定义 SVG 上传 + 9 大场景德语 TTS）· Atelier 呼吸感台账 · 一键数据备份还原
- 🌐 同步与桌面形态：局域网静默同步（6 位短码 P2P / WebRTC 加密通道）· 原生桌面窗口（pywebview + 系统托盘）· 顶栏「检查更新」chip
🖥️ 本版重点（v5.17.0）
- 首个原生桌面窗口：
DeLector.exe现在打开独立窗口（pywebview走系统 Edge WebView2）+ 系统托盘。此前"退出不干净 ⇒ 下次盲复用端口"会让人以为升级了、其实跑的是旧进程，这条已收口。⚠️ Win10 需先装 WebView2 运行时（Win11 自带）。 - 数据落点外置：桌面 / 便携版的学习数据默认改放
%LOCALAPPDATA%\DeLector（首次启动自动迁移，旧位置留.bak）⇒ 此前"解压覆盖升级 = 学习记录全空且零提示"的坑已堵死。升级时请不要删除该目录；想回到"数据随程序目录"可设DELECTOR_PORTABLE=1。 - 更新可见性：顶栏新增"落后"提示 chip（
GET /api/update/check代查 GitHub Releases），桌面端可用。 - 随本版到达的修复（此前已装用户拿不到——
static/内嵌在产物里，必须重下新产物）：错高亮改为在原文上定位命中；文章列表成本 918ms → 8.9ms；静态首屏少 383 KB；四条 P0（建服前端口 / 身份校验、get_setting不再吞异常、阅读器打开失败可见、评分防连点）；"列表显示 A2 → 点进去 A1"的难度跳变（构建期预生成）；spaCy 模型惰性加载（冷启动 3123 → 2128ms）。
⚠️ 已知限制（本版明文登记）
- 冷启动端到端约 6s（本机实测）：其中约 2s 是「建服前的端口 / 身份校验」——本版新引入的显式校验（用于拦住"旧进程冒充新构建"），另有约 2s 加载后端依赖。请勿把这段读作提速卖点；数据面优化已生效（文章列表 918ms → 8.9ms）。
launch.log有已知的整行丢失（Windows 上多个句柄并发追加同一文件，实测约 3%、整行而不是半行）：排查启动问题时若日志缺行，先按此排除；tools/first_screen_from_log.py报退出码 3/5（缺锚行）不必然等于日志损坏。- Win10 需先装 WebView2 运行时（Win11 自带）：缺运行时双击
DeLector.exe会提示安装后退出，不会白屏。 - Android
versionCode只升不降（本版51700）：一次坏发布装不回旧版，只能卸载重装（会清掉应用私有数据，请先导出备份）。 - 数据落点已外置：桌面 / 便携版数据在
%LOCALAPPDATA%\DeLector，升级时不要删除该目录；回退到旧版本需把库手工拷回程序目录。