From 6a8db9ca98d2a283c8c4384f50f0acaa405ceb93 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A7=9A=E7=AB=A0=E6=B5=A9?= Date: Sat, 10 Oct 2026 10:41:49 +0800 Subject: [PATCH] =?UTF-8?q?docs(acceptance):=20=E8=A1=A5=E7=AC=AC=E4=BA=8C?= =?UTF-8?q?=E9=81=8D=E7=95=8C=E9=9D=A2=E9=AA=8C=E6=94=B6=EF=BC=88.md=20/?= =?UTF-8?q?=20drive=20=E7=9B=B4=E4=B8=8B=E8=B7=AF=E7=94=B1=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - A1:第二遍取件(DH-AG95夹爪适配-指令协议.md,3513 B)与内容级 sha256 去重的核对方法 (content_objects 命中已有行时只更新 updated_at,不更新 created_at;必须走 source_item_versions.content_object_id 关联,不要按 created_at 过滤) - B1:tp-466164a074cb22efb → completed(polls=8,测试库 0c84a098…) - C1:v4 rcs-2b22276e…(新增3/阻断193)+ 批次 rb-f1819fb0…(sealed、1 项)→ 再证「批准后才生成」顺序规则 - C2:留档 20261010T023538Z-0b217e8a + guardcheck PASS + 执行 rx-bc714172… 首轮 completed/verified - C3:回滚 rolled_back + 独立核对目标库 enable_status=disabled(行不删) - F:新增待办 3e——发布结果页不自动刷新(worker 已完成仍显示待执行,需手动刷新) --- docs/USER_FLOWS_ACCEPTANCE.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/docs/USER_FLOWS_ACCEPTANCE.md b/docs/USER_FLOWS_ACCEPTANCE.md index 336bef9..94a8a45 100644 --- a/docs/USER_FLOWS_ACCEPTANCE.md +++ b/docs/USER_FLOWS_ACCEPTANCE.md @@ -27,6 +27,12 @@ `file` 认作 Microsoft Word 2007+、zip 12 项;`content_objects` 记 `validated_format=docx`、 `content_state=verified`、`sha256=5d8f38d0…` ✓ - 教训:**dws 取件的端到端证据必须在"平台真实调用路径"里取**(脚本直接跑会漏掉环境白名单这类差异) +- **第二遍(2026-10-10,另一条路由)**:`技术文档/人形适配大寰电爪相关资料/DH-AG95夹爪适配-指令协议.md`(3513 B,**drive 直下**,不走 adoc/sheet) + - 路由回执:"策略已保存 1 份;已记入意图 1 份;排队从源头取件 1 份;列入待入库 1 份" + - `artifact.fetch` 一次成功;spool `sn-22da9a36….md` 3513 B、UTF-8、正文以 `# DH-AG95夹爪适配-指令协议` 开头 ✓ + - **易误判点**:`content_objects` 按 **sha256 内容级去重**,命中已有行时只更新 `updated_at`/**不更新 `created_at`**—— + 本次复用了 2026-09-14 创建的 `co-e90af1d6…`(sha `55fae4b4…`、3513 B、`md`)。核对时必须走 + `source_item_versions.content_object_id → content_objects`,不要按 `created_at` 过滤列表(我一开始就这么看漏了) #### A1 补充:钉钉取件改走 dws(`f4e1ecc` / `6496ee3` / `9155bd3`,2026-10-09) - 开关:`ARTIFACT_DINGTALK_FETCHER=dws|auto|legacy`,线上为 **auto**(先 dws;**仅可重试错误**回落老路径)。 @@ -71,7 +77,15 @@ - 证据(2026-10-10 界面实测):`解析监控 → 待入库(1)` → **开始处理** → `tp-c3412382b66f55404d2b51672ffd0549` → `parse_status=completed`、`ingest_state=uploaded`、`poll_sequence=4`、`last_remote_status=completed`; 知识 `98be235b-68cf-43e1-94ca-419f5b97fddb`;任务链 `test.upload` → `test.poll`×4 → `test.validate` 全 completed ✓ -- 状态:✅ 2026-10-08 / 2026-10-10 实测 +- 证据(2026-10-10 第二遍):`tp-466164a074cb22efb` → `processing_state=completed`(polls=8、remote=completed、 + 测试库 `0c84a098…`);任务链 `test.upload → test.poll×8 → test.validate` 全 completed ✓ +- 证据(2026-10-10 第二遍):批准 `.md` → `生成新版本`(v4 `rcs-2b22276e…`,**新增3/阻断193**)→ `确认冻结` → + 批次 `rb-f1819fb0c4196ae6e22e600874954a0c`(`验收-DH-AG95指令协议-20261010`,**sealed**、1 项、仅 `tp-466164a074cb22efb`、绑定 v4)→ `锁定清单` ✓ + 又一次确认顺序规则:**批准前生成的 v3 里该条仍 `not_ready`,批准后重生成 v4 才 `ready/can_release=t`** ✓ +- 证据(2026-10-10 第二遍):`回滚` + `rollback-production-release` → 执行 `rolled_back`(1/1、failed 0、项级 `rolled_back`); + **独立核对目标库**:`knowledges` 行仍在(title `DH-AG95夹爪适配-指令协议.md.md`)、`parse_status=completed`、 + `enable_status=disabled` ✓(回滚=停用,不删行,两次实测一致) +- 状态:✅ 2026-10-08 / 2026-10-10 实测(两份文档各一次发布+回滚)(两份小文档:docx 转换路 + md 直下路) ### B2 解析监控与补救 - 入口:**解析监控** → 处理中 / 需要你出手 / 需下架 / 死信 / 已完成 / 知识库差异 / 知识库解析进度 @@ -110,6 +124,11 @@ 项级 `verified`、`production_revision=rv-e4b38040…`、`bundle_sha256=19a85aea…`), worker 日志 `in_scope=1 foreign=8 … degraded=true` 无失败行 - 页面原文:该执行 `发布 已完成 1/1`;每项结果 `App账号注册.adoc → 发布并验证通过 · 目标库 0b217e8a… · 生产可用` ✓ + - **第二遍(2026-10-10,`.md`)修复后首次即成功**:留档 `20261010T023538Z-0b217e8a` + (PG knowledges 3830→**3831**、wiki_pages 1982→**1983**,与上一轮发布/回滚后的库状态吻合)→ `guardcheck` 两库 PASS → + 执行 `rx-bc714172a3b0c77885ef18a30dd3ac6b` → **`completed` 首轮通过**(1/1、failed 0、项级 `verified`), + worker 日志同样 `in_scope=1 foreign=8 … degraded=true` 且无失败行 → 页面 + `发布 已完成 · 1/1`、每项结果 `DH-AG95夹爪适配-指令协议.md → 发布并验证通过 · 生产可用` ✓ ### C3 查看结果 → 回滚 - 入口:**发布管理 → 查看结果** → 需要时 **回滚** → 确认语句 `rollback-production-release` @@ -202,6 +221,8 @@ 3. **wiki 通道的真实跨环境发布已跑通**(2026-10-10,见 C2):发现并修复"写入保留外来源页、校验却要求集合相等"的口径冲突(`eabe55b`);降级保留(`degraded=true`)现在是发布常态路径。 3b. **指标条的健康探测有误报**:`解析监控` 顶部把 Embedding 模型 / LLM 模型 / OSS / Redis-MQ / WeKnora API 显示为"阻断",但本期入库与发布全链路(上传/解析/索引/发布/回滚)都实际成功 → 探测口径待校正(不作阻塞项)。 3c. **`系统设置 → 服务配置` 的"测试端"探测报 404**:`test_weknora_base_url` 为空时 api 用 `TEST_WEKNORA_BASE_URL=http://app:8080` 探测,而 `app` 在治理栈网络内不可解析 → 显示"可达·不可接单";worker 走的是可用路径(本清单 B1/C2 均成功),仅探测口径问题。 +3e. **发布/回滚结果页不自动刷新**:Release Worker 完成后,`发布管理` 的执行行仍显示"待执行"(首次与第二遍都遇到), + 需手动 `刷新当前页面`/reload 才看到 `已完成`/`已回滚`。后端状态是对的(DB 已是终态),属展示层轮询缺口。 3d. **`release_executions.snapshot_verification_id` 为空**:发布前快照门禁确实生效(缺少/过期会 `release_target_snapshot_missing`),但执行行没有记下"用的是哪份快照",追踪性待补。 4. **"重排"在页面上无真实失败项可点**(单测覆盖);指标条"失败 1"是旧 `artifact.fetch` 死信遗留。 5. 自管逻辑备份**不能替代 PITR**(RDS 控制台那条本期不做)。