LitePan 文档

Appearance

增强工具 ​

Tools · Enhanced

播放链路、上传与识别的增强卡片

后台 → 辅助工具 → 增强工具。这里汇集了与播放、上传、识别相关的增强卡片：Emby 反代、飞牛影视反代、115 STRM 增强、从服务器上传、AI 辅助增强、夸克 STRM 播放接管。

Emby 反代 / 飞牛影视反代 ​

这两张卡片解决「播放器连不上 STRM」的播放链路问题。播放器请填「反代入口」，不要填下面的 Emby / 飞牛原地址。

Emby

Infuse 等连 Emby 反代

  1. 填 Emby 地址、API Key → 点「测试」
  2. 勾选启用，填未占用的 反代端口 →「保存配置」
  3. 状态变为「运行中」后，复制 反代入口，在 Infuse 等添加服务器时填入口
飞牛

爆米花 / VidHub 等连飞牛反代

  1. 填 飞牛影视地址（多为 :8005，不是管理页 5666）→「测试」
  2. 按 Docker 映射填 飞牛 STRM 目录（见下方说明）
  3. 启用 + 独立反代端口 → 保存 → 播放器填 反代入口
前提

先有可播的 STRM

  1. 先在 STRM 任务 生成 .strm，媒体库指向输出目录
  2. 需要封面 / nfo 时再用 STRM 刮削
  3. 反代解决的是「播放链路」，不替代生成 STRM

我该怎么选 ​

字段谁用填什么
反代入口（给客户端）Infuse / 爆米花等播放器复制页上的入口地址
Emby 地址 / 飞牛影视地址仅 LitePan 连上游你的 Emby 或飞牛影视服务地址

设置项说明 ​

反代卡片本身就是设置。点左侧查看说明。

Emby 地址
LitePan 连接 Emby 用，例如 http://192.168.1.10:8096。
播放器不要填这个地址。

115 网盘 STRM 增强方案 ​

开启

打开增强开关

  1. 卡片右上角打开开关
  2. 未配置分支的 115Open STRM 任务将改用全量清单方式扫描
  3. 一次性获取整个目录清单，不再一层层翻目录，请求更少、更不易触发限制
路径

目录变了就清映射

  1. 扫描时会建立「文件 id ↔ 路径」的映射缓存，减少重复反查
  2. 目录被移动 / 重命名后，映射可能变旧
  3. 点「清空映射数据」重建即可，不影响网盘文件与已生成的 STRM
分支

分支任务不受影响

  1. 已配置分支的 STRM 任务仍按分支方式执行
  2. 生成规则、元数据同步、排除过滤与原逻辑完全一致
  3. 适合影音库很大、日常增量不大的场景

从服务器上传 ​

映射

先配置目录映射

  1. docker-compose 里先映射宿主机目录到容器，例如 - /vol1/1000/updatefiles:/app/data/updatefiles
  2. 卡片点「目录映射设置」→ 添加标签名 + 容器内路径
  3. 多个映射就有多个标签，前台可切换
使用

前台怎么上传

  1. 前台文件列表 → 新建 → 上传文件 / 上传文件夹
  2. 面板里切到「从服务器上传」标签，选映射目录
  3. 选择文件 / 文件夹上传到当前网盘目录，保留文件夹结构
机制

复用现有上传

  1. 上传进入任务面板，与从访问机上传同一套机制
  2. 重名文件仍按你选择的处理方式（覆盖 / 重命名 / 跳过）
  3. 未开启此卡片时，前台上传保持原有方式

AI 辅助增强工具 ​

配置

填模型配置

  1. 点「配置模型参数」→ 填 API 地址、模型名称、API Key（默认 DeepSeek）
  2. 点「测试连接」确认模型能返回识别结果
  3. 保存后开启开关
整理

在目录整理里用

  1. 目录整理遇到低置信（不确定）的作品时，可批量交给 AI 补判
  2. 模型只返回识别结果，不直接改文件
  3. 计划仍由目录整理生成并执行，AI 只做识别补强
复用

后续可扩展

  1. 同一目录树 24 小时内重新生成计划会复用识别结果
  2. 能力是通用 AI 识别，后续可接入其他功能
  3. API Key 只存本机，用于调用模型

夸克 STRM 播放接管 ​

绑定

扫码绑定夸克 TV

  1. 点「账号绑定设置」→「添加绑定」→ 选择夸克网盘账号
  2. 用夸克 App 扫码，手机端确认登录（TV 端需与所选夸克账号一致）
  3. 绑定成功后可多账号分别绑定 / 解绑
生效

开启后播放走 TV 302

  1. 打开卡片开关，夸克账号的 STRM 播放请求改走夸克 TV 302 转码直链
  2. 播放不再经过本机代理拉流
  3. 未绑定 TV 的夸克账号仍走原有网页代理
注意

转码与失效提醒

  1. 走转码播放：画质会明显下降，且存在部分字幕不可用问题，请按需开关
  2. TV 凭证失效时，右上角铃铛会提醒重新扫码绑定，播放自动回退网页代理
  3. 实验性功能，卡片带「实验性」标签

常见问题 ​

启用了反代为什么还没有反代入口？

需要填写反代端口并成功保存。未填端口或保存失败时，入口处可能显示「填写端口后生成」一类提示。

Infuse 里该填哪个地址？

只填「反代入口」。不要把「Emby 地址」填进播放器。

Emby 刷库按钮在哪？

Emby 反代卡片里有「刷库」。飞牛反代卡片没有刷库按钮。

外网 / 另一台设备连不上反代？

确认客户端能访问 LitePan 所在主机的反代端口；防火墙与 Docker 端口映射要放行。从非本机打开后台时，入口主机名会尽量用当前访问主机，跨网段仍需自己确认可达。

115 增强开启后，分支任务还按分支走吗？

是。增强开关只影响未配置分支的 STRM 任务；已配置分支的任务仍按分支方式执行。

为什么前台没有「从服务器上传」标签？

先确认增强工具里「从服务器上传」卡片已开启，并且至少添加了一条目录映射。

夸克 TV 播放变卡 / 没字幕了？

夸克 TV 接管是转码播放，画质下降、部分字幕不可用属于预期现象。可以关掉卡片开关，夸克播放恢复原有网页代理方式。