复现已有算法

2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,91 @@
+---
+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
+| 日期 | 标题 | 模块 | 核心根因 | 漏检点 | 预防规则 | 文件 |
+|------|------|------|----------|--------|----------|------|
+```