# 📝 会话复盘归档（Session Archive）

**日期:** YYYY-MM-DD  
**主题:** 一句话总结本次解决的核心问题  
**标签:** #排错 #架构 #配置 #自动化 （按实际情况调整）

---

# 📌 任务背景

## 问题背景与触发原因
<!-- 本次解决了什么问题？ -->
<!-- 是什么需求、报错、异常现象触发了这次排查？ -->

- 问题描述：
- 触发原因：
- 用户目标：
- 影响范围：

## 涉及模块 / 文件
<!-- 涉及哪些服务、脚本、配置、代码文件？ -->

- 服务：
- 模块：
- 配置文件：
- 代码文件：
- 第三方依赖/API：

---

# 🔍 排错过程

## 排查步骤
<!-- 按时间顺序记录排查动作 -->

1. 
2. 
3. 

## 尝试过的方案
<!-- 记录所有尝试过但失败/部分有效的方案 -->

- 尝试方案 A：
  - 结果：
  - 为什么失败：

- 尝试方案 B：
  - 结果：
  - 为什么失败：

## 排除的错误方向
<!-- 哪些猜测被证明是错误的 -->

- ❌ 
- ❌ 

## 关键发现
<!-- 真正推动问题解决的关键线索 -->

- ✅ 
- ✅ 

---

# 🛠️ 根因分析

## 问题根因
<!-- 底层真正导致问题的原因 -->

- 技术原因：
- 架构原因：
- 环境原因：
- 权限/网络/依赖问题：

## 为什么会发生
<!-- 从机制层解释问题 -->

- 
- 

---

# ✅ 最终解决方案

## 实际修改内容
<!-- 最终落地的变更 -->

### 修改项
- [ ] 配置修改
- [ ] 代码修复
- [ ] 服务重启
- [ ] 架构调整
- [ ] 自动化脚本新增

### 涉及文件
```txt
/path/to/file1
/path/to/file2