中文化

打开后，中文标题按拼音排序，可以在 Plex 中用拼音首字母或全拼搜索。英文标题交给 Plex 自己处理。

1. 1在管理面板左侧打开「中文本地化」，切到「设置」。
2. 2打开「拼音排序与搜索」，在「启用的媒体库」里选择要处理的库，默认自动选择中文媒体库，包括音乐库。
3. 3在「排序标题写法」里选择写法。
4. 4点「保存修改」，确认预演结果后开始写入。

以「潮汐之间」为例，「首字母」写成 CXZJ，「全拼」写成 chaoxizhijian，「全拼 + 首字母」写成 chaoxizhijian CXZJ。三种写法决定能用哪种拼音搜索。

首字母

只按首字母粗排，可以搜 cxzj 这样的首字母。

全拼

排序准确，可以搜 chaoxi 这样从头开始的全拼。

全拼 + 首字母

排序准确，全拼与首字母都能搜。

三种写法都搜不到从中间开始的音节，例如「潮汐之间」的 zhijian。切换写法后已写入的条目按新写法重写，保存前提示条目数与预计耗时。中文条目按拼音与英文标题交错排列，在 Plex Web 与官方 App 里都能用拼音搜索。

启用的媒体库

支持电影、剧集与音乐库。默认选中媒体库语言为中文的库，之后新建的中文媒体库也自动纳入，手动勾选后以勾选为准。

单集标题

打开后在 Plex 顶部的搜索框输入拼音就能找到这一集，媒体库里的筛选仍只认中文标题。写法与锁定沿用上面的设置，只在拼音排序打开时生效。单集数量通常很多，第一次写入会久得多。

处理音乐曲目

音乐库默认只处理艺人与专辑，打开后曲目的排序标题、类型与情绪也一并处理。曲目数量通常很多，第一次写入会久得多，而曲目在专辑里按序号排列，排序收益不大。

锁定写入的字段

默认打开，Plex 刷新元数据后拼音与中文类型保持不变。关闭后刷新会让它们暂时回到 Plex 的默认值，下一轮自动处理再写回。切换后已写入的条目按新的锁定状态重写。

打开后用繁体搜得到简体标题，用简体也搜得到繁体标题，例如搜「潮汐之間」能找到「潮汐之间」。排序仍按拼音。

• 在「中文本地化」页设置里打开「简繁混搜」，它只在「拼音排序与搜索」打开时生效。
• 标题的另一种写法追加在排序标题末尾，繁体按台湾的字形转换。
• 开启或关闭后，有另一种写法的条目按新写法重写，保存前同样先预演。

打开「类型中文化」后，电影与剧集的类型、音乐的类型、风格与情绪显示为中文。翻译按「类型对照表」进行，内置表覆盖常见类型。

点「编辑对照表」可以增删改，也可以「导入 JSON」，例如 MoviePilot「Plex中文本地化」插件的标签设置。导入的内容与现有项合并，同名项以导入为准。

• 已经是中文或对照表里没有的类型保持原样。
• 全部条目换完之前，类型筛选里会短暂中英并存。
• 改了对照表只影响 Cirvel 写过的类型，你自己写下的不受影响。

保存中文本地化的设置之前，Cirvel 先预演一遍，列出将要写入的条目数、按媒体库的分布与预计耗时。确认无误点「保存并开始」，写入在后台进行，可以随时停止或还原。

• 你在 Plex 中自己改过或锁定的值归你所有，不会被覆盖，预演里单独列出数量。
• 写入前的原值都会记下，任何时候都能在「中文本地化」页还原。
• 没有 Pro 时可以保存，但不会写入，激活后开始。

排序标题或类型在 Plex 里改过、锁定过，或由其它工具写下的，归为「已有自定义值」，默认不动，页首会提示有多少个条目已有自定义值。想交给 Cirvel 维护时，点提示里的「查看并接管」先看看是哪些条目，再在媒体库行的菜单里选「接管已有自定义值」，或在页面的菜单里选「全部接管」，确认后按 Cirvel 的写法改写。原值与锁定状态会记下，还原时原样恢复。

电影与剧集的演员、导演、编剧与制片显示中文姓名，所有客户端都能看到，也能用中文姓名搜到人物。角色名只在公开资料收录了中文角色时显示中文。

1. 1在管理面板左侧打开「演职人员中文化」，切到「设置」。
2. 2打开「演职人员中文化」。中文姓名默认来自 Wikidata，填入自己的「TMDB API key」后覆盖更广。这个 key 也用于「元数据」页的缺集检查。
3. 3按需调整「日韩姓名」「中文姓名」「译名」与「角色名」的显示方式，「姓名预览」会示范效果。
4. 4点「保存修改」，已有的电影与剧集在后台陆续换成中文姓名，新入库的随后自动处理。

在 Plex 里刷新元数据后会短暂回到原名，随后自动恢复。冷门演员在来源没有收录时保持原名。容器连不上 Wikidata、又没有填 TMDB API key 时，演职人员取不到中文名，状态页会提示，点「填写 TMDB API key」补上即可。

• 来源 至少要有一个可用的来源，即填入「TMDB API key」或启用 Wikidata。TMDB 可以填 API key（v3）或读取令牌（v4），中文姓名的覆盖面比 Wikidata 更广。
• 来源顺序 每位人物取排在最前、给出了中文的来源，没有中文结果的来源跳过。调整顺序按已取得的结果直接重新计算，不重新查询。
• 日韩姓名 「原文名」是本人的母语写法，「外文名」是 Plex 原来的名字，「中文加外文名」两种都能搜到。母语写法来自 Wikidata，只在 TMDB 找得到的人物按中文名的写法归入「中文姓名」或「译名」。
• 中文姓名与译名 中文名是纯汉字写法的人物归「中文姓名」，按读音翻译、带「·」或空格分隔的归「译名」，例如约翰·史密斯。
• 角色名 中文角色名来自 Wikidata 与华语作品原本的写法，只有部分作品有，其余保持原文。
• 以上显示方式对演员、导演、编剧与制片一致，改动在下一轮自动处理时生效，不需要在 Plex 里刷新。
• 启用的媒体库 默认处理全部电影与剧集库，之后新建的也自动纳入，手动勾选后以勾选为准。

演职表被锁定或被其它工具改写过的作品归为「被其它工具改写」，默认跳过，页首会提示有多少部作品与多少集。常见的来源是 MoviePilot「Plex演职人员刮削」这类插件。想交给 Cirvel 时，点提示里的「查看并接管」或媒体库行菜单里的「接管改写过的演职人员」，勾选要接管的条目后点「接管所选」。接管会解除锁定并请 Plex 刷新取回原始的演职人员，再改为中文，它们现在的写法会被丢弃，无法恢复。改写它们的插件还开着时，先停用，否则会再次改写。

Cirvel 写入过的排序标题、类型与演职人员都可以恢复原样，免费版同样可用。

• 在「中文本地化」或「演职人员中文化」页，从菜单选「全部还原」或某个库的「还原此库」，连续确认两次后开始。全部还原同时关闭这项能力，还原此库会把它移出启用范围。
• 只想处理一个条目时，在「查找条目」里打开它，点「还原并排除」，之后的自动处理跳过它，演职人员中文化还会跳过剧下面的各集。需要时回到这里点「恢复处理」。
• 排除过的条目列在设置里的「排除的条目」，点「全部恢复」并保存后，下一轮自动处理时重新处理。
• 在「演职人员中文化」页还原一个媒体库会把它移出启用范围，之后 Plex 刷新元数据也不会让它回到中文。