PotatoVN

PotatoVN是一款面向 Windows 平台的开源视觉小说（Galgame）管理工具，由开发者 GoldenPotato137 主导开发，托管于 GitHub 平台。该工具以“galgame 屯屯鼠”为核心用户画像，旨在为大量游戏文件的集中管理提供便捷平台。PotatoVN 采用 WinUI 3 框架构建，是较早以现代化 Windows UI 技术栈实现的 Galgame 管理工具之一。

项目背景

PotatoVN 于 2023 年前后进入 Galgame 社区视野，最初在 galgame 贴吧和 Stage1st 等论坛被社区成员推荐。开发者在应用分享平台“小众软件”上以“开发者自荐”的形式介绍了该项目，将其定位为“方便的游戏管理平台”，并强调其存档云同步功能便于在不同电脑间同步游戏进度。项目名称“Potato”取自开发者的昵称 GoldenPotato137，开发者同时维护着个人博客和项目文档站点。

PotatoVN 的文档站点 potatovn.net 提供了较为完整的中文使用指南，涵盖游戏导入、信息源配置、云存档设置、同步服务器部署等主题，文档本身也在 GitHub 上开源维护。

核心功能

游戏导入与游戏库管理

PotatoVN 支持单个游戏导入和批量导入两种模式。单个导入可通过选择运行文件（支持 .exe 和 .bat 格式）或直接拖拽文件夹完成；批量导入则通过将多个游戏整合到一个文件夹（游戏库）进行统一扫描和管理。系统将文件夹识别为游戏的条件是：包含 .exe 文件，同时至少包含 .xp3、.arc、.dat、.ini、.dll、.txt、.pac、.noa、.sh、.bin、.pck 等文件类型中的任意一种，匹配规则可由用户在设置中自定义。

同一款游戏可以同时存在于多个本地游戏库，也可以保留本地文件夹版和 Steam 版。PotatoVN 会将它们显示为同一游戏下的多个安装实例，游戏信息和游玩状态共享，但运行文件、启动参数和存档路径可以分别设置。这一设计在同时管理数字商店版本和本地安装版本时较为实用。

元数据检索

PotatoVN 可从多个信息源自动获取游戏信息。截至 v1.8.1，支持的信息源包括 Bangumi、VNDB、月幕Galgame（Ymgal）以及 CnGal（仅限国产游戏）。系统提供混合搜刮器，允许用户自定义不同条目（如封面、简介）从各个信息源获取的优先级。用户也可通过输入信息源对应的游戏 ID 进行精确匹配。

导入游戏时，PotatoVN 会自动将文件夹名称作为默认游戏名，并在配置的信息源中搜索匹配结果。用户可在弹出的信息窗口中确认或修改匹配的数据。

云存档同步

云存档同步是 PotatoVN 的特色功能之一。该功能需要用户电脑上已安装任意一款同步软件（如 OneDrive、NextCloud、坚果云、百度云同步盘等），PotatoVN 将存档文件夹纳入同步范围，并在原存档位置建立指向新位置的快捷方式，使游戏在访问存档时自动读取新位置的文件。v1.9.11 版本进一步支持了单个文件的云同步，此前仅支持整个存档文件夹的同步。

除本地同步方案外，PotatoVN 也提供官方同步服务器，用户可使用 PotatoVN 账户或 Bangumi 账户登录，同步游戏列表与游玩状态，并支持自建同步服务器。

转区启动与运行辅助

PotatoVN 支持为游戏设置启动参数，并集成了 Locale Emulator 一键转区启动功能，用于处理部分日文游戏在非日文系统下的乱码问题。此外，v1.10.1 版本引入了按键映射功能，旨在解决不同 Galgame 快捷键不统一的问题，映射仅在通过 PotatoVN 启动游戏时生效。

自动库维护

在开启相应设置后，PotatoVN 可在软件运行期间自动检测游戏库文件夹中的增删操作，并相应地更新库内游戏记录。该功能支持分别控制自动添加和自动移除。

技术特点

• 技术栈： PotatoVN 客户端基于 .NET 和 C# 开发，UI 框架为 WinUI 3（Windows UI Library 3），采用 MVVM 架构模式，框架基于 Microsoft TemplateStudio 生成。服务端使用 ASP.NET Core 构建。

• 系统要求： 由于基于 WinUI 3，PotatoVN 仅支持 Windows 10 及以上系统。Windows 10 用户需额外安装 Segoe Fluent 图标字体。

• 插件系统： v1.10.1 版本引入了全新的插件体系，支持插件提供自定义搜刮器、自定义设置界面、注入账户界面、注入游戏详情页、注册侧边栏按钮等功能。软件内置插件市场，用户可在软件内浏览、下载、安装与卸载插件，也支持加载本地 zip 插件包。插件可使用 XAML 定义 UI，也可通过 C# 代码直接描述界面。插件管理平台由 RepoFlow 提供正版授权支持。

• 本地化： PotatoVN 使用 Crowdin 平台进行多语言本地化，社区成员可参与翻译贡献。

• 代码签名： 项目由 SignPath.io 提供免费代码签名服务，证书由 SignPath Foundation 签发。

社区影响

PotatoVN 在 Galgame 管理工具领域具有较高的社区知名度。在中文 Galgame 社区中，该工具常被推荐给拥有大量游戏文件、需要统一管理界面的玩家。社区反馈普遍认可其元数据检索速度和云存档同步功能的实用性，部分用户指出 VNDB 信息源的匹配准确度有时不够理想，开发者回应称匹配基于文件夹名称判断，建议用户保持文件夹命名规范或在编辑界面手动指定游戏 ID。

项目获得了多家组织的基础设施支持，包括 SignPath.io 提供的代码签名、RepoFlow 提供的插件管理平台正版授权，以及 JetBrains 提供的 Rider IDE 开发工具授权。PotatoVN 官方设有 Telegram 用户交流群，开发者亦通过邮件为同步空间不足的用户提供免费扩容服务。