FitGirl Repack Launcher 完整教程环境配置、游戏下载与游戏库管理【免费下载链接】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-LauncherFitGirl Repack Launcher 是一个基于 Electron 与原生 JavaScript 构建的桌面应用专门用于浏览和下载 FitGirl Repacks 站点的游戏。它把“官网检索、磁力下载、安装管理、启动游戏”四步流程收拢到一个窗口内完成。适合需要批量下载 repack 游戏的 Windows 用户也适合作为 Electron 主进程与渲染进程协作的小型实战案例。它解决什么问题官网翻页找游戏、手动复制磁力链接下载完成后要自己翻找安装程序每次启动游戏都要在目录里找 exe体积、语言、开发商等信息分散在网页各处环境要求与快速启动结论先行Windows 加 Node.js 即可四条命令完成部署。组件最低版本说明操作系统Windows 10scraper.js启动时检测平台Mac/Linux 会提示暂不支持Node.js16提供npm用于安装依赖并拉起 ElectronElectron27.0.4package.json中锁定npm install自动安装WebTorrent1.9.7内置种子下载引擎同样在package.json中声明磁盘空间4GB存放依赖与下载文件游戏本体另计# 克隆项目源码 git clone https://gitcode.com/gh_mirrors/fi/Fitgirl-Repack-Launcher # 进入项目目录 cd Fitgirl-Repack-Launcher # 安装依赖耗时 1~2 分钟视网速而定 npm install # 启动应用后续要运行游戏的话建议用管理员终端执行 npm start启动成功的判断标准按顺序核对以下四点终端先打印Platform: win32随后输出App is ready to start...出现一个 400×400 的加载窗口短暂显示后关闭1280×720 主窗口打开弹出 “This app is still in development” 信息框点击Close即可Home 页出现游戏卡片网格右上角是搜索框说明爬虫已成功拉取游戏列表功能模块拆解Home 页浏览与搜索入口启动后默认进入 Home 页侧边栏 Home 图标主区域是游戏卡片网格右上角搜索框占位符为 “Search For Games”。启动爬虫把游戏列表写入src/private/temp/games.json后页面渲染成如下网格操作点击网格中任意游戏卡片右侧滑出详情面板在搜索框输入关键词结果随输入实时过滤点击详情面板左上角的返回箭头回到完整列表提示搜索是对已抓取的本地列表做过滤拼错名字不会有结果建议用英文原名检索。游戏详情与下载入口点击游戏卡片后详情面板展示 Genres/Tags、Company、Languages、Original Size、Repack Size底部是紫色Download按钮。以 RimWorld 为例面板直接给出原始 960 MB 与 repack 328/498 MB 的对比操作点击Download按钮内置 WebTorrent 客户端接管磁力链接开始下载进度与速度每 500ms 刷新一次此时按钮变为Stop Downloading可随时停下载完成按钮变为Install终端对应输出Done.安装流程中通过Choose Install Location对话框选择目标目录提示任务中途停止后再点Download按钮会显示Continue Download断点续传游戏已入库时按钮直接显示Install。游戏库页面确认下载状态入口侧边栏 Library 图标进入库页已下载游戏卡片左上角带绿色对勾个别卡片还会有红色圆形标记。操作切到 Library 页按卡片对勾判断哪些游戏已下载点击卡片打开详情面板查看已保存的封面与描述想把磁盘上已装好的游戏登记进来时在封面上右键选择右键菜单中的Add A Game Locally按提示选择该游戏的 exe 文件提示右键菜单还有Add To Favorites选项收藏功能尚在开发中点击只会弹出保存确认框不会产生实际记录。Start Game 启动游戏入口游戏库详情面板底部点击库中卡片后弹出是Start Game按钮。操作在 Library 页点击带绿色对勾的游戏卡片点击Start Game按钮应用以记录的 exe 路径拉起游戏进程游戏没起来时右键封面选Add A Game Locally重新指向正确的 exe 文件登记一次提示exe 路径来自src/private/library/locally_installed_games.json游戏搬家或重装后必须重新登记终端只打印错误而不会弹窗。进阶玩法与自定义 主题配色改 4 个 CSS 变量整个界面的颜色收敛在src/public/html/style.css顶部:root块的四个变量里:root { --primary-color: rgba(22, 21, 22, 1); --secondary-color: rgba(0, 0, 0, 1); --accent-color: #d3337e; --text-color: #fff; }修改变量取值--accent-color就是按钮与图标的粉紫色文件内注释明确写了 Section 1 样式需同步复制到library.css与settings.css只改style.css会导致子页面侧边栏配色不一致保存后重新执行npm start查看效果下图是修改背景色变量后的渐变效果参考 源码阅读路线项目代码量小且无框架按数据流顺序读四个文件即可串起全貌src/public/scripts/scraper.js用 axios jsdom 从官网抓取游戏列表与磁力链接写入src/private/temp/games.jsonsrc/public/main.jsElectron 主进程创建窗口、持有 WebTorrent 客户端注册start-torrent/stop-torrent等 IPC 通道src/public/html/scripts/processingdata.jsHome 页渲染、搜索过滤、Download按钮的四种状态切换src/public/html/scripts/libraryprocess.js游戏库页渲染与Start Game的进程拉起逻辑数据文件库状态的存储位置应用运行状态全部落在src/private/library/下的 JSON 文件里可直接用文本编辑器打开核对downloaded_games.json已下载游戏列表库页绿色对勾的判断依据info_downloaded_games.json游戏封面、描述等元数据locally_installed_games.json游戏名到 exe 路径的映射Start Game的取数来源favorites_games.json收藏文件对应功能开发中暂未启用常见问题排查1. npm start 后主窗口不出现看终端输出打印Mac/Linux platform detected说明平台不受支持检查爬虫环节是否报错抓取游戏列表需要向 FitGirl 官网发起网络请求删除node_modules文件夹后重新执行npm install主窗口默认开启 DevTools打开开发者工具看控制台的具体报错2. 下载速度低或归零看详情里的对端数量WebTorrent 走 BitTorrent 协议速度取决于种子源对端为 0 或 1 时说明源不足等待或换时段再下用Stop Downloading停掉其他任务只留一个下载大文件避开 20:00~23:00 的网络高峰时段3. 下载完成但游戏库里不显示核对终端有无该任务的Done.日志确认下载真的完成打开src/private/library/downloaded_games.json确认游戏名已写入对照文件名与抓取到的标题是否完全一致空格和标点都算前三项都正常时重启npm start库页在加载时读取该文件4. 关闭窗口后应用仍在后台这是设计行为主窗口的 close 事件被拦截只隐藏不退出见src/public/main.js在系统托盘找到 FitGirl 图标右键弹出菜单选Open Fitgirl Repack Launcher恢复窗口选Exit Fitgirl Repack Launcher才能真正退出进程写在最后FitGirl Repack Launcher 把“检索、下载、管理、启动”压缩进一个窗口全文是不依赖任何框架的原生 JavaScript读起来没有隔阂也是学 Electron 主进程与渲染进程通信的合格样本。需要留意的是README 顶部声明项目已停止积极维护作者推荐其新项目 FIT-LAUNCHER后续功能不会有更新。延伸阅读三处源码src/public/scripts/scraper.jsaxios jsdom 解析官网页面的完整实现src/public/main.jsWebTorrent 下载控制的两个 IPC 通道与窗口生命周期处理src/public/html/scripts/processingdata.jsDownload按钮的状态切换逻辑下一步建议先启动应用用Add A Game Locally登记一个磁盘上已装好的游戏并点Start Game最短路径跑通从 JSON 到 UI 的完整数据流。【免费下载链接】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），仅供参考
