FitGirl Repack Launcher：从磁力到开玩的 Electron 游戏库管理，一条命令跑起来
【免费下载链接】Fitgirl-Repack-LauncherAn Electron launcher designed specifically for FitGirl Repacks, utilizing pure vanilla JavaScript, HTML, and CSS for optimal performance and customization项目地址: https://gitcode.com/gh_mirrors/fi/Fitgirl-Repack-Launcher
周五晚上想玩个游戏，流程往往是这样的：网页上翻磁力链接，粘进下载客户端，等下完再钻进安装目录找 exe。FitGirl Repack Launcher 把搜索、torrent 下载、安装、启动这四步收进同一个 Electron 窗口里——你会复制粘贴几条命令，剩下的都是点击。
它替你省掉的是什么
一句话定位：一个专为 FitGirl Repacks 做的桌面启动器，原生 JavaScript + HTML + CSS 写成，没有前端框架。它帮"下载过很多 Repack 游戏"的人省时间最明显：以前你收藏的游戏散落在浏览器书签、下载工具历史、硬盘文件夹里，现在全部收敛成一面墙的游戏卡片。
可以把整个主页想象成租赁店的玻璃货架：每一格是一款游戏的封面，想租就拿、租了会贴标记，店员（内置爬虫）会定期把货架上的清单跟官网核对一遍。因为 FitGirl 官网没开放接口，这份清单是 src/public/scripts/singlescrap.js 里的爬虫去解析页面拿回来的。
5 分钟装好：环境清单与最小命令集
先对一下环境，三条都不满足的话就别往下走了：
- Windows 10/11（项目代码里有平台检测，Mac 和 Linux 会直接弹窗告知暂不支持）
- Node.js 16 及以上，装完在命令行敲
node -v能看到版本号 - 至少 4GB 空闲磁盘（游戏本体另算）
命令只有四条，建议用管理员身份打开 PowerShell 或 CMD 再执行，后面安装、启动游戏都少很多权限报错：
git clone https://gitcode.com/gh_mirrors/fi/Fitgirl-Repack-Launcher # 拉取源码，10 秒内完成 cd Fitgirl-Repack-Launcher # 进入项目目录 npm install # 安装 Electron、webtorrent 等依赖，视网速 1~3 分钟 npm start # 启动应用，首次会加载游戏列表最容易卡住的地方是第三步：npm install中途报错的话，九成是网络没连上 npm 源，换个网络或重试一次通常就过了。启动后耐心等加载页跑完，爬虫把官网数据抓回来需要一点时间。
功能拆解：四个功能域
实时搜索：只输几个字母
能做什么：在首页右上角的 Search Games 输入框里边打字边过滤，结果列表实时刷新，不用按回车。怎么用：直接输英文关键词，比如Rimworld；拼不准也没关系，输入到能区分出目标游戏就行。得到什么：一个随输入收缩的候选集，点卡片进详情。
详情面板与一键 torrent 下载
能做什么：下载前看清一款游戏的完整信息。怎么用：点任意游戏卡片，右侧滑出详情面板，四行信息按固定顺序排——Genres/Tags（游戏类型标签）、Company（开发商）、Languages（如RUS/ENG/MULTI28这种语言标记）、原始大小与 Repack 后体积（截图里 RimWorld 是 960 MB 压到 328/498 MB）。觉得合适就点紫色 Download 按钮。得到什么：内置 webtorrent（见 package.json 依赖）接管磁力链接，断点续传，进度条实时可见。
游戏库：装没装，看标记
能做什么：集中查看已下载/已安装的游戏状态。怎么用：点左侧导航栏第二个图标进 Library 页。每张卡片左上角有一个角标：绿色对勾代表已下载完成，红色叉号代表还没下。得到什么：不用翻硬盘，扫一眼就知道库里哪些有存货、哪些只是愿望清单。
一键启动：不碰安装目录
能做什么：免去"找 exe、右键、以管理员运行"三连。怎么用：在 Library 里点开已装好的游戏，详情面板底部是 Start Game 按钮。得到什么：应用自动定位可执行文件并拉起进程。它知道游戏装在哪，靠的是安装时写进src/private/library/locally_installed_games.json的路径记录。
| 功能 | 解决什么 | 入口位置 |
|---|---|---|
| 实时搜索 | 记不全游戏名、想按关键词缩小范围 | 首页右上角输入框 |
| 详情面板 | 下载前确认体积、语言、开发商 | 点击任意游戏卡片 |
| torrent 下载 | 断点续传、进度可视 | 详情面板 Download 按钮 |
| 库状态标记 | 一眼分辨已下/未下 | Library 页封面角标 |
| 一键启动 | 免找安装目录 | 详情面板 Start Game 按钮 |
进阶：四件可以自己动手的事
- 换主题色：打开 src/public/html/style.css，文件开头的
:root里有三个 CSS 变量——--primary-color（背景）、--secondary-color、--accent-color（默认#d3337e的品红，所有按钮和强调色都吃这个值）。改成#4ea8de重启应用，整个界面就从品红变天蓝。 - 让改动跨页面生效：style.css 里有一段注释写得明白——第二节之前的通用样式改动，要同步复制到 library.css、settings.css、favorites.css，否则导航栏和搜索框还是旧配色。
- 调抓取频率：游戏列表由爬虫维护，src/public/scripts/scraper.js 里有一个 1 小时的节流（
lastExecutionTimestamp），一小时内的启动会直接复用缓存。想让列表更新鲜，把1 * 60 * 60 * 1000改小。 - 手动核对库数据：
src/private/library/下三个 JSON 是应用的全部"记忆"——locally_installed_games.json记安装路径，info_downloaded_games.json记下载信息。排查"为什么它找不到我装的游戏"时，直接打开看。
排障手册：症状 → 原因 → 解决
- 🖥窗口闪一下就没了→ 依赖没装全或 Node 版本过低 → 先敲
node -v确认 16+，再重跑npm install。 - 🕐主页卡在加载页、游戏列表为空→ 内置爬虫没抓到官网数据 → 检查网络/代理；注意列表每小时才刷新一次，刚启动时稍等。
- 📉下载速度为 0 或极慢→ 磁力节点少或防火墙挡了 webtorrent 端口 → 把同时下载任务降到 1~2 个，检查防火墙放行情况。
- 🔒游戏能装但启动报权限错→ 应用没用管理员身份运行 → 右键 CMD 选"以管理员身份运行"，再执行
npm start。 - 🍎Mac 或 Linux 上完全无法启动→ 项目只适配 Windows，代码里有平台检测会直接提示 → 换 Windows 环境。
- 💾重装后存档不见了→ 应用只管游戏本体，不碰存档 → 重要存档定期从
Documents\My Games或游戏目录的 saves 文件夹手动拷走。
收尾：五步把它用起来
- 管理员终端里跑完四条命令，看到游戏卡片列表出现就算成功
- 用英文原名搜一款游戏，点开详情面板核对体积和语言
- 下载前给硬盘留足游戏体积两倍的临时空间，点 Download 等进度条
- 下载完成后进 Library 确认绿勾，用 Start Game 验证能正常启动
- 顺手改一次
--accent-color，熟悉它"改 CSS 即换肤"的定制方式
想往更深处看，两个入口就够：src/public/main.js 是主进程，webtorrent 客户端和库文件读写都在里面；src/public/scripts/singlescrap.js 是爬虫本体，官网数据怎么被解析成游戏卡片，读完这一百多行就明白了。
【免费下载链接】Fitgirl-Repack-LauncherAn Electron launcher designed specifically for FitGirl Repacks, utilizing pure vanilla JavaScript, HTML, and CSS for optimal performance and customization项目地址: https://gitcode.com/gh_mirrors/fi/Fitgirl-Repack-Launcher
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
