feat: add toggle-labels action

[Wxh16144]

🤔 这个变动的性质是？/ What is the nature of this change?

• 新特性提交 / New feature
• bug 修复 / Fix bug
• 样式优化 / Style optimization
• 代码风格优化 / Code style optimization
• 性能优化 / Performance optimization
• 构建优化 / Build optimization
• 网站、文档、Demo 改进 / Website, documentation, demo improvements
• 重构代码或样式 / Refactor code or style
• 测试相关 / Test related
• 其他 / Other

🔗 相关 Issue / Related Issue

💡 需求背景和解决方案 / Background or solution

需求背景

举个🌰：在维护 issue labels 的时候，会对新建的 issue 添加统一 Unread 标签， 然后对 issue body 进行判断，对不符合条件的 issue 我们期望移除 Unread, 然后追加一个 Invalid label, 现有的 action 不支持 remove-labels,add-labels 同时使用。所以需要一个新的 action。

解决方案

新建一个 toggle-labels action，对现有的 labels 和 action 入参进行判断，如果现有 labels 在 action 入参中存在，则删除这个 label ，反之如果 labels 在 action 入参中不存在，则添加 action 入参的 labels。

Example

假定我们的 action.yml 配置如下：

name: Issues Check

on:
  issues:
    types: [opened]

jobs:
  label_issues:
    runs-on: ubuntu-latest
    permissions:
      issues: write
    steps:
      - name: Add labels
        uses: actions-cool/issues-helper@v3
        with:
          actions: 'add-labels'
          token: ${{ secrets.GITHUB_TOKEN }}
          issue-number: ${{ github.event.issue.number }}
          labels: 'Unread'

      - name: check Invalid label
        uses: actions-cool/issues-helper@v3
        if: contains(github.event.issue.body, 'actions-cool') == false
        with:
          actions: 'toggle-labels,close-issue'
          token: ${{ secrets.GITHUB_TOKEN }}
          issue-number: ${{ github.event.issue.number }}
          labels: 'Unread,Invalid'
      

• case 1. 创建一个不带 body 的 issue

• result: 一个打开且带有 Unread 标签的 issue。

• case 2. 创建一个 body 带 actions-cool 关键词的 issue

• result: 一个关闭且带有 Invalid 标签的 issue

preview:

case:

• init.issueLabels 表示当前 issue 上的 labels
• init.actionInput 表示用户 action 配置 labels
• toggleLabels.removeLabels 实际执行结果需要删除的 labels
• toggleLabels.addLabels 实际执行结果需要添加的 labels

📝 更新日志 / Changelog

Language	Changelog
🇺🇸 English	add toggle-labels action
🇨🇳 Chinese	添加 toggle-labels 功能

[github-actions]

😭 Deploy PR Preview failed.

[xrkffgg]

功能描述可以再清晰一下

[Wxh16144]

功能描述可以再清晰一下

pr 描述已更新

[xrkffgg]

1. 功能描述可以再清晰一下指对用户的描述，即 readme 和 web 里
2. 放在进阶里
3. 功能按照顺序哈

[Wxh16144]

1. 功能描述可以再清晰一下指对用户的描述，即 readme 和 web 里
2. 放在进阶里
3. 功能按照顺序哈

大佬，我已经更新好了，麻烦 review 一下呢？（英文不太好，用的翻译😭

[Wxh16144]

抱歉，我遗留了很多东西，希望下次细心点，麻烦作者重新 review 一下