<!-- 
在提交 PR 前，请确保 / Before submitting a PR, please ensure:
1. 每行不超过 120 字符 / Max 120 characters per line
2. 单引号优先（修改文件需统一）/ Prefer single quotes (be consistent within modified files)
3. 禁止 print / No print statements
4. 注释需解释"为什么"和"怎么做"，而不是"是什么" / Comments should explain "why" and "how", not "what"
5. 执行 / Run:
   pip install flake8-quotes
   pip install flake8-bugbear
   make lint-only-diff
6. 删除本模板的全部注释 / Delete all template comments before submitting
-->

# 📌 PR 内容 / PR Description

- 

---

# 🎯 问题背景 / Problem Context

<!-- 为什么要做这个改动 / Why is this change needed -->
- 

# 🔍 相关 Issue / Related Issue

*

---

# ✅ 变更类型 / Type of Change

* [ ] Bug fix
* [ ] New feature
* [ ] Refactor
* [ ] Breaking change
* [ ] Documentation
* [ ] Performance optimization

---

# 🧪 如何测试 / How Has This Been Tested?

1.
2.
3.

---

# 📷 Demo (Optional)

*

---

# ⚡ 更新后的用法示例 / Usage After Update

```python
```

---

# 🔄 重构对比 / Refactor Comparison (如适用 / if applicable)

## Before

```python
```

## After

```python
```

# ⚠️ 注意事项 / Additional Notes

*

---


# 🧠 AI 参与情况 / AI Involvement

<!-- 本 PR 是否使用 AI 工具 / Whether AI tools were used in this PR -->
- [ ] 未使用 AI / No AI used
- [ ] 使用 AI 辅助（局部代码）/ AI-assisted (partial code)
- [ ] 使用 AI 主导（大部分代码）/ AI-led (majority of code)

**使用工具 / Tools Used：**
- [ ] Cursor
- [ ] CodeX
- [ ] ClaudeCode
- [ ] OpenCode
- [ ] 其他 / Other：

# 🤖 AI 生成过程 / AI Generation Process

## 初始 Prompt / Initial Prompt
<!-- 最开始你是怎么问 AI 的 / How did you initially prompt the AI -->
```text
```

## AI 初始输出质量 / Initial Output Quality

* [ ] 一次正确 / Correct on first try
* [ ] 部分正确 / Partially correct
* [ ] 基本不可用 / Mostly unusable

## **问题点 / Issues：**

## 🔧 人工干预过程 / Human Intervention

<!-- 重点：这是核心 / Key section: this is the core -->

### 第一次修正 / First Correction

**修改后的 Prompt / 操作 / Updated Prompt or Action：**

```text
```

### **原因 / Reason：**

### 第二次修正（如有）/ Second Correction (if any)

**修改后的 Prompt / 操作 / Updated Prompt or Action：**

```text
```

### **原因 / Reason：**

### 最终策略总结 / Final Strategy Summary

<!-- 这一步非常关键：沉淀经验 / This step is critical: capture learnings -->

*

---

# 📊 AI vs 人工贡献占比 / AI vs Human Contribution

<!-- 粗略评估 / Rough estimate -->

* AI 生成代码占比 / AI-generated code：`%`
* 人工修改占比 / Human modifications：`%`

**主要人工修改点 / Key Human Modifications：**

* [ ] 逻辑修正 / Logic fixes
* [ ] 边界处理 / Edge case handling
* [ ] 性能优化 / Performance optimization
* [ ] 代码风格 / Code style
* [ ] 架构调整 / Architecture adjustments

---

# ⚠️ AI 问题记录 / AI Failure Cases

<!-- 失败案例非常有价值 / Failure cases are very valuable -->

### ❌ 失败 Prompt 示例 / Failed Prompt Example

```text
```

### ❌ 问题表现 / Issue Description

*

### ✅ 改进后 Prompt / Improved Prompt

```text
```

# 🧩 可复用经验 / Reusable Patterns

* Prompt 模板 / Prompt template：
* 常见坑 / Common pitfalls：
* 推荐做法 / Recommended practices：
