chore: add ruff checks

progress.md

@@ -1370,3 +1370,13 @@
 - 原因：`tests/test_gui.py` 中两个 `WriteBackWorker` 单测把 `db_path` 写成相对路径 `db.sqlite`；测试创建 run_log 时会打开 SQLite，导致在项目根目录生成一个空 `db.sqlite`。
 - 修复：这两个测试改为使用 `self.make_temp_dir()` 下的 `db.sqlite`，并断言临时目录被清理；根目录空 `db.sqlite` 已删除。
 - 验证：`python -m unittest discover -s tests -p test_gui.py` 通过（97 tests）；`python -m unittest discover -s tests` 通过（221 tests），跑完后根目录没有 `db.sqlite`。
+
+## 【2026-07-07】T-525 完成 · 引入 ruff lint/format 工程检查
+
+- 状态：DONE
+- 代码：新增 `pyproject.toml` 配置 ruff，当前只开启 `E4/E7/E9/F` 安全类规则；保留 `ruff format` 配置但不做全仓格式化重排。新增 `requirements-dev.txt` 锁定 `ruff==0.5.7`，不写入运行依赖或打包依赖。
+- CI：`.github/workflows/tests.yml` 安装 `requirements-dev.txt`，并在语法检查和 unittest 前执行 `python -m ruff check app tests main.py`。
+- 基线：对 `app/cdp.py` 先清代理再导入、`main.py` 先补 `sys.path` 再导入 GUI、`app/gui/widgets.py` 的 GUI 代理初始化顺序配置了明确 `E402` 豁免；修正两个真实未用变量。
+- 文档：同步 `docs/03-tech-stack.md`、`docs/05-coding-rules.md`、`docs/README.md`、`docs/engineering-review.md`、`docs/cmhub-integration-design.md`、`docs/06-tasks.md` 与 `docs/current-state.md`；下一个可领取任务为 T-539。
+- 验证：`python -m pip install -r requirements-dev.txt` 成功；`python -m ruff check app tests main.py` 通过；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（221 tests）；`git diff --check` 无空白错误；根目录未生成 `db.sqlite`。
+- 边界：未改 AI、DB、Excel、Shopee/CDP 流程；未新增 pre-commit 或 mypy。