第三方插件
任何人都可以用插件 SDK 做插件（见开发者文档），例如新的元数据来源、字幕来源、弹幕或演员别名对照表。这一页说明怎样安装第三方插件，以及更重要的：安装时你在信任什么。
安装第三方插件#
第三方插件来自「插件目录」：一个列出插件的 HTTPS 地址。要加入目录，打开「插件」→「插件市场」→「管理插件目录」，输入地址后点「加入」。加入前会先提示风险（见下文），确认后才会加入。同一个窗口会列出所有目录和各自最近一次取得的结果，也可以移除第三方目录（已经从它安装的插件会继续运行；官方目录不能移除）。服务器知道某个目录后，目录里的插件会出现在「插件市场」分页，并标有「第三方」和目录的地址。
- 打开「插件」→「插件市场」，找到插件。
- 点「安装」。会弹出警告，询问是否安装第三方插件；读完后点「仍要安装」。
- 像其他插件一样设置并启用。
目录地址必须是公开的 HTTPS 地址。服务器会拒绝你自己网络里的地址（localhost、内网地址，以及 .lan、.local 这类名称），所以不能加入放在你自己局域网里的目录。
更新只会从你安装它的那个目录找，其他目录不能用更高的版本取代它。
安装前请先看这里#
- 插件是以服务器自己的权限运行的程序，没有额外的隔离。 它可以读取服务器能读的任何文件（包括你的媒体库和服务器的数据目录）、连上网络、启动其他程序。安装第三方插件，就是信任它的作者。只从你信得过的来源安装。
- Kryspal 自己目录里的内容有数字签名，服务器会验证；第三方目录没有签名。 服务器只能检查下载的文件和目录里写的是否一致，无法证明作者是谁。
- Kryspal 插件的名称不能被冒用：第三方目录里与它们同名的项目会被忽略。
- 敏感权限需要管理员明确允许，默认不给。使用 AI 增强（BETA）和访问你的局域网就是其中两项：插件页上会有「AI 使用权限」和「局域网访问」开关。
- 不放心就不要安装。已安装的插件可以随时停用或卸载。
插件能做什么、不能做什么#
- 可以提供：元数据、图片、字幕、片头片尾数据、弹幕、演员别名对照表、元数据识别增强、成员同步等。
- 第三方插件可以提供新的能力。对应付费功能的能力（名称识别、字幕搜索与下载、社区片头片尾数据），不论由谁提供，都需要相同的方案；其他功能则可以免费提供。插件本身不会被锁住：没有方案也可以安装、设置和启用，在你有对应方案之前，它的页面会写「这项功能需要 PRO 才会生效」，这项付费功能不会被使用。
- 演员别名对照表（本名与艺名的对照）：声明了这项能力的插件可以提供整张对照表。服务器每天同步一次，只用来认出同一个人：扫描与刮削时、搜索时，以及检测疑似重复时作为佐证。它不会自己合并已经存在的两个演员。管理员可以停用某个插件的对照表。
第三方插件出问题时#
- 反复崩溃的插件会被自动停用，原因会显示在插件页。各种状态见「插件中心」页。
- 插件的问题请先反馈给插件作者；只有服务器本身的问题才反馈给我们。