diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..4e3e664
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,29 @@
+# 统一换行符：仓库内一律 LF，避免 Windows/Linux 交叉提交产生整文件 diff
+* text=auto eol=lf
+
+# 二进制：不做换行转换，也不做文本 diff
+*.png  binary
+*.jpg  binary
+*.jpeg binary
+*.gif  binary
+*.ico  binary
+*.pdf  binary
+*.zip  binary
+*.whl  binary
+*.so   binary
+*.dll  binary
+
+# Windows 专有脚本保持 CRLF，否则 cmd/powershell 可能解析异常
+*.bat  text eol=crlf
+*.cmd  text eol=crlf
+*.ps1  text eol=crlf
+
+# 语言统计：让 .py 之外的文本也按行处理
+*.md   text
+*.yml  text
+*.yaml text
+*.toml text
+*.sql  text
+
+# lock 文件不参与 diff 统计噪音
+uv.lock linguist-generated=true