docs: 记录 Ruff lint 清理待办

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