企业官网建设流程全解析

GithubLauncher是一款免费开源的应用启动器，它直接对接 GitHub Releases，一条命令即可完成应用的下载、自动更新、启动与卸载。它的命令行模式（CLI）把整个启动器装进终端：无需打开图形界面，7 条核心命令就能管理你的整个应用库。本文带你从零基础快速上手 GithubLauncher 命令行用法，实现应用下载与更新全自动化 🚀

为什么命令行比图形界面更快？

如果你每天都在下载、更新 GitHub 上的开源应用，反复点开界面点按钮会非常低效。而 Program.cs 的设计很巧妙：只要第一个参数以-开头，就直接进入命令行模式，不启动任何界面，执行完立即返回退出码——这意味着它可以无缝接入定时任务、脚本和自动化工具。

💡 所有命令逻辑都集中在 Services/CLIHandler.cs 中，下面 7 条命令覆盖了它的全部日常功能。

1️⃣ --list：一条命令看清整个应用库

GithubLauncher --list

列出所有可管理的应用，并直观标注三种状态：

• [INSTALLED]（绿色）：已安装，附带当前版本
• [UPDATE AVAILABLE]（黄色）：有新版本，显示旧版本 -> 新版本
• [NOT INSTALLED]（灰色）：未安装，显示最新版本号

它还会显示启动器自身版本，并自动检查是否有新版启动器可用——相当于每次打开终端都免费获得一次"体检报告"。想维护完整清单？应用的完整列表由 README.md 中描述的apps.json配置文件驱动，每个条目包含应用名、仓库地址和安装文件夹。

2️⃣ --download：后台一键下载安装

GithubLauncher --download Banjo64

命令行为会实时滚动下载进度百分比（每 5% 刷新一次），完成后自动验证安装状态。它的智能之处：

• 应用已安装 → 直接提示is already installed，不会重复下载
• 应用有更新 → 自动切换为更新流程
• 发布包分平台时（Windows / macOS / Linux），自动识别当前系统并挑选匹配的安装包

实现细节可见 Services/CLIHandler.cs 中的平台匹配逻辑。

3️⃣ --run：启动即自动更新，一行命令

GithubLauncher -r "Mario Kart 64"

这是效率最高的命令：运行时如果发现新版本，会先自动更新再启动，全程无需干预。应用名支持带空格的引号写法，且忽略大小写匹配（详见 Services/CLIHandler.cs 的查找逻辑）。

⚠️ 小提示：如果应用目录下存在多个可执行文件，CLI 会提示你先用图形界面选择一次，之后--run就会记住你的选择，直接启动。

4️⃣ --update：批量更新全部应用

GithubLauncher --update

一条命令检查所有已安装应用，逐个升级有更新的那部分，结束后输出汇总：

✓ Updated 2 game(s) ⚠ 1 game(s) failed to update

配合系统定时任务（Windows 任务计划程序 / Linux cron），可以让它每天凌晨自动跑一次，早上开机时所有应用都是最新版——这就是"更新全自动化"的精髓 🌙

5️⃣ --update-launcher：启动器自己也会更新

GithubLauncher --update-launcher

启动器同样对接 GitHub Releases 做自我更新：自动比对版本号、下载对应平台的压缩包、备份旧文件后应用新文件，失败会自动回滚，完成后自动重启启动器。Windows 和 Linux 都有对应的更新脚本（生成逻辑见 Services/CLIHandler.cs），全程无需手动拖文件。

6️⃣ --uninstall：干净卸载释放空间

GithubLauncher -x OldApp

直接删除该应用的整个安装文件夹并刷新状态，未安装的应用会友好提示而非报错。清理不再用的应用，一条命令的事。

7️⃣ --help：随时查看完整命令手册

GithubLauncher --help

带彩色高亮的帮助界面，列出全部命令、说明和示例，忘记命令时敲一下就有答案。

🎁 彩蛋：把应用加入 Steam 库

GithubLauncher --add-steam-shortcut "Banjo64" --wait-for-steam-exit

在 Windows 和 Linux 上，这条命令能把托管在 GitHub 上的应用以非 Steam 游戏形式加入 Steam 库，实现与 Steam 游戏统一管理（实现见 Services/ShortcutHelper.cs）。注意执行时 Steam 需要先关闭。

常见问题 FAQ

Q：命令行模式和图形界面会冲突吗？不会。两者共享同一套 Models/GameInfo.cs 数据与应用目录，配置保存在 Services/AppSettings.cs 描述的settings.json中，图形界面做过一次配置后，命令行直接复用，无需重复设置。

Q：需要安装什么环境？仅 .NET 9 Runtime 和联网环境。下载发布包解压、运行GithubLauncher即可开始，命令行与图形界面是同一个可执行文件。

Q：命令执行失败怎么排查？每条命令都有明确的退出码（0 成功 / 1 失败），失败时会打印红色ERROR:信息。这正是脚本自动化的基础：你可以在自己的脚本里根据退出码判断是否重试。

总结

GithubLauncher 用 7 条命令行把应用管理变成了纯自动化流程：

GithubLauncher --list # 查看状态 GithubLauncher -d MyApp # 下载安装 GithubLauncher -r MyApp # 自动更新并启动 GithubLauncher --update # 批量更新 GithubLauncher --update-launcher # 启动器自更新

如果你管理着多个 GitHub 上的开源应用，这套 CLI 方案能让下载与更新的效率直接翻倍。