From d087b0ff49652a2c1cd910a6ee5bb49605c68415 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Mon, 28 Sep 2026 19:55:13 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=BF=90=E7=BB=B4):=20=C2=A7=E5=8D=81?= =?UTF-8?q?=E5=85=AB=20=E6=9C=AC=E6=89=B9=E5=8F=91=E7=89=88=E8=AE=B0?= =?UTF-8?q?=E5=BD=95=EF=BC=88a31df4a2=EF=BC=8C=E5=A4=96=E8=A7=82/=E5=93=81?= =?UTF-8?q?=E7=89=8C=E7=8A=B6=E6=80=81=E4=B8=8E=E5=BF=83=E8=B7=B3=20+=20?= =?UTF-8?q?=E5=AF=86=E9=92=A5=E5=90=8E=E5=8F=B0=E4=BB=A3=E5=A1=AB=E9=94=81?= =?UTF-8?q?=E5=AE=9A=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 含两笔提交的分工、验证读数(后端 3283/0、app 800/0、admin 1624/1 存量红)、 worktree 干净检出出包与产物自查、两台发版表(B 19:43 空闲先发 / A 19:45 在飞后发, A 自回收 4、claimed 9、busy requeue 32→4、ERROR 0)、两条前端通道的软链与线上字节校验、 新端点守卫形状,以及 admin_device_logs 缺 guide 这条存量红灯留人决定。 --- docs/ops/prod-decisions-2026-09-28.md | 62 +++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/docs/ops/prod-decisions-2026-09-28.md b/docs/ops/prod-decisions-2026-09-28.md index 3dd20db14..ce202db2d 100644 --- a/docs/ops/prod-decisions-2026-09-28.md +++ b/docs/ops/prod-decisions-2026-09-28.md @@ -1481,3 +1481,65 @@ jar `162,617,089 B` / md5 `e344111aa7716f46e351c0de72ace433`(线上旧版 `688 本机 curl `http://127.0.0.1:18080/api/admin/users` 返回的是 `200`,body 是 `{"success":false,"message":"未登录","data":null,"code":401}` —— 这才是拒绝的形状。 读验收要读 body 的 `code`,或按 §14.5 去数 WARN 级 `[admin-guard] … 拒绝:登录身份 id=… 与请求参数 user_id=… 不一致`。 + +## 十八、本批发版记录:`a31df4a2…`(外观/品牌心跳与判死文案 + 密钥后台代填锁定),19:43 B / 19:45 A + +这批代码由并行会话在 17:57–18:56 写完(18:56 后静置 36 分钟未再改动),本轮只做验证、提交、发版。 +两笔提交:`12d4bdcf`(外观/品牌,7 文件 +102/−32)、`8143a511`(密钥,12 文件 +583/−20), +推 Gitea 后 `git rev-list --left-right --count origin/master...HEAD` = `0 0`。 + +改了什么(按主题): + +- **外观专利判死文案**(前端):`statusText/statusClass` 原先把 `isResultPreparing` 排在 `FAILED` 前面, + 心跳超时判死后(29473/29479)用户看到的是"结果生成中",会以为任务还在跑而继续等。 + 改成 `FAILED` 一律优先判定、`pendingResultHint` 同步切成"任务已失败,结果文件…",下载按钮照常出现。 +- **外观专利批次心跳**(后端):LLM 每批 `touchJavaSideTaskActivity` —— 软恢复后的检测阶段可达数小时, + 不刷会被通用兜底线的 `updated_at` 超 120 分钟误杀。 +- **品牌任务进度**(后端):改走 Redis Lua 合并写,`phase` 不被 `crawling` 打回(assembling/uploading/failed 受保护)、 + `current_line/total_lines` 只增不减;`saveProgressFromResult` 不再按单文件覆盖任务级进度。 +- **密钥后台代填并锁定代理**:`PUT/DELETE /api/admin/user-secrets/{userId}/modules/{moduleKey}`, + 锁定行客户端 save/clear 由服务端直接拒(只置灰挡不住直接调接口);密钥包把代理单独放 `proxy` 字段 + (仍不进 items、不影响 `complete`),锁定时带 `full` 明文让客户端幂等对齐本地 app.json。 + 只开放代理代填——密钥模块要客户端提交任务时携带本地明文,代填会把用户卡死。 + +验证(跑的就是这批内容:跑测前后 19 个文件 sha1 逐字节一致,跑测期间无人改动): + +- 后端 `mvn -o test`:**3283 用例 / Failures 0 / Errors 0 / Skipped 7**,BUILD SUCCESS。 +- `frontend-vue` `npm test` **800/0**(含新增 5 条:3 条状态文案判定顺序 + 2 条锁定代理对齐本地配置);`npm run build` 成功。 +- `admin-frontend-vue` `npm test` **1624 通过 / 1 失败**,失败项是存量的 + `align_guide_every_router_page_has_guide_except_duplicate_check`(`admin_device_logs` 无 guide: + 路由 09-15 由 `79b5d403` 引入、guides 表一直没补),与本批 19 个文件无交集,**留人决定**;`npm run build` 成功。 +- 隔离 worktree(`tmp/head-build`,detached `8143a511`):`mvn -o clean package -DskipTests` + + 定向 `mvn -o test -Dtest=UserApiSecretServiceTest` = **36/0**(干净检出自足性抽样)。 + +产物自查:`entries=2029`、`docs/` 条目 0;`javap` 见 `UserApiSecretService.adminSaveModule/adminClearModule/ +requireNotAdminLocked/requireVisibleUser/isAdminLocked`、`AdminUserApiSecretController.saveModule/clearModule`、 +`BrandTaskProgressCacheService.HEARTBEAT_MERGE_SCRIPT`(Lua 常量 assembling/uploading/failed/crawling 均在)、 +`AppearancePatentTaskService.submitLlmBatches` 里的 `touchJavaSideTaskActivity` invoke。 +jar `162,619,842 B` / md5 `a31df4a21e2bb97bf16b6be0529981cd`。 + +| 项 | 主机B(19:43 先发,发前空闲:5 分钟 23 行日志/0 claimed) | 主机A(19:45 后发,发前在飞:14 claimed、33 条外观日志) | +| --- | --- | --- | +| 替换后线上 md5 | `a31df4a2…` OK | `a31df4a2…` OK | +| health | 200 @ t+5s | 200 @ t+10s | +| Flyway | 137,无需迁移 | 同 | +| instanceId | `server-121` LOW | `server-110` LOW | +| 启动异常采样 | 无 | 无启动异常(采样里的 3 条是品牌检测走 jikip 代理超时重试与客户端 abort,既有现象) | +| `开机自回收本机遗留作业` | 0 | count=4 owner=server-110 cutoff=19:45:29 limit=20 | +| `scheduled worker claimed`(19:44 起窗口) | 0 | 9 | +| `已达到最大重试次数` / `重发轮次已达上限` | 0 / 0 | 0 / 0 | +| `requeued because task lock is busy` | 0 | 32(19:44–19:48 含重启追赶)→ 近 3 分钟 **4**(≈1.3/min,回到 §十一 修后量级) | +| ` ERROR ` | 0 | 0 | +| 启动生效配置两行 | `enabled=false` 均在 | 同;19:48 巡检 `resume(ran=false s=0 r=0 k=0 u=0)` | + +前端两条通道(都在主机B,软链原子切换,无重启代价): + +- app-web:`/opt/1panel/www/sites/app-web-20260928-195043`(98 文件远程 md5 全过), + 回滚点 `app-web-prev -> app-web-20260927-115517`;线上 `assets/ApiSecretSettingsPanel-BqKeRErU.js` + 200 且含"后台锁定",`BrandAppearancePatentTab-Chwa1CJZ.js` 200 且含"任务已失败"。 +- admin-vue:`/var/www/admin-vue-20260928-195218`(55 文件),回滚点 `admin-vue-prev -> admin-vue-20260923-160640`; + 线上 `assets/UserSecretsPage-CtrJDwtI.js` 200 且含"代填代理"。 +- 入口口径(此前文档没写全):`https://api.aishufu.top/` 是 302 → `/admin-vue/`,用户端 SPA 在 `/home`、`/login` 等路径(`/home` 200)。 + +新端点的守卫形状(两台 `127.0.0.1:18080` 直连自测):`PUT .../modules/proxy` 不带凭据回 +`{"success":false,"message":"未登录","code":401}` + HTTP 200 —— 既是"已上线"的证据,也再次印证 §17.1 的读法。