---
name: edge-bug-lessons
description: edge_collector Bug 经验库沉淀规范。用于用户要求 bug 教训、故障复盘、为什么流出、总结经验、沉淀规则时，把边缘侧、云平台、协议采集、部署同步、前端、AI、网络等问题整理为可检索的历史 lesson 和预防规则。
---

# edge_collector Bug 经验库

## 目标

把一次故障从“修好了”沉淀为“以后能提前拦住”。重点记录根因链路、漏检点、验证方式和反哺动作。

## 触发场景

- “总结这次 bug”
- “为什么会流出”
- “写一个复盘”
- “沉淀经验”
- “以后怎么避免”
- 修复完成后需要补长期规则

## 默认落点

```text
docs/bugfix/BugLesson-YYYYMMDD-简述.md
docs/bugfix/BugLesson-index.md
```

如果已有更合适的专题目录，可放到：

- `docs/鲁班猫*/`
- `collector/docs/protocols/`
- `docs/ops/`

但索引仍建议保留在 `docs/bugfix/BugLesson-index.md`。

## Lesson 结构

```markdown
# 标题

**日期**:
**模块**:
**影响范围**:

## 1. 问题现象

## 2. 根因链路

## 3. 流出路径 / 漏检点

## 4. 修复内容

## 5. 验证结果

## 6. 本可在哪一步拦住

## 7. 预防措施

## 8. 可复用规则

## 9. 反哺动作

## 10. 相关文件
```

## 当前项目重点

优先沉淀以下类型：

- 打包或同步覆盖运行态动态配置。
- 97/94/82 等主机系统差异导致运行异常。
- FANUC/西门子协议库、架构、链接方式问题。
- 前端白屏、按钮无反馈、错误提示过泛。
- AI 分析超时、空内容、内部配置泄露。
- WiFi/4G/frpc/端口转发独立 agent 异常。
- 云端设备在线状态、历史趋势、数据不连续误判。

## 写法要求

- 区分“已确认事实”和“推断”。
- 根因必须落到文件、配置、命令、日志或环境差异。
- 不写“加强测试”这类空话，要写可执行拦截点。
- 反哺动作要明确更新哪个 skill、测试清单、文档或脚本检查项。
- 涉及密钥、密码、Token 时必须脱敏。

## 索引格式

```markdown
| 日期 | 标题 | 模块 | 核心根因 | 漏检点 | 预防规则 | 文件 |
|------|------|------|----------|--------|----------|------|
```