Archived
snowy-yang
6fb37534d3
为什么：「任何失败路径必须退款」此前靠路由里每条早退/except 手工调 refund_open 维持（download.py 单文件 25 处），上一轮拆 register/login 时已经体会过这个模式的代价——改任何一条返回路径都要核对还原时序， 漏一处不会有测试报警，只剩重启对账兜底在跑。 改动： - Billing.scope()（asynccontextmanager）：作用域退出时自动退还仍 open 的账本行。正确性完全依赖 refund_open 的既有幂等口径（只退仍 open 的行）——settle()/rename_to() 消费过的行天然豁免，成功路径零动作， 无需手动「取消自动退」；未捕获异常先退款再原样穿透。 - download.py 四个端点全部改用 async with billing.scope()，删除全部 手工退款与 _fail 收尾闭包；_sync_download_json 的内部退款一并移除 （docstring 标明必须在 scope 内运行）。 - 语义逐路径等价：错误早退→自动退（同原手工）；register 成功后 rename→自动退 no-op（同原手工退的 no-op）；start 失败行挂 task_id 留给对账（同原）；CancelledError 语义不变（退款随取消中断，对账兜底）。 先写测试后动代码：tests/test_billing_scope.py 5 例（TDD 红→绿）， 对真实沙箱账本断言——open 行自动退、settle 后 no-op 且余额恰 -1、 rename 后请求级行消失且任务级行保持 open、异常穿透、free 路径零动作。 既有 30 例计费/下载端到端测试作迁移回归网。 门禁：ruff 全过 · pyright 0/0 · pytest 387 passed（382→387）。