[其他] 基于GitHub Actions与LLM的AI查重方案：零成本自动识别重复Issue

维护开源项目时，处理重复的 Issue 绝对是让维护者最头疼的环节之一。用户遇到问题，常常不会先去搜索历史记录，而是直接开一个新帖提问。作为项目维护者，你不得不一遍又一遍地回复：“这个问题之前讨论过，请看 #123。”

市面上确实有一些 Issue 管理机器人，但很多配置起来相当复杂，或者需要你自己去部署和维护一个后端服务。最近我在尝试 OpenCode Actions 时，发现了一个极简的解决方案：

只需要约 60 行 YAML 配置文件，你就能实现一个基于 AI 的自动化 Issue 查重机器人。

整个方案依靠复制粘贴即可部署，模型使用 OpenCode 的免费额度，运行成本近乎为零。

它究竟是如何工作的？

核心思路非常“Serverless”化：不需要额外部署任何 Bot 服务，而是直接利用 GitHub Actions 的 Runner 来执行 AI 逻辑。

我已经在自己的开源项目 Sink 中成功应用了这套方案。其工作流清晰且高效：

1. 触发：当有新的 Issue 被创建时，配置好的 GitHub Action 会自动启动。
2. 环境：在 Action 的 Runner 环境中，安装 opencode 命令行工具。
3. 执行：运行一段预设好的 AI Prompt 指令。
4. 决策：AI 会读取新 Issue 的内容，并通过 GitHub CLI (gh) 搜索历史 Issue，进行语义层面的比对分析。
5. 反馈：如果发现潜在的重复 Issue，AI 会自动在该新 Issue 下发表评论，并给出相关旧 Issue 的链接。

核心代码解析

整个配置文件大约 60 行。其中最精彩的部分，在于它如何通过精心设计的 Prompt 来驱动 AI 完成复杂工作。

以下是 Sink 仓库中实际配置的核心片段（文件位于 .github/workflows/duplicate-issues.yml）：

- name: Check for duplicate issues
  env:
    OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
    # 权限控制：只允许 AI 执行 gh issue 相关命令，确保安全
    OPENCODE_PERMISSION: |
      {
        "bash": {
          "*": "deny",
          "gh issue*": "allow"
        },
        "webfetch": "deny"
      }
  run: |
    opencode run -m ${{ secrets.OPENCODE_MODEL }} "A new issue has been created:

    # ... (省略部分 Prompt) ...

    Lookup this issue and search through existing issues...
    Consider:
    1. Similar titles or descriptions
    2. Same error messages or symptoms

    If you find any potential duplicates, please comment on the new issue...
    "

为什么推荐这个方案？

1. 实现真正的“语义级”查重
传统的基于关键词的匹配方法经常失灵（比如一个 Issue 说“启动失败”，另一个说“无法运行”）。而大型语言模型（LLM）能够理解上下文语义，即使表述的词汇不同，也能识别出它们描述的是同一个 Bug 或需求。

2. 内置安全沙箱机制
请注意配置中的 OPENCODE_PERMISSION 环境变量。我们显式地限制了 AI 只能执行 gh issue 相关的命令。这意味着即使 AI 出现“幻觉”或产生错误指令，它也没有权限去删除代码、访问敏感信息或执行其他危险操作，整个流程安全可控，非常适合自动化运维场景。

3. 极致轻量，Less is More
没有需要维护的数据库，没有独立的 Webhook 回调服务，也没有复杂的鉴权逻辑。它仅仅是一个 YAML 配置文件。你只需要把它放进项目的 .github/workflows/ 目录，配置好必要的 Token，它就会立刻开始默默工作。

动手试试看

这套工作流已经在 Sink 仓库中运行。如果你也想为自己的项目添加这个智能查重功能，只需三步：

1. 在你的项目根目录创建 .github/workflows/duplicate-issues.yml 文件。
2. 复制 Sink 仓库里的完整工作流代码。
3. 在仓库的 Settings -> Secrets and variables -> Actions 中，配置 OPENCODE_API_KEY（OpenCode 提供免费额度，足够个人项目使用）。

技术的本质是为了解决问题，而不是制造更多的维护负担。这种“用完即走”、几乎零维护的自动化，才是开发者真正需要的利器。如果你对这类提升开发效率的实战技巧感兴趣，欢迎到云栈社区与其他开发者交流探讨。

本文提到的完整配置已在 Sink 项目中上线，你可以 Star 或 Fork 该项目以参考配置：https://github.com/miantiao-me/Sink