# 问题排查助手 - 使用手册

> 一句话说明：遇到问题时，打开网页输入情况，系统自动给你排查步骤。

---

## 一、怎么打开？

在浏览器地址栏输入：`http://<内网服务器IP>:8088`

例如：`http://192.168.5.100:8088`

---

## 二、怎么用？

### 第 1 步：填写项目名称

输入你所在的项目名称，例如：`厦门银行`、`展厅`、`招商局`

> 💡 小技巧：输入时会自动提示已有项目名，可以直接选择

### 第 2 步：选择系统类型

从下拉菜单选择，共 4 种：

| 系统类型 | 说明 |
|----------|------|
| 标准版预定2.0 | 会议室预定系统 |
| 标准版运维集控系统 | IoT 设备运维 |
| 新统一平台 | 新版统一管理平台 |
| 统一平台 | 旧版统一管理平台 |

### 第 3 步（可选）：填写 APK 产品

如果问题涉及以下设备，请填写：

- `门口屏5.0`、`门口屏4.0`
- `无纸化`
- `桌牌`

> 如果不涉及 APK 设备，可以跳过

### 第 4 步：描述问题

用你自己的话说清楚遇到什么问题，例如：

> 门口屏绑定失败，提示 MQTT 连接错误

> 预定系统启动失败，日志显示 redis 连接超时

> 更新配置后服务没生效

**描述越详细，排查越精准**，建议包含：

- 报错信息或截图内容
- 问题发生时间
- 最近有没有改过什么

### 第 5 步：点击"帮我排查"

等待 3-30 秒，系统会返回：

1. **匹配到的历史案例**：有多少人遇到过类似问题
2. **排查步骤**：一步步教你怎么查
3. **可能原因**：按概率从高到低排列
4. **注意事项**：提醒你别乱动

---

## 三、排查步骤安全吗？

**安全！**

- 所有给出的命令都是**只读操作**（查看、检查、测试）
- **不会**让你重启服务、删除文件、改配置
- 如果真需要这些操作，会提示"联系研发组执行"

---

## 四、问题解决了怎么办？

页面底部有**"提交记录入库"**按钮。

点击后填写：

- 实际根因是什么
- 你是怎么解决的
- 你的名字

提交后，下次别人遇到同样问题就能查到，帮助更多人！

---

## 五、常见问题

### Q1：搜索不到相似案例？

可能是关键词太泛，试试：

- 加入具体报错信息（如 `redis connection refused`）
- 加入设备名称（如 `门口屏`、`无纸化`）

### Q2：AI 一直不返回结果？

可能是网络问题或 API 超时，等一会再试。

如果反复超时，联系研发组。

### Q3：排查步骤看不懂？

每个步骤都写了"查什么"、"查到什么说明是什么问题"。

如果还是不明白，截图发给研发组。

---

## 六、截图示例

### 输入页面

```
┌─────────────────────────────────────────┐
│  🔍 问题排查助手                          │
├─────────────────────────────────────────┤
│  项目名称：[ 厦门银行____________ ]       │
│  系统类型：[ 标准版预定2.0      ▼ ]       │
│  APK 产品：[ 门口屏5.0___________ ]       │
│                                          │
│  问题描述：                               │
│  ┌─────────────────────────────────────┐ │
│  │ 门口屏绑定失败，提示MQTT连接错误...   │ │
│  └─────────────────────────────────────┘ │
│                                          │
│        [ 🔬 帮我排查 ]                    │
└─────────────────────────────────────────┘
```

### 结果页面

```
┌─────────────────────────────────────────┐
│  ✅ 排查诊断结果                          │
├─────────────────────────────────────────┤
│  📋 匹配到 3 个相似案例                   │
│  · [92%] 厦门银行-门口屏MQTT绑定失败      │
│  · [75%] 展厅-门口屏不显示会议信息        │
│                                          │
│  🔬 排查步骤（只读操作）                   │
│  Step 1: 检查门口屏版本...               │
│  Step 2: 查看设备日志...                 │
│                                          │
│  🎯 最可能的根因                          │
│  · 70%：旧版门口屏无默认MQTT凭证          │
│                                          │
│  [ 📝 提交记录入库 ]                      │
└─────────────────────────────────────────┘
```

---

## 七、需要帮助？

联系研发组，把问题截图和排查结果一起发过去。

---

*最后更新：2026-07-11*