Repository navigation
Description
版本与范围
- 版本:v3.5.0-beta.3 / v3.5.0-beta.4(服务端受控续期路径:
core/plugin_host/wasm/codearts_refresh+core/account_store/credential_version/codearts_slot) - 影响:CodeArts 账号续期;其它 provider 无关
- 结论:换票结果只存在内存里。上游已经轮换 RT 之后,本地任何结算失败都会丢新 RT;旧 RT 已作废,账号只能重新登录。
实际观察到的现象
维护日志里出现(账号 id 已截断):
[Accounts] ❌ CodeArts 令牌请求被拒(HTTP 429):{"error_msg":"The throttling threshold has been reached: policy ip over ratelimit,limit:20,time:1 second", ...}
[Accounts] ❌ 账号 codearts-account-… 凭证自动刷新失败: CodeArts 上次续期或登记来源未确认,请先查看原操作状态;不会再次换证、重新占槽或沿用旧值冒充成功
[Accounts] 本轮失败分布:codearts_refresh_unconfirmed×4
一批 66 个账号里,4 个账号进入「上次续期未确认」,之后不再自动换证,只能人工处理。更严重的情况是账号直接失效:上游已接受换票,但本地没存住新 RT。
失败链路(按代码路径逐条)
-
上游已换票、本地结算失败 → 丢 RT
Ready→Pending 占槽 → 发 HTTP → 上游返回新 AT/RT(旧 RT 作废)→complete_pending_once写账号与槽。第 4 步任何失败(SQLite busy、COMMIT 未确认、进程退出、写库失败)都会让第 3 步的结果只剩内存:- 重试不能用旧 RT(已作废);
- 槽留在 Pending → 后续永远判「上次续期未确认」;
- 没有任何落盘记录能证明「上游已经换过」,恢复流程无从补结算。
-
收尾失败把槽悬挂在 Pending
保存/收尾任一步失败后不落 Blocked,账号永久报「上次续期未确认」。 -
发送前失败被当成刷新失败
收据提交锁竞争、HTTP client 构造失败发生在任何字节发出之前,RT 实际未被消费,却把槽封成 Blocked,需要人工停服务重置。 -
导入/替换无条件重置
_hostCredentialVersion
一次整份导入就让所有已登记账号的续期槽版本错位,刷新全部 409;自动维护还会误报「无需刷新」。 -
并发换票触发上游 IP 限流
启动或批量维护并发换票,命中上游约 20 次/秒的 IP 限流(429),批量失败并把槽封 Blocked。 -
恢复流程自锁
恢复在 IMMEDIATE 事务内写运行日志,而日志写同一个库 → 抢自己已持有的写锁;启动期卡在恢复步骤,Windows SCM 30 秒超时后服务起不来。
方案(已在 fork 的 beta.3/beta.4 构建上验证)
1. 换票结果耐久日志(核心)
新表 codearts_refresh_results(CREATE TABLE IF NOT EXISTS,不改 user_version):
account_id PK, operation, generation, db_epoch, born, revision, payload(enc1:), created_at
顺序改成:收到上游响应 → 先加密落盘 → 再结算。
- 落盘成功后的任何失败,都能在恢复流程里用同一份响应补完;
- 落盘失败才退回「失败即 Blocked」的旧纪律;
- 结算成功删除该行。
恢复入口:启动时 + 每轮凭据维护开始时。只有同时满足以下条件才补结算:
- 账号当前版本 == 日志里的
born + revision; - 槽处于 Pending,且
operation、generation、revision、born、db_epoch全部一致。
任一不一致 → 判陈旧并删除(绝不跨账号/跨代次套用);读/写失败 → 保留记录等下一轮(不丢唯一副本);补结算失败 → 槽落 Blocked 并删除记录(避免无限循环)。
2. 五条不变量
- 上游结果未知时,绝不重发同一 RT(at-most-once);
- 日志落盘成功后,已轮换的 RT 不丢(durability);
- 只有「确认未发出」的阶段才允许自动重试;
- 应用日志前必须账号 + 槽身份完全一致;
- 恢复必须幂等,可每轮安全执行。
3. 发送前失败与阶段码
- 收据提交失败重试 4 次(20/40/80/160ms),仍失败回退 Ready;
- HTTP client 构造失败同样回退 Ready;
- 两者都不推进账号版本、不消费 RT;
- 发送之后(可能已发出)的失败才 Blocked,且不自动重试,避免同一 RT 被发两次;
- 阶段码不再统一成
codearts_refresh_unconfirmed,细分:
not_ready / pre_send / egress / request / material / read / call / random / send_failed / post_response / complete_failed / journal / unavailable; - 维护只对 pre-send 阶段瞬时失败重试(1s、2s,最多 3 次),
send_failed不重试;每 8 个临期账号暂停 2 秒。
4. 导入与限流
- 导入逐行比较授权材料:未变化沿用原版本;确实变化才重置版本并作废该账号的续期槽;
- 进程级换票节拍 ≥120ms(约 8 次/秒),降低命中上游 20 次/秒 IP 限流的概率。
5. 恢复日志自锁
事务内只收集文案,事务提交、锁释放后再写运行日志。
验证
- 单测:加密落盘、同账号覆盖、按操作删除、篡改识别;导入未变更保留、变更重置、普通更新推进。
- 线上:66 账号 / 66 槽;部署前后槽密文逐字节一致;维护轮次 0 刷新 0 失败;无
codearts_refresh_unconfirmed。 - 负向:收到响应后 kill -9 → 重启补结算;收尾失败 → 恢复;收据锁竞争 → 回退 Ready。
与当前 beta 的关系(请维护者定方向)
上游 beta 的 e4d8e3f7 已「将 CodeArts 续期迁回插件」,删除了服务端 codearts_refresh、credential_version/codearts_slot*、codearts_enrollment*,新增宿主 db/codearts_slot(FULL 事务 + COMMIT 事实)与插件侧实现。
因此本 fork 的补丁按原文件无法直接合入;但上面的失败窗口与不变量在新架构里仍然成立:
db/codearts_slot解决的是「事务提交事实」,不是「换票结果耐久」;- 建议二选一:
- A(推荐):宿主在
db/codearts_slot旁开放受限的journal_result(account, operation, generation, version, payload)+recover()接口,密钥与事务都留在宿主,插件只调用; - B:在插件仓库
ProvidersPlugin/Agent2Providers内实现同样的 journal/restore,插件自己持有换票响应。
- A(推荐):宿主在
我们可以基于最新 beta 重新实现并提 PR(请指定目标仓库与接口边界),也可以只提供设计、测试用例与复现脚本。
参考
- Fork 分支:https://github.com/Smirk1921/Agent2API/tree/fix/codearts-pending-leak-and-batch-export
- 提交(beta.3 之后):
- 说明:分支里还带一个独立的批量导出功能(
/api/accounts/export-batch),与本问题无关;如果要 PR,我会把它拆开或丢弃。
🤖 本条回复由 AI Agent 生成
Activity
coderabbitai commentedon Nov 21, 2026
aimod-cc/Agent2API(网关侧接口契约有责) +ProvidersPlugin/Agent2Providers(插件侧触发点有责)。 #389🔗 Related PRs
#631 - fix: 放宽 CodeArts 换证读响应预算,避免弱网下误判未确认 [open]
📝 Issue Planner
Check the box below or use the
@coderabbitai plancommand to generate an implementation plan and prompts that you can use with your favorite coding assistant.🧪 Issue enrichment is currently in open beta.
You can configure auto-planning by selecting labels in the issue_enrichment configuration.
To disable automatic issue enrichment, add the following to your
.coderabbit.yaml:💬 Have feedback or questions? Drop into our discord!
Smirk1921 commentedon Nov 21, 2026
按这个设计在新架构上落了实现:WASM 插件侧的两阶段暂存(复用现有
account.update,不需要新宿主能力)——ProvidersPlugin/Agent2Providers#57。服务端旧路径的补丁仍保留在分支里,供 3.5 之前的版本参考。🤖 本条回复由 AI Agent 生成