diff --git a/mypy.ini b/mypy.ini
new file mode 100644
index 000000000..73dfd155a
--- /dev/null
+++ b/mypy.ini
@@ -0,0 +1,76 @@
+[mypy]
+# 宽松模式：只检查有类型注解的函数和变量
+# 后续逐步收紧配置
+check_untyped_defs = False
+disallow_untyped_defs = False
+disallow_incomplete_defs = False
+
+# 基本配置
+python_version = 3.10
+warn_return_any = False
+warn_unused_ignores = True
+no_implicit_optional = True
+
+# 忽略第三方库和生成代码
+[mypy-alembic.*]
+ignore_missing_imports = True
+
+[mypy-fastapi.*]
+ignore_missing_imports = True
+
+[mypy-sqlalchemy.*]
+ignore_missing_imports = True
+
+[mypy-pydantic.*]
+ignore_missing_imports = True
+
+[mypy-redis.*]
+ignore_missing_imports = True
+
+[mypy-celery.*]
+ignore_missing_imports = True
+
+[mypy-minio.*]
+ignore_missing_imports = True
+
+[mypy-jwt.*]
+ignore_missing_imports = True
+
+[mypy-passlib.*]
+ignore_missing_imports = True
+
+[mypy-ffmpeg.*]
+ignore_missing_imports = True
+
+[mypy-tortoise.*]
+ignore_missing_imports = True
+
+[mypy-uvicorn.*]
+ignore_missing_imports = True
+
+[mypy-starlette.*]
+ignore_missing_imports = True
+
+[mypy-httpx.*]
+ignore_missing_imports = True
+
+[mypy-aiofiles.*]
+ignore_missing_imports = True
+
+[mypy-boto3.*]
+ignore_missing_imports = True
+
+[mypy-botocore.*]
+ignore_missing_imports = True
+
+# 生成代码和迁移文件
+[mypy-alembic.versions.*]
+ignore_errors = True
+
+[mypy-*.migrations.*]
+ignore_errors = True
+
+# 测试文件可以宽松一些
+[mypy-tests.*]
+ignore_errors = False
+warn_return_any = False