refactor: 两个「数据泥团」收成 dataclass / 字典

为什么:上一轮报告「11 个参数 > 6」的清单实测只有 7 个 ≥7 参数,其中真正
该改的是 2 个(另 5 个是 HTTP/下载原语的参数透传,合并反而降低清晰度,有意
保留)。

1) auth_system.create_user(11 参 → 6 参)
   前 5 个是账号属性(username/password/email/credits/role,同属一个概念),
   后 6 个才是泥团——它们是「注册风控上下文」(同 IP 频率闸 + 设备赠送闸)。
   收成 frozen dataclass RegistrationGuard,默认值等价于「不做任何风控」,故
   老调用点语义不变。

2) web/routers/download.py._single_task(11 参 → 2 参)
   11 个位置参数改成一个 params 字典 + device_id,字典原样透传给 worker。
   顺带删掉原本就**未被使用**的 data 参数(11 个里有 1 个是死的)。
   理由不是「参数多」而是这 11 个位置参数没有名字,调用点极易错序。

教训:create_user 签名重构时漏改 web/routers/admin_site.py:155,pytest 189 例
全绿(该端点无测试覆盖)但 pyright 报出 2 errors —— 两道门禁互补的实证,
说明类型检查不是冗余。
This commit is contained in:
snowy-yang committed 2026-09-26 18:54:17 +08:00
1 parent 0569b50737
commit 3de75f7479
5 files changed
+53 -27

No files matched your search

+4 -3
View File
@@ -186,9 +186,10 @@ async def register(request: Request):
try:
user = await asyncio.to_thread(
auth.create_user, username, password, email=email, credits=credits,
device_id=device_id, ip=ip,
ua=str(request.headers.get('user-agent') or ''),
register_ip_limit=3, register_device_once=True)
guard=auth.RegistrationGuard(
device_id=device_id, ip=ip,
ua=str(request.headers.get('user-agent') or ''),
ip_limit=3, device_once=True))
except sqlite3.IntegrityError:
await asyncio.to_thread(auth.restore_verify_code, email, code, code_ttl, 'register')
return error('用户名或邮箱已被注册,请换一个再试')