docs: 代码修改约定改为根治优先原则

2026-07-22 22:38:15 +08:00 · 2026-07-22 22:38:15 +08:00 · d891ccf08f
commit d891ccf08f
parent f953127613
1 changed files with 1 additions and 1 deletions
--- a/AGENTS.md
+++ b/AGENTS.md
@ -141,7 +141,7 @@

 ## 4) 代码修改约定（实用版）

- **最小改动原则**：只改与需求直接相关文件，避免顺手重构。
+- **根治优先原则**：修复问题时优先判断能否根治；能根治的，应告知用户根治方案与影响范围并询问是否执行，在一定范围内的重构是可接受的，尽可能避免打补丁式的临时修改。
 - **精确读取原则**：禁止整文件通读。阅读/修改前先用搜索工具（grep / 符号查找 / 关键字定位）锁定需要的行段，只精确提取并阅读相关片段，不要把整个文件一次性读进来。
 - **文件编辑方式**：修改文件时优先使用 `apply_patch` 或其他原生文件编辑工具；尽量不要用 `bash`/`python` 脚本批量改文件，除非原生工具明显不适合。
 - **后端改动优先级**：先改 `modules/`、`server/` 内对应模块，最后才动入口。