【deepin插件开发活动】老崔PDF阅读工具：Deepin 25 文档阅读器 Piper 语音跟随朗读

项目简介

一款托盘常驻的 PDF 跟随朗读工具，配合 Deepin 25 系统文档阅读器（deepin-reader，玲珑版）使用：
自动识别当前打开的 PDF、从上次阅读位置续读、Piper 神经语音逐页朗读（中文少女音），纯本地离线、无需联网。

参赛方向：桌面效率工具（PDF 朗读助手）
使用 Skill：Qt6/C++ 桌面开发、Poppler、Piper TTS
开发工具：UOS AI 助手（小U同学）
开源协议：GPL-3.0-or-later

这是什么？

灵感来自"看 PDF 看到眼睛酸，想让它读出来"：

自动跟随：deepin-reader 打开 PDF → 托盘工具自动识别文档（/proc fd 轮询，兼容玲珑容器）
位置续读：从 deepin-reader 的 user.db 读取上次阅读位置，打开即续读
少女音朗读：Piper TTS 神经语音（huayan-medium 中文女声模型），声音自然清亮、无回音
无缝衔接：流水线预合成机制，播放当前页时后台合成下一页，页间无停顿
简洁面板：右下角悬浮圆角卡片，两行布局（上页/播放/下页 + 页码框/语速），可拖动记忆位置
托盘标识：蓝底白"读"字图标，与其他应用明显区分

技术亮点

全自包含打包（116MB deb）：Qt6/Poppler/espeak 动态库 + Piper 模型 + Python 运行时全部内置，安装即用、无需联网下载
双引擎：Piper 神经语音优先，模型缺失自动降级 espeak-ng，功能不中断
C++17 + Qt6 纯本地实现，无云依赖，断网可用

安装

方式一：直接安装 deb（推荐）

sudo apt install ./cspdfreader_1.0.0_amd64.deb

（附件：cspdfreader_1.0.0_amd64.deb，116MB 全自包含）

方式二：源码构建

git clone <仓库地址> CSPDFREADER
cd CSPDFREADER
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
./build/CSPDFREADER

（附件：cspdfreader_submit.tar.gz 含全部源码、构建脚本、设计文档）

环境要求

Deepin 25（x86_64 / AMD64）
依赖：libc6, libstdc++6, libgcc-s1, python3 >= 3.12（系统自带）
配合 deepin-reader 使用；也支持手动打开任意 PDF

卸载

sudo apt purge cspdfreader

截图

控制面板：右下角悬浮两行布局（[上页][播放][下页] / [页码框][语速]），右上角 ✕ 退出
托盘图标：蓝底白"读"字（展开任务栏托盘可见）随后补充github链接

https://github.com/cuisir7236/CSPDF

安装后需要手工执行该命令

sudo apt update && sudo apt install libespeak-ng1

cspdfreader_submit.tar.gz cspdfreader_submit.tar.gz| 文件 | 说明 |
| --------------------------- | --------------------------------------- |
| cspdfreader_1.0.0_amd64.deb | 安装包（116MB 全自包含） |
| cspdfreader_submit.tar.gz | 完整源码（含 README/设计文档/构建脚本） |

Reply Like 1 Favorite View the author

All Replies