diff --git a/tools/codegen/README.md b/tools/codegen/README.md
new file mode 100644
index 0000000..aa3f1fa
--- /dev/null
+++ b/tools/codegen/README.md
@@ -0,0 +1,9 @@
+# 代码生成器（已归档，禁止直接运行）
+
+这些脚本已从 `src/test/java` 移出，不参与 Maven 编译。原样运行会：
+
+- `setFileOverride(true)` 直接覆盖 `src/main/java` 与前端视图；
+- 生成配置关闭 `@PreAuthorize` 与 `@OperationLog`；
+- 连硬编码的生产库，并写死 Mac 输出目录。
+
+需要恢复代码生成时，先修复上述四点（确认开关、打开注解、改测试库、改项目相对路径），再决定是否放回可编译位置。