# Gitea PR 评审 Action

这个 Gitea Action 允许你在 Gitea 的 Pull Request 中添加或更新代码评审（Review）评论。它专为自动化代码审阅工具设计，支持精准的代码行评论。

## 功能特性

- **零配置启动**：自动从运行环境获取 Gitea 地址、仓库名、PR 编号和提交 ID。
- **行级评论**：支持在代码文件的特定行添加评审意见。
- **评审总结**：支持提交整体的评审状态（批准、请求修改或仅评论）。
- **智能更新**：通过唯一标识符（identifier）更新现有评论，避免评论堆积。

## 输入参数

| 名称 | 描述 | 必填 | 默认值 |
| --- | --- | --- | --- |
| `gitea-token` | 用于 API 认证的 Gitea token | 是 | |
| `body` | 评论的 Markdown 内容 | 是 | |
| `identifier` | 评论的唯一标识符（用于更新） | 否 | |
| `update-if-exists` | 是否更新具有相同标识符的现有评论 | 否 | `false` |
| `event` | 评审类型 (`COMMENT`, `APPROVE`, `REQUEST_CHANGES`) | 否 | `COMMENT` |
| `commit-id` | 提交的 SHA（默认从 PR 自动获取） | 否 | |
| `path` | 文件相对路径（行级评论必填） | 否 | |
| `new-line` | 新文件中的行号 | 否 | |
| `old-line` | 旧文件中的行号 | 否 | |

### 高级/覆盖参数（通常自动推断）

| 名称 | 描述 | 默认值 |
| --- | --- | --- |
| `gitea-base-url` | Gitea 实例的基础 URL | `GITEA_SERVER_URL` |
| `repository` | 仓库路径 (owner/repo) | `GITEA_REPOSITORY` |
| `issue-number` | PR 编号 | 自动从事件 Payload 获取 |

## 使用方法

### 1. 简单的评审总结

```yaml
- name: 批准 PR
  uses: ren/gitea-comments@v0.1.0
  with:
    gitea-token: ${{ secrets.GITEA_TOKEN }}
    event: 'APPROVE'
    body: "代码审阅通过！ ✅"
```

### 2. 自动化的代码行评论（更新模式）

非常适合 Linter 或静态分析工具。

```yaml
- name: 提交代码规范建议
  uses: ren/gitea-comments@v0.1.0
  with:
    gitea-token: ${{ secrets.GITEA_TOKEN }}
    path: "src/main.js"
    new-line: 15
    body: "建议在此处使用 `const` 而不是 `let`。"
    identifier: lint-error-line-15
    update-if-exists: true
```

## 许可证

MIT