feat(ci): 代码质量深度加固 - mypy/ruff/vulture 接入Validate #328

Merged

xiaoxia merged 3 commits from feat/ci-code-quality-deepening into develop 2026-07-14 17:56:15 +08:00

Conversation 0 Commits 3 Files Changed 2

+111 -25

xiaoxia commented 2026-07-14 17:39:22 +08:00

Owner

Copy Link

Copy Source

变更内容

1. ruff 替换 flake8（Validate 阻断级）

• 用 ruff 替代 flake8，规则集扩展到：E/F/W（基础）+ I（isort）+ B（bugbear）+ UP（pyupgrade）+ SIM（simplify）+ RET（return）+ ARG（unused-arguments）
• 新增 pyproject.toml 集中配置
• 自动修复了 34 个低风险问题（未使用 import、f-string 无占位符等）
• 手动修复：10 个 F841 未使用变量 + 2 个 E722 裸 except

2. mypy 类型检查（告警模式，不阻断）

• 接入 Validate 阶段，检查范围：apps/api/app + packages 核心业务代码
• 配置：--ignore-missing-imports --no-strict-optional --explicit-package-bases
• 告警模式，发现问题只打印不阻断，后续逐步修复

3. vulture 死代码扫描升级

• 置信度阈值从 80% 降到 70%，输出更多参考条目
• 按文件大小排序，便于优先审查高价值条目
• 告警模式，不阻断 CI

影响范围

• 仅 CI 配置 + 死代码清理 + 格式修复，无业务逻辑变更
• 删除的 import/变量均为 ruff 检测确认未使用的

验证目标

• Validate 通过（ruff 全绿）
• Unit Tests 通过
• Integration Tests 通过
• mypy 告警输出正常（不阻断）
• vulture 扫描输出正常（不阻断）

## 变更内容 ### 1. ruff 替换 flake8（Validate 阻断级） - 用 ruff 替代 flake8，规则集扩展到：E/F/W（基础）+ I（isort）+ B（bugbear）+ UP（pyupgrade）+ SIM（simplify）+ RET（return）+ ARG（unused-arguments） - 新增 `pyproject.toml` 集中配置 - 自动修复了 34 个低风险问题（未使用 import、f-string 无占位符等） - 手动修复：10 个 F841 未使用变量 + 2 个 E722 裸 except ### 2. mypy 类型检查（告警模式，不阻断） - 接入 Validate 阶段，检查范围：`apps/api/app` + `packages` 核心业务代码 - 配置：`--ignore-missing-imports --no-strict-optional --explicit-package-bases` - 告警模式，发现问题只打印不阻断，后续逐步修复 ### 3. vulture 死代码扫描升级 - 置信度阈值从 80% 降到 70%，输出更多参考条目 - 按文件大小排序，便于优先审查高价值条目 - 告警模式，不阻断 CI ## 影响范围 - 仅 CI 配置 + 死代码清理 + 格式修复，无业务逻辑变更 - 删除的 import/变量均为 ruff 检测确认未使用的 ## 验证目标 - [ ] Validate 通过（ruff 全绿） - [ ] Unit Tests 通过 - [ ] Integration Tests 通过 - [ ] mypy 告警输出正常（不阻断） - [ ] vulture 扫描输出正常（不阻断）

xiaoxia added 1 commit 2026-07-14 17:39:22 +08:00

feat(ci): 代码质量深度加固 - mypy/ruff/vulture 接入 ... 19edd9aa85

- ruff 替换 flake8：增加 bugbear/pyupgrade/simplify/return 等规则集
  * 自动修复34个问题（未使用import/格式等）
  * 手动修复10个F841未使用变量 + 2个E722裸except
- mypy 类型检查：告警模式接入Validate，不阻断CI
  * 检查范围：apps/api/app + packages核心业务代码
  * 配置：ignore-missing-imports + explicit-package-bases
- vulture 死代码扫描升级：
  * 置信度阈值从80%降到70%，输出更多参考
  * 按size排序，便于人工审查高价值条目
  * 告警模式不阻断CI
- 新增 pyproject.toml：ruff 集中配置
- 修复F841未使用变量（10处）+ E722裸except（2处）

xiaoxia added 1 commit 2026-07-14 17:41:22 +08:00

fix(ci): 收窄ruff规则集，确保Validate通过 ... 53fcc84fbb

- 只保留 E/F/W/I/B 核心规则，与原 flake8+isort 范围相当
- 后续逐步增加 UP/SIM/RET 等进阶规则

xiaoxia force-pushed feat/ci-code-quality-deepening from 5ce6446c5f to 4c97e269dc 2026-07-14 17:48:10 +08:00 Compare

xiaoxia added 1 commit 2026-07-14 17:51:50 +08:00

feat(ci): 代码质量深度加固 - mypy/ruff/vulture 告警模式接入Validate ... c05223c6f8

新增3个告警级别的质量检查（均不阻断CI，先摸底）：

1. **ruff lint（告警模式）**
   - 规则集与原flake8对齐 + 新增bugbear规则摸底
   - 集中配置在 pyproject.toml
   - 后续分批修复后正式替换flake8

2. **mypy 类型检查（告警模式）**
   - 检查范围：apps/api/app + packages 核心业务代码
   - 配置：ignore-missing-imports + no-strict-optional
   - 输出前60条最有价值的错误供参考

3. **vulture 死代码扫描（升级）**
   - 置信度阈值从80%降到70%，输出更多参考
   - 按置信度排序输出，便于优先审查高价值条目
   - 修复--sort-by参数兼容性问题（改用管道sort）

所有新检查均为告警模式，不阻断现有CI流程。
后续根据摸底结果分批修复，逐步升级为阻断级。

xiaoxia force-pushed feat/ci-code-quality-deepening from 4c97e269dc to c05223c6f8 2026-07-14 17:51:50 +08:00 Compare

xiaoxia merged commit ea93387f98 into develop 2026-07-14 17:56:15 +08:00

xiaoxia deleted branch feat/ci-code-quality-deepening 2026-07-14 17:56:15 +08:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#328