在 Plex 网页浏览影片，点击原生播放按钮旁的 “用 PotPlayer 播放”，使用本机 PotPlayer 播放共享目录中的视频。
项目由 Edge 扩展与 Windows 本地小助手组成。扩展提供播放入口、版本选择、Plex 连接及 SMB 映射设置；小助手读取媒体信息并启动播放器，处理完成后退出。
- 安装扩展和本地小助手，步骤见 安装说明。
- 点击扩展图标 → 连接与映射设置，填写 Plex 地址和令牌，验证并保存。
- 添加文件路径映射，例如
/volume1/Video→\\NAS\Video，点击 保存修改。 - 在 Plex 中打开电影或单集详情页，点击 用 PotPlayer 播放。有多个版本时可先选择版本。
支持 Windows SMB 共享中的单段视频文件。播放入口不负责 Plex 观看状态、评分或进度同步。
需要 Windows、.NET 9 SDK；运行小助手需要 .NET 9 基础运行时。项目没有第三方包依赖，NuGet.Config 清空包源。
$env:DOTNET_CLI_TELEMETRY_OPTOUT = '1'
$env:DOTNET_SKIP_FIRST_TIME_EXPERIENCE = '1'
$env:DOTNET_GENERATE_ASPNET_CERTIFICATE = 'false'
dotnet publish .\src\PotPlayerPlex.NativeHost\PotPlayerPlex.NativeHost.csproj -c Release --self-contained false -o .\artifacts\native-host图标文件已包含在源码中，可使用 .\scripts\Build-Icons.ps1 重新生成。
dotnet run --project .\tests\PotPlayerPlex.Tests\PotPlayerPlex.Tests.csproj --no-launch-profile
node --test .\tests\browser-extension.test.mjs测试使用模拟 Plex、临时配置和虚拟播放器启动器，覆盖路径映射、连接设置、配置兼容与冲突、Native Messaging、按钮定位及页面交互。Node 测试使用内置模块。
| 目录 | 内容 |
|---|---|
browser-extension |
Edge 扩展、设置页面与图标 |
src\PotPlayerPlex.NativeHost |
本地小助手、消息处理与播放器启动 |
src\PotPlayerPlex.Core |
小助手使用的 Plex 只读接口和路径映射 |
src\PotPlayerPlex.Windows |
小助手使用的配置持久化与 Windows 凭据加密 |
scripts |
安装、注销与图标生成 |
tests |
.NET 与 JavaScript 回归测试 |
连接和映射保存在 %LOCALAPPDATA%\PotPlayerPlex\settings.json，令牌由当前 Windows 用户的 DPAPI 加密。更新保留已有设置。
MIT © 2026 flyrobin620。