gitlink-cli/skills/gitlink-faq/examples/duplicate-detection-demo.md

重复检测完整示例

演示对新 Issue 进行查重检测的端到端流程。

场景

有用户提交了一个新 Issue #312，标题是"登录的时候一直转圈"。维护者想确认这是不是之前已经被问过的问题。

执行流程

Step 1: 用户发起查重请求

用户: 帮我看看 Issue #312 是不是重复了

AI: 好的，先看一下这个 Issue 的详情。

Step 2: 获取目标 Issue

gitlink-cli issue +view --number 312 --format json

返回：

{
  "subject": "登录的时候一直转圈",
  "description": "打开登录页面，输入账号密码点击登录，页面一直转圈不跳转，换了浏览器也不行"
}

Step 3: 获取对比数据

# 获取 FAQ 知识库
gitlink-cli wiki +view --title "Issue-知识库" --format json

# 获取已关闭 Issue
gitlink-cli issue +list --state closed --limit 100 --format json

Step 4: AI 匹配分析

AI 对比分析中...

返回匹配结果：

┌─────────────────────────────────────────────────────┐
│ 🔍 Issue #312 查重结果                               │
│                                                      │
│ 标题: "登录的时候一直转圈"                            │
│                                                      │
│ 高度重复 (≥0.85):                                    │
│ ┌──────────────────────────────────────────────┐     │
│ │ 📖 FAQ Q3: 登录失败或提示 401 错误             │     │
│ │    相似度: 0.91                               │     │
│ │    答案: Token 过期或网络问题，尝试重新登录    │     │
│ ├──────────────────────────────────────────────┤     │
│ │ 🔗 Issue #142: 登录页面显示空白               │     │
│ │    相似度: 0.88                               │     │
│ │    已解决: 浏览器缓存问题                      │     │
│ ├──────────────────────────────────────────────┤     │
│ │ 🔗 Issue #205: 无法登录，页面无响应           │     │
│ │    相似度: 0.86                               │     │
│ │    已解决: DNS 解析问题                        │     │
│ └──────────────────────────────────────────────┘     │
│                                                      │
│ 判定: 高度重复 (top_match: 0.91)                      │
│ 建议: 添加引导评论 + duplicate 标签                   │
└─────────────────────────────────────────────────────┘

Step 5: 用户确认

AI: 检测到 3 个高度相似的匹配。建议：
A. 添加引导评论（推荐用户查看 FAQ Q3 和 #142）
B. 添加 duplicate 标签后关闭
C. 仅查看，不操作

用户: 选 A

Step 6: 执行操作

gitlink-cli issue +comment --number 312 --body "你好！检测到你的问题与已有内容高度相似：

- 📖 [FAQ - Q3: 登录失败或提示 401 错误](wiki/Issue-知识库)
- 🔗 Issue #142: 登录页面显示空白（浏览器缓存问题）
- 🔗 Issue #205: 无法登录，页面无响应（DNS 解析问题）

建议先查看以上内容。常见原因包括：浏览器缓存、DNS 解析、Token 过期。
如果以上方案无法解决，请补充错误截图或浏览器控制台日志，我们会进一步排查。"

Step 7: 完成

AI: 已为 Issue #312 添加引导评论。用户将收到通知，看到参考链接。