Twitter, together!完整指南：从创建Twitter应用到发布第一条协作推文

【免费下载链接】action:bird: A GitHub action to tweet from a repository项目地址: https://gitcode.com/gh_mirrors/act/action

GitHub 加速计划 / act / action 是一个强大的 GitHub 动作，能让你从仓库直接发推文，实现团队协作发布推文的高效流程。本指南将带你一步步完成从创建 Twitter 应用到发布第一条协作推文的全过程，让团队协作推文变得简单又高效。

一、创建 Twitter 应用的详细步骤

1.1 申请 Twitter 开发者账号

在开始创建 Twitter 应用之前，你需要先拥有一个 Twitter 开发者账号。前往 https://developer.twitter.com/en/portal/projects-and-apps 开始申请流程。如果你的 Twitter 账号还未关联邮箱，请先在 Twitter 邮箱设置 中进行设置。申请过程中，可能会被问及使用场景，推荐选择“Making a bot”，并回答不会向政府实体提供 Twitter 内容或衍生信息。提交申请后，你会收到验证邮件，验证通过后即可返回继续创建应用。

1.2 创建项目与应用

首先需要创建一个项目来容纳应用，若已有合适项目可跳过此步。进入 https://developer.twitter.com/en/portal/projects/new 或在仪表板点击“Create Project”。项目名称建议与 Twitter 协作相关，使用场景选择“Making a bot”，描述可参考“Collaboratively tweet using GitHub’s pull request review process by utilizing the twitter-together GitHub Action.”。

项目创建完成后，在项目下点击“Add App”创建应用。应用环境根据实际使用情况选择，应用名称需全球唯一，推荐格式为“<你的 Twitter 账号名>-twitter-together”。创建成功后，记下“API Key”和“API Secret”。

1.3 配置应用权限与保存凭据

进入应用设置，在“User authentication settings”中设置“App permissions”为“Read and write”，“Type of App”为“Web App, Automated App or Bot”。配置 OAuth 2.0 相关信息，“Callback URI”设为“http://localhost”，“Website URL”设为“https://github.com/twitter-together/action”，保存设置。

回到应用的“Keys and tokens” tab，若之前未记下“API Key/Secret”，可点击“Regenerate”获取新的。同时，为更新权限，点击“Regenerate”获取新的“Access Token and Secret”并记下。最后将这些凭据保存到仓库的“Secrets”设置中，对应关系如下：

二、创建 Twitter Together 工作流文件

2.1 进入 Actions 选项卡

在你的仓库中，打开 Actions 选项卡。

2.2 新建工作流文件

点击“Setup a new workflow yourself”按钮打开文件编辑器。

2.3 编写工作流代码

在文件名输入框将“main.yml”替换为“twitter-together.yml”，然后将以下代码替换进去：

on: [push, pull_request] name: Twitter, together! jobs: preview: name: Preview runs-on: ubuntu-latest if: github.event_name == 'pull_request' steps: - uses: twitter-together/action@v3 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} tweet: name: Tweet runs-on: ubuntu-latest if: github.event_name == 'push' && github.ref == 'refs/heads/main' steps: - name: checkout main uses: actions/checkout@v3 - name: Tweet uses: twitter-together/action@v3 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} TWITTER_ACCESS_TOKEN: ${{ secrets.TWITTER_ACCESS_TOKEN }} TWITTER_ACCESS_TOKEN_SECRET: ${{ secrets.TWITTER_ACCESS_TOKEN_SECRET }} TWITTER_API_KEY: ${{ secrets.TWITTER_API_KEY }} TWITTER_API_SECRET_KEY: ${{ secrets.TWITTER_API_SECRET_KEY }}

注意，如果你更改了仓库的默认分支，需要将代码中的“main”替换为你的默认分支名称。

2.4 提交工作流文件

点击“Start commit”按钮，可选择设置自定义提交信息，然后点击“Commit new file”完成文件创建。

三、发布第一条协作推文

完成上述设置后，在仓库的默认分支创建或更新“.github/workflows/twitter-together.yml”文件不久，会自动创建一个拉取请求，其中包含进一步的操作说明。你可以按照说明在 tweets 目录下创建 .tweet 文件编写推文内容，通过拉取请求进行协作审核，审核通过合并到默认分支后，推文将自动发布。

通过以上步骤，你就成功搭建了 Twitter 协作推文的流程，团队成员可以轻松地通过 GitHub 仓库协作发布推文啦！🎉

【免费下载链接】action:bird: A GitHub action to tweet from a repository项目地址: https://gitcode.com/gh_mirrors/act/action