在开发前端项目时，我们常常需要发布更新版本到 Github 上。而手动更新版本不仅费时费力，还容易出错。这时候，npm 包 github-post-release 就可以派上用场了。本文将详细介绍如何使用该包来自动化发布 Github 版本。
什么是 github-post-release
github-post-release 是一个基于 Node.js 开发的 npm 包，旨在简化 Github 版本发布流程。它提供了命令行工具，可以通过配置文件自动生成 Github 发布版本页面，并将生成的版本信息上传到 Github 仓库中。
安装
要使用 github-post-release，首先需要在全局安装它：
npm install -g github-post-release
配置
在开始使用 github-post-release 前，我们需要创建一个配置文件 .ghprc.json，并填写相应的内容。下面是一个简单的示例：
{
"token": "YOUR_GITHUB_ACCESS_TOKEN",
"owner": "OWNER_NAME",
"repo": "REPO_NAME",
"tag": "v1.0.0",
"name": "Release v1.0.0",
"bodyPath": "./CHANGELOG.md"
}其中，token 是 Github 的访问令牌；owner 和 repo 分别代表你的 Github 用户名和仓库名；tag 是你要发布的版本号；name 是该版本的名称；bodyPath 是版本更新内容的文件路径。
需要注意的是，为了保证安全，不建议直接在配置文件中写入 Github 访问令牌。可以在执行命令时通过参数传入：
ghpr --token YOUR_GITHUB_ACCESS_TOKEN
发布版本
完成上述配置后，就可以使用 github-post-release 来发布版本了。只需在命令行中输入以下命令即可：
ghpr --config .ghprc.json
执行完毕后，你就可以在 Github 上看到生成的新版本页面了。
深度
除了基本的配置外，github-post-release 还提供了许多高级功能。
预发版
如果你想发布一个预发版，可以加上 --prerelease 参数：
ghpr --config .ghprc.json --prerelease
附件
如果你的版本需要包含一些附件，比如压缩包或可执行文件，可以使用 --assets 参数：
ghpr --config .ghprc.json --assets ./dist.zip ./app.exe
版本号自增
如果你希望每次发布时能够自动递增版本号，可以使用 --increment 参数。该参数支持三种递增方式：major、minor 和 patch。
ghpr --config .ghprc.json --increment patch
发布到 Gitlab
如果你的项目还同时托管在 Gitlab 上，可以使用 --gitlab 参数来将版本同时发布到 Gitlab：
ghpr --config .ghprc.json --gitlab
指导意义
github-post-release 可以帮助我们自动化发布 Github 版本，提高开发效率，减少出错概率。但在使用前需要认真配置参数，确保信息的准确性和安全性。
此外，本文也介绍了一些高级功能，可以根据实际需求进行使用。但要注意不要过度依赖这些功能，以免造成不必要的麻烦。
示例代码
以下是一个示例项目的完整配置文件：
-- -------------------- ---- ------- - -------- --------------------------- -------- ------------- ------- ------------ ------ --------- ------- -------- -------- - ----------------------------------------------------------- -------- ----------------------------------------------------------------------------------