From c6b5fc63ad1fe19b13fc8e29686a67f21e0abdde Mon Sep 17 00:00:00 2001
From: yml2213 <a2213290201@gmail.com>
Date: Sun, 30 Aug 2026 21:13:53 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20Ruff=20lint=20?=
 =?UTF-8?q?=E6=B8=85=E7=90=86=E5=BE=85=E5=8A=9E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 TODO.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 TODO.md

diff --git a/TODO.md b/TODO.md
new file mode 100644
index 0000000..7102d54
--- /dev/null
+++ b/TODO.md
@@ -0,0 +1,22 @@
+# 待办
+
+## Ruff lint 清理
+
+记录日期：2026-08-30
+
+`uv run ruff check .` 当前发现 1263 条 lint 诊断。该事项暂不在本次处理，后续按批次清理并逐批运行 pytest、Pyright 和 Ruff 检查。
+
+建议顺序：
+
+1. `F401`、`F841`：未使用导入和变量。
+2. `BLE001`、`S110`、`S112`：异常处理质量。
+3. `B008`：FastAPI 依赖声明模式，区分真实问题与框架惯用写法。
+4. `I001`：导入排序。
+5. `UP045`、`UP007`、`UP017`、`UP035`、`UP006`：类型注解和 Python 版本语法现代化。
+
+当前基线：
+
+- Ruff lint：1263 条
+- Ruff format：207 个文件全部通过
+- pytest：104 passed
+- Pyright：0 errors / 0 warnings