MovieClaw 的每一次更新

⚠️ 需要更新 Docker 镜像：先停止容器并备份数据目录，再执行 docker compose pull && docker compose up -d。应用内更新装不了这一版，会提示需要拉取新的 Docker 镜像。

本版亮点

在飞机上也能看，不只在家里

以前 iPhone App 只能在线播放，没网就没片看。现在用 iPhone 0.8.0 或更新版本，在影片详情的 ⋯ 菜单里点「下载」，可以存原画，也可以存 1080p、720p 或 480p，每档都标出预计大小。转码版不用等服务器转完，边转边下。原盘（蓝光、DVD、ISO）暂不支持下载。

• 只提供比片源低的画质。低画质不一定更小，以每档标出的预计大小为准。
• 小画质由服务器的显卡来转；没有显卡时，由在线的 Mac 转码器转成 HEVC，体积通常更小。
• 两者都没有时，小画质需要软件转码。设置里没有这个开关：管理员播放需要转码的片子时，会弹窗询问是否开启。
• HDR 片的小画质需要显卡或 Mac 转码器，转出来是 SDR 画面。
• 转码版只保留一条立体声音轨。文本字幕（SRT、ASS）随片下载，图形字幕只在原画里。

接入模型，不用再手抄模型名

以前兼容端点要一个个手填模型 ID，OpenAI 也只能用内置目录里的模型。现在点「从端点获取模型列表」，就能列出你的密钥能看到的模型。OpenAI 和兼容端点可以补录内置目录以外的模型；其他供应商只能选内置模型。从「设置 → 模型接入」新增或编辑供应商开始（仅管理员）。

• 可以自己选连接测试用的模型；接入第一个供应商时，它同时成为 AI 默认模型。
• GPT-6 Astra 和 GPT-6.1 Sol 必须用 Responses API，在「高级设置 → API 协议」里切换；选 Chat Completions 时不显示。
• 在 Chat Completions 下，GPT-6 Sol 和 Luna 只能关闭思考。
• DeepSeek 官方模型现在可以关闭思考。
• 已知问题：百炼上的 Kimi K2.6、K2.5 无法开启思考，以前选过的思考档位现在按不思考运行。需要思考时，可以改用 Kimi 官方平台的 K2.6，那里默认开启思考。

其他新功能与改进

• 新收录 18 个模型：OpenAI 的 GPT-6 Astra、GPT-6.1 Sol、GPT-6 Sol、GPT-6 Luna；百炼的 Qwen3.8 27B、2.4T-A95B、Omni Flash 与 Max 0902 快照，Qwen3.7 Flash，DeepSeek V4.1 Flash，Kimi K2.7 Code，GLM-5.3，MiniMax-M3，MiMo-V2.5-Pro；以及官方平台的 DeepSeek Flash、GLM-5.3 FlashX、Kimi K2.7 Code 与 K2.7 Code HighSpeed。
• 更多思考档位：GPT-5.6 Luna 新增「最高」档。
• 自定义模型：只有用「预算分段」控制思考时，才必须填思考预算。
• 命令行：新增 mclaw llm models discover，列出端点上的模型。

修好了

• 慢盘上首次安装时，不会再出现数据库初始化被中途打断、此后每次重启都起不来的问题。
• 如果已经这样卡住（日志反复出现 table … already exists），这一版修不好它。没有数据的首次安装：停止容器，删掉数据目录里以 movieclaw.db 开头的文件，再重新启动。如果是在升级时卡住的，什么都不要删：用你自己的备份恢复；那次升级若是走的应用内更新，也可以用 data/updates/backup 里以旧版本号命名的自动备份。

管理员须知

• 所有成员默认可以下载。 要禁止某个成员，到「设置 → 成员 → 编辑成员」关闭「下载影片到设备」。
• 关闭后，新的和没下完的下载都会停，已经下好的照常能看。它也会拒绝 VidHub 等 Jellyfin 客户端的整文件下载，Infuse 可能同样受影响。
• 转码一次只转一部，有人播放时让路。「活动 → 正在下载」会显示每个转码的画质、由谁在转、速度和进度。
• 转码副本占用数据目录的空间，没有容量上限，在「设置 → 更新与维护 → 缓存管理」里显示为「离线下载转码」。手机下载完成后副本自动删除，家里其他设备还要用的除外。已知问题：其余副本没有定时清理，超过 72 小时无人访问的，要等下一次有人发起小画质下载时才删除。
• 网盘 strm 条目的原画下载经服务器中转。
• 离线观看在手机联网后同步回来，计入观看记录和播放次数。补传的观看只会向 Webhook 发「看完」事件，时间是实际看完的时间。
• 已知问题：在 iPhone 上取消或删除下载，服务器上的转码不会跟着停。已经排上的（比如一整季）仍会全部转完，副本至少保留 72 小时。要立即停止：停掉容器，删除数据目录下的 cache/offline-exports 文件夹，再启动容器。iPhone 上当前登录账号没下完的较小画质下载，下次打开 App 后过一会儿会自动从头开始；个别显示出错的，删掉后重新下载。
• 已知问题：转码可能一直等下去，并堵住后面的转码。可能出现在它依赖的 Mac 转码器离线时；或者服务器只有 Intel 核显、没有 Mac 转码器、软件转码没开时，部分 HDR 片和 10-bit SDR 片（这些片仍会列出小画质）。可以让转码器重新上线；或者在每台发起过这个下载的 iPhone 上删掉它，再按上一条停容器清理。

升级须知

• 本版包含数据库迁移，更新 Docker 镜像不会自动备份。要回到 v0.37.0：停止容器，把镜像标签改回 movieclaw/movieclaw:v0.37.0，恢复你做的备份后再启动。
• 服务器的 Release 不再附带各客户端安装包（Mac 转码器、Mac 版、iPhone、Android、Android TV）。各客户端单独发布，下方「客户端」一节列出最新版本。Android 的固定下载地址是 https://movieclaw.io/download/android.apk。
• Windows 1.0.x 不会自动更新到新版 Windows App，请到 https://github.com/movieclaw/MovieClaw/releases/tag/windows-v0.1.0 手动下载。

完整变更：v0.37.0 → v0.38.0。

✅ 搭配 MovieClaw 服务器 0.28.0 或更新版本即可使用，与 0.7.0 相同。下载到 iPhone 需要服务器 0.38.0 或更新版本。这个服务器版本需要更新 Docker 镜像。更旧的服务器上不会出现下载入口。从 TestFlight 安装，或到 https://github.com/movieclaw/MovieClaw/releases/tag/ios-v0.8.0 下载未签名 IPA 侧载。IPA 不再附在服务器的 Release 上。

本版亮点

把一部电影或一整季带在身上

从家里串流，一没信号就看不了。现在可以提前下好，直接在 iPhone 上播放。在媒体库打开一部片，点右上角的「⋯」按钮（更多操作）→「下载」，选好画质，再点面板右上角的「下载」。

• 可以下原文件，也可以下比原片分辨率低的 1080p / 720p / 480p 版本，由服务器边转边下。较小画质的大小是预计值（带 ≈），不一定比原文件小。
• 较小画质需要服务器能转码，HDR 影片还需要显卡或 Mac 转码器，否则只能下原文件。它会把 HDR 转成 SDR，只保留一条立体声音轨，不带图形字幕（PGS）。
• 蓝光、DVD 原盘目录和 ISO 镜像暂时不能下载。
• 剧集可以选这一集、接下来几集、未看的集或剩下的全部；已在 iPhone 上的集会跳过。也可以长按分集卡 →「下载这一集」。
• 默认只在 Wi-Fi 下下载；开了低数据模式的 Wi-Fi 和 iPhone 热点上可能也不会下。要用蜂窝网络：我的 → 下载 → 右上角的齿轮按钮（下载设置）→ 打开「使用蜂窝网络下载」。
• 下载前会给 iPhone 留出 2 GB 空间。放不下时，面板会写明需要多少空间，并且不能开始。

服务器连不上，下好的片子还在

以前连不上家里的服务器，App 里什么都看不了。现在 iPhone 没有网络（比如开了飞行模式）时，「媒体库」页签会换成 iPhone 上的片子，并带一行「接着看」。刚打开 App 时，或者在后台超过 10 分钟再回来时连不上服务器，也可能自动切过去。服务器能连上后会自动回到在线，也可以点「重新连接」。

• 网慢不会被切到离线。首页提示连接失败时，可以点「看 iPhone 上的 N 部」自己切过去。
• iPhone 上至少有一部已经下好的片子，才会进入离线模式。
• 离线时看的进度和观看历史，连上后会补到服务器上，时间按你实际观看的时间记。
• 离线时，发现、订阅、活动、搜索、AI 会话和设置会显示占位页；影片详情页只能看、不能改。
• 已知问题：离线时，媒体库顶部的 ▶ 按钮（片段）和「⋯」菜单、详情页的演职员、管理员「我的」页的 AI 输入框仍能点，但加载不出来或发送失败。连上服务器后再用。

其他新功能与改进

• 所有下载集中在一页：「我的 → 下载」里有正在下载的、已下载的条目、「删除已看完的」建议、这台 iPhone 上其他账号的下载，以及占用的空间。左滑或长按条目可以删除；只删 iPhone 上的副本，观看进度会保留。有下载在进行时，媒体库首页会出现一条提示条，点它进这一页。
• 一次下一个：进度显示在分集卡上，电影显示在播放键上方。电影要停下，点「⋯」→「取消下载」；剧集长按分集卡可以暂停或取消，或点「⋯」→「取消全部下载」。切到后台、锁屏后可能也会接着下。
• 下载过的片子，连着服务器时也放 iPhone 上的这份：画质是你下载时选的那一档；能连上服务器时，续播点仍以服务器为准。想改回从服务器播放，删掉 iPhone 上的副本即可。要换画质，在「文件」里长按标着「本机」的那一行 →「改下其他画质」；旧的副本会马上删除。
• 退出登录时会问要不要删下载：退出当前账号时，可以删掉它的下载，也可以保留（重新登录同一账号还能接着看）。「退出全部账号」时会问要不要删掉这台 iPhone 上的全部下载。

管理员须知

• 成员默认可以把影片下载到自己的设备。要禁止某个成员，在网页上进入 设置 → 成员 → 编辑成员，关闭「下载影片到设备」；iPhone App 里没有这个开关。
• 关闭后，成员不能再下新的，没下完的也会停下；已经下到手机上的照常能看。Infuse 等播放器的下载可能也会被禁止。
• 较小画质和播放用同一套转码（显卡、Mac 转码器，或你开启的软件转码）。一次只转一个；播放需要转码时，下载的转码会先让路。手机下完后，转码出来的文件会删除，家里其他设备还要用的除外。
• 已知问题：在 iPhone 上取消或删除下载，服务器上的转码不会跟着停。已经排上的（比如一整季）仍会全部转完，副本至少保留 72 小时。要立即停止：停掉容器，删除数据目录下的 cache/offline-exports 文件夹，再启动容器。iPhone 上当前登录账号没下完的较小画质下载，下次打开 App 后过一会儿会自动从头开始；个别显示出错的，删掉后重新下载。
• 已知问题：Mac 转码器离线、而服务器又没有别的办法转（HDR 影片，或没开软件转码）时，正在转的会一直停在「等待转码器空闲」，后面排着的也跟着等。让转码器重新上线即可，或按上一条停容器清理。

升级须知

• 影片详情页的「⋯」菜单不再有「搜索资源」。回到页签首页，点右上角的放大镜按钮（搜索），切到「资源」，再输入片名；不会再自动填好片名。
• 影片详情页的「⋯」菜单不再有「清除观看记录」。App 里只能在媒体库首页「接下来继续」旁的「⋯」里，按时间或按媒体库清空（这一行显示时才有）。网页版影片详情页仍可以只清一部。
• 这个菜单的其余部分也重新整理了：下载、加入合集、分享（仅管理员）排在顶部一行。管理员用的维护操作收进「管理」子菜单，「删除影片」改叫「从媒体库删除」。
• 下载的片子不进 iPhone 备份；换新 iPhone 或从备份恢复后需要重新下载。
• 如果退回 0.7.0，已下载的文件可能仍留在 iPhone 上占用空间，但看不到。退回前请先在「我的 → 下载」里删除。

完整改动：ios-v0.7.0 → ios-v0.8.0。

⚠️ 需要 MovieClaw 服务器 0.33.0 或更新版本。 0.31、0.32 的服务器登录时会被拒绝。从 https://movieclaw.io/download/android.apk 下载，覆盖安装当前 App。

本版亮点

长回答不再把回复淹没

以前一次回答会摊开一串工具行和原始推理。现在每条回复之前的步骤折成一行总结，点开能看细节。助手干活时，这一行会显示它正在做什么。

• 点自己的提问，可以复制，也可以改写。
• 改写会替换这条提问及其之后的全部对话，然后重新回答。回复进行中不提供改写。
• 用 /skill:名字 调用的技能，会以小标签显示在提问上。
• 你的提问改成半透明气泡，字也更大。
• 已知：点「改写」后，原提问会放回输入框，但没有改写标记，也没有取消键；想放弃，退出这个对话即可。改写会沿用原提问的图片、模型和思维链档位，改写时新加的图片会被丢掉。

提问前挑模型和思维链档位

对话页和新会话页的输入框里，图片键旁边多了模型按钮。在这里选模型；模型支持时，还能选思维链档位。新对话从「我的 → 最近会话 → 新会话」开始（仅管理员）。

• 没选过模型时，用服务器设定的默认 AI 模型。思维链档位选「默认」时，思考多少由模型自己决定。
• 选择会被记住。指定过模型的对话继续用那个模型，其余对话改用你记住的模型；记住的思维链档位只要不是「默认」，继续任何对话时都会用它。
• 服务器接入了 AI 模型、并且模型列表加载成功时，才会出现这个按钮。
• 已知：在已有的对话里改回默认模型或「默认」档位不会生效，对话仍沿用之前的设置。暂时可以新开一个会话。

新功能

• AI 对话里的图片：新会话页现在也能附图片，第一条消息可以只发图片。每条消息最多 4 张。
• 已知：提问气泡里不显示图片；只发了图片的提问，回复结束后会从对话里消失。
• 已知：对话页的已选图片条会显示两遍，点任意一条的 × 都能移除。图片还在上传时按键盘上的「发送」，消息会不带这张图发出，等「上传中…」消失再发。
• 已知：新会话页发送失败或图片上传失败时没有提示。请确认图片已出现在输入框上方、不超过 4 张，并且服务器已接入 AI 模型（网页「设置 → 模型接入」），再检查网络后点发送。

体验改进

• 详情页换成剧照的颜色：媒体库里影片的详情页，底色取自剧照，顶部大图也更高了。没有剧照的影片按海报取色。
• 顶栏按钮变大：顶部的返回、搜索等圆形按钮更大，更好点。
• 玻璃底栏：在「我的 → 显示与外观」打开玻璃底栏后，选中页签的气泡会像真玻璃一样折射下面的画面（需要 Android 13 或更新版本）。顶栏按钮、筛选胶囊和底栏收起后的圆钮也换成同一套玻璃质感。这个开关默认关闭。
• 已知：打开玻璃底栏时，在发现页往下滚动后，选中页签的气泡和收起后的圆钮可能看着偏暗。
• 菜单弹出更顺：发现页的来源菜单和筛选面板改为带动画弹出，不再一下子闪出来。

修好了

• 使用会思考的模型时，回答结束后或重新打开对话时，整段推理混进回复正文的问题已修复。
• 用了技能的提问显示成一大段技能说明原文的问题已修复。
• 新建会话或聊完一轮后，「我的 → 最近会话」不更新的问题已修复。
• 开着玻璃底栏时，打开 App 后第一次进「我的」，开关会自己播一遍切换动画。这个问题已修复。

升级须知

• 0.31.0～0.32.x 的服务器在登录或添加账号时会被拒绝，并提示先在网页「设置 → 更新与维护」里升级服务器。已经登录的账号可以继续用，直到退出或登录过期。
• 0.28～0.30 的服务器不报版本号，这项检查拦不住，但本 App 不支持在上面使用；更早的服务器登录时会提示「服务器版本过旧」。
• 把服务器升到最新版需要更新 Docker 镜像；从 0.30 或更早升级，哪怕只升到 0.33.0 也要换。需要换镜像时，「更新与维护」会提示。
• Android 安装包不再随服务器版本一起发布。以后到 https://movieclaw.io/download/android.apk 下载新版。
• 新会话页不再有开始对话按钮；改用输入框里的发送键。

感谢 @anlan-home 的贡献。完整改动：android-v0.3.1 → android-v0.3.2。

⚠️ 这一版需要手动安装：MovieClaw Desktop 1.0.x 会一直显示已是最新版本，不会提示这次更新。请先退出 MovieClaw Desktop（关掉窗口就会退出），再从 https://github.com/movieclaw/MovieClaw/releases/tag/windows-v0.1.0 下载 MovieClaw-Windows-0.1.0-Setup-x64.exe 并运行。之后的新版本 App 会自己提示。

✅ 对服务器的要求与随 MovieClaw 服务器 0.37.0 发布的 MovieClaw Desktop 1.0.4 相同。

本版亮点

在电脑上看片，有一个完整的播放器

以前在电脑上看片通常要开浏览器。现在可以在桌面 App 里浏览媒体库、搜索片名和影人、收藏、打开电影和单集详情。播放前可以选文件版本、音轨和字幕；播放器支持续播、下一集、跳过片头、倍速、画质、画中画和键盘媒体键。观看进度同步到服务器，在其他设备上能接着看。

• 播放时右键可以打开「播放信息」。
• Windows 版暂时播不了 ISO 镜像，也不显示 DVD 位图字幕。

发现与订阅，想用再打开

不用打开网页，就能从 TMDB 或豆瓣找新片、看影片和影人页面、订阅，并跟进下载和入库进度。两个入口默认关闭：到「设置 → 导航入口」打开「发现」或「我的订阅」。

• 开关按这台电脑、服务器和账号分别保存。
• 「我的订阅」需要账号有订阅权限。
• 站点和下载器在服务器网页上设置。管理员可以从「我的订阅 → 入库链路」里点「打开服务器配置」跳过去。

新版本自己来，装前先核对

App 启动几秒后会到 GitHub 检查有没有 Windows 新版，有就提示你。也可以在「设置 → 关于 → 检查更新」或托盘图标菜单里手动检查。安装前，App 会核对下载的文件是否完整，并检查数字签名。

• 安装包暂时没有代码签名，App 会请你确认「仍然安装未签名的更新」。
• 已知问题：更新对话框里只显示英文说明的开头，而且是未排版的原文。点「打开发布页面」可以看完整说明。
• 用便携版的话：App 内更新下载的是安装包，不是新的压缩包。想继续用便携版，请到发布页下载新的 portable-x64.zip。

其他新功能与改进

• 管理员可以生成 AI 字幕：在影片详情页，管理员点「AI 生成字幕」，就能让服务器生成单语或双语字幕。需要有参考字幕，并在服务器上配置好 AI 模型。
• 多个账号：在「设置 → 账号 → 添加账号」里添加，再从侧栏底部的账号按钮切换。

开始之前

• 需要 64 位（x64）的 Windows 10 或 11。安装包会在缺少时装上 Microsoft WebView2；便携版需要电脑上已经有 WebView2。
• 第一次打开时用「局域网发现」或填写服务器地址，然后用用户名和密码登录。
• 已知问题：登录页会显示「兼容登录」，并提示升级服务器后可以用设备配对。目前还没有服务器版本支持，忽略即可。
• 「发现」和「我的订阅」默认关闭，打开方法见上文。
• 「设置 → 好友与观看隐私」需要服务器安装「服务器观看动态」插件。这个插件不随服务器附带，目前也没有公开发布。
• 界面只有中文。
• 安装包没有代码签名，第一次运行时 Windows 通常会弹出 SmartScreen 警告。

从旧版迁移

除以下几点外，功能与 MovieClaw Desktop 1.0.4 相同。

• 怎么拿到：1.0.x 不会自己更新到 0.1.0，请按开头的提示先退出旧版，再手动安装。版本号比 1.0.4 小，但这一版更新。
• 数据：服务器地址、已保存的账号和登录状态都会保留。播放设置、发现与订阅的开关和最近搜索也可能一并保留。
• 名字：App 在 Windows 里改叫「MovieClaw」，「设置 → 关于」里显示「MovieClaw for Windows」。它可能装在「MovieClaw Desktop」旁边，而不是替换它。
• 合集：侧栏不再有「合集」一节。同样的合集仍是首页「我的媒体库」一行里的卡片，也在影片详情页的「所属合集」里。
• 用的是安装版：确认新版能用后，到 Windows「设置 → 应用」里卸载 MovieClaw Desktop。建议卸载时不要勾选删除应用数据，因为这可能连带清掉新版的本机设置，比如播放偏好。
• 用的是便携版：从开头的链接下载 MovieClaw-Windows-0.1.0-portable-x64.zip，解压到一个新文件夹。退出旧版，运行新文件夹里的 movieclaw-desktop.exe，确认能用后删掉旧文件夹。服务器地址和账号存在文件夹之外，会保留。

感谢 @sexyfeifan 开发了 Windows 客户端，并持续改进。

⚠️ 需要更新 Docker 镜像：先停止容器并备份数据目录，再执行 docker compose pull && docker compose up -d。应用内更新装不了这一版，会提示需要拉取新的 Docker 镜像。

本版亮点

在当前页面就能挑下一部

以前看完一部，想找类似的片要重新搜索，所属系列也只是一个链接。现在媒体库详情页在演职员下面列出「相似推荐」；系列电影还会按上映顺序列出整个系列，并标出你已有几部。网页、iPhone、Mac、Android、Android TV 都有，升级后自动出现，不用设置。

• 只从你能看到的同类型媒体库里推荐。动画、纪录片、真人秀不会和其他片混在一起推荐。
• 系列一行需要 TMDB 的系列资料；只靠本地 NFO 定的系列不显示这一行。
• 系列里库中没有的片显示为压暗。在网页、iPhone 和 Android 上可以点开去订阅。
• Android 还新增「相关链接」一行，可跳到 TMDB、IMDb 和豆瓣。
• Mac 和 Android TV 的演职员改为竖版照片卡片。

手机和 IM 的通知，在一个地方选

以前 Telegram、微信这类 IM 有自己的两个全服务器开关，和手机通知是两套。现在绑定的 IM 账号只是它主人的又一个通知渠道，收什么和他的手机一样。新增的通知有：订阅收齐了、下载卡住了、可能还有更多集、问题已恢复，以及 AI 回复完成。从「设置 → 账号 → 通知」开始。

• 这一页的测试通知现在也会发到你的 IM。
• 「AI 回复完成」只发给管理员，只推到手机、不发 IM，覆盖在 App 或网页里提的问题。侧载的 iPhone 收不到推送；Android 需要打开实时通知。
• IM 账号的登录凭据失效、需要重新绑定时，管理员也会收到提醒。
• 插件发的通知也在同一个列表里，按插件分组。

新功能

• Android TV 播放选集：播放时按上键，可以选「下一集」或「选集」。
• iPhone 上的 AI 对话（管理员）：对话改为聊天气泡，长按气泡可以复制或改写提问。「我的」页的标签栏上方多了一行 AI 输入框。
• 本地挂载的网盘文件：内容是服务器路径的 strm（如 CloudDrive2、rclone 挂载）现在能像本地文件一样播放。这个路径必须在容器里也能按同样的位置访问到。
• 网盘少走中转：strm 链接经过局域网里的 302 服务时，如果播放器能直接访问最终地址，就直接跳过去。

体验改进

• 自动播下一集：没认出片尾时，这一集会放到最后，再倒计时接下一集。连续自动播了 3 集都没有操作时，会问「还在看吗？」（网页、iPhone、Mac）。
• Android TV 首页更安静：预告自动播放改为默认关闭。可以在侧栏的账号页打开「自动播放预告」。
• Intel 核显：显卡支持时，硬件转码改用低功耗编码。部分 Intel 核显（如虚拟化的核显）转码时出现的崩溃可能因此消失。
• 图床浏览：「图床浏览」改为每个媒体库分别记住。合集页上的切换按钮从顶栏挪进了 ⋯ 菜单。
• 以及 3 处细节改进：识别片头片尾更省 CPU；iPhone 上的豆瓣链接在装了豆瓣 App 时直接打开 App；扫描和手动整理后也会通知已关联的 Emby 或 Jellyfin 刷新。

修好了

• 网页播放时，服务器转码起不来，播放器会反复重试好几分钟。现在会马上降一档画质继续播。
• 浏览几页就把任务中心塞满网盘预探任务的问题已修复。内置预探插件更新到 1.0.1，会清掉旧版本留下的任务。
• 带 UTF-8 BOM 的 strm 不会再被拒绝，GB18030 编码的也能正确读取。
• Android TV：打开侧栏时按返回会直接退出 App，现在只会关闭侧栏。
• Android TV：关闭侧栏或播放器后，焦点卡住、只剩左键能用的问题已修复。
• Android TV：详情页在背景图和剧集行之间滑动要好几秒，现在不会了。
• 以及 2 处 Android TV 显示问题：剧集卡片下集数显示两遍、中文字重不一致。

管理员须知

• 已有的 IM 账号现在都归管理员，推送内容按管理员在「通知」里的选择。原来的 IM 开关不会迁移过来。
• IM 收到的内容有变化：「开始下载」「洗版完成」现在默认关闭；原来在 IM 里关掉了「入库完成」的，升级后会重新收到。
• IM 现在只推管理员发起或关注的订阅。想收到所有新入库的片，打开「媒体库有新片」。
• 群机器人收到的和绑定人一样，包括新设备登录（带设备名和 IP 地址）。
• MovieClaw 格式的 Webhook 改用新的报文结构：字段改了名，请求头改为 X-MovieClaw-Event-Id。请同步更新接收端。Jellyfin 格式的 Webhook 照常使用你的模板。
• Webhook 可订阅的系统事件从 10 个增加到 35 个，插件声明的事件也能订阅。投递失败会在约 40 分钟内重试 5 次，重启后不会丢；播放进度和打开详情这两个事件不重试。
• 安装插件时的审批页会列出它发哪些通知、读取哪些观看动态。要让它给成员发通知，需要勾选「允许它给家里的成员发通知」。为旧版本写的、监听事件的插件可能需要更新。
• 使用 host 网络时，如果 3001 端口已被占用，把 MOVIECLAW_NEXT_PORT 设成别的端口；8000 端口仍须空闲。

升级须知

• 本版包含数据库迁移，更新 Docker 镜像不会自动备份。要回到 v0.36.0：停止容器，把镜像标签改回 movieclaw/movieclaw:v0.36.0，恢复你做的备份后再启动。
• 相似推荐和系列一行需要新版 App；旧版 App 照常能用，只是没有这两行。Android 0.3.1：https://github.com/movieclaw/MovieClaw/releases/download/v0.37.0/MovieClaw-Android-arm64.apk · Android TV 0.2.2：https://github.com/movieclaw/MovieClaw/releases/download/v0.37.0/MovieClaw-AndroidTV.apk
• iPhone 和 Mac 版仍是 0.7.0，但为这一版重新构建：https://github.com/movieclaw/MovieClaw/releases/download/v0.37.0/MovieClaw-iOS-unsigned.ipa · https://github.com/movieclaw/MovieClaw/releases/download/v0.37.0/MovieClaw-macos-arm64.zip 。本版无需更新 Mac 转码器。
• 还在用 Android 0.3.0 的，部分通知可能会落到另一个通知类别里，更新到 0.3.1 即可。

感谢 @WadeChenn 改进 Android TV。完整变更：v0.36.0 → v0.37.0。

⚠️ 需要更新 Docker 镜像：先停止容器并备份数据目录，再执行 docker compose pull && docker compose up -d。应用内更新装不了这一版，会提示需要拉取新的 Docker 镜像。

本版亮点

网盘里的片，不用再挑播放器

以前 strm 条目只有播放器能直接解码原文件时才能播，网页播放器只会提示你改用 Infuse、VidHub。现在服务器会先探明每部片的格式，需要时换封装或转码，网页播放器和 Jellyfin 播放器都受益。只在家里网络能访问的直链，由服务器转发。升级后自动生效；新的官方插件「网盘规格预探」会在后台提前探好规格，起播更快。

• 换封装、转码和转发都经过你的服务器，和播放本地文件一样占用它的带宽与 CPU。公网直链仍直接交给播放器。
• 指向内网地址或本地名称（如 alist）的直链会被转发；按 Kodi 写法带了请求头的也会：上一行写 #EXTVLCOPT:http-user-agent=…，或在链接后接 |User-Agent=…。
• MKV 条目有进度条缩略图，内封字幕不用通读整片就能加载；本地 MKV 文件的内封字幕也因此更快。
• iPhone 和 Mac App 仍和以前一样直接播放这些条目。
• strm 文件里必须是 http(s) 链接，不支持本地文件路径。

Android 通知，即时送达

以前 Android App 只能每 15 分钟自己查一次有没有新消息。现在用 Android 0.3.0，App 可以和你的服务器保持直连，通知即时送达，不经过谷歌或厂商推送；离线期间错过的，重新连上后补发。在 App 的「设置 → 通知 → 实时通知（保持连接）」开启。下载：https://github.com/movieclaw/MovieClaw/releases/download/v0.36.0/MovieClaw-Android-arm64.apk

• 默认关闭，需要本版服务器。服务器较旧时开关会弹回关闭，并提示先更新服务器。
• 会常驻一条静音通知，显示下载进度（仅管理员）或你自定义的文字，默认是「今天入库 {今日入库} 集」。
• 在「推送哪些事」里选择要推的事件；按账号保存，与 iPhone、网页共用。
• vivo/iQOO、小米/Redmi、OPPO/一加/realme、华为/荣耀手机有分步引导，帮你让它在后台常驻。

新功能

• 官方插件可以停用：管理员在「设置 → 插件」打开某个插件，可以「停用」或「卸载」；卸载的官方插件随时能「恢复」。
• 插件能做更多事：插件可以建后台任务（在「活动」页显示），也可以调用 AI 助手。插件发起的对话在侧边栏标「插件」。
• Firefox 扩展：「设置 → 资源站点 → 安装扩展」现在也提供 Firefox 安装包。它没有签名：要作为临时附加组件载入，Firefox 重启后需重新载入。
• Android 活动页：长按正在播放的会话，可以查看为什么是这种播放方式、打开影片详情、结束播放或注销设备。
• Android 下载与对话：季包下载行显示每一集的进度；AI 回复可以展示影片、媒体库和订阅卡片。

体验改进

• 模型密钥：编辑供应商时 API Key 留空，沿用已保存的密钥。更换供应商类型或 API 端点时仍要重填。
• 站点验证：NexusPHP 站点登录过期、被 Cloudflare 人机验证拦下时会明确说明，不再误报站点改版。
• 跳过片头片尾：断成两截的片尾会接成一段，「即将播放下一集」出现得更早；延续到剧情里的片头结束得更准。
• iPhone 推送：本版附带的 iPhone App 在侧载版收不到推送时，会在「设置 → 通知」里说明原因。
• Android：启动器和通知换成新的极光图标；页脚显示真实的版本号。

修好了

• 在 OpenAI 上使用 GPT-5.6 系列模型时，选了思考档位后 AI 助手一调用工具就报 400 的问题已修复。
• 网页播放器直通连续失败两次后，没试硬件转码就要求开启软件转码（HDR 片直接报错）的问题已修复。
• 媒体库放在 mergerfs 合并盘（如飞牛）上时，新下载要等下一次定时检查（最长约 6 小时）才入库的问题已修复。如果这种库建好时「实时监控目录变化」是关的，到库的编辑弹窗里把它打开。
• 季包里没勾选的集不会再让订阅一直等下去，会重新搜索。
• 慢机器上，更新后可能卡在旧版本反复重启的问题已修复。
• 重启后，后台任务可能一直排队、要再重启一次才动的问题已修复。
• Android：带工具调用的 AI 对话闪退或加载失败的问题已修复。
• Android：点已失效的账号不再没反应，现在会打开登录，并预填服务器和用户名。
• 以及 3 处细节修复。

管理员须知

• 网盘规格预探插件默认开启。升级后它会探一遍已有的全部 strm 条目，每 3 秒一个，每次从网盘读取文件开头一小段。在「设置 → 插件」调整或停用。
• 已有的片头片尾识别结果会先隐藏，等每一季重新识别后再出现。识别在后台进行，有人开始看的剧排在最前。
• 每台开启实时通知的 Android 设备和服务器保持一条连接。错过的通知保留 7 天，每台设备最多 200 条。
• 调用 AI 助手的插件以管理员身份运行，消耗你的模型用量；批准界面会标出这一点。
• 官方端点上的 OpenAI 供应商改用 Responses API；填了其他 API 端点的保持 Chat Completions。可在「高级设置 → API 协议」切换；端点不支持 /v1/responses 时，把思考档位改为「默认」或「关」。
• GPT-5.6 Luna 不再提供「最高」档；用过这一档的对话改按模型默认强度运行。

升级须知

• 本版包含数据库迁移，更新 Docker 镜像不会自动备份。要回到 v0.35.0：停止容器，把镜像标签改回 movieclaw/movieclaw:v0.35.0，恢复你做的备份后再启动。
• 上面标注 Android 的功能需要 Android 0.3.0；Android 0.2.0 照常可用，只是没有这些功能。Android TV 0.2.1（https://github.com/movieclaw/MovieClaw/releases/download/v0.36.0/MovieClaw-AndroidTV.apk）没有可见变化。iPhone 和 Mac App 保持 0.7.0，Mac 转码器无需更新。

感谢 @WadeChenn 和 @anlan-home 的贡献。完整变更：v0.35.0 → v0.36.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」更新即可。

本版亮点

MovieClaw 还不会的，装个插件补上

以前想多接一个消息通道或下载器，只能等新版本。现在微信、Telegram、Discord、飞书四个通道和 qBittorrent、Transmission 两个下载器是六个官方插件，你也可以在旁边装第三方插件包。还可以让 AI 助手为缺的功能写一个插件并装好。管理员从「设置 → 插件」开始。

• 每个插件有详情页，列出它带来的功能、设置和存储；第三方插件包按风险分级列出权限，安装前要先核对。
• 第三方插件可以回到上一版或卸载；官方插件在这一版里不能停用。
• 第三方插件在独立的低权限进程里运行；新版本起不来时会自动回到上一版。请只安装可信来源的插件。
• 已知问题：第三方插件可以绕过检查直接调用另一个插件的接口，插件还能拿到当前用户的登录凭据。已在 v0.36.0 修复，升级即可。
• 如果装了第三方插件后服务器启动不久就崩溃，下次启动会跳过这些插件，插件页上有「退出安全模式」。
• 已绑定的 IM 通道和已配置的下载器照常可用；通道仍在「设置 → IM 推送」里接入。

电视预告和片段，不用再等

以前 Android TV 的大图预告和 iPhone 的片段都要播完整原片，iPhone 在外网时还得让服务器实时转码。打开「片段预切」后，服务器在后台为每部片切一段 1080p 小片段，预告和片段改播小文件。管理员在「设置 → 播放 → 片段预切」开启，默认关闭。

• 需要 Android TV 0.2.0 或本版附带的 iPhone App；旧版 App 照旧播原片。
• 开启后，还没切好的片在 Android TV 上只显示剧照，在 iPhone 片段里暂不出现。
• 在 Android TV 上，蓝光、DVD 原盘切好后也有预告了。
• 网盘 strm 条目和太短挑不出片段的片不切。
• 进度在「活动 → 任务」里显示为「片段预切」，重启或更新后接着切。
• 有人用过片段或电视预告后，网页「媒体库」页顶部会提示管理员开启。

几百集的剧，也能一下找到

以前在几百集的季里找看到哪一集，要划很久。现在超过 50 集的季按 50 集分段，带「全部分集」面板；每一季打开都停在你接着看的那一集。网页、iPhone、Mac、Android、Android TV 自动生效。

新功能

• 删片时连下载一起删：删除影片或文件时，管理员可以勾选「同时删除下载任务和源文件」，默认不勾；网页、iPhone、Android 都有。
• TMDB 之外的新集：站点出现比 TMDB 更新的集时，网页订阅详情页会提示继续追；在网页的「更多 → 调整集数」里改集数。
• 用别名搜资源：在详情页或订阅里搜资源时，同时用英文名和原名搜，网页和 iPhone 都支持；每个站点最多搜 3 个词，请求会变多。
• Android 播放器与订阅：播放键居中，加了「下一集」按钮、选集弹窗和进度条上的片头标记；订阅详情页重新设计。
• Mac 播放时置顶：播放时窗口浮在其他窗口之上；可在「窗口 → 播放时置顶」关闭。

体验改进

• Android 切换底部页签不再顿一下，回到页签时滚动位置还在。
• 站点 Cookie 同步用的「浏览器插件」改名为「浏览器扩展」，位置仍在「资源站点」页；已装的扩展照常可用。
• 以及 5 处细节改进：「IM 推送」里不接 AI 模型也能添加飞书群机器人、Netflix 主题的主播放键和「已入库」斜标改用品牌红、手机网页的设置首页改成分组列表、「按类型找」格子的悬停效果、Android TV 首页滚动可能更流畅。

修好了

• Android TV 现在会出现在小米、海信、TCL 等电视桌面的应用列表里，并换上了正式图标和横幅。
• Android 订阅详情里的「暂停追踪」「恢复追踪」和自动续订开关恢复正常；标记一集已看后，收藏的心不会再消失；只追新集的订阅不会再显示「第 1 季 · 0 / 0」。
• Android 删除、恢复或立即清理文件后，媒体库首页的数量和占用会马上更新；iPhone 下载弹窗第一次打开时，不会再误报「自动识别暂不可用」。
• AI 助手的回复在出字前被停止后，对话可以继续，以前这样卡住的对话也能继续。
• 命名模板只用「原始文件名」时，扫描入库的文件不会再被整理成「未命名」；已经改名的不会自动恢复。
• 海报卡悬停上浮时顶角不会再被裁掉；搜索结果的站点状态浮层在站点很多时可以滚动了。

管理员须知

• 预切片段存在数据目录里，在「设置 → 更新与维护 → 缓存管理」里显示为「预切片段」。在我们的测试中每部约 15～30 MB。
• 预切用服务器 CPU，一次切一部，有人看片时让路。关闭开关会停止预切，并询问是否删除已切的片段。
• 删除源文件不可恢复。种子还供着别的文件、有 H&R 风险或不是 MovieClaw 投递的，选项会变灰并写明原因；升级前手动下载的片子也不能用。
• 站点出现比 TMDB 更新的集时，已收齐的剧集订阅可能回到「追踪中」；继续追或忽略的提示只在网页上有。
• mclaw 的 channels im … 和 channels weixin … 命令改为 channels list、channels accounts 和 channels bindings。

升级须知

• 本版包含数据库迁移。要回到 v0.34.0，用「设置 → 更新与维护 → 回退到历史版本」，它会恢复更新前的备份，此后的数据会丢失，包括这一版里绑定的 IM 通道。如果你是拉取 Docker 镜像来更新的，不会自动备份，请先停止容器并备份数据目录。
• 「成人」不再是内置搜索分类，以前打开过的，这个标签会消失。要找回，到「设置 → 资源站点 → 搜索分类 → 新建自定义分类」里勾选「成人」。
• 自定义站点 YAML 里的 custom_class 不是内置站点类的，这个站点会被跳过，日志里有警告。
• 要用上文中各 App 的改动，请安装本版附带的 App。Android 0.2.0：https://github.com/movieclaw/MovieClaw/releases/download/v0.35.0/MovieClaw-Android-arm64.apk ；Android TV 0.2.0：https://github.com/movieclaw/MovieClaw/releases/download/v0.35.0/MovieClaw-AndroidTV.apk 。iPhone 和 Mac App 版本号仍是 0.7.0，但已重新打包：https://github.com/movieclaw/MovieClaw/releases/download/v0.35.0/MovieClaw-iOS-unsigned.ipa 、https://github.com/movieclaw/MovieClaw/releases/download/v0.35.0/MovieClaw-macos-arm64.zip 。Mac 转码器无需更新。

感谢 @WadeChenn 带来 Android 播放器与订阅改进，@duchanghexuhe 打磨 Netflix 主题与海报卡，@anlan-home 修复 Android TV 桌面入口。完整变更：v0.34.0 → v0.35.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」更新即可。

本版亮点

拿起 Android 电视遥控器就能看片

以前在 Android 电视或盒子上只能用 Jellyfin 播放器。新的 Android TV App 能看首页各行、媒体库和合集，用遥控器搜索，播放时有字幕、音轨、画质面板，能跳过片头，还有下一集卡片。下载 https://github.com/movieclaw/MovieClaw/releases/download/v0.34.0/MovieClaw-AndroidTV.apk 装到电视上，选好服务器，再用手机扫电视上的二维码并批准即可。首版面向早期测试，不同电视和盒子的播放表现可能不同。

• 需要 Android 6.0 或更高、ARM 芯片的电视或盒子，以及 MovieClaw 服务器 v0.34.0 或更新版本。更旧的服务器会拒绝它登录。
• 可以用手机相机或 iPhone App「我的」页右上角的扫码批准，也可以在浏览器打开电视上显示的地址输入配对码。谁批准，电视就登录成谁，并出现在这个人的「设置 → 设备」里。也可以用账号密码登录。
• 可以保存多个账号（可跨服务器），在「谁在看？」里切换。
• 电视能放的直接放原文件，放不了的由服务器转码。电视支持的杜比视界不做色调映射；ASS 字幕和 DTS、TrueHD 音轨由 App 自己处理。画面会切到影片的帧率；Android 12 及以上按系统的「匹配内容帧率」设置来。
• 在大图上停一会儿会带声音播放一小段片段，没有关闭开关。待继续的剧集会放到系统的「接下来播放」行，部分电视没有这一行。
• 它专为看片：没有发现、订阅、片段、设置、下载和推送通知。界面只有中文。

ISO 光盘镜像在网页里也能放

以前蓝光、DVD 的 ISO 镜像只能用能直接读镜像的播放器放，比如 iPhone、Android App 或 Infuse；网页播放器会提示放不了，App 调低画质后也一样。现在服务器能读出镜像里的正片并串流出去，网页、Android TV 和调低画质的 App 都能放 ISO，包括正片在镜像里分成很多段的光盘。升级后自动生效，不用设置。

• 服务器读不出的镜像仍会拒绝播放，并建议改用能直接打开 ISO 的播放器。

观看统计按实际看的来算

以前每打开一次都算一次播放，点开几秒的片子也能冲上「本期最受欢迎」，来回拖动还会算进观看时长。现在至少看满 1 分钟或看到结尾才算一次播放，3 小时内从停下的地方接着看（换了设备也一样）仍算同一次，观看时长也不会超过实际经过的时间。管理员在「活动 → 观看统计」查看，不用设置。

• 「看完」指这次观看到了最后 10%，且其中至少三分之一是真的在看。重看到结尾现在也算；直接拖到结尾不算。
• 热力图和每日走势把观看时长分摊到实际经过的各个小时，深夜看的电影不会全堆在一个小时或算到错的那天。
• 「按播放方式」排除不满 1 分钟的播放，说明文字也改正为统计网页和各 App。
• 只有记录覆盖了整个上一周期，才显示与上期的对比。
• 分享访客的时长照算，但不计入活跃成员。
• 过去各周期的播放次数也按新口径算，可能变少。本版之前记下的观看时长不会重新计算。

其他新功能与改进

• 转码器忙时说清楚：HDR 片要靠 Mac 转码器、而它在线但名额已满时，会提示转码器正忙、请稍后再试，不再说没有检测到硬件。
• iPhone 提示：弹出的提示改到屏幕底部，在弹层和键盘上方也能看到。下滑或点按即可收起。
• 「活动」里的设备名：Android 手机和电视的新播放记录显示机型，也不会再重复客户端名。

修好了

• 部分 ISO 剧集和电影一开播就被标成已看、不留续播点、片长显示不对的问题已修复。升级后会在后台自动校正已有镜像的片长。已经被误标已看的不会自动恢复，可以在影片页点「标记为未看」。
• 部分手机上，Android App 通过 HTTPS 访问服务器播放某些片子时可能闪退的问题已修复。感谢 @WadeChenn。
• App 在转码播放时被强行关掉后，服务器没有其他空闲转码名额时，同一台手机或电视最多 3 分钟内开不了新片的问题已修复。
• 只有 Mac 转码器能做色调映射时，重新打开 HDR 片或切换字幕、音轨会报「未检测到硬件」的问题已修复。
• 以及 1 处细节修复。

管理员须知

• 每次启动后，服务器会在后台把每个 ISO 镜像的盘内结构读一遍，每个镜像只读几小块，不耽误启动。
• 升级后，服务器会在后台把每个杜比视界文件的文件头读一遍，只读一次。
• 每次播放结束，Android TV App 会把诊断信息发给你自己的服务器：电视型号、解码器、显示模式和出错日志。不会发给开发者。

升级须知

• 本版包含数据库迁移。在「设置 → 更新与维护」更新时会先自动备份。要回到 v0.33.0，到「设置 → 更新与维护 → 选择版本回退…」，它会恢复这份备份，更新之后记录的内容会丢失。
• 如果是拉取 Docker 镜像更新，不会自动备份：请先停止容器并备份数据目录。回退时停止容器，把镜像标签改回 movieclaw/movieclaw:v0.33.0，恢复这份备份后再启动。
• iPhone 上的改动需要 iPhone App 0.7.0：https://github.com/movieclaw/MovieClaw/releases/download/v0.34.0/MovieClaw-iOS-unsigned.ipa ，按原来的方式覆盖安装。Android 的修复需要 Android 0.1.1：https://github.com/movieclaw/MovieClaw/releases/download/v0.34.0/MovieClaw-Android-arm64.apk 。旧版 App 连这一版服务器照常能用。
• Android TV App 与 Android 手机版是两个独立的 App，同一台设备上可以都装。

感谢 @WadeChenn 的贡献。完整变更：v0.33.0 → v0.34.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」里更新即可。

本版亮点

订阅前不用先配规则组

以前订阅只能靠你事先配好的规则组来决定下什么。现在可以选「智能选择」：电影和剧集各设一次，选好想要的分辨率、片源和最多等多久。符合要求的版本一出现就下载。等到期还没有，就下当前最好的合格版本，剧集也会尽量跟着同一个版本。管理员在「设置 → 订阅规则 → 智能选择」里设置，或者直接在订阅弹窗里设置。

• 网页和 iPhone 0.6.0 新建订阅时默认用智能选择。要用规则组，在「更多选项 → 选择方式」里选「规则模式」。
• 可选项：4K 或 1080p；WEB-DL、蓝光或 Remux；不等待、最多 3 小时、1 天或自定义 1～7 天；是否允许后续洗版；是否只接受所选分辨率。
• 订阅会按创建时的设置执行。之后改设置只影响新订阅，已有订阅也不能在智能和规则之间切换。
• 订阅详情会写明每集或每部片最晚等到什么时候、当前候选是哪个，可以「立即下载当前候选」或延长等待。
• 只有管理员能改设置。管理员保存过以后，成员也能用智能选择订阅。
• 已有订阅继续用原来的规则组。Android 和 AI 助手创建的仍是规则订阅。

在 Android 上看片

以前 Android 手机只能用网页。新的 Android App 能浏览媒体库、发现、搜索和订阅，播放时能切换字幕和音轨、跳过片头、生成 AI 字幕。下载 https://github.com/movieclaw/MovieClaw/releases/download/v0.33.0/MovieClaw-Android-arm64.apk 安装后，输入服务器地址、用户名和密码登录。

• 需要 Android 8.0 或更新版本，arm64 的手机或平板。安装时系统会要求允许安装未知应用。
• 装过这个 App 早期测试包的，先卸载它，签名不同。
• 没有推送，App 自己大约每 15 分钟检查一次新通知。
• 智能选择、订阅规则、站点和下载器在网页端管理。
• 光盘镜像（ISO）只在服务器地址是 http 时能播，https 不行。
• 界面只有中文。

一季一组消息，不再一集一条

以前每次下载、每次入库、每集洗版，微信、Telegram 等 IM 通道都会各收到一条消息。现在同一批剧集共用几条：开始下载时、前几集可以先看时、全部到齐时，以及卡住时。集数写成区间，比如「第 1–8 集」。升级后自动生效。

• 洗版消息按订阅合并。已经从订阅里移出的季集不会再发消息。
• iPhone App 的可展开通知卡片依赖推送，侧载的 iPhone App 收不到推送。

新功能

• 发现：网页的「发现电影」「发现剧集」合并成一个「发现」入口。电影和剧集、TMDB 和豆瓣都在页面标题处切换。手机上的网页现在打开后先进媒体库。
• 转码并发：在「设置 → 播放」里为每台 Mac 转码器设置同时转码的任务数（1～4 路），页面还会显示它的芯片、内存和负载；网页经它播放时起播更快。
• 命名模板：模板不再必须包含片名、季号或集号。已知问题：文件名模板只用 {release_name} 时，整理媒体库会把扫描入库的文件改名为「未命名」。已在 v0.35.0 修复，升级即可。

体验改进

• 同名电影：资源无法和同名同年的另一部电影区分时，订阅会跳过它继续找，不再停下来发告警等你确认。之前留下的这类待确认告警，升级后会自动消失。
• 网页设置：开关改完即存，文本离开输入框就保存。危险操作放到页底或 ⋯ 菜单里。
• 下载器和站点改在侧边面板里新增和编辑。在面板外点一下或按 Esc，已填的内容会直接丢弃。
• 规则预览：「模拟一单」改为「订阅规则 → 自定义规则」里的「预览匹配」。
• 设备：设备分四类显示，每类最多列出 5 台在线设备，点「查看全部」看完整列表。
• iPhone 设置：「服务器设置」改版，支持搜索设备、给每个成员单独的详情页，也能配置 Fanart.tv。
• 字幕：网页、iPhone 和 Mac 的字幕菜单显示每条轨道自己的名字（如「简体中文特效」），并标出强制字幕。

修好了

• 分享链接现在能播放了。从 v0.28.0 起，用分享链接起播会报服务器错误。
• 剧集海报被单集缩略图顶替的问题已修复，网页和 Infuse 等 Jellyfin 播放器都不会再出现。
• 在 Infuse 等 Jellyfin 播放器里打开影片详情，「活动」里不会再误显示为正在播放。
• 以及 6 处细节修复。

管理员须知

• Mac 转码器的并发上限改为保存在服务器上。旧版转码器照常能用，但更新前不能在网页里调整上限：https://github.com/movieclaw/MovieClaw/releases/download/v0.33.0/MovieClawTranscoder-macos-arm64.zip。

升级须知

• 本版包含数据库迁移。走应用内更新的，可以在「设置 → 更新与维护 → 选择版本回退…」里回到 v0.32.0。回退会恢复更新前自动生成的备份，之后新增的数据会丢失。
• 拉取 Docker 镜像升级的没有自动备份。要回退：停止容器，把镜像标签改回 movieclaw/movieclaw:v0.32.0，恢复你自己备份的数据目录后再启动。
• 文中 iPhone 的改动需要 App 0.6.0：https://github.com/movieclaw/MovieClaw/releases/download/v0.33.0/MovieClaw-iOS-unsigned.ipa。Mac 版在 https://github.com/movieclaw/MovieClaw/releases/download/v0.33.0/MovieClaw-macos-arm64.zip。
• 旧版 App 连这台服务器照常能用，只是不能创建智能订阅。0.6.0 的 App 连旧服务器时，订阅请选「规则模式」。

感谢 @anlan-home 带来 Android App，感谢 @WadeChenn 对它的改进。完整变更：v0.32.0 → v0.33.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」里更新即可。

本版亮点

Mac 上有了专门看片的 App

以前在 Mac 上只能用浏览器看。新的 Mac App 能浏览媒体库、合集和收藏，搜片名和影人；播放时有字幕、音轨和画质面板，能跳过片头、接着看下一集，也支持键盘操作。下载 https://github.com/movieclaw/MovieClaw/releases/download/v0.32.0/MovieClaw-macos-arm64.zip ，解压后打开即可。

• 需要 Apple 芯片的 Mac，macOS 26 或更新版本。App 已经过 Apple 公证。
• 需要 MovieClaw 服务器 v0.32.0 或更新版本。更旧的服务器会拒绝它登录，App 会提示先升级服务器。
• 可以用账号密码登录；也可以选「扫码登录」，在 iPhone「设置 → 设备」或已登录的浏览器里批准。
• 可以保存多个账号（不同服务器的也行），在「账号」菜单里切换。
• 它专门用来看片：发现、订阅、片段和设置仍在网页上，也收不到推送通知。

不知道看什么，先挑一种类型

不用先想好片名。新增「按类型找电影」「按类型找剧集」两行，每种类型一张卡片，配上这个类型最近入库那部片的剧照。点开就是各个库里这个类型的全部作品。这两行会自动出现在「我的媒体库」之后，网页「媒体库」页、iPhone 和 Mac 都有。

• 不想要的话，在「媒体库」页的「自定义首页」里隐藏。
• 成员只会看到自己能访问的库里的类型。设成不在首页显示的库不计入。
• iPhone 需要 0.5.0 版 App，旧版 App 不显示这两行。

新功能

• 「片段」能放更多格式：iPhone 0.5.0 的「片段」现在也能放蓝光原盘目录、ISO 镜像、DVD、TS 和 AVI。旧版 iPhone App 在「片段」里可能放不了这些片子。
• 清理长期没用的设备：在「设置 → 设备 → 清理…」选 7、30 或 90 天（默认 30 天），先列出这段时间没用过的设备，再一次注销。管理员可以在「全部成员」视图里清理所有人的设备。iPhone App 0.5.0 也有。
• 清理会保留什么：正在用的这台和连着的转码器不会被清理。Infuse 等 Jellyfin 播放器在清理范围内，被清掉后要重新登录。
• 更多命名占位符：「设置 → 刮削与整理 → 命名模板」新增英文名、豆瓣 ID、季名、视频编码、HDR、位深、音轨、站点和原始文件名。站点和原始文件名只有 MovieClaw 自己入库的文件才有，原始文件名从这一版开始记录。

体验改进

• 文件名更整齐：同一个名字里重复的片名（比如原名和片名相同）只写一次。超过 200 字节的名字会自动缩短，季集号和规格保留。
• 设备列表：每台设备前有图标和在线标记。改名和注销收进了每行的 ⋯ 菜单。
• iPhone 播放按钮：写明是哪一集，比如「继续 第 1 季第 3 集 · 46:56」；打开剧集时直接落在正在看的那一集。
• iPhone 画面色调：SDR 视频的色调与 Infuse 一致，中间调不会再偏亮、发白。
• iPhone 媒体库页：「片段」改成顶栏最左边的 ▶ 图标，挨着 ⋯。
• iPhone 播放画质：「自动」改名为「原画」，作用不变。
• 搜索资源：详情页的「搜索资源」和订阅的「手动选种」只搜电影或只搜剧集，想放宽可以点「全部」。
• 库封面：库里满 4 张海报后，拼贴封面一天最多换一次。
• 以及 2 处细节改进。

修好了

• 看完的片子重看到一半，退出再进会接着这次的位置播放。
• 命名模板里的 {episode_title} 以前总是空的，现在会填入集名。
• 在 Jellyfin 播放器里，库的顺序与 MovieClaw 一致，「合集」视图有了封面，个别以前可能显示不出的海报也能显示了。
• iPhone 0.5.0 上，部分 DVD 镜像不会再只放几秒菜单、放不出正片。
• iPhone 0.5.0 上，改由服务器转码的片子起播时可能不会再停在 0:00。
• 以及 1 处细节修复。

升级须知

• 本版包含数据库迁移。通过应用内更新升级的，要回到 v0.31.0，可以在「设置 → 更新与维护 → 选择版本回退…」操作。它会恢复更新前自动生成的备份，此后新增的数据会丢失。
• 如果是拉取 Docker 镜像升级的，不会有自动备份。要回退：停止容器，把镜像标签改成 movieclaw/movieclaw:v0.31.0，恢复你自己备份的数据目录，再启动。
• 写明 iPhone 的改动需要 0.5.0 版 iPhone App：https://github.com/movieclaw/MovieClaw/releases/download/v0.32.0/MovieClaw-iOS-unsigned.ipa 。旧版 App 仍能连这台服务器，只是没有这些改动。

完整变更：v0.31.0 → v0.32.0。

⚠️ 需要更新 Docker 镜像：先停止容器并备份数据目录，再执行 docker compose pull && docker compose up -d。应用内更新装不了这一版，会提示需要拉取新的 Docker 镜像。iPhone App 也请更新到 0.4.0（https://github.com/movieclaw/MovieClaw/releases/download/v0.31.0/MovieClaw-iOS-unsigned.ipa）：0.3.0 连这一版服务器时，媒体库搜索会失败。

本版亮点

打几个字母，就能搜到想看的片

以前搜媒体库只认片名原文，得切中文输入法，还得记准名字。现在全拼、首字母（如「st」「xjcy」）、中文拼音混输、繁体、别名，以及演员和导演的名字都能搜到。结果按相关度排列并注明命中原因，搜到的人物单独成一行，点进去是他在你库里的影人页。网页上打开搜索（⌘K / Ctrl+K）选「媒体库」；iPhone 上点放大镜，选同一个标签。

• 输入时就有联想；iPhone 上边输入边出结果。
• 结果不再按库分组、不再显示总数；往下滚或点「更多结果」加载更多。
• 升级后服务器会在后台建立搜索索引。建好之前照样能搜，大库可能会慢一些。

海报、剧照和演职员头像更清楚

以前分集剧照只存 300 像素宽、海报存 780，电视和大屏上看着发虚。现在服务器默认保存原图，各设备按需要的尺寸取图，演职员头像也存到本地。填上自己的 Fanart.tv API Key，还能多出海报、背景、片名 Logo 和季海报可选。管理员从「设置 → 刮削与整理」里的「本地图片画质」和「启用 Fanart.tv」开始。

• 画质可选原图（默认）、标准、节省空间和自定义，每档标出按你的媒体库估算的大小。
• 已入库的条目要「刷新元数据」或等下次定时刷新，才会用上 Fanart.tv 的图。想手动挑，在条目详情的 ⋯ 里点「更换图片…」。

其他新功能与改进

媒体库与播放
- 跳过按钮分类型：能认出厂标这类短片头，欧美剧可以靠画面上的演职员表认出片尾。广告和下集预告分别显示「跳过广告」「跳过预告」，其他片段显示「跳过此段」。
- 片头片尾识别更快：按 CPU 核数最多同时识别 4 集；有人在看片时只留一路，服务器本机转码时才暂停。
- 首页显示的合集会同时在「我的媒体库」里多出一张卡片。
- 刷新元数据不会再把所有图片重下一遍，完好的直接沿用；任务中心会显示新下载、沿用和没下到的图片数。

站点与下载
- 刷流单独选下载器：「设置 → 资源站点 → ⋯ → 开启刷流…」里多了「刷流下载器」，有两台及以上下载器时才出现。它不可用时该站暂停刷流，不会改投别的下载器。删除这台下载器会关闭用它刷流的站点，已在做种的种子保留。
- 新增站点：SunnyPT（界面上叫 Sunny，用站点生成的 API Key 接入）和 UBits（用浏览器 Cookie 接入）。

iPhone
- 点「接着看」条上的 ✕ 可以收起它，这台设备再播放时才重新出现。
- 「我的」页的扫码按钮可以批准其他设备登录。
- 「自定义首页」改成编辑列表：显示或隐藏、拖动排序，可以按类型、媒体库或合集添加行。
- 连接出错时会说明原因和解决办法，并带上地址和错误码。

修好了

• iPhone 用「http + 域名」地址登录时报 -1022 的问题已修复。
• 在 iPhone 上编辑首页布局时，会删掉网页上添加的「全部电影」「全部剧集」行的问题已修复。
• iPhone 锁屏和控制中心的「正在播放」没有封面的问题已修复。
• 跳过按钮偶尔把剧情当成片尾、把其他片段标成片头、漏掉短广告，或者换过片源后用旧时间点的问题已修复。
• 用 Mac 转码器播放时可能中途停住的问题已修复，这项修复在服务器上。
• Mac 转码器手动断开后又自己连回去、改名后服务器上还是旧名字、网络恢复后迟迟不重连的问题已修复。需要新版转码器：https://github.com/movieclaw/MovieClaw/releases/download/v0.31.0/MovieClawTranscoder-macos-arm64.zip
• 最近搜索里影视和资源混在一起、点「清空」两种一起清掉，以及手机上点搜索结果里的剧集要点两下才能进详情的问题已修复。
• 系统日志里可能出现明文 TMDB API Key 和站点 passkey 的问题已修复。
• 以及 2 处细节修复。

管理员须知

• 图片会多占磁盘：不管选哪档画质，已有图片都会重新下载一次，由定时刷新在约一个月内轮完。在我们的测试库里，原图档估算约 2.6 GB，原来是 0.28 GB；设置页会按你的库给出估算。想少占一些，升级后尽早在「本地图片画质」里选标准或节省空间。
• iPhone 通知暂时用不上：新增的「设置 → MovieClaw Cloud」「App 推送」（管理员）和「通知」（所有人）是为它准备的，但需要从 App Store 或 TestFlight 安装的 App，目前还没有公开。侧载版收不到通知。
• MovieClaw Cloud 上报：连接后，服务器会上报版本和系统信息。「上报统计信息」默认开启，还会上报按平台和 App 版本汇总的设备数，以及官方推送能否连通；可以在 MovieClaw Cloud 页关掉。没连接时不会发送任何信息。

升级须知

• 本版包含数据库迁移，更新 Docker 镜像不会自动备份。要回到 v0.30.0：停止容器，把镜像标签改回 movieclaw/movieclaw:v0.30.0，恢复你做的备份后再启动。
• 上面的 iPhone 各项，以及 iPhone 上的新跳过按钮名，需要 App 0.4.0。
• 升级后会给所有剧集重新识别一遍片头片尾，CPU 和磁盘会忙上一阵，大库可能要很多个小时。识别完之前那部剧不显示跳过按钮，开始播放的那一季优先识别。
• 「全部电影」「全部剧集」行不再自动出现：同类型有两个及以上的库、又没自定义过首页的，会看不到它们。要加回来：媒体库页 ⋯ →「自定义首页」→「＋ 添加一行」。
• 「设置 → 设备」里不再有配对码输入框。在那里点「批准新设备登录」，或直接打开 /activate；旧的批准链接仍然能用。
• 「消息推送」改名为「IM 推送」，位置不变。
• mclaw search library-items 改为 mclaw search library，接口 /api/v1/search/library-items 已删除。请从本版下载新的 mclaw，并同步修改自己的脚本。
• 升级前写下的日志里仍有这些密钥。分享日志之前，先删掉 data/logs 里的旧文件。

感谢 @DongShull 的贡献。完整变更：v0.30.0 → v0.31.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」一键更新即可。

本版亮点

不用每集都拖过同一段片头

连着刷一季剧，每集都要手动拖过同一段片头。现在 movieclaw 会把同一季各集的声音互相比对，认出片头、片头前的冠名广告和片尾，播到时出现「跳过片头」按钮。一直放到结尾的片尾一开始，就弹出「即将播放」卡片，倒计时 8 秒自动放下一集。升级后所有剧集库自动开启，网页播放器和 iPhone App 0.3.0 或更新版本都能用。

• 点卡片右上角的 ✕ 可以继续看片尾。连续自动播了三集、期间没人碰过播放器，就不再自动播。
• 片尾之后还有正片内容的，给的是「跳过片尾」按钮，不弹卡片。
• 以下情况认不出：库里这一季不到三集、片头短于 15 秒或不在前 10 分钟内、每集片尾配乐都不同；这时卡片只在最后 40 秒出现，也不倒计时。
• 新集入库时顺手识别。已有的剧在后台慢慢补，正在追的排在最前，老剧要过一阵才有按钮。
• Infuse 等 Jellyfin 客户端可能也会出现跳过按钮。

网页播放器守住画质，断线自己接上

以前网页播放器在网速慢时会自作主张改成转码、降低画质，断一次线也要降一档。现在断线后按原画质自动重连、从刚才的位置接着放；线路确实跟不上时，弹出卡片显示实测速度、建议换低一档，换不换由你。文件已经不在服务器上时，会直接提示「服务器上找不到这个文件」，不会反复重试。升级后自动生效，不用设置。

• 画质按每部片分别记住。以前版本里那个对所有片生效的画质设置会恢复成「自动」。
• 打开一部片时沿用了上次的非默认画质、音轨或字幕，会短暂提示一下。
• 部分 MP4 和大体积 TS 文件第一次播放时，不用再等服务器把整个文件读一遍；在我们的 NAS 测试中，这一步原来要一分钟以上。
• iPhone 和 iPad 的 Safari 里，HEVC 视频改用系统播放器，拖进度、跳过片头可能不会再停顿一两秒。

几个库的电影，合成一行

电影分在好几个库里，「媒体库」页只能一个库一行地翻，同一部片还可能出现两次。现在「全部电影」「全部剧集」「全部其他视频」把同类型的库合成一行，同一部片只出现一次；点行标题可以浏览全部。同类型有两个及以上的库时自动出现；要自己加，点「媒体库」页右上角的「自定义首页」（手机上在 ⋯ 菜单里）→「＋ 添加一行 · 从哪来？」。目前只有网页有这几行，iPhone App 里不显示。

• 已知问题：在 iPhone App 里保存「自定义首页」，会删掉你在网页上加的这几行，其余的恢复成默认设置。已在 v0.31.0（iPhone App 0.4.0）修复，升级即可。

新功能

• GitHub 访问令牌：检查更新时提示 GitHub 限流，可以在「设置 → 更新与维护 → GitHub 访问令牌」里填一个令牌，不勾选任何权限的 Fine-grained token 即可；也可以用 mclaw app update github-token-put 设置。
• iPhone 上的接着看条：App 标签栏上方的接着看条只显示在这台 iPhone 上播过的片，不会混进 Infuse 或其他设备上看的。「媒体库」页的「接下来继续」仍然跨设备。
• 新标志：iPhone App 图标（含深色与着色版本）、网页、Mac 转码器、浏览器扩展都换上了新标志，浏览器标签页也有了图标。
• iPhone 的「片段」页：筛选菜单多了「其他」，用来刷「其他视频」库，默认仍只从电影和剧集里抽。页面加了返回键，点顶部的片名进详情页。竖屏时横滑不会再拖进度，要拖进度请进全屏。

体验改进

• Mac 远程转码更快：换上这一版的 Mac 转码器后，转码播放的起播和拖进度更快，原盘和 TS 文件最明显。从 https://github.com/movieclaw/MovieClaw/releases/download/v0.30.0/MovieClawTranscoder-macos-arm64.zip 下载后替换旧版；不更新也照常能用。

修好了

• 多版本影片看较长的那一版（比如加长版）时，离结尾还远就被标成已看、续播点丢失的问题已修复。
• 网页播放器里，画面出来之前从画质菜单选低画质没有反应的问题已修复。
• 扫描媒体库的同时刷新元数据、读取本地 NFO 时，部分新文件报「database is locked」、这次扫描入不了库的问题已修复。
• 「设置 → 更新与维护 → 缓存管理」里点「清理孤儿条目」报错的问题已修复。
• 以及 1 处 Jellyfin 客户端相关的修复。

管理员须知

• 升级后所有剧集库会在后台识别片头片尾：每集读开头 10 分钟和结尾 7 分钟，会占用读盘和 CPU，有人在看片时自动暂停。进度在「活动」页查看；要关掉某个库的识别，进该库 → ⋯ →「编辑库」，关掉「识别片头片尾」，已认出的结果会保留。
• 识别会留下很小的指纹文件，在「缓存管理」里显示为「片头片尾指纹」。清空后已认出的片头片尾不受影响，但之后这一季再来新集时，要把整季重新读一遍。
• 源码部署需要带 chromaprint 的 ffmpeg（如 jellyfin-ffmpeg），否则识别不出来。Docker 镜像已自带。
• 全家共享的合集（没选「只有我可见」的）现在只有创建者和管理员能改。已有的这类合集一律归管理员，成员不能再改名、编辑或删除，包括他们自己建的。
• 成员权限里的「站点搜索」更名为「资源搜索」。没有这项权限的成员也会看到搜索入口：有「订阅追踪」权限的可以搜影视，也能搜自己可见的媒体库。
• 成员现在能在自己发起或关注的订阅里看到下载进度，但看不到种子名和下载器名。
• 同时有「订阅追踪」「资源搜索」「一键下载」权限的成员，现在可以在自己发起的订阅里「手动选种」；他们下载时，保存位置弹窗只列出自己可见的媒体库和下载器默认目录。

升级须知

• 上面提到的 iPhone 功能需要 iPhone App 0.3.0：下载 https://github.com/movieclaw/MovieClaw/releases/download/v0.30.0/MovieClaw-iOS-unsigned.ipa，用你当初安装的方式覆盖安装旧版。
• 本版包含数据库迁移。在「设置 → 更新与维护」更新时会先自动备份。要回到 v0.29.0，在同一页点「选择版本回退…」，它会恢复这份备份，更新之后产生的数据会丢失。
• 如果你是拉取 Docker 镜像升级的，不会自动备份：先停止容器并备份数据目录。要回退时停止容器，把镜像标签改回 movieclaw/movieclaw:v0.29.0，恢复这份备份后再启动。

完整变更：v0.29.0 → v0.30.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」一键更新即可。
⚠️ 请先升级服务器，再装 iPhone App 0.2.0。 iPhone 0.2.0 连 v0.28.0 服务器时，打不开「更换图片」，需要确认作品的手动下载也会失败。旧的 0.1.0 版 App 连本版服务器照常可用。

本版亮点

在外面用手机看 4K，也不用干等

以前出门用蜂窝网络看高码率原片，起播要等很久，拖一下进度又要等。现在用 iPhone 0.2.0，App 边收边播：字幕轨多的 MKV 不用先下完一大块索引，拖到没缓冲的位置也直接从那里开始读。续播（包括重新打开 App 后续播）也快了很多。升级服务器与 App 后自动生效。

• 换低画质的提示来得更早：连续等满 8 秒（等首帧、拖进度后、播放中卡住都算），且网速低于片子码率时就会提示。每次播放最多提示一次，选不选由你，不会自动切换。
• MKV 起播提速从第二次播放这个文件、以及追剧的下一集起生效：第一次播放时服务器才生成一份精简索引，在「设置 → 更新与维护 → 缓存管理」里显示为「MKV 精简索引」。
• App 会把最近播放的数据留在手机上，重开 App 也在，最多 512 MB，30 天没用自动删除；手机空间紧张时系统也会回收。

「片段」：在自己的片库里竖滑刷片

不知道看什么时，在 iPhone App「媒体库」页右上角点「▶ 片段」，竖着一条条滑，看从你的电影和剧集里挑出的精彩片段。看中了点「详情」进条目页，或点「全屏观看」再点「看全片」接着看。可以按电影 / 剧集、类型、年代、国家 / 地区、最低评分、片长筛选，也可以只看没看过的。

• 需要 iPhone 0.2.0 和本版服务器。成员只会刷到自己能看的媒体库。
• 只支持 MKV、MP4 的电影和剧集；蓝光、DVD、ISO、TS 和网盘 strm 条目会跳过。剧集的片段取自第一季第 2 集。
• 画质在家默认原画，在外网或蜂窝默认 720p，可用画质按钮切换。用蜂窝网络进入前会先确认一次。
• 刷片段不计入观看记录；只有点「已看」或接着看全片才会记录。

默认音轨、字幕自己就选对

以前默认轨跟着片源的标记走，常常放的是配音，字幕也要自己打开。现在默认音轨是影片原声，默认字幕按媒体库的元数据语言来选：中文库里的外语片会自动开中文字幕。只有你亲手换过的音轨、字幕才会被记住，自动挑的不会再沿用到整部剧。网页和 iPhone 0.2.0 升级后自动生效，Infuse 等 Jellyfin 客户端可能也会跟着生效。

• 条目页的音轨、字幕行会标出你起播时会放哪一条，并写明原因。
• 导评、口述影像这类轨不会被自动选中。
• 升级时，记忆里只是旧规则自动挑出的那些会被清掉，改按新规则选；你自己选过的保留。

新功能

• 片名 Logo：网页（默认主题）和 iPhone App 的条目页改用片名 Logo 显示片名，Jellyfin 客户端也能拿到。想换一张，在网页上到条目的 ⋯ →「更换图片」→「徽标」里挑。老条目在下一次刷新元数据时补上 Logo；开了向媒体目录写入图片的库，会多写一个 clearlogo.png。
• 手动下载能确认作品：搜索结果的下载认不出是哪部片时，可以在网页或 iPhone 上按片名搜索并点选正确的作品，媒体库仍和自动识别时一样自动分配。
• iPhone 上切换账号：长按底部头像页签切换账号，双击切回上一个账号。
• iPhone「接着看」浮条：iOS 26.1 及以上，标签栏上方显示下一部要接着看的片，点一下就播；长按可以暂时隐藏。

体验改进

• iPhone 页签：顺序改为「媒体库、订阅、发现、活动、我的」，所有账号打开 App 都先到「媒体库」。以前管理员先到「发现」。
• iPhone「我的」页：「设置」改名「服务器设置」；「关于 MovieClaw」挪到「服务器设置」页最底部，「退出登录」挪到个人信息页最底部。
• 大库筛选更快：文件很多的媒体库，打开「更多筛选」和进入库页面都快了很多。在我们的测试中，1.8 万个文件的库从约两分钟缩短到不到一秒。
• AI 字幕即时响应：发起 AI 字幕即时响应，停止几秒内生效；读取字幕轨有单独的进度，模型出错时会说明原因，暂时故障后从中断处继续。
• 细节打磨：iPhone 播放时按侧键调音量，会弹出和竖滑一样的音量提示；发现页、订阅页的大图在拉过头或横屏时不会再露出边缘底色。网页桌面端（默认主题）的活动页改为与 App、手机一致的「总览 + 二级页」。

修好了

• Mac 转码器使用 ffmpeg 7.1 时，需要缩小画面的显卡转码总是失败的问题已修复。
• 季文件夹名带额外文字（如 Season 4-第 4 季-(2007)）时会被当成单独一部片的问题已修复。季号定不下来时，剧集以前会被悄悄归进特别篇；现在进入待识别，由你指定第几季。
• 洗版之后，同一个下载有时会被再复制进媒体库一份的问题已修复。
• 网页播放时，同时有国语 DTS 和英语 AC3 音轨的片子，不会再为了省转码换成英语。
• iPhone 播放器的暗场画面正中，不会再隐约露出一个椭圆。

管理员须知

• MovieClaw 的页面不能再嵌入其他网站的 iframe（比如导航面板）。API 描述文件不再公开，需要时设置 APP_ENV=local 恢复。
• 服务器启动后第一次有人打开「片段」时，会在后台把每部电影、每部剧的一个文件的索引读一遍，只读一次。

升级须知

• 「生成章节」改为默认关闭，已有的媒体库也全部关掉。 关闭期间，条目页不显示章节横排，Infuse 等 Jellyfin 客户端也拿不到章节图；文件自带的章节照常可用。要重新打开（管理员）：「媒体库 → 齿轮按钮（管理媒体库）→ 库所在行的 ⋯ → 编辑库 → 扫描与监控」里的「生成章节」。已生成的图都还在，缺的会在后台补生成。
• 网页和 iPhone 的字幕样式去掉了「描边」。不开背景时，字幕统一为白字加柔和投影。
• 本版包含数据库迁移，应用内更新会先自动备份。要回到 v0.28.0：到「设置 → 更新与维护 →『选择版本回退…』」，它会恢复这份备份，更新之后产生的数据会丢失。如果你是拉取 Docker 镜像更新的，请先停止容器并备份数据目录；回退时把镜像标签改回 v0.28.0，并恢复这份备份。
• 标了 iPhone 的改动需要 0.2.0 版 App：https://github.com/movieclaw/MovieClaw/releases/download/v0.29.0/MovieClaw-iOS-unsigned.ipa

感谢 @miniers 的贡献。完整变更：v0.28.0 → v0.29.0。

✅ 本版无需更新 Docker 镜像，在「设置 → 更新与维护」里更新即可。
⚠️ iPhone App：需要本版服务器，旧服务器上 App 登录不了。
⚠️ 用 Mac 转码器的：下载 MovieClawTranscoder-macos-arm64.zip 替换旧版。App 改名为「MovieClaw 转码器」，请删掉旧的「MovieClaw Transcoder.app」，免得出现两个（设置和配对会沿用）。旧版仍能用，但蓝光原盘和 Infuse 的转码不会交给它，改由服务器自己转或直接播放原文件。

本版亮点

片库变成真正的 iPhone App

以前在 iPhone 上只能开网页，大文件和原盘常常要转码或者放不了。新 App 直接从服务器播原文件，4K HDR、蓝光原盘目录、DVD、ISO 都能放，支持画中画和隔空播放。下载 MovieClaw-iOS-unsigned.ipa，用 AltStore、SideStore 或 Sideloadly 以自己的 Apple ID 安装。

• 需要 iOS 26 或更新版本。只适配 iPhone（iPad 上以兼容模式运行），界面只有中文。
• 填服务器地址、用户名和密码登录；首次打开会在局域网里找服务器。可以保存多台服务器、多个账号。
• 订阅规则、资源站点、下载器、自动入库在网页端配置，App 里会引导你去网页。
• 用免费 Apple ID 签的包 7 天后过期，AltStore、SideStore 可以自动续签。

Mac 转码器，打开就能用

Mac 转码器以前是菜单栏图标加设置窗口，现在是一块状态面板，看得到正在转哪部片。它开机自启，转码内核崩溃后会自动重启。蓝光原盘目录能直接转，HDR 和杜比视界在显卡上转成 SDR。安装包经过 Apple 公证，下载后双击即可打开。

• 需要 Apple 芯片的 Mac，macOS 12 或更新版本。ISO 和 DVD 暂时不能转。
• 在显卡上转 HDR 需要 Jellyfin-ffmpeg；换成其他 ffmpeg 时 HDR 改用 CPU，会慢很多。
• 设置变化：「暂停接收任务」去掉了，App 开着就接任务；「最大并发」改到「设置 → 转码 → 同时转码」。

看清并注销每一处登录

以前看不到账号在哪里登录着，命令行和转码器也只有管理员能管。现在「设置 → 设备」列出登录着你账号的浏览器、App、命令行、转码器和 Jellyfin 播放器，带系统、版本和最近活跃时间。每位成员都能给自己的设备改名，或把任意一台「注销」；管理员还可以切换查看全部成员的设备。

• 新的 mclaw 或转码器，输入它显示的配对码、或打开它给出的链接即可批准；待批准请求列表去掉了。
• 成员可以用自己的账号给 mclaw 配对，它只有这个成员的权限。转码器只能由管理员批准。
• 修改密码会注销你的其他浏览器、App 和 Jellyfin 播放器；勾选「同时注销命令行和转码器」才会一并注销它们。
• 已配对的 mclaw 和转码器更新后照常可用，不用重新配对；mclaw logout 现在会同时在服务器上注销这台机器。

新功能

• 订阅页（银玻璃）：顶部是带片名 Logo 和剧照的轮播大图，下面有「刚刚入库」、一周更新日程，电影和剧集分成两行、用「查看全部」进入，不再有类型切换。
• 自动选规则组：在「设置 → 订阅规则」给规则组设「适用范围」（电影或剧集、区域、类型）。新订阅自动选中匹配的组，都不匹配时用默认组。已有订阅的规则组不变。
• 电脑和手机用不同主题：「设置 → 外观」现在设置的是你当前这类设备的主题。
• 看得出怎么在播：活动页标出每个播放是直连、重封装还是转码，转码时显示在哪台机器上转。
• 清理残留的刷流种子：关闭刷流或删除站点时，可以连同数据文件删掉该站的刷流种子；事后也能在活动页用「清理刷流种子…」清。还没做满站点要求做种时长的，到期后再自动删。

体验改进

• 更快：续播起播更快，保存订阅不再卡几秒，订阅页和媒体库页打开更快。
• 少读盘：打开影片详情不再通读整个文件来抽字幕，内封字幕改为播放器需要时再抽。
• 网页播放器：播放器里的速度改为显示实际正在加载的速度。诊断面板的「取流」改名「带宽」。进度条去掉章节刻度，拖动时仍显示章节名。
• 手机版布局（银玻璃）：底栏只留图标。「更多」变成显示头像的「我的」页签，搜索挪到右上角。新会话从「我的 → 最近会话」开始；「复制会话 ID」只在电脑版侧栏里还有。

修好了

• 用 Infuse 播放、经远程转码器转码时总是失败的问题已修复（需要新版 Mac 转码器）。
• Findroid、Flow、Jellyfin 官方 Android TV 版等新版 Jellyfin 客户端，可能因服务器报的版本太旧而拒绝连接，这个问题已修复。
• Docker 桥接网络下，播放器在局域网自动发现到的地址连不上。现在自动发现会返回「设置 → 网络 → 外部访问地址」，在那里填上局域网地址，并映射 UDP 7359 端口即可。
• 定时任务开关在 Chrome、Edge 里错位，订阅规则页的规则组列表在手机上变形，这两个问题已修复。

管理员须知

• 重置成员密码会让他在网页、App 和播放器上下线，命令行不受影响；要全部收回，在「设置 → 成员」里用「全部下线」。
• 播放质量记录现在在服务器上保留 90 天后删除。

升级须知

• 本版包含数据库迁移。要回退，到「设置 → 更新与维护 → 选择版本回退…」选 v0.27.0，会恢复这次更新前的自动备份，更新之后的改动会丢失。
• 项目许可证从 MIT 改为 MovieClaw 许可证（Apache-2.0 附加非商业条件），个人和家庭自用不受影响。

感谢 @duchanghexuhe 和 @jasonhorga 的贡献。完整变更：v0.27.0 → v0.28.0。