++

.gitignore

@@ -0,0 +1,99 @@
+# =========================================================
+# Python AI Agent 学习项目 · .gitignore
+# 把以下内容提交到 git：源码 / docs / pyproject.toml / uv.lock
+# 以下内容**不**提交：临时文件、虚拟环境、密钥、IDE 配置
+# =========================================================
+
+# ---------- 虚拟环境 ----------
+.venv/
+venv/
+env/
+ENV/
+.python-version-env/
+
+# uv 缓存（避免巨大目录误入仓）
+.uv-cache/
+
+# ---------- Python 编译产物 ----------
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# 打包 / 分发产物
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+pip-wheel-metadata/
+htmlcov/
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# ---------- IDE / 编辑器：PyCharm / JetBrains ----------
+.idea/
+*.iml
+*.ipr
+*.ipr.user
+out/
+
+# VSCode（备用，你或协作者可能用）
+.vscode/
+
+# ---------- 操作系统 / 文件管理器 ----------
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+.Spotlight-V100
+.Trashes
+# Windows
+Thumbs.db
+ehthumbs.db
+[Dd]esktop.ini
+# Linux
+*~
+.nfs*
+
+# ---------- 环境变量 / 密钥（绝对不入仓） ----------
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+secrets.*
+
+# ---------- 本地调试 / 临时文件 ----------
+*.log
+logs/
+tmp/
+temp/
+*.swp
+*.swo
+*~
+
+# ---------- 数据 / 模型权重 ----------
+# 个人练习时可能下的数据集 / 模型，别入仓
+data/
+datasets/
+models/
+checkpoints/
+*.bin
+*.pt
+*.pth
+*.safetensors
+
+# ---------- Jupyter ----------
+.ipynb_checkpoints/
+*.ipynb_checkpoints/
+
+# ---------- uv / 项目工具链 ----------
+# 注意：uv.lock 应该被提交（保证依赖可复现）
+# 这里只忽略 uv 自带的本地缓存
+.uv/