Skip to content

feat: 账号批量编辑支持逐账号同步上游模型白名单 - #918

Draft
ranxi2001 wants to merge 13 commits into
productionfrom
feat/account-batch-upstream-model-sync
Draft

ranxi2001 wants to merge 13 commits into
productionfrom
feat/account-batch-upstream-model-sync

Conversation

@ranxi2001

@ranxi2001 ranxi2001 commented Nov 18, 2026 •

Copy link
Copy Markdown
Owner

解决的问题与行为变化

  • 触发条件 / 原行为:多选账号后,批量编辑的“同步最新支持模型”只填充共同目录,不能逐账号保存自己的上游模型。
  • 修改后行为:新增“批量同步上游模型”,冻结显式勾选的 ID,以最多两个并发逐账号立即保存自己的白名单。失败保留原值,支持仅失败集合重试。
  • 本次范围与仍未解决的问题(如有):本 head 的 CI/PG/前端与 UI 证据已核验;四身份附件和参与者披露在本轮修正。保留 Draft,未 ready/merge/release/deploy。注意另一路四小时维护源码审查在相同 head 报告 BPS/native 认证状态副作用与 stale 目录替换两项阻塞,尚未在新 head 关闭;绿色 CI 不消除这两个负路径覆盖缺口,当前不能称整体 review-ready。

关联记录与来源

管理员新功能提示

完整规则见贡献指南。新增管理员可见功能、菜单、页签或设置项时,必须在同一 PR 完成 ID 登记、标签接入和必要回归,不能留到 Release 发布后补录。

  • 提示 ID 与 frontend/src/constants/newFeatureNotices.ts 登记项(稳定且唯一):batchUpstreamWhitelist → account-batch-upstream-whitelist-v1。
  • 所有 NewFeatureBadge 展示位置:批量编辑 → 模型白名单区域 → 批量同步按钮旁(唯一入口)。
  • 关闭行为(同一功能多入口共用 ID,点击任一标签后同步隐藏;不同新功能使用不同 ID):复用 NewFeatureBadge/store,以浏览器和管理员 ID 的 localStorage 持久化。
  • ID 沿用 / 重新公告说明(普通修复、文案调整、重复发版不换旧 ID;同功能重新通知须明确为新公告登记新 ID):新增独立批量操作,首次登记独立稳定 ID;不复用自动刷新提示。
  • 同一 PR 的必要回归证据(操作或命令、实际结果、未覆盖情况):BatchUpstreamWhitelist.spec.ts 的真实 badge 测试:A=accountAutoRefreshUpstreamModels 已关闭;B 出现并可关闭;新 Pinia/弹窗同用户仍隐藏;A/B 保持隐藏、C 出现。14 项组件测试通过。未执行真实登录服务器流程。
  • A 已关闭后升级到 B,B 的新 ID 仍可见;证据或不适用原因:上述真实 badge/remount/localStorage 测试;只有一个入口。
  • 点击 B 任一入口的标签,相关入口同步隐藏;证据或不适用原因:上述真实 badge/remount/localStorage 测试;只有一个入口。
  • 同一浏览器同一管理员刷新/remount 后 B 仍隐藏(本地存储可用且未清除);证据:真实 badge/remount/localStorage 测试。真实登录服务器的退出/重新登录未运行,不将 fixture remount 等同于实际登录验收。
  • 后续 C 新 ID 正常显示,普通升级不复活 A/B;证据或不适用原因:上述真实 badge/remount/localStorage 测试;只有一个入口。

复现与验收

  • 环境与基线:基线 701612f;当前 head add606e。Chromium 桌面 1366×900、手机 390×844,虚构管理员与账号。
  • 前置条件与操作:
    1. 多选具有不同上游目录的两个虚构账号,打开批量编辑。
    2. 点击批量同步,检查逐账号结果、只失败重试、停止/关闭后不会启动未提交账号。
  • 修复前观察:基线真实弹窗缺少此操作;相同 mounted oracle 实际 RED。
  • 修复后观察 / 验收标准:选中跨页 ID [7,22] 时不包含未勾选 [8,21]。上游 A/B 可独立保存不同映射,失败不修改旧映射。停止只停止排队;已提交请求仍可能保存且完成前锁住新轮。
  • 回归测试位置、覆盖的分支及未覆盖的情况:frontend/src/components/account/tests/BatchUpstreamWhitelist.spec.ts、AccountsView.bulkEdit.spec.ts;backend 的 account_handler_batch_whitelist*_test.go、upstream_batch_whitelist_test.go。前端新测试已登记 Makefile FRONTEND_CRITICAL_VITEST;Go 测试进入原 unit/integration 集及专用路径工作流。
协议、调度或传输改动补充(相关时填写)
  • 端点、模型映射、平台/账号类型、通道与 stream 模式:复用 POST /api/v1/admin/accounts/:id/models/sync-upstream;复用账号真实目录/凭据/base URL/proxy/归一化/订阅排除/有效别名/条件更新。没有 generation 或流式业务请求。
  • 请求/响应或事件序列的脱敏最小样例:[41,42] 各发 {"apply":true,"whitelist_only":true};结果 applied/changed 或 skipped 分别展示。不把一个账号目录复制给其他账号。
  • 正常完成、上游拒绝、超时、EOF、客户端取消的处理:逐账号捕获失败;不清空旧白名单,不自动重试。断网可能失去保存确认,提示核对账号。停止/关闭仅停止未启动;不 abort 并宣称撤销已发送写入。
  • HTTP 状态与最终业务错误、request ID、耗时及用量的记录:复用已有安全错误响应;UI 不展示上游原始错误体或凭据。服务端一分钟窗口,浏览器请求 70 秒等待。无计费验收。
  • 是否改变重试/故障转移/幂等语义;请求已发出或流已开始后如何处理:只手动重试失败 ID;已提交工作保留锁直至 Axios promise settlement,关闭后丢弃旧结果界面更新。没有持久化后端 job/status 对账;传输拒绝属于未知写入结果,不能据此证明服务端仍运行任务始终最多两个。保护普通批量表单预检查互斥及关闭后的旧选择。
  • 并发占用、粘性状态、冷却与账号状态是否正确释放/保留:双 worker;预期不改自动冷却或业务调度状态,但维护审查发现混合 BPS/native 401 分支仍有副作用,待修复。保存沿用原 CAS 和调度失效通知。Vertex 继续有界分页;其他未消费分页标记保留旧值。混合 BPS/native 需完整目录。

完整 scope acceptance checklist

  • 显式多选/跨页冻结、逐 ID 请求、独立结果、失败重试、限并发、停止/关闭、重入和旧轮隔离(挂载测试通过)。
  • 旧共同目录按钮保留;独立白名单操作不顺带提交其他表单字段。
  • 中英文本、唯一 notice ID、真实 NewFeatureBadge A→B→C 持久化。
  • 当前 head 已选择的后端权限、独立目录/失败/unsupported/empty、归一化/别名/排分页测试通过;不包括维护审查新增的 structured-401/stale-cache 负路径。
  • 当前 head 隔离 PostgreSQL 真实 handler POST→GET、CAS/调度失效 2 PASS/0 FAIL/0 SKIP;后端 production adapter build 与 make test-frontend/build 通过。
  • 原生前后桌面/手机附件和 GET SHA256 验证;截图仅存 artifacts,不进源码。
  • 最终 exact head/body/CI 与四附件回读完成(本轮证据见 DELIVERY_FIXED.md);既有独审的已验范围通过,但后来的维护源码 P1/P2 仍阻塞整体接受,未标记为已关闭。

实际验证

检查与执行目录 / 命令 结果 覆盖范围、证据或未运行原因
frontend / pnpm exec vitest run src/components/account/tests/BatchUpstreamWhitelist.spec.ts --maxWorkers=1 --minWorkers=1 通过 初版 1 项 RED→GREEN,队列/提示 4 项行为 RED→11 GREEN;增加表单并发/旧轮测试分别 RED→GREEN,最终 14 项。
frontend / pnpm exec vitest run src/components/account/tests/BatchUpstreamWhitelist.spec.ts src/components/account/tests/BulkEditAccountModal.spec.ts src/views/admin/tests/AccountsView.bulkEdit.spec.ts src/i18n/tests/localeKeyCompleteness.spec.ts --maxWorkers=1 --minWorkers=1 通过 最终 4 文件/141 项,本机轻量定向,日志 final-local-green.log。
git diff --check;pnpm --dir frontend exec eslint(改动组件/composable/API/测试文件) 通过 无本地全服务编译、全量 typecheck/build。
backend / go test -v -tags=unit ./internal/handler/admin -run '^TestAccountHandlerBatchUpstreamWhitelist$' -count=1 基线 RED,候选通过 原始 RED run 原因:额外写 2 次元数据;0636 候选 此测试通过,权限 fixture 缺 avatar stub 导致其他测试 panic,已补。不是整轮 GREEN。
backend / go test -v -tags=unit ./internal/service -run 'TestBatchWhitelistSafety/unconsumed|TestBatchWhitelistBPSPartialCatalog' -count=1(基线) 行为 RED 同一 run 44248615153,未消费分页和部分 native 来源应保留旧值但旧代码未保护。
ae1fbf 专用证据 CI 通过 Handler/service、真实 PG POST→GET、CAS/调度失效、生产后端及前端 build、4 张原组件 UI 全部通过。最终后端树仍为 93eb4ee335d0e0c5db96778b04f9ea47af10a45c;该轮没有运行完整前端 critical manifest。
最终 head 专用 handler/service、生产 adapter build、真实 PostgreSQL 通过 专用 run 44251323721 completed/success;后端 63 顶层 PASS / 121 PASS nodes / 106 package-qualified PASS leaves,0 FAIL/SKIP;隔离真实 PG 2 PASS/0 FAIL/0 SKIP,实际 handler POST→GET、失败/未选账号保留、CAS/调度失效。
最终 head make test-frontend + production frontend build 通过 同一专用 run:lint 0 errors/1 个既有无关 warning;vue-tsc 通过;161 passing files、2917 passing cases、10 skipped;build 通过。是 critical manifest,不是全仓 all Vitest。
最终 head 主 CI / all checks 通过(有 skips) 主 run 44251323675 completed/success;filter=all 分页核对 92=81 success+11 skipped,0 active/failure。传统 statuses 0 contexts,aggregate pending 不是待跑的具名任务。main integration 29285 PASS/600 SKIP nodes(26563 PASS/599 SKIP leaves),0 FAIL;两项新 PG oracle 在此亦显式 PASS。
Hermes 独立 mounted / real HTTP-XHR browser oracle 通过(分层证据) 4-file 141 PASS;外置 mounted 17 PASS(包含原 14,仅新增 3 个独立断言);桌面/手机真实 Vue/CSS/Axios→loopback HTTP synthetic API,序列 [41,42,43,42]、两 active requests、失败单独重试、普通 save 不带 model_mapping,geometry/mobile scroll 通过。不是 PG-backed browser E2E,也未执行真实登录或付费生成。
后续维护独立源码审查 阻塞 相同 add606e 的 BPS/native structured-401 健康写入副作用、stale fallback 用于 destructive apply 两项待修复/新 head 回归;既有全绿测试缺少这些负路径,不能用 CI 代替关闭。
frontend / PLAYWRIGHT_ROOT=… node ../.github/scripts/batch-whitelist-ui.mjs before|after … 通过 原组件/真实 CSS、过渡动画 settle、按钮可见/可点击和 [41,42,42] 请求断言;没有真实后端联调。

UI 证据(四身份明确选择,不按 upload history 的最后四项;真实组件/CSS、虚构管理员/账号,离线 Axios adapter,不是后台联调):

before desktop — 1366×900

capture SHA 701612f6e9f7b697eb36397b9fb49bf7324e56a1。SHA256 f1cb4bcb70a7a32953d51d64cca439eb3b6f63f3c83cad88754e6735117e35c3。

before-desktop capture 701612f6e9f7b697eb36397b9fb49bf7324e56a1

before mobile — 390×844

capture SHA 701612f6e9f7b697eb36397b9fb49bf7324e56a1。SHA256 f9a87753b7ed354776aaf9a6deed7021702b56ac87601164bcc1ddcf87fa12e4。

before-mobile capture 701612f6e9f7b697eb36397b9fb49bf7324e56a1

after desktop — 1366×900

capture SHA add606e964972ded3d6389790586c781c89a58c1;附件最初捕获于 0867559e3e4c2883912bf682f52e2d066f1bd486,final-head recapture 与其 byte-identical,复用原附件,不冒称新上传。SHA256 2ee3d26b5068cf045b386d7658c1e368e88479ddf8e216e17a89be4cda47f1c9。

after-desktop capture add606e964972ded3d6389790586c781c89a58c1

after mobile — 390×844

capture SHA add606e964972ded3d6389790586c781c89a58c1。SHA256 55c07738e045b3396b5366bb1b2378851049cdef697cb7222015bb5089ad3c4e。

after-mobile capture add606e964972ded3d6389790586c781c89a58c1

四附件关联正文后独立回读 body/body_html,并逐个匿名 GET 验证 HTTP200/精确 SHA256 与 ui/*-manifest.json 一致;记录于 independent/delivery-readback.json。远程 CI 的 remote-final-ui 截图是独立渲染产物(不同字体/运行环境字节),不与本地原生附件混淆。未重传附件。截图可见区域无凭据或真实用户数据;普通表单下方未完整入图,移动滚动/几何由独立 XHR oracle 另验。

兼容性与运行影响

  • 配置 / API / 默认行为:新增可选 whitelist_only,仅允许显式 apply=true 且 automatic=false;省略时保留现有单账号/自动同步行为。
  • 数据库迁移、数据兼容与二进制回滚限制:无迁移,复用 credentials.model_mapping CAS。只更新映射、既有 updated_at 和调度失效事件;正常/已覆盖路径不写能力元数据、观测、质量状态;维护审查指出 BPS/native 401 的账号健康/调度副作用在 CAS 前发生,CAS 无法撤销,当前待修复。
  • 权限、凭据脱敏、日志或采集内容:真实管理员 middleware 和 handler 权限测试;observer apply 被拒绝,正整数 ID 校验。全部 fixture synthetic,未使用真实账号/凭据。
  • 计费、资源开销、并发或性能(声明提升需给出测量条件):只用既有模型目录 API;两账号并发,无付费/生成调用。未声称吞吐性能提升。本机仅定向 Vitest/ESLint/Vite 开发渲染,完整 Go/前端构建交给 CI。
  • 灰度 / 回滚方式与残余风险:前后端配套发布/回滚(旧后端会忽略新字段);回滚代码不会恢复已经保存的白名单。中断时需核对每个账号的实际保存结果。

文档与用户可见变化

中英文同步。新增 功能说明。完整证据在 /data/development/artifacts/account-batch-upstream-model-sync/;progress.json 记录当前 gate。截图不入源码。PR 合并、Release 和部署均未执行。

Agent 使用声明

  • Codex CLI(原唯一实现 writer):代码、测试、证据与原 PR 正文;模型 gpt-6-astra,推理强度 xhigh(实际 turn_context);fast 仅 requested,未证实 delivered。
  • Hermes Agent 主协调:协调、日志与远端核验、正文/附件最终交付;模型 gpt-6.1-sol,推理强度未知(运行时未提供)。
  • Hermes Agent 独立子 Agent(原源码/CI/PG/UI独审及本轮 D1/D2 正文与四附件核验):模型 gpt-6.1-sol,推理强度未知(运行时未提供);本轮未改应用代码。
  • 四小时维护 Hermes 独立子 Agent:后续 BPS/native 源码审查,模型 gpt-6.1-sol,推理强度未知(运行时未提供);发现 P1/P2已由后续修复在源码层关闭,动态待CI。其协调者记录的后续 Codex 修复配置为 gpt-6.1-sol / ultra / fast 仅 requested;这不是原 gpt-6-astra/xhigh writer 配置,修复已发布至e18e9eb4,新头远程动态门待完成。

提交前自查

  • base 分支和改动范围正确,没有夹带无关修改。
  • 正文、提交、测试数据和附件不含凭据、ticket/state 或真实用户敏感信息。
  • 实际验证结果已列出,失败、未运行和未覆盖的部分已说明。
  • 已检查配置默认值、权限、兼容性及相关文档;不适用项已说明。
  • Bug 修复有针对性回归验证,或已说明暂时无法补充的原因。
  • 已核对管理员新功能提示的 ID 登记、所有位置的标签接入、ID 复用/沿用规则及关闭行为;不适用项已逐项说明原因。
  • 新功能提示的必要回归已在同一 PR 完成,未留到 Release 后补录;已提供 A→B→C 等验收证据,或逐项写明不适用及原因。
  • 已填写 Agent 使用声明,列出所有参与的 Agent、模型和推理强度;纯人工编写已注明未使用。

四小时维护独立验收(2026-11-18,本轮修复已发布)

当前精确头e18e9eb4fc6e07709d7e1671a78a918ac2053196。以上“当前head/最终head”表格均为add606e964旧checkpoint证据,不代表本新头。旧文中副作用/stale阻塞是已修复前的记录,以下为最新逐项状态:

  • bbbc3955:fresh完整且read-only目录,避免structured401 auth/health/refresh写入;stale失败保留旧白名单。
  • ad4cd137:真实SyncUpstreamModelMapping入口对AgentIdentity fail-closed,零任务/凭据写回归;旧默认同步兼容未改。普通合入production657bb38d。
  • e18e9eb4:RED harness显式拒绝编译/setup/skip/panic/data-race等无效失败。
  • 父级及独立review已读生产链与回归,原P1/P2及新发现入口遗漏在源码层关闭。未运行本地动态,须等待本精确新头全部push/PR CI及专用RED/GREEN/PG/production-build;旧头绿不替新头,未接受/合并/发版/部署。
  • 前端树与add606e9相同,保留现有四原生附件与各capture SHA,不冒称重拍;父级亲看四图脱敏/布局,下载SHA256匹配。真实CSS+mockAPI证据不等于真实后端save。
  • 本轮Codex唯一修复writer及只读辅助实际metadata为gpt-6.1-sol/ultra,fast仅requested;Hermes父级和独审gpt-6.1-sol,推理强度未知。父级附一行CI过滤条件的静态修正。以上与原实现gpt-6-astra/xhigh分别披露。

远程 CI 历史 overlay 补修已发布

最新头a7c06e639409a70c64d55977093db1e2592121ea。e18新头三项失败原始日志明确为历史RED混合源码缺失API,不是有效业务RED:Issue715/quality-live旧manifest callee与候选policy caller混合;config-switch旧token callee与候选read-only caller混合(原JSON artifact14406818407已读取,wrong package是validator表层)。补修只改三个workflow:历史checkout内匹配caller API/精确pin前helpercaller;保留原基线缺陷、全部命名断言/测试、packagevalidator,退出恢复candidate。生产/前端/测试断言无变动。父级diffcheck和独立静态review918-ci.md CLEAR。新头全部CI与RED/GREEN仍待,旧头失败不冒称新头失败或成功。新增独立审查Hermes/gpt-6.1-sol/推理强度未知,Codex同原thread sol/ultra,fast仅requested。

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