Skip to content

验证码框架 CP1-CP10 全链路——契约成文 + java/golang/python 三栈同源 + V1-V11 向量守护 - #22

Merged
ydonghao merged 16 commits into
mainfrom
dev
Sep 18, 2026
Merged

ydonghao merged 16 commits into
mainfrom
dev

Conversation

@ydonghao

Copy link
Copy Markdown
Owner

摘要

按 CP1-CP10 拍板(2026-09-18)落地的验证码框架全链路,另含两笔并行会话的设计 docs。

契约层

  • 新立 contract/api/captcha.md v1.0:Provider SPI 三档(image/sms-otp/turnstile)+ LOCAL/REMOTE 校验二分 + GETDEL 一次性原子消费【强制】+ 场景路由(默认+覆盖映射)+ verify 内联业务流不设独立端点 + V1-V11 跨栈测试向量附录
  • error-codes.md 升 v1.1:纯增量 2005 CAPTCHA_INVALID(三态合一禁细分)→ dist 14 码 → 四栈 conformance 同步(含 ContractAsserts 手抄表、python testx 手抄表、contract-dist workflow 内联自检——全仓 7 处计数点清扫)

实现层

栈 内容 验证
java captcha starter SPI 重构:框架核心(场景路由/GETDEL Lua 原子消费,修存量两步消费竞态)+ 三 Provider + 端点限流;存量便捷面锁死 image 档(ysaas 零影响) 全 reactor 绿(本地)
golang 五处漂移清偿(长度/TTL/端点字段/key 形状/失败码 2005)+ SPI 化 + 装配 fail fast 11 包 + TC 真 Redis 绿(CI ✓)
python yarch_python.captcha 首批:同构 SPI/核心 + create_router 默认限流;PNG 纯 stdlib 位图字模渲染(零 Pillow) 127 passed + ruff 双门

随批 docs(并行会话)

  • ycomp 组件资产平台设计定稿 + 修订(dc922a0 / 28e3940,docs/superpowers/specs/)

合并后动作

  • 无发版动作(java starter 行为变更待 0.2.0 tag 时随 java-publish 出口)

… V1-V11 向量守护

- 契约:新立 contract/api/captcha.md v1.0(Provider SPI 三档 image/sms-otp/turnstile + LOCAL/REMOTE 校验二分 + GETDEL 一次性原子消费 + 场景路由默认/覆盖映射 + verify 内联业务流不设独立端点 + 跨栈测试向量附录);error-codes v1.1 纯增量 2005 CAPTCHA_INVALID(三态合一禁细分)→ dist 14 码,四栈 conformance 断言与 java ContractAsserts 手抄表同步(13→14)
- java:captcha starter SPI 重构——框架核心(场景路由/GETDEL 等价 Lua 原子消费,修复存量 get→delete 两步消费竞态)+ 三 Provider(OTP 通道宿主 SmsSender 注入+目标脱敏;turnstile SiteVerifyCaller 打桩+fail-closed)+ 端点默认限流;存量便捷面锁死 image 档,ysaas 消费面零影响
- golang:五处漂移清偿(长度 5→4 / TTL 默认 120s / 端点字段 provider·key·imageBase64 裸 base64 / 存储 key 加 provider 段 / 校验失败 1001→2005)+ SPI 化 + 场景路由 + 装配 fail fast;TC 真 Redis 行为级(V6 并发恰一过/V7 TTL/key 形状)
- python:yarch_python.captcha 首批——同构 SPI/核心/路由 + create_router 默认 per-IP 限流(redis 档可插 FixedWindowLimiter)+ 校验失败 2005;PNG 纯 stdlib 位图字模渲染(零 Pillow,CP9 渲染自由)
- 验证:java 全 reactor / go 11 包+TC / py 126 / web 51 全绿;登记 contract README CP 行与变更记录 + 两栈 PLAN 完成段
…根因)+ python testx 手抄表补 CAPTCHA_INVALID + 契约/README 现行散文计数同步 14 码(历史拍板记录保持原样)
…数 ChallengeStore Protocol 化(fake 可注入);verify key 放宽 str|None(None/不存在一律 False,V4 语义)
…stable/1.80 实际生效(原 dtolnay 覆盖被 toolchain file 目录 override 压制,rustfmt 组件缺失即红)
@ydonghao
ydonghao merged commit a11a0f0 into main Sep 18, 2026
28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant