reasonsoftware/action-notify-slack

通过args参数为默认模板添加自定义字段：

• 使用SEPARATOR自定义分隔符（默认==）
• 参数以换行符\n分隔
• 含空格的字段名/值需用"包裹

yaml
    - name: 发送带额外字段的通知
      uses: docker://reasonsoftware/action-notify-slack:v1
      env:
        TOKEN: ${{ secrets.SLACK_TOKEN }}
        CHANNEL: ${{ secrets.SLACK_CHANNEL }}
        STATUS: finished
      with:
        args: |
          "下载链接"==<https://my-website.com/file.exe|安装包>
          版本==v3.1.0
          构建号==#123

通过JSON文件定义Slack附件，完全自定义通知内容：

yaml
    - name: 发送自定义通知
      uses: docker://reasonsoftware/action-notify-slack:v1
      env:
        TOKEN: ${{ secrets.SLACK_TOKEN }}
        CHANNEL: ${{ secrets.SLACK_CHANNEL }}
        ATTACHMENTS_FILE: ./custom-attachments.json

custom-attachments.json示例：

json
{
  "fallback": "构建完成通知",
  "color": "#36a64f",
  "title": "应用构建成功",
  "text": "版本v2.1.0已构建完成",
  "fields": [
    {"title": "环境", "value": "生产", "short": true},
    {"title": "耗时", "value": "2m30s", "short": true}
  ]
}

注意：JSON文件需包含单个附件对象{}或附件数组[]，可通过Slack消息构建器设计格式。

通过时间戳实现消息更新，适用于多阶段流程通知：

yaml
    - name: 发送初始通知
      id: initial-notify
      uses: docker://reasonsoftware/action-notify-slack:v1
      env:
        TOKEN: ${{ secrets.SLACK_TOKEN }}
        CHANNEL: ${{ secrets.SLACK_CHANNEL }}
        STATUS: building

    - name: 执行构建任务
      run: ./build.sh

    - name: 更新通知状态
      uses: docker://reasonsoftware/action-notify-slack:v1
      env:
        TOKEN: ${{ secrets.SLACK_TOKEN }}
        CHANNEL: ${{ secrets.SLACK_CHANNEL }}
        STATUS: finished
        TIMESTAMP: ${{ steps.initial-notify.outputs.timestamp }}
      with:
        args: |
          构建结果==成功
          版本==v1.2.3

通过时间戳文件在多作业工作流中共享通知状态：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 开始构建通知
        uses: docker://reasonsoftware/action-notify-slack:v1
        env:
          TOKEN: ${{ secrets.SLACK_TOKEN }}
          CHANNEL: ${{ secrets.SLACK_CHANNEL }}
          STATUS: started
          TIMESTAMP_FILE: .github/notify-ts

      - name: 执行构建
        run: docker build -t myapp:latest .

      - name: 上传时间戳文件
        uses: actions/upload-artifact@v2
        with:
          name: timestamp
          path: .github/notify-ts

  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: 下载时间戳文件
        uses: actions/download-artifact@v2
        with:
          name: timestamp
          path: .github/notify-ts

      - name: 部署中通知
        uses: docker://reasonsoftware/action-notify-slack:v1
        env:
          TOKEN: ${{ secrets.SLACK_TOKEN }}
          CHANNEL: ${{ secrets.SLACK_CHANNEL }}
          STATUS: deploying
          TIMESTAMP_FILE: .github/notify-ts

      - name: 执行部署
        run: kubectl apply -f deployment.yaml

      - name: 部署完成通知
        uses: docker://reasonsoftware/action-notify-slack:v1
        env:
          TOKEN: ${{ secrets.SLACK_TOKEN }}
          CHANNEL: ${{ secrets.SLACK_CHANNEL }}
          STATUS: finished
          FAIL: ${{ failure() }}
          TIMESTAMP_FILE: .github/notify-ts