企业官网建设流程全解析

GithubLauncher 是一款跨平台启动器（Launcher）应用，专为自动下载、更新和管理托管在 GitHub Releases 上的应用程序而生。它内置应用库管理、版本检测、一键下载与自动更新功能，让你彻底告别手动解压、反复升级的繁琐操作。本文面向新手和普通用户，用最短的篇幅带你完成安装、上手和配置。

GithubLauncher 能帮你做什么？

• 📥自动下载：选中应用后一键下载，启动器自动从 GitHub Releases 抓取对应平台的最新安装包
• 🔄自动更新：启动时自动检查版本，发现新版本即可一键更新，不再落后
• 🗂️应用库管理：所有应用以卡片形式集中展示，支持网格/列表视图、排序与筛选
• 🎮多平台运行：基于 .NET 9 + Avalonia 构建，支持 Windows、Linux（x64/arm64）与 macOS
• 🖥️CLI 命令行：无需打开界面即可列表、下载、更新、卸载应用

核心功能由应用管理模块 Services/GameManager.cs 与命令行处理器 Services/CLIHandler.cs 共同承担，底层逻辑封装在 lib/GitHubLauncher.Core/ 中。

一键安装步骤：3分钟完成部署

前置条件

安装流程

1. 从 Releases 发布页下载最新版本的发布包
2. 将压缩包解压到你喜欢的任意目录（无需管理员权限）
3. 双击运行可执行文件GithubLauncher，即完成安装

就是这么简单——没有安装向导，没有注册表，解压即用，想移动随时移动。

快速上手：下载、启动与更新应用

上图已用于开头，这里不再重复引用。

实际操作只有三步：

1. 启动应用：启动器会自动检查待处理应用与更新状态
2. 浏览应用库：左侧面板可切换「全部应用 / 仅已安装」，右上角支持按最近玩过等条件排序
3. 点击按钮：未安装显示蓝色"Download"，已安装显示绿色"Launch"，单击即完成下载或启动

每张应用卡片都会同时显示Installed（已安装版本）与Latest（最新版本），一眼就能判断是否需要升级。

隐藏但好用的右键菜单

点击卡片上的⋯按钮，可以展开完整选项，包括：

• Update Now / Force Update：立即更新或强制更新
• Skip Update：跳过某个版本的更新
• Change Version：切换指定版本
• Create Desktop Shortcut：创建桌面快捷方式
• Add to Steam：把应用加入 Steam 库
• Open Folder / Delete：打开安装目录或卸载

这些菜单项定义在界面文件 MainWindow.axaml 中，功能逻辑可在 Services/GameManager.cs 中对照理解。

配置指南：Token、apps.json 与个性化

设置 GitHub API Token（推荐）

访问 GitHub 接口有频率限制。建议创建一个无需任何权限的 Personal Access Token，填入启动器的 Settings 面板即可避免限流。创建完成后请妥善保管，切勿泄露。

自定义应用列表 apps.json

启动器通过apps.json文件管理可用应用列表，每个应用条目包含 4 个属性：

示例格式见 README.md 中的 Example Configuration 部分。

个性化设置

设置项涵盖范围很广，完整字段定义见 Services/AppSettings.cs：

• 图标大小、透明度、边距，以及网格/列表视图切换
• 主题主色/副色（PrimaryColor/SecondaryColor）
• 背景图片、启动音乐与音量
• 游戏手柄输入开关（EnableGamepadInput）
• 平台目标过滤（自动 / 指定操作系统）

所有设置保存在启动器目录下的settings.json中，修改即时生效。

CLI 命令行用法：脚本党福音

除了图形界面，GithubLauncher 还内置了一套完整的命令行接口（入口逻辑见 Program.cs），常用命令如下：

在 Windows 下，它会自动附加父进程控制台以输出彩色结果（Windows 控制台适配代码见 Program.cs）。配合批处理或 shell 脚本，你可以轻松实现"开机自动更新全部应用"这类自动化场景。

常见问题 FAQ

Q：旧版 N64RecompLauncher 的用户如何迁移？直接下载新版文件覆盖到启动器目录即可，设置保持兼容。若不想自动更新，可把update_check.json中的LastCheckTime年份改成9999。详见 README.md。

Q：应用安装在哪里？默认安装在启动器同级/自定义目录下的Apps文件夹中（默认路径逻辑见 Services/GithubLauncherProfile.cs），可在设置中通过AppsPath修改。

Q：为什么更新检查不生效？请先确认网络可用；若频繁触发 API 限流，请按照上文配置 Token。

Q：支持哪些系统？Windows x64、Linux x64/arm64、macOS x64，运行时定义见 GithubLauncher.csproj。

总结

GithubLauncher 把"从 GitHub Releases 下载应用 → 安装 → 启动 → 更新"这一整套流程压缩成了两次点击。无论你是想管理一堆开源移植游戏，还是托管在 GitHub 上的其他工具，它都能以跨平台、低配置、可脚本化的方式帮你省心完成。解压即用，上手只需 3 分钟，值得一试 🚀