PLCN v3.3.1

Download a matching installer below; no Python, Node.js or Xcode needed.
Windows/macOS packages include ADB. Android USB debugging authorization
and, for some Windows devices, vendor USB drivers are still required.

These CI packages are not distribution-signed; macOS is not notarized.
First-launch security restrictions may apply. See README installation notes.

Chinese game titles can be searched against the official artwork gallery;
candidates are graded by match quality and are only written after an
explicit click. The playlist image column reports cover, snap and title
screen status separately. Backups stay outside the playlists folder.

Disc-based games are listed per disc when there is no .m3u, and as the
single .m3u entry when there is one. Names can be edited inline, and the
repair preview no longer carries a separate write-name column.

中文游戏名可直接搜索官方图库，候选按匹配可靠度分级，必须手动点选后才会写入；
游戏列表的图片列分别显示封面、游戏截图、标题图的状态。

光盘游戏没有 .m3u 时按碟逐行显示，有 .m3u 时只显示 m3u；
名称可在行内编辑，补图预览不再单独占用“写入名称”列。

PLCN v3.3.0

Download a matching installer below; no Python, Node.js or Xcode needed.
Windows/macOS packages include ADB. Android USB debugging authorization
and, for some Windows devices, vendor USB drivers are still required.

These CI packages are not distribution-signed; macOS is not notarized.
First-launch security restrictions may apply. See README installation notes.

Chinese game titles can be searched against the official artwork gallery;
candidates are graded by match quality and are only written after an
explicit click. The playlist image column reports cover, snap and title
screen status separately. Backups stay outside the playlists folder.

中文游戏名可直接搜索官方图库，候选按匹配可靠度分级，必须手动点选后才会写入；
游戏列表的图片列分别显示封面、游戏截图、标题图的状态。

PLCN v3.2.5

下载即用

下载对应系统的附件，无需 GitHub 账号，无需安装 Python、Node.js 或 Xcode。启动后会自动打开本机浏览器界面。

系统	下载与启动
Windows 10/11 x64	PLCN-Windows-x64-Setup.exe：双击安装，从开始菜单启动
Windows 便携版	PLCN-Windows-x64-Portable.zip：完整解压后双击 PLCN.exe
Mac Apple 芯片	PLCN-macOS-arm64.dmg：打开后将 PLCN 拖入“应用程序”
Mac Intel	PLCN-macOS-x64.dmg：打开后将 PLCN 拖入“应用程序”
Linux x64	PLCN-Linux-x64.tar.gz：命令行版本，解压后运行 ./plcn --help

请下载以上附件，不要把 GitHub 自动生成的 Source code 当作安装包。

本次更新

• Windows / macOS 安装包内置 ADB，无需另外安装命令行工具。Android 掌机仍需开启 USB 调试并授权；部分 Windows 设备需要厂商 USB 驱动。
• DOS 游戏中文别名识别、官方图库优先搜索，以及带来源信息的备用图片预览和本地导入。
• 修复中文化或换图后，同一光盘的英文 CUE/BIN 等重复入口残留。保留不同光盘、版本和 ROM 文件。
• 游戏列表备份保存在电脑的应用数据目录，不在 playlists 目录生成备份列表。
• 修复 Windows 中文图片缓存读取和备份路径处理。

写入设备前请正常退出 RetroArch，避免旧列表覆盖修改。

签名与验证

本次按未公证版本发布：macOS 未使用 Developer ID 发行签名、未公证；Windows 未做发行证书签名。首次启动可能被系统安全策略拦截。请核对下载来源并参阅 macOS 官方说明 或 Windows 安全说明，不建议关闭系统防护。

GitHub Actions 已验证 macOS 两种架构的 DMG 安装与启动、Windows 安装启动卸载、内置 ADB 可执行检查，以及跨平台回归测试。这不代表所有系统安全策略和所有 USB 设备均已人工测试。

Windows/macOS packages are self-contained and include ADB. No Python, Node.js or Xcode is required. These packages are not distribution-signed; macOS is not notarized. Linux is a CLI build. See English README.

v3.2.3 游戏列表备份位置修复 (unsigned)

Windows installer/portable ZIP and macOS Intel/Apple Silicon DMGs.
These are unsigned preview artifacts. Complete signing/notarization and
manual installation/file-picker/device validation before a public stable release.
See DOC/DESKTOP_GUIDE.md for the release checklist.

v3.2.2 ADB 图片重试修复 (unsigned)

Windows installer/portable ZIP and macOS Intel/Apple Silicon DMGs.
These are unsigned preview artifacts. Complete signing/notarization and
manual installation/file-picker/device validation before a public stable release.
See DOC/DESKTOP_GUIDE.md for the release checklist.

v3.2.1 光盘游戏列表修复 (unsigned)

Windows installer/portable ZIP and macOS Intel/Apple Silicon DMGs.
These are unsigned preview artifacts. Complete signing/notarization and
manual installation/file-picker/device validation before a public stable release.
See DOC/DESKTOP_GUIDE.md for the release checklist.

v3.2.0 设备游戏库工作台 (unsigned)

Windows installer/portable ZIP and macOS Intel/Apple Silicon DMGs.
These are unsigned preview artifacts. Complete signing/notarization and
manual installation/file-picker/device validation before a public stable release.
See DOC/DESKTOP_GUIDE.md for the release checklist.

v3.1.1

PLCN v3.1.1 中文父目录名称修复

中文更新

• 修复普通 ROM 列表扫描时，gba中文游戏、中文游戏、游戏合集 等中文父目录名被误写成所有游戏名称的问题。
• 修复已被旧版本污染的游戏列表：如果当前 label 已经变成泛化目录名，重新预览时会回到 ROM 文件名和数据库匹配结果。
• 调整匹配优先级：ROM 文件名、已有有效 label、Libretro DAT 和本地中文库优先，中文集合目录只作为弱线索，不再覆盖游戏身份。
• 保留 v3.1 状态驱动修复工作台、封面状态即时刷新、“写入名称 / 封面源英文名”拆分显示和 FBNeo/Arcade 匹配增强。
• 新增 GBA 中文父目录和已污染 label 的回归测试，防止扫描后整组游戏显示成同一个目录名。

English Updates

• Fixed regular ROM playlist scans where Chinese parent folders such as gba中文游戏, 中文游戏, or 游戏合集 could be written as every game's display name.
• Fixed playlists already polluted by older versions: when the current label is a generic collection folder name, preview now repairs it from the ROM filename and database match.
• Adjusted matching priority so ROM filenames, valid existing labels, Libretro DAT evidence, and the local Chinese database win over generic Chinese collection folders.
• Preserved the v3.1 status-driven repair workbench, immediate cover-state refresh, separated Write Name / Cover Source Name fields, and FBNeo/Arcade matching improvements.
• Added regression coverage for GBA Chinese parent folders and polluted labels so a whole scanned list cannot collapse to one folder name again.

v3.1.0

PLCN v3.1.0 状态与封面匹配优化

中文更新

• 升级状态驱动修复工作台，清晰区分“可自动修复 / 无需修复 / 已完成 / 需人工确认 / 重复需处理”。
• 移除逐行人工确认按钮，改为通过状态、勾选队列和应用摘要决定是否写回。
• 修复完成后即时更新当前名称、封面状态和本地/ADB 封面预览，不再依赖刷新页面。
• 将表格字段调整为“写入名称”和“封面源英文名”，避免把英文封面源误读为推荐中文名。
• 优化中文目录和中文当前名的封面源匹配：优先使用文件名、精确别名和 Libretro DAT 线索，修复 Snatcher.bin 被匹配到无关英文名的问题。
• 增强 FBNeo/Arcade 本地匹配，支持 ROM 路径、zip 短名、RetroArch crc32、本地 zip CRC 和 DAT 校验值别名。
• 补充封面路径回写、下载汇总、FBNeo 匹配、搜索精度和 UI 状态模型回归测试。

English Updates

• Upgraded the status-driven repair workbench with clear auto-repair, no-repair-needed, completed, review, and duplicate states.
• Removed per-row manual confirmation buttons; status labels, the selected queue, and the apply summary now drive write-back decisions.
• Current names, cover states, and local/ADB cover previews update immediately after apply without requiring a page refresh.
• Renamed table fields to “Write Name” and “Cover Source Name” so English artwork sources are not confused with recommended Chinese names.
• Hardened artwork-source matching for Chinese folders and existing Chinese labels by preferring filename, exact alias, and Libretro DAT evidence; this fixes cases like Snatcher.bin matching an unrelated English title.
• Improved FBNeo/Arcade local matching with ROM paths, zip short names, RetroArch crc32, local zip CRCs, and DAT checksum aliases.
• Added regression coverage for cover-path write-back, download summaries, FBNeo matching, search precision, and the UI status model.

v3.0.0 - PLCN 设备库工作台

v3.0.0 - PLCN 设备库工作台

中文更新说明

PLCN v3.0.0 把项目从“单个游戏列表修复工具”推进到“设备库扫描 + 修复预览 + 一键应用”的工作台形态。

主要更新

• 新增设备与目录扫描，可识别本地 RetroArch 目录、已挂载设备目录，以及已授权 ADB Android 掌机/设备中的 /sdcard/RetroArch 等常见路径。
• 新增游戏列表库视图，按主机缩写横向筛选，点击主机后直接显示对应游戏列表的所有游戏。
• 新增 ADB 游戏列表读取与写回基础能力：预览时会把远端 .lpl 拉取到本地缓存，应用时会先备份远端游戏列表再推回。
• 重构 PLCN v3.0 Web UI：左侧聚焦设备与目录，中间显示游戏库扫描和修复表格，右侧修复预览改为按需浮层，底部只保留任务进度和按需任务详情。
• 优化表格体验：增加封面缩略图、封面状态、人工确认按钮、选中态、主机缩写筛选、搜索数据库默认英文名自动搜索。
• 优化顶部工具区：中英文 UI 切换、深色/浅色主题切换改为无文字 SVG 图标，并修复切换后的图标状态。
• 优化深色模式：降低选中状态、按钮边框、状态徽章的亮度，长时间校对更耐看。
• 更新 README，GitHub 默认展示中文说明，英文 README 可通过链接打开。
• 新增设备扫描、UI 信息架构、深色主题状态等回归测试。

已知限制

• ADB 需要用户先在设备上完成授权；多设备选择、授权失败解释和更细的超时重试仍需继续优化。
• SSH/SFTP 连接实机尚未实现，后续会作为独立连接器设计。
• 本地封面存在性检查仍在计划中，目前 UI 已区分“待下载 / 已有封面 / 缺少封面源”的前端状态。

English Release Notes

PLCN v3.0.0 moves the project from a single game-list repair helper toward a device-library workbench with scan, review, and one-click apply workflows.

Highlights

• Added device and folder scanning for local RetroArch folders, mounted device folders, and authorized ADB Android handhelds/devices with common paths such as /sdcard/RetroArch.
• Added a game-list library view with horizontal system-abbreviation tabs. Selecting a system shows the matching game list directly.
• Added foundational ADB game-list read/write support: remote .lpl files are materialized into a local cache for preview, then backed up and pushed back during apply.
• Reworked the PLCN v3.0 Web UI: device/folder entry on the left, game-library scan and repair table in the center, on-demand repair preview on the right, and task progress at the bottom.
• Improved table workflows with cover thumbnails, cover status, manual confirmation, stronger selected states, system tabs, and automatic database search using the default English game name.
• Refined the top toolbar: UI language and light/dark theme toggles now use text-free SVG icons with correct icon-state switching.
• Tuned dark mode by reducing active-state brightness, button border intensity, and status badge contrast.
• Updated README so GitHub shows Chinese by default, with the English README available through a link.
• Added regression tests for device scanning, UI information architecture, and dark-theme active states.

Known Limitations

• ADB still requires device-side authorization first. Multi-device selection, authorization diagnostics, and finer timeout/retry handling remain follow-up work.
• SSH/SFTP device connections are not implemented yet and will need a dedicated connector design.
• Local cover existence detection is still planned. The UI now distinguishes pending download, existing cover, and missing cover-source states.