Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明
Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明 项目地址:Microsoft Store - Ebook Voice Player 前言 在数据隐私日益受重视的今天,Ebook Voice Player 从架构层面确立 隐私优先 设计原则:书籍内容本地解析、仅合成请求文本上云、无账号体系、无遥测上报、无广告追踪。本文深度剖析其隐私架构设计、数据流向分
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 源码
隐私政策:在线阅读
Originally published by Dev.to Security. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.