forked from Gitlink/gitlink-cli
106 lines
4.0 KiB
Markdown
106 lines
4.0 KiB
Markdown
# 重复检测完整示例
|
||
|
||
> 演示对新 Issue 进行查重检测的端到端流程。
|
||
|
||
## 场景
|
||
|
||
有用户提交了一个新 Issue #312，标题是"登录的时候一直转圈"。维护者想确认这是不是之前已经被问过的问题。
|
||
|
||
## 执行流程
|
||
|
||
### Step 1: 用户发起查重请求
|
||
|
||
```
|
||
用户: 帮我看看 Issue #312 是不是重复了
|
||
|
||
AI: 好的，先看一下这个 Issue 的详情。
|
||
```
|
||
|
||
### Step 2: 获取目标 Issue
|
||
|
||
```bash
|
||
gitlink-cli issue +view --number 312 --format json
|
||
```
|
||
|
||
返回：
|
||
```json
|
||
{
|
||
"subject": "登录的时候一直转圈",
|
||
"description": "打开登录页面，输入账号密码点击登录，页面一直转圈不跳转，换了浏览器也不行"
|
||
}
|
||
```
|
||
|
||
### Step 3: 获取对比数据
|
||
|
||
```bash
|
||
# 获取 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: 执行操作
|
||
|
||
```bash
|
||
gitlink-cli issue +comment --number 312 --body "你好！检测到你的问题与已有内容高度相似：
|
||
|
||
- 📖 [FAQ - Q3: 登录失败或提示 401 错误](wiki/Issue-知识库)
|
||
- 🔗 Issue #142: 登录页面显示空白（浏览器缓存问题）
|
||
- 🔗 Issue #205: 无法登录，页面无响应（DNS 解析问题）
|
||
|
||
建议先查看以上内容。常见原因包括：浏览器缓存、DNS 解析、Token 过期。
|
||
如果以上方案无法解决，请补充错误截图或浏览器控制台日志，我们会进一步排查。"
|
||
```
|
||
|
||
### Step 7: 完成
|
||
|
||
```
|
||
AI: 已为 Issue #312 添加引导评论。用户将收到通知，看到参考链接。
|
||
```
|