Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明
前言
在数据隐私日益受重视的今天,Ebook Voice Player 从架构层面确立 隐私优先 设计原则:书籍内容本地解析、仅合成请求文本上云、无账号体系、无遥测上报、无广告追踪。本文深度剖析其隐私架构设计、数据流向分析、防火墙验证指南,以及如何通过代码审计验证隐私承诺。
1. 隐私设计原则
| 原则 | 实现方式 | 用户价值 |
|---|---|---|
| 本地优先 | 文档解析、章节检测、书签笔记、进度记忆全本地 | 书籍内容永不离开设备 |
| 最小化上云 | 仅将待合成文本片段发送 edge-tts,不含元数据/标识符 | 合成请求无法关联用户身份 |
| 无账号体系 | 纯本地配置存储,无注册/登录/云同步 | 零身份关联风险 |
| 无遥测上报 | 代码中无任何 analytics/telemetry/crash reporting SDK | 使用行为不被记录 |
| 无广告追踪 | 无广告 SDK、无第三方统计、无指纹追踪 | 纯净体验 |
| 数据流向透明 | 网络请求仅指向 *.azure.com / *.microsoft.com | 可防火墙验证 |
2. 数据流向全景图
┌─────────────────────────────────────────────────────────────────────────────┐ │ USER DEVICE │ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────────┐ │ │ │ Document Files │───▶│ Local Parser │───▶│ Paragraphs (RAM) │ │ │ │ (TXT/PDF/EPUB/ │ │ (reader.py) │ │ - Zero network │ │ │ │ DOCX/HTML) │ │ - No cloud │ │ - Full content │ │ │ └──────────────────┘ └──────────────────┘ └──────────┬───────────┘ │ │ │ │ │ ┌───────────────────────────────────┘ │ │ ▼ │ │ ┌──────────────────────────────────────────────────────────────────────┐ │ │ │ TTSService (Local Orchestration) │ │ │ │ - Playback state machine │ │ │ │ - Audio queue management │ │ │ │ - Bookmarks/Notes/Progress (local JSON) │ │ │ └──────────────────────────────────┬───────────────────────────────────┘ │ │ │ │ │ ┌────────────────┴────────────────┐ │ │ ▼ ▼ │ │ ┌─────────────────────────────┐ ┌─────────────────────────────────┐ │ │ │ Local Cache │ │ Network (HTTPS) │ │ │ │ ~/.tts_ebook_reader/ │ │ *.azure.com / *.microsoft.com │ │ │ │ audio_cache/c_<hash>.mp3 │ │ POST /cognitiveservices/v1 │ │ │ │ - SHA256(content|voice|rate) - Text only │ │ │ │ - Atomic write + validate - No user ID │ │ │ │ - User manually clearable - No metadata │ │ │ └─────────────────────────────┘ └─────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────────────────────────────────────────────────────────┐ │ │ │ Audio Playback (Local) │ │ │ │ - Kivy SoundLoader → SDL2 → System Audio │ │ │ │ - Zero network during playback │ │ │ └──────────────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────────────┘ 3. 核心隐私机制详解
3.1 文档解析零网络
# reader.py - 所有解析器均为纯本地库调用 def read_txt(filepath, encoding=None): # 纯文件 IO + 编码探测,无任何网络请求 ... def read_pdf(filepath): # PyMuPDF / pdfplumber 纯本地解析 # 即使是加密 PDF,也仅在本地尝试解密 ... def read_epub(filepath): # ebooklib + BeautifulSoup 纯本地 DOM 遍历 # EPUB 内部资源(图片/CSS/字体)仅读取不上传 ... def read_docx(filepath): # python-docx 纯本地 XML 解析 ... 验证方法:断网状态下打开任意格式文档,均可正常解析、显示章节、跳转段落。
3.2 合成请求最小化
# tts_engine.py - TTSGenerator.gen_one() async def gen_one(idx, text): # 仅发送:文本内容 + 语音 ID + 语速 # 不发送:文件名、章节名、用户设置、设备信息、IP 以外标识 communicate = edge_tts.Communicate(text, self.voice, rate=rate_str) await communicate.save(str(tmp_file)) 请求负载分析:
POST https://<region>.tts.speech.microsoft.com/cognitiveservices/v1 Headers: - Authorization: Bearer <短期 token> (边缘服务自动获取,无用户凭证) - Content-Type: application/ssml+xml - X-Microsoft-OutputFormat: audio-24khz-48kbitrate-mono-mp3 Body (SSML): <speak version='1.0' xml:lang='zh-CN'> <voice xml:lang='zh-CN' xml:gender='Female' name='zh-CN-XiaoxiaoNeural'> <prosody rate='+10%'>第 一 章 正文 内容...</prosody> </voice> </speak> 关键点:
- 无 Cookie、无 User-Agent 标识用户
- Token 由 edge-tts 库自动从公共端点获取,非用户登录态
- 同一段落同一语音同一语速 → 相同缓存键 → 二次请求命中本地缓存,零网络
3.3 本地存储:仅配置与进度
# main_screen.py - save_settings() def save_settings(self): data = { "font_size": self.font_size, "line_spacing": self.line_spacing, "page_margin": self.page_margin, "dark_mode": self._dark, "ui_lang": get_language(), # 仅 UI 语言偏好 "recent_files": self.recent_files, # 本地文件路径列表 "bookmarks": self.bookmarks, # {file, paragraph, label} "annotations": self.annotations, # {paragraph: note_text} "reading_stats": { # 仅统计计数 "total_sec": self._stats["total_sec"], "total_paras": self._stats["total_paras"], }, "last_file": self._last_file, # 最后打开文件路径 "last_position": self._last_position, # {file, paragraph} } # 存储位置:%APPDATA%\EbookVoicePlayer\settings.json (Windows) # 或 ~/.config/EbookVoicePlayer/settings.json (Linux/Android) with open(self._settings_path(), "w", encoding="utf-8") as f: json.dump(data, f, ensure_ascii=False, indent=2) 存储内容清单:
| 字段 | 含义 | 敏感度 |
|------|------|--------|
| font_size 等 | UI 偏好 | 无 |
| recent_files | 本地路径列表 | 低 (仅本机可读) |
| bookmarks | 书签位置+标签 | 低 (用户主动创建) |
| annotations | 笔记文本 | 中 (用户输入内容) |
| reading_stats | 累计时长/段数 | 无 |
| last_file/position | 续读位置 | 低 |
不存储:书籍全文、合成音频(缓存目录单独管理)、网络身份、使用时间戳序列。
3.4 缓存隔离与用户控制
# tts_engine.py - get_cache_dir() & cleanup() def get_cache_dir(): app = App.get_running_app() if app is not None: base = Path(app.user_data_dir) # 系统分配的应用私有目录 else: base = Path.home() / ".tts_ebook_reader" d = base / "audio_cache" d.mkdir(parents=True, exist_ok=True) return d def cleanup(self): """用户手动清理 / 卸载时自动清理""" for f in get_cache_dir().glob("*.mp3"): try: f.unlink() except OSError: pass self._stale = [] 缓存特性:
- 位于应用沙箱目录,其他应用不可访问
- 文件名为
c_<SHA256前16位>.mp3,无法从文件名推断内容 - 用户可随时通过菜单「工具→清理音频缓存」一键清空
- 卸载应用时系统自动清理沙箱目录
4. 网络连接白名单与防火墙验证
4.1 仅允许的出站域名
| 域名模式 | 用途 | 协议/端口 |
|---|---|---|
*.azure.com | edge-tts 语音合成端点 | HTTPS/443 |
*.microsoft.com | Token 获取、CDN | HTTPS/443 |
4.2 Windows 防火墙验证脚本
# 1. 创建仅允许上述域名的出站规则 New-NetFirewallRule -DisplayName "EbookVoicePlayer Allow TTS" ` -Direction Outbound -Action Allow ` -Program "C:\Program Files\WindowsApps\nannan2008.EbookVoicePlayer_*\TTSReader.exe" ` -RemoteAddress (Resolve-DnsName "*.azure.com", "*.microsoft.com" -Type A).IPAddress # 2. 禁用其他出站 New-NetFirewallRule -DisplayName "EbookVoicePlayer Block Other" ` -Direction Outbound -Action Block ` -Program "C:\Program Files\WindowsApps\nannan2008.EbookVoicePlayer_*\TTSReader.exe" ` -RemoteAddress Any # 3. 验证:Wireshark 抓包仅见 TTS 请求 # 过滤器: http.host contains "azure" or http.host contains "microsoft" 4.3 Wireshark 抓包预期结果
正常会话仅包含: 1. DNS 查询: <region>.tts.speech.microsoft.com 2. TLS 握手 (TLS 1.2/1.3) 3. HTTP/2 POST /cognitiveservices/v1 (SSML body) 4. HTTP/2 200 OK (MP3 binary response) 5. 后续播放零网络流量 异常指标(均不应出现): ❌ 任何 analytics/telemetry 端点 ❌ 任何广告/追踪域名 ❌ 任何非 azure/microsoft 域名 ❌ 任何非 443 端口连接 ❌ 任何周期性心跳/上报流量 5. 代码审计指南:如何验证隐私承诺
5.1 关键词搜索清单
# 1. 搜索网络请求库引用 grep -r "requests\|httpx\|aiohttp\|urllib\|socket" --include="*.py" . # 预期结果:仅在 tts_engine.py 中通过 edge_tts 间接使用 # 2. 搜索遥测/统计关键词 grep -ri "telemetry\|analytics\|tracking\|metrics\|sentry\|crashlytics\|firebase\|amplitude\|mixpanel" --include="*.py" . # 预期结果:零匹配 # 3. 搜索广告 SDK grep -ri "admob\|adsense\|unityads\|applovin\|chartboost\|vungle\|ironsource" --include="*.py" . # 预期结果:零匹配 # 4. 搜索账号/认证相关 grep -ri "oauth\|login\|register\|account\|password\|token\|jwt\|api_key" --include="*.py" . # 预期结果:仅 edge-tts 内部 token 处理,无用户认证流程 # 5. 搜索数据上传 grep -ri "upload\|sync\|backup\|cloud\|remote.*config" --include="*.py" . # 预期结果:零匹配 5.2 依赖包审计
# requirements.txt edge-tts==6.1.9 kivy==2.3.0 python-docx==1.1.0 PyMuPDF==1.23.0 pdfplumber==0.10.0 ebooklib==0.18 beautifulsoup4==4.12.0 lxml==4.9.0 # 审计要点: # - 无 requests/httpx 等直接 HTTP 库(edge-tts 内部使用 aiohttp) # - 无 telemetry/analytics 相关包 # - 无广告 SDK 依赖 # - 所有依赖为知名开源库,源码可审计 5.3 运行时行为审计
# 启动时监控网络连接 (Windows) # 使用 TCPView / Resource Monitor / Wireshark # 1. 启动应用 → 无网络连接建立 # 2. 打开本地 EPUB → 无网络连接 # 3. 点击播放 → 建立到 *.azure.com:443 的 TLS 连接 # 4. 暂停/停止 → 连接保持或关闭,无新连接 # 5. 切换语音/语速 → 新建合成连接,旧连接复用 # 6. 待机 10 分钟 → 零心跳连接 # 7. 关闭应用 → 所有连接关闭 6. 对比:典型隐私风险点与本应用对策
| 风险点 | 典型 App 做法 | Ebook Voice Player 对策 |
|---|---|---|
| 书籍内容上传 | 云端解析/同步阅读进度 | 纯本地解析,进度仅存本地 JSON |
| 用户画像构建 | 收集阅读偏好/时长/书籍元数据上报 | 无任何上报,统计仅留本地 |
| 第三方追踪 | 集成 Firebase/Adjust/友盟等 | 无任何第三方 SDK |
| 广告投放 | 插屏/横幅/原生广告 | 无广告代码、无广告位 |
| 账号强绑定 | 必须登录才能用 | 无账号体系,开箱即用 |
| 数据导出困难 | 云端锁定,导出受限 | 配置/书签/笔记均为本地 JSON,随时可拷贝 |
| 卸载残留 | 注册表/云端数据保留 | 沙箱目录随卸载自动清理 |
| 合成内容泄露 | 服务端日志记录全文 | 仅边缘服务临时处理,无持久化日志(微软隐私条款) |
7. 企业/敏感场景部署建议
7.1 完全离线方案(内网/保密环境)
# 1. 预热缓存:在联网环境批量合成所需章节 # - 打开书籍 → 全选导出 MP3 (菜单: 工具→导出为音频文件) # - 导出完成后,缓存目录已包含所有段落音频 # 2. 断网部署:将安装包 + 缓存目录拷贝到目标机器 # - 安装应用 # - 将缓存目录拷贝到 %APPDATA%\EbookVoicePlayer\audio_cache\ # 3. 离线使用:完全断网状态下 # - 打开书籍 → 解析正常 # - 播放 → 直接读取缓存 MP3,零网络 # - 书签/笔记/进度 → 全本地保存 7.2 防火墙策略模板
# 企业防火墙/代理策略示例 rules: - name: "EbookVoicePlayer TTS Allow" action: allow app: "TTSReader.exe" dst_domains: - "*.azure.com" - "*.microsoft.com" dst_ports: [443] protocol: tcp - name: "EbookVoicePlayer Default Deny" action: deny app: "TTSReader.exe" dst: any log: true 8. 合规性声明
| 合规维度 | 状态 | 说明 |
|---|---|---|
| GDPR | 合规 | 无个人数据收集,无数据主体权利诉求场景 |
| CCPA | 合规 | 不出售个人信息,无追踪 |
| 中国个人信息保护法 | 合规 | 无个人信息处理活动 |
| Microsoft Store 政策 | 合规 | 通过认证上架,隐私声明公开 |
| 儿童在线隐私保护 (COPPA) | 合规 | 不收集 13 岁以下儿童数据 |
隐私政策链接:privacy.html
9. 未来隐私增强路线图
- [ ] 本地 TTS 引擎集成 (Piper/Coqui) - 彻底离线合成,零云端依赖
- [ ] 端到端加密同步 (可选) - WebDAV 加密同步书签/进度,密钥用户自管
- [ ] 差分隐私统计 (可选) - 本地聚合后仅上报模糊统计,用户可完全关闭
- [ ] 审计日志导出 - 一键导出应用所有网络请求记录供合规审计
10. 结语
Ebook Voice Player 以 代码即契约 的方式兑现隐私承诺:
- 架构层面隔离:解析/播放/存储全本地,仅合成最小文本上云
- 代码层面透明:零遥测、零广告、零账号、依赖可审计
- 运行时可验证:防火墙白名单、Wireshark 抓包、断网测试全通
- 用户掌控权:缓存可清、配置可导出、卸载无残留
在「数据即资产」的时代,选择一款不把你的阅读当商品的工具,是对自己隐私的基本尊重。
体验地址:Microsoft Store - Ebook Voice Player
源码审计:GitHub - 可完整审计的 Python 源码
隐私政策:在线阅读
