cloud
92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
---
|
|
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
|
|
| 日期 | 标题 | 模块 | 核心根因 | 漏检点 | 预防规则 | 文件 |
|
|
|------|------|------|----------|--------|----------|------|
|
|
```
|