文章目录
- 1 连接 ChatGPT Work 和 GitHub
- 1）唤起 ChatGPT 插件安装
- 2）在 GitHub 里授权
- 3）测试连接情况
- 2 给 APP 配置 Fine-grained Token
- 1）打开申请页面，选择仓库
- 2）添加权限，Contents 不要漏
- 3）生成 Token，填进 APP
- 4）打开 APP，试一下能不能读取文件
- 3 使用 GitHub Actions 在线编译 Android APP
- 1）让 Work 创建 APP 和编译工作流
- 2）运行 Actions，下载编译好的 APK
- 3）编译失败，让 Work 读取日志并修复
成文时间：2026-09-19左右，忘了啥时候了。
我最近在使用 ChatGPT，它记忆力挺好的，在磨合一段时间之后适合写论文，开了个 Plus 凑合用用。
投完稿还剩半个月的 Plus 闲置了，加上不太喜欢桌面端的 CodeX，就开始探索纯手机端的 ChatGPT Work 连接 GitHub 做一些轻量常用工具了。
以下记录 ChatGPT Work 怎么连接 GitHub，以及怎么直接开发一个 APP 通过 GitHub Action 编译来避免繁重的配置环境工作。顺便，由于我的 APP 要用到 GitHub 一些功能，再记录一下 GitHub 的 fine-grained token 申请注意事项。
1 连接 ChatGPT Work 和 GitHub
分为两个步骤，分别是唤起 ChatGPT 的 GitHub 插件安装按钮，和在 GitHub 端授权 ChatGPT Connector 给指定用户或组织的仓库。
1）唤起 ChatGPT 插件安装
最简单方法是打开 ChatGPT，切换到工作模式，要求它连接 GitHub，它就会弹出一个按钮帮忙装插件。
如果没弹出来，可以去网页端插件市场看一下有没有安装方法，具体参考 ChatGPT 官方说明。
2）在 GitHub 里授权
GitHub 这边也要安装对应应用，并勾选允许访问的仓库。可以直接打开这个安装链接：ChatGPT Codex Connector。
登录 GitHub 之后，先选组织或者用户，然后再配置权限。在Repository access里选Only select repositories，再勾选需要让 Work 操作的仓库，完成安装。
已经装过应用、只是想增加仓库的，也一样可以点这个链接改。
3）测试连接情况
装好后回到 Work，把剩下的连接提示处理完，再让它读一个文件试试。例如：
请读取 shandianchengzi/shandianchengzi 仓库里的 README.md， 告诉我这个仓库的默认分支和文件内容。2 给 APP 配置 Fine-grained Token
1）打开申请页面，选择仓库
APP 需要用 Token 访问仓库，去这里申请：Fine-grained personal access token。这里配置的是 APP 自己使用的 Token，不需要发给 Work。
页面上先填这几个选项：
Token name：起个能认出来的名字，比如github-pages-manager。Expiration：设置有效期，到期后要更新 APP 使用的 Token。Resource owner：选仓库所属的账号。Repository access：选Only select repositories，勾选 APP 要管理的仓库。
我这个 APP 管理的是github.io仓库里的 HTML，所以这里要勾选存放 HTML 的仓库。填好后接着选下面的权限，选完再生成 Token。申请页面各字段的说明见 [GitHub 文档](Managing your personal access tokens - GitHub Docs)。
2）添加权限，Contents 不要漏
权限这里记得加上Contents，要上传、修改、删除文件就选Read and write。在Permissions的仓库权限部分找到它并添加；如果只是读取私有仓库文件，选Read-only即可。
我一开始漏选了，结果访问不了仓库内容。已经生成的 Token 也可以回到 管理页面，点开 APP 正在用的那枚 Token，编辑权限补上，不用重新申请。文件读写所需的权限见 [GitHub 仓库内容 API 文档](REST API endpoints for repository contents - GitHub Docs)。
如果 APP 还要查看部署状态、安装工作流，就按实际功能再加下面几项：
| 需要做什么 | 添加的权限 |
|---|---|
| 查看 Actions 状态 | Actions: Read-only |
| 查看 Pages 信息 | Pages: Read-only |
创建或修改.github/workflows/里的工作流文件 | 在Contents: Read and write基础上，加Workflows: Read and write |
| 通过 API 手动触发工作流 | Actions: Read and write，工作流需支持workflow_dispatch |
我这个 APP 的配置可以对照 仓库说明。注意Actions和Workflows是两项权限，修改工作流文件时不要只加Actions。手动触发的要求见 [GitHub 工作流 API 文档](REST API endpoints for workflows - GitHub Docs)。
3）生成 Token，填进 APP
权限选好后，点击Generate token，把生成的 Token 保存好，再填到 APP 的 Token 登录框里。
如果选的是组织仓库，Token 显示pending，需要等管理员批准后再访问组织的私有资源。这是组织审批要求，见 [GitHub Token 说明](Managing your personal access tokens - GitHub Docs)。
Token 不要贴进博客、截图或代码仓库。后面如果重新生成了 Token，记得把 APP 里保存的值也换掉。
4）打开 APP，试一下能不能读取文件
填好 Token 后，刷新 APP 的文件列表，打开一个仓库里已有的 HTML 看看。能读取内容后，再按需要测试上传或修改，到 GitHub 对应分支核对文件。
我开发这个 APP 时还遇到过“显示 0 个 HTML，但仓库里明明有文件”的情况。这里除了权限，还要检查 APP 扫描的分支和目录：文件放在子目录里，就不能只扫描根目录；接口请求失败，也不能直接当成没有文件。
3 使用 GitHub Actions 在线编译 Android APP
既然已经能让 ChatGPT Work 操作 GitHub 仓库，就可以进一步让它直接编写 APP，并通过 GitHub Actions 在线编译 APK。这样就不用在本地安装 Android Studio、配置 Android SDK 和 Gradle 环境了，手机上也能完成开发、编译和下载安装。
1）让 Work 创建 APP 和编译工作流
首先创建一个 GitHub 仓库，连接给 ChatGPT Work，然后告诉它需要实现的功能，并要求使用 GitHub Actions 编译。
例如：
请在这个仓库中创建一个 Android APP， 实现我描述的功能。 要求： 1. 使用 GitHub Actions 自动编译 APK。 2. 不依赖本地 Android Studio 环境。 3. 每次推送代码后自动编译，也支持手动触发。 4. 编译结果通过 Actions Artifacts 提供下载。 5. 编译失败时检查日志并修复问题。这里实际是把开发环境转移到了 GitHub 的云端运行器上。Work 负责修改源代码和工作流文件，GitHub Actions 负责执行编译。
对于已有 Android Gradle 项目的仓库，可以在.github/workflows/目录下创建build-apk.yml，参考下面的配置：
name:Build Android APKon:workflow_dispatch:push:branches:[main]jobs:build:runs-on:ubuntu-latestpermissions:contents:readsteps:-name:Checkoutuses:actions/checkout@v4-name:Setup Javauses:actions/setup-java@v4with:distribution:temurinjava-version:'17'-name:Build APKrun:|chmod +x ./gradlew ./gradlew assembleDebug --no-daemon-name:Upload APKuses:actions/upload-artifact@v4with:name:android-debug-apkpath:app/build/outputs/apk/debug/*.apkif-no-files-found:error这里的 Java 版本需要与项目使用的 Android Gradle Plugin 兼容，app目录和编译命令也要根据实际工程调整。如果仓库已经有工作流，就不需要重新创建，可以直接让 Work 修改现有配置。
2）运行 Actions，下载编译好的 APK
代码和工作流提交后，打开仓库的Actions页面，选择Build Android APK。如果已经提交到main分支，按照上面的配置会自动开始编译；也可以点击Run workflow手动触发。
编译完成后，进入对应的运行记录，在页面下方找到Artifacts，点击android-debug-apk下载。上面的upload-artifact@v4默认会将文件打包为 ZIP，解压后就是 APK。
这个流程生成的是 Debug APK，适合自己安装和测试。如果后续需要正式发布，再配置 Release 构建和签名密钥，不能把签名密码直接写进公开仓库。
3）编译失败，让 Work 读取日志并修复
GitHub Actions 的另一个好处是编译过程有完整日志。遇到 Gradle 依赖错误、SDK 版本不匹配或者源代码编译失败时，可以让 Work 检查对应的失败记录，修改代码后重新触发编译。
不过需要注意，Actions 显示绿色，只代表工作流成功执行，不代表 APP 一定能够正常使用。下载安装之后，还是要自己测试一下实际功能，尤其是文件权限、网络请求、后台运行等依赖 Android 系统环境的部分。
这样就形成了一套比较省事的开发流程：在 ChatGPT 中提出需求，由 Work 修改 GitHub 仓库，通过 Actions 编译 APK，再下载安装进行测试。对于一些简单的个人工具，基本可以不碰本地 Android 开发环境。
本账号所有文章均为原创，欢迎转载，请注明文章出处：https://shandianchengzi.blog.csdn.net/article/details/164334601。百度和各类采集站皆不可信，搜索请谨慎鉴别。技术类文章一般都有时效性，本人习惯不定期对自己的博文进行修正和更新，因此请访问出处以查看本文的最新版本。
