夸克助手

夸克助手用于管理夸克网盘 TV 扫码配置，并给 Emby 助手的路径替换直链能力提供账号基础。它不是 STRM 生成主入口，而是作为直链解析账号被路径替换链路调用。

适合做什么

场景	说明
路径替换直链	Emby 助手按路径匹配到夸克资源后获取可播放链接
多账号管理	不同资源目录使用不同夸克配置
TV 扫码登录	通过二维码获取并保存 Token
画质选择	可选择原画或转码播放方式
缓存控制	控制直链缓存时间，减少重复请求

配置字段

字段	说明
名称	配置唯一名称
登录方式	页面当前支持 TV 扫码
播放方式	原画或转码
优先分辨率	转码模式下优先选择的清晰度
缓存时间	单位秒，用于直链缓存

登录流程

1. 进入 NanShare Web -> 工具箱 -> 夸克助手。
2. 点击添加配置，填写配置名称。
3. 点击扫码登录。
4. 使用夸克客户端扫码确认。
5. 页面显示 TV Token 已获取后保存配置。
6. 点击验证 TV Token，确认 Token 可用。

Token 获取后会保存在 NanShare 配置中。文档中不要写入真实 refresh_token、access_token 或 device_id。

播放方式

方式	说明
原画	优先获取原始文件链接，适合带宽和客户端能力足够的环境
转码	获取转码播放链接，可按分辨率选择

转码分辨率常见选项：

4K (2160p)
2K (1440p)
超清 (1080p)
高清 (720p)
标清 (480p)
流畅 (360p)

使用流程

1. 进入 NanShare Web -> 工具箱 -> 夸克助手。
2. 添加配置并完成 TV 扫码。
3. 选择播放方式和优先分辨率。
4. 设置缓存时间。
5. 保存配置并验证 Token。
6. 在 Emby 助手的路径替换链路中引用该配置。

路径替换示例：

/CloudNAS/CloudDrive/夸克网盘 => 夸克一号

常见问题

什么时候用原画

客户端能稳定播放原始码率、网络带宽足够时优先用原画。原画更接近本地文件体验。

什么时候用转码

移动端、外网、带宽受限或客户端解码能力不足时可以用转码。转码模式建议设置合理的优先分辨率。

验证 TV Token 失败

重新扫码获取 Token，然后保存配置。若多次失败，检查容器网络和夸克账号状态。

缓存时间怎么选

如果播放链接稳定，可以设置较长缓存；如果经常遇到链接过期，适当缩短缓存时间。