首页与系统体检 1.0 预览版
首页把每天要看的放在一页：NAS 的 CPU、内存、网络、存储池、硬盘温度与告警，今天播出的集入库了没有、有哪些事要处理、媒体服务器里没看完的、最近入库的、这周还要播的，以及下载速度、磁盘空间、下载器、体检与备份的状况。系统体检一次检查 pt-tools 用到的服务与设置，每项写明现在的样子和怎么修。
打开首页
打开网页先到首页（地址是 /home）。导航里是「概览 → 首页」，也是左边窄栏的第一个图标；手机底栏的「概览」打开首页。原来打开网页时的「用户统计」还在「概览」里。
页头的一句话写今天几集播出、几部上映，其中几集已入库，几件事要处理，例如「今天 3 集播出 · 其中 1 集已入库 · 6 件事要处理」。
首页的每一块单独读取：一块取不到时只在那一块写原因（例如 取不到：15 秒内没取到，稍后刷新），别的块照样显示。首页的数据在服务端缓存 30 秒（跑完一次系统体检以后不用等，下次打开就用新结果），点页头的「刷新」（手机上在页面底部）不用缓存，重新读一遍。
桌面上最上面是 NAS 概览，下面是今天播出与待处理；再往下左边是继续观看、最近入库与这周还要播，右边是下载器、存储与状态，窗口窄时右边这几块放到下面。手机上从上到下排成一列，NAS 概览在最上面。
NAS 概览
首页最上面的一张卡，显示一台机器现在的 CPU、内存、网络与存储。数据来自「系统 → NAS 监控」里的来源（见 NAS 监控）：pt-tools 所在的主机（本机来源），或者接入的 NAS。首页显示哪一个在 NAS 监控里选，默认显示第一个能用的来源，没有时用本机。
标题旁边写来源的类型（例如 本机），右边是更新时间：绿色圆点加 刚刚更新、40 秒前更新；超过 90 秒没更新时圆点变成黄色，连不上时变成红色并写 连不上 · 这是 3 分钟前的数据。接了几个来源时还写 另有 N 个来源（有连不上的写 N 个来源有问题，鼠标停在上面看各自的状态）。「NAS 监控 ›」打开 NAS 监控页。
主机行：主机名、平台与版本（例如
Linux 6.12.15）、CPU 型号与核数、内存总量、已运行多久。接入的 NAS 有严重告警或存储池用了 80% 以上时，右边写出来（2 条严重告警、tank 已用 85%，90% 以上是红色）。四张数值卡：
卡 大字 下面一行 下面的图 CPU 使用率 负载，读得到时还有 IO 等待与 CPU 温度（读不到温度时写 读不到温度）最近 30 拍的使用率 内存 用了百分之几 已用与可用 最近 30 拍 网络 所有网卡合起来的下行速度 上行速度 最近 30 拍的下行速度 存储 各存储池合起来用了百分之几 已用与剩余 一段一个存储池，段宽按容量，下面写各池用了多少 一拍 30 秒，柱子新的一拍从右边推进来，数字从旧值过渡到新值。这个来源读不到某一类数据时，大字写
—，下面一行写原因。存储池、硬盘与告警（接入的 NAS 才有）：每个存储池写健康状态与用了多少，用了 80% 以上写
快满了、条换成黄色，90% 以上换成红色，最多列 5 个；每块硬盘一个方块，写温度、类型与容量，机械盘 50 °C、固态与 NVMe 70 °C 以上换成黄色，读不到的写没有温度，最多列 9 块；告警写严重、警告、信息各几条和最新的三条，最下面一行写应用：运行中几个、共几个、几个可更新。
本机来源读不到网卡、存储池、硬盘与告警：网络那张卡换成 下载器速度（所有下载器合起来），存储那张卡合计首页的下载盘与媒体库所在的盘；下面一行左边列这几块盘，右边写本机读不到哪些。
首页显示的来源连不上、登录失败或证书有问题时，卡片顶上一条红色的说明写原因与下次什么时候再试，点「去看看」打开 NAS 监控；下面还是上一次读到的数据，颜色变灰。一个能显示的来源都没有时（例如关了本机来源、也没有接入 NAS），卡片写 还没有 NAS 监控来源，按钮打开 NAS 监控。
开着首页时每 30 秒取一次新数据（只读 pt-tools 内存里的，不会让 NAS 多一次请求），切到别的标签页时不取。系统设置里打开「减少动态效果」时，卡片出现、数字过渡与柱子推进都不动，直接换成新值。
今天播出
列出订阅的剧集今天播出的集与今天上映的电影，一项一张卡（同订阅日历的今天那一天）。标题右边是计数（3 集、4 集 · 1 部）与「看日历」；一个订阅都没有时写 还没有追剧，右边换成「去探索」；有订阅但今天没有要播的写 今天没有要播的集。
每张卡是剧照（没有剧照时用这一部的背景图）、状态、名字与副行。按播出时间追剧的带上播出时刻：状态是 还没播 的写 20:00 播出，别的写 19:30。
| 状态 | 副行 | 卡片底部 |
|---|---|---|
已入库 | 集号与入库文件的版本（S02E09 · 2160p HHWEB） | 媒体服务器里有这一集时是「播放」：在新标签页打开服务器上的这一集；没有时写 已入库 |
下载中 | 集号、站点与进度（S03E05 · HDSky 63%） | 写 下载中，预计 12 分钟 |
缺 | 集号与播出了多久（S01E21 · 播出 6 小时） | 「搜资源」：打开种子搜索，按这个条目搜这一季（见按条目搜索） |
等版本 | 集号与锁住的版本（S02E09 · 锁定 HHWEB 2160p） | 「看版本」：打开条目详情，滚到这一集 |
还没播 | 集号与集名 | 什么时候开始搜：按播出时间追剧的写 播出后 2 小时开始搜（播出就搜的写 播出就开始搜），别的写 按追剧计划搜 |
不追 | 集号与集名 | 写 这一集不追 |
电影的副行写 电影 · 今天上映，入库以后写入库文件的版本。
桌面上卡片排成一行，排不下时两端有翻页按钮。手机上横着滑，下面的圆点是第几张；点整张卡：已入库、服务器里有的去播放，缺的去按条目搜索，别的打开条目详情。
待处理
一行列出要你处理的几类事，每类一个标签，写着有几件；页头的「几件事要处理」是这些数加起来。没有时写 没有要处理的事。
| 标签 | 什么时候出现 | 点了去哪 |
|---|---|---|
整理失败 N | 整理失败、不再自动重试的记录（没识别出来的另算一类） | 「整理历史」，只看失败的 |
识别不出 N | 没识别出来的失败与跳过的记录 | 「整理历史」，分类选好「没识别出来」 |
等版本 N | 在找的订阅里在等锁住的版本的集，N 是集数 | 「追剧与订阅」，勾上「等版本」：只看有集在等版本的订阅 |
某站 签到失败、N 个站点签到失败 | 启用的站点今天签到失败 | 「自动签到」 |
某站 登录探测失败、N 个站点登录探测失败 | 启用、没关登录探测的站点最近一次探测不正常（同每日战报的「登录状态异常」） | 「站点列表」，只看异常的 |
媒体服务器里删了 N 部 | pt-tools 整理进库的片子在媒体服务器里没了，按部计数 | 打开抽屉，在首页处理（见下） |
库文件不见了 N 个 | 每天巡检发现库里的文件不见了，按文件计数 | 打开抽屉，在首页处理（见下） |
备份 N 天没成功、最近一次备份失败 | 开着每天定时备份，最近一次失败，或者两天以上没成功 | 「全局设置」，滚到备份那一段 |
体检有 N 项失败 | 上一次系统体检有失败的项 | 「系统体检」 |
「全部」打开右侧的抽屉（手机上是全屏），一件事一行，写明是哪一部、哪个站点或哪一项，每类最多列 20 行；点某一类的标签时抽屉里只列这一类。大多数行的「去处理」打开对应的页面；等版本的一行是一个订阅，写哪几集在等，「去处理」打开条目详情、滚到第一个在等的集。
媒体服务器里删了的与库文件不见了的，同一部（剧集按季）合成一行，在抽屉里直接处理：
继续观看
在 Emby、Jellyfin 的设置里选了「继续观看的用户」时才有这一块（见继续观看）：这个用户没看完的电影与剧集，一项一张卡，写还剩多久（S01E13 · 还剩 18 分钟），底下的进度条是看了多少。点卡片在新标签页打开服务器上的这一项。标题旁边写服务器与用户（Jellyfin · admin），右边「在 Jellyfin 打开」打开服务器的网页。
桌面上只排一行，放不下的不显示；手机上横着滑。没有选了用户的 Emby、Jellyfin 时整块不显示。
最近入库
最近整理进库的电影与剧集，最多 12 项：同一季的几集合成一项，写最新的那一集（S01E14）；连了媒体服务器时，服务器里新加、不是 pt-tools 整理的也列进来。海报右上角是按种子名解析出的质量（Remux 或分辨率，服务器里新加的没有）。标题旁边写今天入库了几项，右边「整理历史」打开整理历史。点海报打开条目详情。
这周还要播
明天起 6 天里订阅的集哪天播出、电影哪天上映，列前 4 项，一项写日期、名字与集号、播出时刻（按播出时间追剧的才有）。其余的点「看日历」在订阅日历里看。点一项打开条目详情，剧集滚到那一集。
下载器、存储与状态
首页右边（窗口窄时在下面）从上到下三块：
- 下载器：标题旁边写有几台，右边「任务列表」打开任务列表。上面是所有下载器合起来的下载与上传速度（桌面上还写下载中、做种的种子数），下面的柱子是最近 20 拍的总速度，一拍 30 秒；下面每台启用的下载器一行，写上下行速度，连不上时写
离线与原因。速度跟着页面底部的状态栏每 30 秒更新，不用刷新首页。速度柱只在有人开着网页时记，pt-tools 重启后从头记；某一拍有下载器没取到时，鼠标停在速度上会写明那一拍只算了连上的。 - 存储：首页显示的不是本机来源时才有这一块（本机来源时这几块盘在 NAS 概览里）。每台下载器的默认保存路径（
下载盘 · qb）与每个媒体库（媒体库 · 电影）所在的盘，写剩余与总量，同一块盘只列一行、名字连在一起。下载器的路径配了路径映射时按映射到的 pt-tools 路径读；pt-tools 里读不到时用下载器报的剩余空间（这时不知道总量，不画条）。剩余不到总量的 5% 或不到 20 GB 时，剩余与条都换成红色；用了 85% 以上时条换成黄色。读不到的盘那一行写取不到与原因，例如下载器连不上时读不到它的默认保存路径。 - 状态：体检、备份与媒体服务器各一行，右上角「系统体检 ›」打开系统体检。
- 体检：标题写上一次体检的结果（
体检：13 项通过，1 项提醒），下面一行写第一项失败（没有失败时写第一项提醒），右边是体检的时刻；点了打开系统体检。没体检过时写体检：没体检过，右边是「体检」。 - 备份：标题写最近一次的结果（
备份：最近一次 04:30 成功、备份：3 天没成功、备份：最近一次失败、备份：每天定时备份关着；开着但到点前一份都没做过时写备份：没做过），失败时下面一行写原因；「设置」打开全局设置的备份那一段。 - 媒体服务器：标题写第一台媒体服务器的种类与版本、上次同步索引的时刻（
Jellyfin 12.2 · 14:00 同步），下面一行写索引里有多少部电影与剧、继续观看有几项；连不上或上次同步索引失败时标题写出来（Jellyfin 12.2：连不上），下面一行写原因。「打开」在新标签页打开服务器的网页。没有媒体服务器时写没有连媒体服务器，「去设置」打开媒体库页。
- 体检：标题写上一次体检的结果（
状态行右边的时刻是今天的只写时间（08:00），别的天带日期（11-03 08:00）。手机上不列各台下载器，存储只列下载盘与媒体库盘各一块（剩余最少的那块），状态行只有标题那一行。
系统体检
「系统 → 系统体检」，或首页「状态」那一块右上角的「系统体检 ›」打开。页面显示上一次体检的结果：页头写体检的时间、用了多久与结果（例如 11-04 09:30 体检 · 用时 3.2 秒 · 1 项失败、1 项提醒）。下面从上到下是三块：
- 总览：左边的环形图按项数分成失败、提醒、正常、跳过几段，中间写有几项要处理（都没问题时写
都正常）；右边是上一次体检的时间与项数、四个计数块和各组的状态条。点计数块只看这个状态的项，再点一次取消；点一组的状态条跳到下面那一组（被筛选藏起来时先清掉筛选）。 - 需要处理：每个失败或提醒的项一张卡，失败在前、提醒在后。卡上写现在的样子、怎么修，以及「去处理」：站点去那个站点的详情页，下载器去「下载器设置」，媒体服务器、路径映射与媒体库去「媒体库」，TMDB 与时间去「媒体识别」，NAS 去「NAS 监控」，备份去「全局设置」；磁盘空间与加密密钥没有能在页面上改的地方，不给链接。点「立即体检」以后，比体检前变坏的项（新出现的问题，或者从提醒变成失败）带
新出现。没有要处理的项时这一块只写没有要处理的项。 - 全部检查项：每组一张卡，卡头是组名、项数与这一组最坏的状态，下面一项一行。右上角的「只看有问题的」只列提醒与失败的项。
没体检过时写 还没体检过，点卡片里的「立即体检」查第一次。
点「立即体检」（手机上在总览卡底部）现在查一遍，最多 60 秒；同时只跑一次，正在体检时再点会等这一次的结果。体检进行中环形图上转一段弧，写已经用了几秒，下面的卡片还是上一次的结果（区块标题旁写 上一次的结果），结果到了再换。超过 60 秒没查完的那一组算失败，写 在时限内没检查完，多半是连不上，检查网络与代理以后再体检一次。结果会存下来，下次打开页面时显示；首页的待处理与「状态」那一块用的也是这一次的结果。
卡片在结果到了时依次出现，数字从旧值过渡到新值；系统设置里打开「减少动态效果」时这些都不动，直接显示。
体检不改任何设置。媒体库一项同媒体库的「检查」，会在库目录里试建一个文件再删掉；站点一项只看最近一次登录探测的结果，不向站点发新的请求；NAS 一组只看「NAS 监控」已经读到的数据，不再连一次 NAS。
每项的状态是 正常、提醒、失败、跳过（没配这一项，或者这一次没法查）。
| 分组 | 查什么 | 提醒、失败与跳过 |
|---|---|---|
| TMDB | 用 TMDB API Key 请求一次接口，再取一张海报 | 没有 Key、请求太频繁、图片取不到是提醒；Key 无效、连不上是失败 |
| 站点 | 每个启用的站点最近一次登录探测的结果 | 关了登录探测、没探测过、不适用、暂不支持探测的跳过；Cookie 过期、API Key 不对、被站点的防护拦下、连不上、限流等是提醒，写明怎么修 |
| 下载器 | 连每台启用的下载器，读版本与剩余空间 | 没有启用的下载器、读不到剩余空间、剩余不到 20 GB 是提醒；连不上是失败 |
| 媒体服务器 | 连每台启用的媒体服务器，读版本；看上次同步索引的结果 | 没有媒体服务器的跳过；上次同步索引失败是提醒（关了索引的不看）；连不上是失败 |
| 路径映射 | 每条路径映射的 pt-tools 路径在 pt-tools 里能不能读 | 没有路径映射的跳过；目录不在、不是目录、读不了是失败 |
| 媒体库 | 同媒体库的「检查」：库目录存在、可写；用硬链接的库还看下载器的默认保存路径和库是不是在同一个文件系统 | 没有媒体库的跳过；检查的一步失败是失败；硬链接的库和下载器的保存路径不在同一个文件系统是提醒 |
| 磁盘空间 | 数据目录、备份目录、各媒体库、路径映射的 pt-tools 路径与下载器的保存路径所在的盘，同一块盘只列一行 | 剩余不到总量的 5% 或不到 20 GB 是提醒 |
| NAS | 「NAS 监控」里每个启用的接入来源（本机来源不算）：连没连上、存储池健不健康、NAS 自己的严重告警、硬盘温度 | 没有添加来源、来源都停用了或正在连接时跳过；登录失败、证书不受信任或换了、连不上超过 3 分钟、有存储池不健康是失败；刚连不上（不到 3 分钟）、3 分钟没读到新数据、有严重告警、机械盘到 50 °C 或固态盘与 NVMe 到 70 °C 是提醒 |
| 时间 | 本机时间和 TMDB 响应里的时间 | 差 5 分钟以上是提醒：签到、免费到期与定时任务都按本机时间算 |
| 备份 | 每天定时备份开着没有、最近一次的结果 | 关着、没做过的跳过；最近一次失败、两天以上没成功是提醒 |
| 密钥 | 加密密钥来自环境变量 PT_TOOLS_SECRET_KEY 还是 secret.key，文件还在不在 | 读不出来、文件不见了是失败：重启以后存着的 Cookie 与通知凭证都解不开（见备份加密密钥） |