Dev.to Security 🔐 Cybersecurity 👁 0 📖 3 min read

Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明

Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明 项目地址:Microsoft Store - Ebook Voice Player 前言 在数据隐私日益受重视的今天,Ebook Voice Player 从架构层面确立 隐私优先 设计原则:书籍内容本地解析、仅合成请求文本上云、无账号体系、无遥测上报、无广告追踪。本文深度剖析其隐私架构设计、数据流向分

Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明

Ebook Voice Player 隐私优先架构设计:本地解析、最小化上云、数据流向全透明

项目地址:Microsoft Store - 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 以 代码即契约 的方式兑现隐私承诺:

  1. 架构层面隔离:解析/播放/存储全本地,仅合成最小文本上云
  2. 代码层面透明:零遥测、零广告、零账号、依赖可审计
  3. 运行时可验证:防火墙白名单、Wireshark 抓包、断网测试全通
  4. 用户掌控权:缓存可清、配置可导出、卸载无残留

在「数据即资产」的时代,选择一款不把你的阅读当商品的工具,是对自己隐私的基本尊重。

体验地址:Microsoft Store - Ebook Voice Player

源码审计:GitHub - 可完整审计的 Python 源码

隐私政策:在线阅读

📰 Read the original article on Dev.to Security

Originally published by Dev.to Security. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.