一个运行在 Android TV(及机顶盒/投影仪)上的第三方阅读客户端,可连接微信读书账号,为遥控器阅读而设计。
声明:本项目为非官方客户端,仅供个人学习与技术研究使用。请勿用于商业用途或公开分发。 详见文末免责声明。
VSCode 上的 TouchFish 插件把微信读书搬进了编辑器。本项目把它的微信读书模块复刻到了 Android TV 上,并针对遥控器操作和大屏阅读做了重新设计:
- 书架、阅读、进度云同步与官方服务器互通(手机读到哪,电视接着读)
- 翻页设计为整页换页:按行网格切分,任何一页都不会出现半行字
- 阅读界面支持主题(浅色/深色/任意自定义色)、字号、行距、页边距、翻页方向等排版调整
- 支持书内注释(脚注)浏览
| 书架 | 阅读 |
|---|---|
![]() |
![]() |
| 注释 | 设置 |
|---|---|
![]() |
![]() |
- 扫码登录(电视上显示二维码,手机微信扫码;支持验证码兜底)
- 书架浏览(按最近阅读排序,封面网格)
- 章节阅读:正文分页渲染、章节跳转、目录导航
- 阅读进度:章节内精确到段落的位置会在本地保存,退出重进或换排版后回到原处;同时同步到云端
- Cookie 自动续期(长期不用掉登录)
- 章节预加载(翻章基本无等待)
- 书内注释:支持行内图片注释与章尾
[n]锚点注释——正文只显示上标序号,长按 OK 或顶栏「注释」查看全文 - 主题:5 种预设色 + 1 个自定义保存色 + 连续色盘(色相/饱和度/明度)+ 十六进制色值输入
- 暗黑模式:独立的纯黑 + 浅灰配色,开关不影响已保存的背景色
- 字体:内置 7 种开源字体(思源宋体/思源黑体/霞鹜文楷/霞鹜新晰黑/悠哉字体/未来荧黑/得意黑),可另选系统默认或等宽;支持正文加粗
- 排版:字号(1px 步进)、字体颜色浓淡、字体样式(二级选择)、文字加粗、行距、左右边距、上/下边距独立调节、翻页方式(平滑/瞬时)、翻页方向(左右/上下)、长按行为
- 阅读页四角信息:时间 / 章节号 / 章节名 / 当前页/本章节页 / 本章进度 / 全书进度 / 书名 / 无,四个角可分别设置,悬浮显示不占边距
- 自动滚动:连续纵向滚动,顶栏「滚动」可随时切换;支持匀速与「按可见字数自适应」两种速度模式,速度 1-10 级;方向键每次滚动行数可调(默认 3 行)
- 离线朗读:内置 sherpa-onnx 引擎,首次在设置中下载小雅 int8 中文模型(约 14MB)后完全离线;按当前进度朗读,读完自动下一章
- 目录快速跳跃:长按方向键达到设定时间后进入快速模式,每次跳过可配置的章节数
- 自动检查更新:启动时检查 GitHub Releases,可直接下载安装(带进度条),支持后台下载与静默下载、多线路测速、忽略版本 / 关闭检查
- 账号面板:查看登录状态、刷新书架、退出登录
| 操作 | 阅读页 | 书架页 |
|---|---|---|
| 方向键 | 翻页(章末继续按 → 下一章) | 移动焦点 |
| 长按方向键 | 跳到上一章 / 下一章(可在设置中改为连续快进) | — |
| OK | 呼出目录 | 打开书 |
| 长按 OK | 本章注释列表 | — |
| 目录页长按方向键 | 达到设定时间进入快速跳跃(默认 10 秒 / 100 章) | — |
| 返回键 | 第一次呼出顶栏(含提示)→ 再按回书架 | 退到桌面 |
| 菜单键 | 打开设置 | 打开设置 |
adb connect <电视IP>:5555 # 需先在电视上开启 ADB 调试
adb install WCReader-1.0.19.apk把 APK 拷到 U 盘,插入电视,用电视自带的文件管理器安装。
安装时如提示“未知来源”,请在系统设置中允许安装。
需要 JDK 17 与 Android SDK(local.properties 中配置 sdk.dir)。
gradle assembleDebug
# 产物:app/build/outputs/apk/debug/app-debug.apk- 纯 Kotlin + Android SDK,无第三方运行时依赖(OkHttp 除外)
- 阅读正文使用 WebView 渲染,CSS 多栏布局实现真实分页(epub.js 同款机制)
- 接口与加解密算法移植自 TouchFish,并做过逐项对拍验证
- ylw1997/touchFish — 微信读书接口逆向、请求签名与章节解密算法均来自该项目(MIT License)
- truefedex/tv-bro — Android TV 遥控器交互参考
内置阅读字体均为 SIL Open Font License 1.1 开源字体(Google Fonts 与作者官方发布版):
- 思源宋体 / Noto Serif SC
- 思源黑体 / Noto Sans SC
- 霞鹜文楷 Lite / 霞鹜新晰黑(LXGW)
- 悠哉字体(LXGW Yozai)
- 未来荧黑 / Glow Sans
- 得意黑 / Smiley Sans
许可全文见 app/src/main/assets/fonts/OFL.txt。
- 非官方项目:本项目与腾讯公司及「微信读书」无任何关联,不是官方客户端。
- 仅供学习研究:代码用于学习 Android TV 开发、WebView 排版与网络协议分析,请勿用于商业用途。
- 请勿分发:微信读书用户协议禁止使用第三方客户端访问其服务。请勿公开分发本应用或将其上传至任何应用商店,由此产生的一切后果由使用者自行承担。
- 账号风险:使用非官方客户端可能导致账号被风控,风险自负。
- 接口稳定性:本项目依赖微信读书 Web 端的非公开接口,官方更新可能导致功能失效,恕不保证持续可用。
- 版权:书籍内容版权归原作者及版权方所有,本项目不存储、不传播任何书籍内容。
仅供学习交流,未授权任何商业使用。



