whykang / ssts

# 随身听书
参照 eprendre/tingshu 的自定义源机制，用 WPF 编写的 Windows 听书程序。
本程序只是播放器，不提供任何内容，所有音频都来自第三方网站，请支持正版。
> **安卓版和 iOS 版**在这里下载：whykang/ssts--Android（插件和电脑版通用）
## 下载
最新版本：**v5.3**（全部版本和更新说明）
| 文件 | 适用 |
|---|---|
| ssts-mac-5.3.dmg | Mac 版 5.3（Apple 芯片和 Intel 通用，macOS 14.6 及以上） |
| Sources-v5.3.zip | 听书源插件 5.3（34 个源，Windows 版、Mac 版通用，和安卓、iOS 也通用） |
| ssts-5.3.0-win-x64.zip | Windows 版 5.3：绝大多数电脑（64 位 Windows 10 / 11） |
| ssts-5.3.0-win-x86.zip | Windows 版 5.3：32 位旧电脑 |
| ssts-5.3.0-win-arm64.zip | Windows 版 5.3：ARM 笔记本 |
1. Windows：下载程序，解压后直接运行“随身听书.exe”，不需要安装其它东西。
 Mac：打开 dmg，把“随身听书”拖进“应用程序”；第一次打开如果被系统拦住，在“系统设置 → 隐私与安全性”里点“仍要打开”。
2. 程序本身不带任何听书源：下载上面的插件包（不用解压），在程序的“插件”页点“导入”选择它，或者直接把它拖进“插件”页。
 也可以在“插件”页从网址导入：`https://gitee.com/whykan/ssxz/raw/master/Sources-v5.3.zip`
**Mac 版 5.3 的更新**：
- 新增云同步：在“设置 → 云同步”里填上坚果云账号（WebDAV），书架、播放记录、每本书听到哪里、书签可以和安卓、iOS 互相同步；书架右上角可以手动同步
- 新增书签：播放页右上角可以在当前位置加书签、写备注，点书签就跳回那里接着听；详情页菜单里也能看这本书的书签
- 新增预缓存：播放时提前把这一集和后面几集下到本机，听过去的自动删掉
- 定时结束前渐弱：定时快到时最后 30 秒慢慢调低音量再暂停（设置里可以关）
- 内置的“云听”：央广频道（中国之声、经济之声等）可以回听最近 7 天播过的节目
- 书籍详情页点来源名字，直接跳到发现页看这个源
**插件 5.3**（34 个源）：新增 13听书网；爱听书、13听书网等在插件页登录后能显示“已登录”；网易云播客上千集的有声书能全部列出来（以前最多 200 集）；喜马拉雅搜索能搜到付费、会员专辑；修复爱听书有的设备上播放时报证书错误。
**Windows 版 5.3 的更新**：
- 新增云同步：在“设置 → 云同步”里填上坚果云账号（WebDAV），书架、书架分类、播放记录、每本书听到哪里、书签可以和安卓、iOS、Mac 互相同步；书架右上角可以手动同步
- 新增书签：播放页和详情页右上角可以在当前位置加书签、写备注，点书签就跳回那里接着听
- 定时结束前渐弱：定时快到时最后 30 秒慢慢调低音量再暂停（设置里可以关）
- 内置的“云听”：央广频道（中国之声、经济之声等）可以回听最近 7 天播过的节目
- 书籍详情页点来源名字，直接跳到发现页看这个源
- 音频服务器开了人机验证（Cloudflare）时，播放前自动通过一次
- 修复：程序退出时会把没播放过的进度写回书架，盖掉从别的设备同步来的进度
详见 v5.3 的发布说明。
## 界面预览
**发现**：按源浏览分类，点标题切换听书源；内置的“云听”可以收听各地的广播电台
**书架**：收藏的书可以分类，和最近播放分开；右边的按钮直接接着听
**详情**：左边是书的信息，右边是章节，可以筛选、定位到上次听到的地方、倒序
## 功能
- **通用插件**：程序本身不带任何听书源，所有源都来自导入的插件，一个插件可以包含多个源（开发指南）
 - **脚本插件**：一个 zip 包，里面是 `manifest.json` 和 JavaScript 脚本，用文本编辑器就能写，导入后立即生效
 - **DLL 插件**：C# 编写，引用 TingShu.Sdk 继承 SourceBase；全部听书源都打包在 `ShunSources.Plugin` 这一个插件里
 - 支持从文件 / 网址导入，或者把 zip 直接拖进“插件”页；可以启用、禁用、排序、登录，以及一键测试和调试日志
- **广播电台**：内置“云听”，可以收听全国各地的广播电台直播；也可以自己添加电台（名称 + 直播流地址，还可以选一张图片做图标）
- **网盘**：内置夸克网盘、百度网盘、阿里云盘、115 网盘和 WebDAV（可以连自己的 NAS）。在“设置 → 网盘”里开启并登录成功后，才会出现在“插件”和“发现”里；每个文件夹是一本书，里面的音频是章节，可以指定只看某个目录
- **本地文件**：在“设置 → 本地文件”里开启并选择一个文件夹后，作为一个源出现；每个子文件夹是一本书，文件夹里的图片用作封面
- 发现（分类浏览、无限滚动）、**聚合搜索**（多源并发，按源筛选，需要人机验证的网站可以在程序里完成验证）、书架（支持自己建分类）和最近播放；发现页可以在封面网格和带简介的列表之间切换
- **听书源分组**：在“插件”页给源建分组、排序、折叠，搜索结果可以只看某个分组
- **听书统计**：记录每天实际听了多久，在“设置”里看今天、近 7 天、累计和每天的柱状图
- 播放：断点续播、自动下一集、倍速 0.5–3x、快进快退、暂停后自动回退几秒、定时关闭（按时间或按集数，可以设成每次播放或锁屏时自动开启）、打开程序后自动接着播、单书跳过片头片尾、章节倒序和筛选；点底部播放条可以展开播放页
- 音频提取：直链 / HTML / JSON / 正则 / **WebView 渲染** / **WebView 嗅探**；本地代理统一附加 UA、Referer、Cookie，并支持拖动进度
- 界面：浅色、深色、跟随系统，7 种主题色；自绘标题栏，Windows 11 下圆角；任务栏缩略图上有播放控制按钮和进度；关闭按钮可以设为收到右下角托盘，继续在后台播放
- **适配大部分电脑**：
 - 每显示器 DPI 感知，高分屏和多屏缩放不同时也清晰
 - 窄窗口时侧栏自动收起，卡片列数随窗口宽度变化
 - 提供 x64 / x86 / ARM64 独立部署单文件版本，目标电脑无需安装 .NET
 - 首次启动按屏幕大小设置窗口尺寸，支持便携模式
快捷键：`空格` 播放/暂停 · `←/→` 快退/快进 · `Ctrl+←/→` 上/下一集 · `Ctrl+F` 搜索 · `Alt+←` 或鼠标侧键返回 · 媒体键
## 插件开发
📖 **插件开发指南**
插件有两种写法，可以同时安装：
**脚本插件（推荐）**：一个 zip 包，里面是 `manifest.json` 和若干