🤖 Issue Helper

English | 简体中文

一个帮你处理 issue 的 GitHub Action

😎 为什么用 GitHub Action？

1. 完全免费。
2. 全自动操作。
3. 托管于 GitHub 服务器，只要 GitHub 不宕机，它就会一直跑下去。

Private 项目每月有 2000 次的限制，具体查看。Public 项目无限制。

列 表

• ⭐ 基 础
  • add-assignees
  • add-labels
  • create-comment
  • create-issue
  • delete-comment
  • lock-issue
  • remove-assignees
  • set-labels
  • unlock-issue
  • update-comment
  • update-issue
• ⭐ 进 阶
• ⭐ 高 级

🚀 使 用

⭐ 基 础

为了更好的展示功能，下面以实际场景举例，请灵活参考。

add-assignees

当一个 issue 新增时，将这个 issue 指定某人或多人。

name: Add Assigness

on:
  issues:
    types: [opened]

jobs:
  add-assigness:
    runs-on: ubuntu-latest
    steps:
      - name: Add assigness
        uses: actions-cool/issue-helper@v1
        with:
          actions: 'add-assignees' or ['add-assignees']
          token: ${{ secrets.GITHUB_TOKEN }}
          issue-number: ${{ github.event.issue.number }}
          assignees: 'xxx' or ['xxx'] or ['xx1', 'xx2']

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1
assignees	指定人。当不填或者为空字符、空数组时，不指定	string | string[]	✖	v1

• 其中的 name 可根据自行根据实际情况修改
• on 参考
• ${{ github.event.issue.number }} 表示当前 issue。更多参考。

⏫ 返回列表

add-labels

当一个新增的 issue 内容不包含指定格式时，为这个 issue 添加 labels。

name: Add Labels

on:
  issues:
    types: [opened]

jobs:
  add-labels:
    runs-on: ubuntu-latest
    if: github.event.issue.body.indexOf('Create by specifying way') == -1
    steps:
      - name: Add labels
        uses: actions-cool/issue-helper@v1
        with:
          actions: 'add-labels'
          token: ${{ secrets.GITHUB_TOKEN }}
          issue-number: ${{ github.event.issue.number }}
          labels: 'bug' or ['bug'] or ['bug1', 'bug2']

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1
labels	新增的 labels。当不填或者为空字符、空数组时，不新增	string | string[]	✖	v1

⏫ 返回列表

create-comment

当新增一个指定 label 时，对该 issue 进行评论。

name: Create Comment

on:
  issues:
    types: [labeled]

jobs:
  create-comment:
    runs-on: ubuntu-latest
    if: github.event.label.name == 'xxx'
    steps:
      - name: Create comment
        uses: actions-cool/issue-helper@v1
        with:
          actions: 'create-comment'
          token: ${{ secrets.GITHUB_TOKEN }}
          issue-number: ${{ github.event.issue.number }}
          body: |
            Hello ${{ github.event.issue.user.login }}. Add some comments.

            你好 ${{ github.event.issue.user.login }}。巴拉巴拉。
          contents: '+1' or ['+1', 'heart']

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1
body	新增评论的内容	string	✖	v1
contents	为新增评论的增加 reaction	string | string[]	✖	v1

• body 默认为：Currently at ${owner}/${repo}. And this is default comment.
  • 其中 ${owner}/${repo} 表示当前仓库
• 返回 comment-id，可用于之后操作。用法参考
• ${{ github.event.issue.user.login }} 表示该 issue 的创建者。

⏫ 返回列表

create-issue

感觉新增 issue 使用场景不多。这里举例，每月 1 号 UTC 00:00 新增一个 issue。

name: Create Issue

on:
  schedule:
    - cron: "0 0 1 * *"

jobs:
  create-issue:
    runs-on: ubuntu-latest
    steps:
      - name: Create issue
        uses: actions-cool/issue-helper@v1
        with:
          actions: 'create-issue'
          token: ${{ secrets.GITHUB_TOKEN }}
          title: 'xxxx'
          body: 'xxxx'
          labels: 'xx'
          assignees: 'xxx'
          contents: '+1'

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
title	新增 issue 的标题	string	✖	v1
body	新增 issue 的内容	string	✖	v1
labels	为新增 issue 添加 labels	string | string[]	✖	v1
assignees	为新增 issue 添加 assignees	string | string[]	✖	v1
contents	为新增 issue 增加 reaction	string | string[]	✖	v1

• title 默认为：Default Title
• body 默认同上
• 返回 issue_number，用法同上

⏫ 返回列表

delete-comment

根据 comment_id 删除指定评论。单个应用场景不多，可参考高级用法。

- name: Delete comment
    uses: actions-cool/issue-helper@v1
    with:
      actions: 'delete-comment'
      token: ${{ secrets.GITHUB_TOKEN }}
      comment-id: xxx

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
comment-id	指定的 comment	number	✔	v1

⏫ 返回列表

lock-issue

当新增 invalid label 时，对该 issue 进行锁定。

name: Lock Issue

on:
  issues:
    types: [labeled]

jobs:
  lock-issue:
    runs-on: ubuntu-latest
    if: github.event.label.name == 'invalid'
    steps:
      - name: Lock issue
        uses: actions-cool/issue-helper@v1
        with:
          actions: 'lock-issue'
          token: ${{ secrets.GITHUB_TOKEN }}
          issue-number: ${{ github.event.issue.number }}

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1

⏫ 返回列表

remove-assignees

移除 issue 指定人员。

- name: Remove assignees
    uses: actions-cool/issue-helper@v1
    with:
      actions: 'remove-assignees'
      token: ${{ secrets.GITHUB_TOKEN }}
      issue-number: ${{ github.event.issue.number }}
      assignees: 'xx'

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1
assignees	移除的指定人。当不填或者为空字符、空数组时，不进行移除	string | string[]	✖	v1

⏫ 返回列表

set-labels

设置 issue 的 labels。

- name: Set labels
    uses: actions-cool/issue-helper@v1
    with:
      actions: 'set-labels'
      token: ${{ secrets.GITHUB_TOKEN }}
      issue-number: ${{ github.event.issue.number }}
      labels: 'xx'

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1
labels	labels 设置。当不填或者为空字符、空数组时，会移除所有	string | string[]	✖	v1

⏫ 返回列表

unlock-issue

解锁指定 issue。

- name: Unlock issue
    uses: actions-cool/issue-helper@v1
    with:
      actions: 'unlock-issue'
      token: ${{ secrets.GITHUB_TOKEN }}
      issue-number: ${{ github.event.issue.number }}

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1

⏫ 返回列表

update-comment

根据 comment_id 更新指定评论。单个应用场景不多，可参考高级用法。

- name: Update comment
    uses: actions-cool/issue-helper@v1
    with:
      actions: 'update-comment'
      token: ${{ secrets.GITHUB_TOKEN }}
      comment-id: xxx
      body: 'xxxx'
      update-mode: 'replace'
      contents: '+1'

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
comment-id	指定的 comment	number	✔	v1
body	更新 comment 的内容	string	✖	v1
update-mode	更新模式。replace 替换，append 附加	string	✖	v1
contents	为 comment 增加 reaction	string | string[]	✖	v1

• body 默认同上
• update-mode 为 append 时，会进行附加操作。非 append 都会进行替换。仅对 body 生效。

⏫ 返回列表

update-issue

根据 issue-number 更新指定 issue。

- name: Update issue
    uses: actions-cool/issue-helper@v1
    with:
      actions: 'update-issue'
      token: ${{ secrets.GITHUB_TOKEN }}
      issue-number: ${{ github.event.issue.number }}
      state: 'open'
      title: 'xxx'
      body: 'xxxx'
      update-mode: 'replace'
      labels: 'xx'
      assignees: 'xxx'
      contents: '+1'

参数	描述	类型	必填	版本
actions	actions 类型，当为数组时，会进行多个操作	string | string[]	✔	v1
token	token 说明	string	✖	v1
issue-number	指定的 issue	number	✔	v1
state	修改 issue 的状态，可选值 open closed	string	✖	v1
title	修改 issue 的标题	string	✖	v1
body	修改 issue 的内容	string	✖	v1
labels	修改 issue 的 labels	string | string[]	✖	v1
assignees	修改 issue 的 assignees	string | string[]	✖	v1
contents	为修改的 issue 增加 reaction	string | string[]	✖	v1

• state 默认为 open
• 当可选项不填时，会保持原有

⏫ 返回列表

⭐ 进 阶

⭐ 高 级

🎁 参 考

token

需拥有 push 权限的人员 token。

• 个人 token 申请
  • 需勾选 Full control of private repositories
• 项目添加 secrets
  • 选择 settings，选择 secrets，选择 New repository secret
  • Name 与 actions 中保持一致
  • Value 填写刚才个人申请的 token

当 actions 不填写 token 时，会默认为 github-actions bot。适度使用。

⏫ 返回列表

条件判断

触发机制

• Workflow syntax for GitHub Actions
• Events that trigger workflows

⏫ 返回列表

Reactions types

content	emoji
+1	👍
-1	👎
laugh	😄
confused	😕
heart	❤️
hooray	🎉
rocket	🚀
eyes	👀

⏫ 返回列表

comment_id 获取

点击某个评论右上角 ··· 图标，选择 Copy link，url 末尾数字即是 comment_id。

⏫ 返回列表

谁在使用？

LICENSE

MIT