# 开发工作经验与教训

> 用途：记录代码、架构、构建、发布、技术实现方面的可复用教训。

## 2026-06-07｜已确认功能线不得当作无价值代码清理

- 触发：用户指出 Quick Switch 的关闭按钮、关闭确认弹窗、关闭服务和专门 close QA 脚本是已确认并做出的功能线，被误删了。
- 失误：AI 把未完全理解的 close 功能线当成可清理代码删除，导致交互和 QA 覆盖一起丢失。
- 原因：清理未确认代码前没有先用 git 历史、QA 报告、用户决策记录核对功能归属。
- 改进：删除任何已出现过 QA 报告、脚本、用户验收截图或专门服务协议的功能线前，必须先列出影响面并取得用户明确同意；恢复时必须同步恢复对应 QA 脚本。
- 关联：`C1.source/Sources/Aligner/QuickSwitchRootView.swift`、`QuickSwitchCloseRequest.swift`、`DebugWindowCloseService.swift`、`C3.tools/round1-close-fixture-qa.sh`。