From 275c252cf1f8d442d60e2cacd4e090ed9dc12b25 Mon Sep 17 00:00:00 2001
From: cnphpbb <moqiruyi@126.com>
Date: Fri, 19 Jun 2026 11:43:07 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E6=B7=BB=E5=8A=A0=20.gitattributes=20?=
 =?UTF-8?q?=E5=BC=BA=E5=88=B6=20LF=20=E8=A1=8C=E5=B0=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

同步在 AGENTS.md 补充 CRLF 验证与修复方法。
---
 .gitattributes | 13 +++++++++++++
 AGENTS.md      |  1 +
 2 files changed, 14 insertions(+)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..db72de2
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,13 @@
+# 强制 LF 行尾（防止 Windows 工具引入 CRLF 导致 bash 报错）
+*               text=auto eol=lf
+
+# 显式标记常见脚本/配置类型
+*.sh            eol=lf
+*.bash          eol=lf
+*.py            eol=lf
+*.md            eol=lf
+*.yml           eol=lf
+*.yaml          eol=lf
+*.cfg           eol=lf
+*.example       eol=lf
+Dockerfile      eol=lf
diff --git a/AGENTS.md b/AGENTS.md
index 5cc9f76..87324b2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -132,6 +132,7 @@ docker compose -p <名称> --env-file ./builder/golang/env.cfg -f ./builder/gola
 - **国内镜像源**：Dockerfile 和 apt 配置默认使用国内 CDN 镜像（中科大、阿里云、华为），部署在其他地区需修改。
 - **Portainer Docker 兼容性**：Portainer CE LTS < 2.36.0 不兼容 Docker >= 29.0.0，需设置 `DOCKER_MIN_API_VERSION=1.24`。详见 `portainer-ce/readme.md`。
 - **i2c.py 需要硬件**：OLED 显示脚本需要树莓派 I2C 硬件、`adafruit_ssd1306` 库和中文字体（`fonts-wqy-microhei`）。
+- **shell 脚本禁用 CRLF**：仓库根目录的 `.gitattributes` 已强制 `*.sh` / `*.bash` / `*.py` / `*.md` / `*.yml` / `*.cfg` 等文本 LF 行尾。Windows 工具（IDE agent、记事本、PowerShell）默认写 CRLF，会导致 Linux 上 `'\r': 未找到命令` 和 `function xxx() {` 语法错误。**新建或修改脚本后必须 `file <script>` 验证输出不含 `CRLF line terminators`**，如果命中立即 `sed -i 's/\r$//' <script>` 修正。
 
 ## 系统配置（etc/）