Add private layer 07 for field real cases in IP knowledge base.

Keep 01-06 as summarized general knowledge; route on-site reports into 07 and update the ops playbook retrieval order.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-07-29 11:18:28 +08:00
parent 07002caeb8
commit 9f2dba7a23
7 changed files with 160 additions and 32 deletions

View file

@ -0,0 +1,9 @@
# 04 历史故障案例库(教材化)
> **定位**:脱敏后的、可复用的案例骨架与根因链,供专家推理与培训。
> **不是**现场报告原文存放处。
新的现场 PPT/PDF、值班闭环、客户侧细节 → 写入 **`07_现场真实案例库`**。
从 `07` 提炼出的稳定模式,再整理进本目录(少客户私有信息)。
现有示例:`BGP/标签与LDP类/BGP_跨域下一跳NULL_LDP策略与下一跳修复_20260720.md`

View file

@ -0,0 +1,45 @@
# 07 现场真实案例库(私有)
> **定位**:存放**本项目/本客户现场**真实故障与处置记录(PPT/PDF 报告提炼、值班闭环沉淀等)。
> **属性**:私有经验,可含现场拓扑指称、客户侧约定、内部编号;**不是**通用教材。
## 与 01–06 的关系
| 层级 | 内容性质 | 用途 |
|------|----------|------|
| `01`–`06` | **总结后的通用/可复用网络知识**(逻辑树、产品特性、基线、教材化案例模式、阈值、SOP) | 给排障「怎么想、怎么配、敲什么」 |
| **`07`(本目录)** | **现场私有真实案例**(一事一记,可追溯源报告) | 给「我们现场是否遇到过、当时怎么查的」 |
从 `07` 提炼出的稳定规律,应再写入 `01`/`02`/`03`/`06`(或写入 `04` 的教材化案例);**不要**把未脱敏的客户细节写进 01–06。
`04_历史故障案例库`:保留**已总结、可公开给专家推理复用**的案例骨架(少客户私有信息)。
新的现场报告与值班沉淀,**优先写入本目录 `07`**。
## 建议子目录
按协议/主题分,勿按「第几份 PPT」分:
```text
07_现场真实案例库/
├── README.md # 本说明
├── _TEMPLATE.md # 入库模板
├── BGP/
├── OSPF/
├── MPLS_LDP/
├── 光与传输/
└── _staging/ # 可选:模型草稿,未过审勿当正式知识引用
```
## 入库约定
1. 一案一文件 Markdown;文件名:`协议_现象关键词_YYYYMMDD.md`
2. 必填:现象、排查步骤、根因、修复、关键词、**源报告路径/页码**
3. 敏感信息:客户全名、公网 IP、账号口令等按需脱敏;保留排障所需的网元角色与命令输出
4. 状态:`draft`(未过审)/ `reviewed`(可被 playbook 正式引用)
5. 原 PPT/PDF 建议放 `_raw/` 或不进 git 的对象存储,md 内只留相对路径索引
## 检索提示(给 ops)
- 「以前现场有没有类似的」→ 优先 `search_files` 本目录 `07_现场真实案例库`
- 「标准怎么查/怎么配」→ 仍用 `01`–`06`
- 命中 `07` 后仍须用 netx 在**当前**网元验证,不得直接套用历史配置

View file

@ -0,0 +1,65 @@
# (标题:协议_现象关键词_YYYYMMDD)
> 状态:`draft` | `reviewed`
> 层级:`07_现场真实案例库`(私有现场案例)
## 案例元数据
| 项目 | 内容 |
|------|------|
| **案例编号** | 如 FIELD-BGP-001 |
| **适用产品/版本** | |
| **涉及协议** | |
| **关键词标签** | #标签1 #标签2 |
| **故障日期** | YYYY-MM-DD |
| **故障等级** | |
| **源报告** | 路径或文件名 + 关键页码 |
| **客户/项目(可脱敏)** | |
| **审核状态** | draft / reviewed |
---
## 1. 现象特征
### 业务影响
### 直接现象(告警 / CLI / 截图要点)
### 环境要点(拓扑角色、跨域/VPN 等)
---
## 2. 排查过程(有序)
| 步骤 | 动作 | 发现 | 判断 |
|------|------|------|------|
| 1 | | | |
| 2 | | | |
---
## 3. 根因
(一句话 + 关键证据;标明来自源报告哪一页)
---
## 4. 修复与验证
---
## 5. 易混淆点 / 经验
---
## 6. 可沉淀到通用层(可选)
- [ ] 已提炼进 `01_协议排障逻辑树`
- [ ] 已提炼进 `02_产品平台特性` / `03_配置规范` / `06_SOP`
- [ ] 已整理进 `04_历史故障案例库`(脱敏教材版)