feedback_keep_legacy_code.md 1.4 KB
name: 重构时保留旧实现,多留几天
description: 用户偏好在大重构 / 替换实现时保留旧代码作为回退参考,不急着删
type: feedback
originSessionId: 21abab40-0d6c-449a-ae72-9ca03205f077

重构、替换实现、删除老入口时,默认先保留旧代码几天到几周,不要在 PR 里同时删。

Why:用户多次强调(2026-05-09 改 image_generator.py.txt 时、2026-05-11 重申"多留几天")。 理由是新实现刚跑通时未必稳定,"万一有问题还能翻翻老代码"。Linus 风格的"不破坏兼容" 在这个项目里被延伸成"不要急着断老路"——回退点的存在比代码整洁更重要。

How to apply

  • 老入口 / 老实现替换为新版后,git mv 改 .txt 后缀(Python 不加载 / PyInstaller 不扫) 而不是 git rm。等用户主动说"删了吧"再删。
  • 类似 image_generator.py.txt 的情况:要重构的大文件别"一次干净到底", 先把核心拆出去,老文件保留两版并存几天。
  • 在 PR 描述里指明老代码留作 fallback,预计何时清理(让 reviewer 知道"这不是漏删")。
  • 自己看见老代码躺着别"顺手 cleanup" — 没用户授权不删。

判断边界

  • 真正过期、已破坏 API、有安全问题的老代码,可以删(这种情况会很明显)。
  • 普通的"功能重写、行为不变"的老代码,按本规则保留。