Commit Graph

485 Commits

Author SHA1 Message Date
姚章浩 e8bfdbbc06 docs(changelog): 记录工作台界面优化开发快照 0.1.375
build / build (push) Failing after 1m41s
为什么:本仓每个面向使用者的变更都要在 CHANGELOG 留开发快照段,版本号按
基线 tag 后的提交数推导(5e850e9 为 0.1.369,本轮 6 个提交后为 0.1.375)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:10:28 +08:00
姚章浩 ef3c1fbf84 fix(web): 侧栏环境标注改为云测试环境
为什么:平台已迁到云测试主机,侧栏底部仍硬编码「本地治理环境」,会让人误以为
操作的是本机旧栈。

改了什么:文案改为「云测试环境」,用例同时断言不再出现旧文案。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:09:43 +08:00
姚章浩 2da96da592 feat(web): 问答流水立即同步改为次按钮并对齐页面边距
为什么:「立即同步」会让后台入队写同步作业,却与只读的「查询」同为蓝色实心主按钮,
容易误点;问答页左边缘比其他模块多缩进 8px,切换页面时标题会跳。

改了什么(同步的启用条件、调用与状态提示不变):
- 「查询」用全站主按钮色;「立即同步」加 qa-sync-action,改为白底钴蓝描边次按钮;
  「本周」悬停不再被主按钮悬停规则染色。
- 查询区、结果区改为与其他模块一致的圆角卡片 + 极轻投影;焦点改为统一光晕。
- 页头改用共享 .page-header(h2→h1,每页一个 h1);横向边距统一 24px,
  纵向保留原有紧凑密度;删掉被后文覆盖、从未生效的重复 padding/gap。
- 问答区硬编码蓝/灰映射回令牌;修正从未定义的 --danger-ink。

验证:typecheck、vitest 全量通过(含 96px 按钮宽度断言);浏览器只读核对
查询=实心钴蓝、立即同步=白底描边,执行一次查询(GET)台账正常;未点击立即同步。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:09:43 +08:00
姚章浩 10182b027e feat(web): 来源与目录批量条按选中高亮并换用线性图标
为什么:「对内/对外/禁止导入」是三块实心色按钮挤在右上角,「已选 N 项」缩在
禁止导入下面;没选中时整条也一样抢眼,📁/📄 emoji 与工作台风格不协调。

改了什么(策略按钮的启用条件、调用与确认不变):
- 批量条:「全选当前页」后紧跟「已选 N 项」,策略按钮归入一组(role=group);
  只有选中后整条才浅钴蓝高亮。
- 策略按钮改为浅底语义色描边,与表格内策略徽标同色同形。
- 📁/📄 换成 CSS mask 线性图标;文件夹名改为深色正文、悬停变钴蓝。
- 表头/单元格字号统一(11→12.5px),行悬停底色;页头接入共享 .page-header。
- 删除重复的列宽规则与被后文覆盖的禁止导入样式(同一含义只留一份),
  目录区硬编码蓝/灰映射回令牌。

验证:typecheck、vitest 全量通过(App 用例按新 h1 标记更新);浏览器只读核对
勾选→高亮/已选 1 项、取消→恢复中性、文件格式筛选展开;未点击任何策略按钮。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:09:43 +08:00
姚章浩 060872a144 feat(web): 解析监控标明筛选范围并收拢筛选与批量条
为什么:顶部「失败 35」是全部任务口径,下方表格默认只看「未结束」,常常为空;
两者范围不同却没有任何提示,「已选 0 项」的批量条也常亮蓝色,像有待办动作。

改了什么(筛选项、接口参数、重试权限与确认流程均不变):
- 指标卡口径(全部任务口径/最近 1 小时/当前)改成徽标;文件处理标题旁显示
  「当前筛选 N 项 · 本页 M 项」,分页写明「当前筛选共 N 项」「第 x / y 页」。
- 「清除筛选(N)」显示已生效筛选数(默认的未结束也算一项),无筛选时禁用;
  「仅当前绑定」改为可见按下态的切换片;时间范围展开为浮层,不再挤乱筛选行。
- 批量条只有选中后才高亮;禁用的主按钮改为中性灰,不再像"加载中"。
- 表格行距收紧、状态改为圆点徽标、选中行左侧标记;来源名限两行并保留完整 title;
  页头接入共享 .page-header。

验证:typecheck、vitest 全量通过;浏览器只读核对范围说明与分页总数一致、
时间浮层、详情抽屉 Esc 关闭、服务状态展开、1920/1024/390 宽度无横向溢出,
全程浏览器侧拦截非 GET 请求(0 条)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:08:49 +08:00
姚章浩 0f7b8987b4 feat(web): 全站改用越疆配色并统一模块页头
为什么:测试机工作台要长时间盯着看。原配色是深色侧栏 + 三种"主按钮"
(全局深藏青、监控页蓝、问答页黑),各模块页头字号/边距/是否装卡片各不相同;
另有一处真缺陷:全局 button:hover:not(:disabled) 特异性高于 .nav-item:hover,
悬停导航时被刷成白底,选中项文字几乎看不见。

改了什么:
- 色板改取越疆官网 dobot.cn:品牌钴蓝 #0039C8 为全站唯一强调/主操作色,
  文字与底色改为不带蓝紫偏色的中性灰(用户反馈紫色费眼);卡片细边 + 极轻投影。
- 侧栏改为明亮底,选中项浅钴蓝底 + 钴蓝字;悬停规则补 :not(:disabled) 修复白底。
  导航字号/点击区保持 16px / 44px(沿用 8d44d54 的放大决定)。
- 新增唯一一份 .page-header / .page-title / .page-subtitle;版本记录、系统设置、
  发布管理接入(版本记录页头不再装卡片),删掉各自重复的标题字号规则;
  page-shell 改为 max-width,模块自己的 1800/1500 上限终于生效。
- 版本记录、系统设置、问答同步状态里的硬编码蓝/石板灰映射回令牌;顺带修正
  6 个从未定义的变量(--border/--card/--accent/--brand 等)——它们此前只靠
  回退值或干脆不生效。

不改业务语义、权限、确认流程与接口调用。
验证:npm run typecheck、vitest 全量(110 文件 / 568 用例)通过;浏览器只读核对
导航悬停色、六个模块页头左缘/字号/字重一致。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 17:07:44 +08:00
姚章浩 5e850e96f5 fix(qa-weekly-mail): 修复发送记录读回并区分未知投递
build / build (push) Successful in 2m18s
1) 发送记录读回(确定性回归):Sends() 的 SELECT 只有 6 列,Scan 却收 7 个字段(多出
message_id)。只要历史里存在任意一条发送记录,整个列表就返回 ErrUnavailable —— 发送
成功后页面刷新、以及“完成读真实发送记录”都会失败。改为查询带 message_id,并检查
rows.Err(),不把截断的列表当成完整历史。

2) 未知投递不再当成可重试失败:DATA 已提交但没收到最终 250(连接中断/超时)时,邮件可能
已被服务器接受;旧实现记 failed 并允许下一分钟重发,会重复投递。现在由 SMTPMailer 在
writer.Close() 失败处抛出窄类型 unknownDeliveryError,deliver 保留 sending 并记录原因,
自动/手动路径都不再重发(手动返回 ERRDeliveryUnknown,HTTP 409 说明原因)。连接建立前
失败、STARTTLS/AUTH/MAIL/RCPT/DATA 命令被拒、正文写入失败仍是确定失败,可如实 failed 并
重试一次。

3) SMTP 交互加有限期限:整体 90 秒(随请求 ctx 收紧),并用 context.AfterFunc 在取消时打断
阻塞读写,避免服务器接受 DATA 后不响应时挂死 worker 与发送行。

验证:真实隔离 PG 先 RED 后 GREEN(非空 sent+failed 历史读回成功并带真实 message_id;
HTTP GET /weekly-mail/sends 非空历史 200);本机 TLS SMTP 桩 + 真实 SMTPMailer 覆盖成功、
RCPT 550、DATA 后丢最终 250、DATA 阶段卡死(ctx 800ms 内返回)四类;真实 deliver 在未知
结果时留 sending 且不重发,在明确拒绝时 failed 并可重试一次成功。make verify 17 项全绿。
2026-11-09 01:06:09 +08:00
姚章浩 719876d039 fix(qa-weekly-mail): 修复周日发送窗口并提供正式补发
build / build (push) Successful in 3m5s
根因:SendDue 同时要求“已到配置时段”与“该周已结束(下周一00:00)”。周日23点的时段
只在周内存在,当周周报永远不满足“已结束”,于是 11/08 23:00 只报 nothing_confirmed、
11/09 00:00 又已成 not_due —— 邮件从未尝试发送,与 SMTP 凭据/网络无关。

改法(最小、不碰历史发布模块):
1. 由发送窗口反推要发的周:周日窗口发当天结束的那一周,其它工作日仍发上一完整周
   (周一09:00 语义不变)。自动发送只处理这一周,不再按“所有已结束的周”回填。
2. 认领改为只重认 failed(或首次)记录:sent 幂等返回真实 message_id;sending 视为
   结果未知,拒绝盲重发并提示核对邮箱。自动与手工共用同一条渲染/认领/投递路径,
   并发或重复点击只投递一次;失败如实写 failed,不假写 sent。
3. 新增管理员正式补发(页面按钮 + GET 预览 + POST /weekly-mail/send/{week}):精确指定
   周、已确认版本与正文 hash,必须同源操作意图;未来周拒绝,当前周须到设定时点,
   已结束周可显式补发。正文/看板图片/主送/抄送与自动发送一致,结果写入正式发送记录。
   这不是“发送测试邮件”(只发 review 地址、不登记)。

验证:真实隔离 PostgreSQL(kg-pgtest-writeset 上的独立一次性库)先 RED(旧实现真实
复现 nothing_confirmed)后 GREEN;覆盖到点前/未来周/未确认/正文变化、周一语义保持、
手工补发一次并读回 message_id、并发只投递一次、结果未知不重发、失败可重试一次。
HTTP 与前端解析用例通过;make verify 17 项全绿。
2026-11-09 00:48:33 +08:00
姚章浩 9d445f4953 test(ci): 声明两个隔离PG纵向用例为可选未运行
build / build (push) Successful in 1m53s
2026-11-06 11:04:07 +08:00
姚章浩 2eff9447e1 fix(library): 修正启动收敛误判并提供精确核对
build / build (push) Failing after 1m20s
ReconcileLibraryJobs 不再把 completed capture queue 当成不存在,保留待核对
pending 封存作业;failed/cancelled/missing 仍按真实队列状态处置。管理员核对
入口只允许精确的启动误判形态,并要求 completed queue、export succeeded、
唯一 test_sealed 版本、来源身份与完整归档复核。新增 library_job_repairs
不可变审计表,在同一事务内 CAS 保存原 state/stage/error/recovery/finished_at
及本次 actor/原因/证据后修复;真实失败/取消不开放。

验证:真实隔离 PostgreSQL 启动收敛 RED/GREEN、启动→handler 纵向 pending 与
系统误判 failed、审计保留/幂等、负例;真实 Go 全量与 make verify 17 项通过。
2026-11-06 10:51:21 +08:00
姚章浩 146ac832a2 fix(library): 修复封存终态回写并增加精确核对
build / build (push) Successful in 2m9s
修复 varchar 状态参数在 AdvanceLibraryJob 的 42P08;worker 开始/终态写入失败
不再吞掉。新增管理员核对路由,仅在 completed capture queue、export succeeded、
精确 test_sealed 版本、来源身份和归档复核一致时,以条件更新修复仍为
pending/running 的同一作业;已有不同快照或并发失败/取消行拒绝覆盖。保留
第一因与历史记录,不重新封存、不产生快照、不写源或目标知识。

验证:真实 varchar DDL PG 路径、handler 负例/幂等、worker 注入、web 组件;
umask022 与真实隔离 kg_library_test_* 下 Go 全量与 make verify 17 项通过。
2026-11-06 10:04:19 +08:00
姚章浩 77bbc3ac6b fix(worker): 恢复保留错误的第一因分类
build / build (push) Successful in 1m38s
恢复 terminalLibraryCaptureError,但仅限仍存在的 missing library generated
question index 和 empty library index content;已恢复写入者时走
jobs.Permanent(validation_failed),保留原消息。已取消的正文索引覆盖 marker
和网络超时仍重试。部署脚本另以新包提供旧基线稳定性采样;不恢复 R3f 已取消
的正文索引/父类型规则。

验证:worker 保留错误 RED→GREEN、v071、Go 全量、make verify 17 项。
2026-11-05 18:48:53 +08:00
姚章浩 eaa388f76b fix(release): 取消封存正文索引与父类型推断规则
build / build (push) Successful in 1m42s
按用户明确要求,治理封存不再替 WeKnora 判断正文块“应该”有独立索引:
删除 status/chunk_type/parent/mixed/flat 推导的 needOriginal、mixedDocs
及覆盖门槛;删除 parent 类型搭配限制,仅保留父引用存在与同 knowledge。
capture/preflight/archive/load/replay/writeset 共用校验同步更新,移除已无
用途的 worker 永久失败分类。

保留真实导出范围、PG/ES 原始正文/问题 metadata/vector、tenant/KB/
knowledge/chunk 身份、清单摘要、资源字节、Wiki/问题索引 source_id 及真实
悬空引用等完整性检查;不修改源端,不补数据/索引。旧测试改为原样捕获正例,
新增 status0/2 缺正文索引和父类型不匹配的接受回归,以及 archive/readback
逐行/逐记录比对。

验证:v071、cmd/worker、Go 全量、make verify 17 项。
2026-11-05 18:24:36 +08:00
姚章浩 cf11343cf4 fix(release): 适配原生 parent-child 索引覆盖选择
build / build (push) Successful in 2m0s
治理候选封存现在解析 chunks.parent_chunk_id,并按 knowledge 区分源端
v0.7.1 的原生索引选择:mixed 文档只要求有 parent 的 text 原文索引,
flat 文档仍要求全部 text;parent_text 仅作上下文;status=2 缺失仍拒绝。
问题索引仍按 source_id 精确核对,不把问题记录当正文索引。

非空 parent_chunk_id 必须指向同一 knowledge 的真实 parent_text;standalone
空字段不强制关联,不被其他文档的 parent 豁免。归档与解档复用同一校验;
合成夹具证明 PG 全部 4 个 chunk 与 2 条 ES 原始记录读回保留。

验证:真实 ArchiveLibraryCandidate RED→GREEN、v071 全量、Go 全量、
make verify 17 项。源 WeKnora 未修改,不补父关联/索引,不重解析。
2026-11-05 16:18:20 +08:00
姚章浩 7511c59987 fix(release): 修复封存阶段真源与精确验证列表
build / build (push) Successful in 1m56s
F02:测试封存作业只展示只读导出测试版本,不再套用备份生产/同步 Wiki/
生产验证/生产生效,也不再写目标维护;运行和失败终态都保留真实 export
状态。同一挂载覆盖 running→failed。

F03:版本列表按每个 snapshot_id 精确查询恢复验证记录,与详情使用同一
endpoint;同 scope 最新 passed 不再给其他快照染色,未演练与读取失败分开。

封存失败:已恢复写入者且确定不可重试的捕获校验错误使用永久失败,避免
第二次 attempt 的 already exists 覆盖第一因;业务 job 的 error 在失败重试
中保留第一条,成功时清除。瞬时不可达/超时仍保留重试。

验证:Go/前端全量、隔离 PG 精确快照与首因测试、临时独立 ES 的
Current→Prepare→Verify PASS、make verify 17 项。host libraryctl 仍是旧
f9c15a8f...dirty,360 镜像未替换 host 工具,本轮只单独准备包不切换。
2026-11-05 14:05:13 +08:00
姚章浩 b81fcd07e3 fix(release): 修复tableState文本身份与快照统计归属
build / build (push) Successful in 1m57s
tableState 非 resources 分支恢复直接扫描 text 身份,避免 queryRows 把普通
doc id/UUID/复合键/数字 id 当 JSON canonical 校验而失败;resources 仍使用
F01 精确引用闭包。隔离 PG 覆盖字符串、UUID、复合键与数字 ID。

F11:快照 HTTP 投影补 bindings/wiki_log_entries;作业统计按本作业
target_snapshot_id/snapshot_id 取对应快照,取不到显示未知,不借最新封存;
running/pending/failed/unknown 不再在无 detail 时显示完成。

F03:verifications 支持 snapshot_id 精确查询,返回 snapshot_latest 并只按
该快照回答 verified;抽屉“查看校验记录”按选中快照加载,不借用最新记录。

F08:显示主机探测时间;无真实 next-run 时说明尚未核验下一次执行;最近成功
单列未知,不以最近运行冒充。

验证:Go/前端全量、隔离 PG tableState/F01 对拍与 make verify 17 项通过。
实际 Current→Prepare→Verify ES 集成被共享 ES 磁盘 watermark 阻塞,未冒充。
2026-11-05 13:19:27 +08:00
姚章浩 1a0f99e346 fix(release): 修复发布管理F01-F11资源闭包与状态呈现
build / build (push) Successful in 1m44s
F01:捕获、写前镜像、指纹和恢复后内容校验共用按目标精确绑定的资源闭包:
从已限定范围的 resource_bindings 与正文 handle 一次提取,再按索引取资源,
不再对每个租户资源扫描全部正文表。无绑定正文引用仍保留,缺失资源仍失败。

F02/F03:恢复验证使用 capture/verify/canary/restore/finalize 自己的阶段,登记
证据不再叫新版本生效;顶部优先在飞作业;已验证且 API reason 为空时不再同屏
显示未读到状态,报告可展开。

F04-F11:显示实际目标实例/项目/库;运行中主按钮查看当前任务并禁止重复启动;
快照历史默认已登记、可筛选分页并定位所选;无真实下次计划时显示未读取;各
scope 独立 overview;新操作清旧通知;存储行按文档/分块/资源/绑定及 Wiki
页面/目录/日志分项。高影响恢复验证/恢复增加一次影响确认。

验证:隔离 PG 20k 无关资源夹具旧扫描 683ms→新导出 41ms,资源 ID 闭包相等;
Go/前端全量及 make verify 17 项通过。未部署、未做 8088 UI 验收。
2026-11-05 12:50:11 +08:00
姚章浩 7675e2cd88 fix(ui): 保留业务HTTP配置超时
build / build (push) Successful in 1m33s
F13 动态客户端原先把 TEST_WEKNORA_HTTP_TIMEOUT(默认 60s)强制截成 10s,
与 readiness 探针上限混用,导致上传/轮询等业务请求 10s 即超时。

现在显式正超时原样传入;未配置/非正值回落到 appconfig 的 60s 默认。
readiness 探测自己的 10s 上限不变。

新增本地 httptest:60s 配置下 11s 响应成功,显式 50ms 短超时仍生效;
端点/凭据/绑定动态解析回归保持通过。make verify 17 项通过。
2026-11-05 12:03:42 +08:00
姚章浩 5bf4aae30e fix(ui): 接通取件后自动解析与一次性定位
build / build (push) Successful in 1m42s
F17:MarkArtifactFetched 与已验证内容复用都在同一事务内经过策略、来源启用、
过滤、superseded 和当前绑定的复核后,自动把 planned 转 pending 并入队唯一
test.upload;确认与作业幂等,失败整笔回滚。356 已卡记录可对同一文件再次保存
当前策略,经同一路径恢复,不做全库补扫或手工补队列。来源页提示改为自动接续。

F14:来源→监控定位清空未结束/动作/阶段/时间筛选;来源目录定位改为一次性请求
并由父消费,revision/sources 重载不再重放旧请求,手工换目录保持。

F13:抽出 readiness.Resolver 作为端点/绑定/凭据唯一来源;worker 上传/轮询/
校验/移除改用动态客户端,每次调用重读有效配置,不再固化启动 env 客户端。

验证:隔离 PG 的 F17 正负例与恢复用例、前端挂载定位回归、全量 Go/前端测试
及 make verify 17 项通过。未部署、未做 8088 UI 验收。
2026-11-05 11:46:42 +08:00
姚章浩 1c80b07f2c fix(ui): 修复F12-F16入口与追溯缺陷
build / build (push) Successful in 1m59s
Dockerfile 运行阶段补齐 dws_dingtalk_scan(F12),并新增 runtime-scripts 门禁
做脚本依赖闭包正负例;就绪探测每次解析当前端点/绑定/凭据并区分 404、未配置、
不可达(F13);路由写入来源路径与父目录,历史空值仅按同连接同 item 的意图读时
补齐(F14);目标筛选显示短 ID 与当前绑定/历史并提供快捷筛选(F15);刷新终态
移除后台运行、展示失败时间/旧快照/脱敏原因/作业 ID 与重试(F16)。

验证:make verify 17 项全过(identity 本地按设计 skipped);一次性 schema 的
Monitor 目录/路由集成用例通过;8088 部署与真实 UI 验收仍由父会话执行。
2026-11-05 10:38:26 +08:00
姚章浩 dfbf3336b2 docs(version): 修正0.1.28同号说明归属
build / build (push) Successful in 1m29s
f33730ed 按第一父真实边界说明开发版本历史修复并标注QA分支为集成。
保留另一0.1.28提交自身说明;新增同号不同SHA选择回归。
2026-11-04 17:05:51 +08:00
姚章浩 600cca02e5 docs(version): 修订历史说明 merge 与 rename 统计
build / build (push) Successful in 1m30s
0.1.207/0.1.35 按真实第一父 diff 重写范围与功能摘要。
0.1.340 修正为 +2485/-336 并补 rename 测试文件变更。
0.1.28 正文保留,仅补目标提交;新增合并说明回归断言。
2026-11-04 16:34:21 +08:00
姚章浩 e735ae603d docs(version): 补齐270条历史开发版本说明
build / build (push) Successful in 1m29s
按权威 version→commit 映射,为缺失开发版本增加 exact-SHA CHANGELOG 块。
正文采用该提交新增 CHANGELOG 或真实 commit body/diff 归纳,已有82条不改。
新增270条绑定验收与错SHA拒绝测试,不改变版本计算与同步实现。
2026-11-04 16:20:09 +08:00
姚章浩 2a2e98bd8e fix(version): 兼容开发快照版本标题
build / build (push) Successful in 1m41s
识别“## 开发快照 <version>(说明)”并保留旧 snapshot/v 格式。
版本号精确匹配、不跨二级标题、空正文不返回,archive 精确 SHA 绑定不变。
2026-11-04 15:57:53 +08:00
姚章浩 92684c6f60 fix(index): 预检使用目标映射 ID
build / build (push) Successful in 1m45s
PlanWriteSet 的 index preflight 改用与 plan/Apply 一致的目标物理 _id。
保留 tenant/KB 归属、完整 _mget 与并发版本校验;legacy 路径不映射。
负例:映射后 ID 被占、legacy 源 ID 冲突仍拒绝。
2026-11-04 15:12:08 +08:00
姚章浩 537a6df46d fix(library): 首次同步可复用同租户已存在资源
build / build (push) Successful in 1m39s
取消资源复用必须属于本目标历史成功同步/预备份的自加门槛。
仍要求目标行逐列一致与实际对象字节一致;旧库资源行/绑定/对象不删不改。
新增 reuse evidence v3:无 provenance,保留行摘要与逐对象字节证据。
2026-11-04 14:22:51 +08:00
姚章浩 0d9091e464 fix(library): 目标隔离映射兼容旧计划与真实回归
build / build (push) Successful in 1m41s
空 mode 计划不映射;索引 source_id 按语义映射;relation 按字段表解析。
隔离回归按持久映射 ID 断言,DS02 故障注入真实命中。
2026-11-04 12:40:12 +08:00
姚章浩 e0fc2c32b8 feat(library): 目标库隔离 ID 映射并保留旧库
build / build (push) Successful in 2m11s
同实例第二个目标 KB 与旧库共享源 UUID 时,计划/写入/校验/恢复按目标范围派生稳定身份;
计划持久化 target_id_mode,旧计划与写前镜像不二次映射;资源保持共享 ID。
2026-11-04 12:07:27 +08:00
姚章浩 6042955498 fix(objectgateway): 入口测试夹具改用无口令 PG URL
build / build (push) Successful in 1m59s
现象:CI run 347 / job 362 在 security-secrets 失败,指向
cmd/object-gateway/main_test.go:30 的 pg-url 类别。

根因:该 DSN 只用于 127.0.0.1:1 故意不可达连接,验证启动能越过
配置阶段到达 journal/后端准入,本身不需要任何口令,却写成了带口令形式。

取舍:直接换成合法无口令 URL,不拆秘密字符串隐藏检测、不改扫描器/基线/
必需项范围。产品代码与测试行为不变。

证据:check_secrets.py 由 exit 1(指向该行)转为 exit 0;go test
./cmd/object-gateway 通过;umask 022 下 make verify 16 项本地必需全 success。
2026-11-04 09:52:00 +08:00
姚章浩 a55319d972 fix(objectgateway): 取消整桶独占前置并按维护停写更新
build / build (push) Failing after 2m29s
现象:共享桶部署下网关启动即报 gateway_auditor_key_required,残留过期
审计文件则每次 Execute 报 gateway_exclusive_writer_evidence_unverified;
用户已改为“停目标写入容器→更新→启动”的维护式更新。

根因:Gateway.Ready 强制 Isolation.Verify,main 强制 Ed25519 公钥,等于
把整桶独占证明当作发布前置;这与共享桶、沿用原 AK 的实际部署矛盾。

取舍:删除审计校验与相关 env 依赖,保留 journal、治理 PG 只读 authority、
plan/owner/attempt/epoch 绑定、intent-before-send、单次写与精确版本回滚。
create 仅在精确版本读回且仍为 current 时提交;发现外部 latest 只返回冲突,
不在 confirm 阶段删除(journal create intent 已提交,删除会变成无 delete
intent/receipt 的未记账副作用并让 intent 永久 held)。同 key 不自动合并。

证据:真实二进制无审计/残留审计两环境通过;kg-pgtest-writeset 一次性库 +
随机 MinIO 桶跑 14 个网关用例(含共享桶共存写者、同 key 既有对象拒绝、
精确回滚)全过;umask 022 下 make verify 本地必需项全 success。
2026-11-04 09:45:47 +08:00
姚章浩 017765763a fix(library): 维护卡只展示 owner_job_id 匹配的作业详情
build / build (push) Successful in 1m45s
问题:维护窗口 record.owner_job_id 指向失败/待恢复的作业 A,但页面把同 scope
最新作业(更新的成功封存 B)当窗口进度,needs_restore 被显示成“导出 · 已完成”,
需要处理的原窗口因此看起来已经结束。

改法:
- maintenanceSummary 只接受“按 owner_job_id 读到的持有作业”,id 不一致一律按
  未读取处理;进度/错误/恢复说明只来自该作业,不拿最新作业兜底。
- 新增 fetchLibraryJobDetail 读取既有只读接口 GET /api/v1/library/jobs/{id},
  明确区分 loaded / missing(404) / error(非2xx、结构不符、id 串包) / unread,
  不把读取失败吞成“不存在”。
- 恢复可用性只由“维护仍持有 + 本窗口作业未收口 + 当前 scope 等于 owner_scope”
  决定;running/pending 不并发恢复,已释放/无记录不提供恢复,跨 scope 给切换提示。
- 入口状态明确标注“维护记录,未实时探测”;held 时说明只有维护记录释放才算结束;
  held 但持有作业已完成时写“维护记录未对账”,不提供强制成功。
- load 增加请求代次守卫,晚回包不覆盖更新的窗口;作业详情返回的 id 与请求不符
  按读取失败处理。

未改后端准入、网关协议或任何维护记录;未部署。
2026-11-03 23:02:00 +08:00
姚章浩 bd452e85b3 test(library): 维护 scope 终态按正式释放语义断言 released
build / build (push) Successful in 1m32s
ReleaseLibraryMaintenance 的真实终态是 state=released + released_at,原断言写成 verified 会误红;改为按生产语义核对 released/open。
2026-11-03 13:05:26 +08:00
姚章浩 71f23c6763 test(library): 用结构化 URL 构造 reader DSN 夹具
build / build (push) Has been cancelled
保持同一解析断言,避免源文件出现字面带口令连接串被密钥扫描器误报。
2026-11-03 13:04:34 +08:00
姚章浩 b4add6c9b0 fix(library): 收口 B1-R1/B2-R1/B5-R1 并让恢复链经过正式队列终态
B1-R1: 演练写集改为受限 restore-drill(V2 信封/contract 1/schema 摘要,零对象、零索引、零本地映射,来源身份必填)。B2-R1: verify 作业先建不可变 operation 并携带 operation_id,同 job recover 的网关 claim 同时携带原 operation 与 recovery 身份。B5-R1: 前端按 scope 世代与动作序号丢弃迟到响应,不污染新 scope 或父级旧回调。harness 的 recovery 改由生产 jobs.Worker.RunOnce 消费并读回 jobs 终态;原失败窗口作业保持 failed,不改写历史。
2026-11-03 13:02:42 +08:00
姚章浩 f9457fab52 fix(library): 打通恢复验证的正常恢复与页面联动
build / build (push) Successful in 1m35s
B1/B2:演练在同一维护切点做两次真实捕获(写前镜像与来源身份),
写集合在写第一笔之前落盘并登记;恢复走限定范围的 RestoreDrill,
复用同一份 DS01 身份合同与 Apply 原语整段回放,不再让同快照必被拒绝。
worker 接治理维护生命周期(实例+scope 行、真实入口状态、成功才释放),
held 保留行并由同 job 的 library.recover 收口(kind 过滤贯通 verify)。
B3:证据优先,failed/invalid 与读取错误即使 env=true 也拒绝。
B4/B5:GET 投影在飞作业,子面板回调父页面轮询;观测绑定 scope 与代次,
刷新失败明确过期,不再显示旧的"已验证"。
迁移 79 不自动 down;未部署、未调用业务目标。
2026-11-03 11:14:27 +08:00
姚章浩 5e1482e349 feat(library): 恢复验证成为可页面发起的真实作业
build / build (push) Successful in 1m40s
根因:生产可恢复性只有 PRODUCTION_BACKUP_RESTORE_VERIFIED 这个手填 env 开关,
页面没有任何入口去真跑一次恢复;CLI(librarydrill)又不是 worker 能复用的实现,
所以"已验证"既证明不了跑过、也证明不了跑的是当前目标。

改动:
- 共享实现 internal/libraryverify(维护隔离→捕获→基线校验→canary→恢复→复核→关窗口),
  cmd/librarydrill 改为薄封装,CLI 与 worker 只允许一份执行体。
- verify 成为独立业务作业:kind + VerifyStages(capture/verify/canary/restore/finalize),
  与 sync/restore/baseline 共用同一把写互斥;迁移 79 加 kind 约束、重建部分唯一索引、
  新建 library_restore_verifications(按 target_id 绑定,换库/索引/桶旧证据自动失效,
  同 target+scope+job 幂等)。
- worker:admitLibraryJob + runOwnedLibraryAttempt 之后调用共享实现,阶段实时写
  library_job_stages,结束后写真实终态;通过写 passed 证据,失败写 failed+原因(不伪成功);
  中断接管按同一作业 id 收掉维护窗口。
- API:POST/GET /api/v1/library/verifications(管理员;闸口关闭/维护中拒绝;返回完整
  整库目标、最近证据、失败原因),OpenAPI 同步。
- 闸口:同步/恢复/续作的证据判断改为读当前目标证据;历史 env 仅在证据缺失时兜底,
  证据存在时以证据为准。
- 页面:生产保护与恢复面板加「恢复验证」块(完整 KB/索引/桶、状态、最近证据、失败原因、
  管理员按钮、5s 轮询),作业类型补 verify 文案。

测试:make verify 16/16 全绿(go 1387 例 + web 454 例 + 契约/迁移/密钥/依赖锁定);
新增用例覆盖证据四条件、闸口证据优先、页面无证据/失败/通过三种呈现与管理员可见性。
2026-11-03 10:14:08 +08:00
姚章浩 4421dd38ce fix(worker): 封存来源校验失败写入失败终态
build / build (push) Successful in 1m35s
verifyCapturedSource 失败时原实现只 return err:队列作业已是 failed,业务行
library_jobs 却停在 running/export、error 为空,页面永远显示"导出中"(实测
libseal-lib-internal-20261102T234053)。同函数其余四条失败分支都同时写 stage 与
job,这一条漏了。

现在 ensureCapturedSource 在校验失败时按既有惯例写 stage failed + job failed,
原错原样进取值、stage detail 与 job.error,恢复文案指向"修配置后重新封存"(快照
字节完好,不需要重采)。成功路径不变。

验证:
- RED:新增用例在修复前失败于 "stage writes = [], want exactly one failed stage"
- GREEN:TestCapturedSourceMismatchPersistsFailedStageAndJob /
  TestCapturedSourceMatchStaysSuccessful 通过
- make verify:16 项必需检查全绿(tests-go 含新用例)
2026-11-03 07:59:40 +08:00
姚章浩 22fb33aa75 test(library): 两次recover的202响应留在raw里
build / build (push) Successful in 1m30s
第一/第二次 recover 的 HTTP 202 与队列 id 原先只在用例断言里,raw 只留了失败结果。
补两份 accepted 回应,报告可直接引用接口受理证据而不是转述断言。
2026-11-02 23:00:25 +08:00
姚章浩 0d180aa401 test(library): 台账行按列原文留档
build / build (push) Successful in 1m32s
`to_jsonb` 行里有数字/布尔/NULL 列,直接解到 map[string]string 在真实数据上
报 "cannot unmarshal number into Go value of type string"。改为解到
json.RawMessage 再按列名存原文,比较的仍是每一列的精确值。

第二轮失败运行已按登记精确清理并读回。
2026-11-02 22:56:10 +08:00
姚章浩 0a87dc8e03 test(library): 修正D06台账读回的SQL别名
build / build (push) Has been cancelled
`SELECT to_jsonb(x)` 缺表别名,真实跑出 SQLSTATE 42703,基线抓取在启动第一个
新 PID 之前就中止。补 AS x,其余不变。
2026-11-02 22:55:06 +08:00
姚章浩 96472c1dde test(library): D06场景同样激活恢复派发协议
build / build (push) Has been cancelled
首轮 D06 跑出 worker 日志"restore marker dispatch protocol is not activated",
现场缺 05b-activation:激活条件只写了 ds01/ds01-n1,漏了新分支。补进 ds01Second,
否则场景停在激活前,acquire 永远到不了 durable dispatching。

首次失败运行按登记精确清理并读回(cleaned_readback)。
2026-11-02 22:54:14 +08:00
姚章浩 bad9034cf7 test(library): 增加D06第二次真实重启held场景
build / build (push) Successful in 1m30s
N1 只证到"旧执行者被杀→一个新 PID 接管仍 held",没有证明第二个新 PID 再接管
仍然 held。D06 要求同一 window/plan/effect 上连续两次真实换进程:第一次接管后
真实终止那个新执行者、等真实租约过期、起第二个新 PID,再走同一 recover API。

新增 ds01-n1-second 场景复用 N1 的 dispatching+missing 边界,用同一份冻结基线
(目标 PG 逐行、ES 命中代次、对象版本与逐字节摘要、effect 文件键值、marker 转发、
派发台账整行、journal 状态)对两次接管分别做前后对拍;进程证据补 argv/scenario/
可执行摘要,drill 构建标签一并落盘,避免把 4s 缩短租约当成生产默认。

仅测试夹具与证据,不改生产实现,不新增版本。
2026-11-02 22:51:25 +08:00
姚章浩 f330a75641 test(library): 使用点复核同SHA错display
build / build (push) Successful in 1m27s
激活点已覆盖同 SHA 错 display;使用点原先只构造了 unknown 与跨 SHA 篡改。
补一条同 SHA、错 display 的台账篡改,证明使用点同样核运行 display,不只是比 SHA。
仅测试夹具,不改生产实现。
2026-11-02 21:24:27 +08:00
姚章浩 19ec03c417 docs: 说明跨SHA兼容默认关闭
build / build (push) Successful in 1m37s
原快照描述"同一兼容批次内的不同完整 SHA 记为 compatible_upgrade",与本轮收口后
的行为相反。改为:epoch 只约束派发语义,构建身份精确绑定运行 SHA,无可核受信
批次成员证明的跨 SHA 兼容默认关闭。未改版本号,未新增发布记录。
2026-11-02 21:18:17 +08:00
姚章浩 6209072e43 fix(library): 跨SHA兼容需受信证明默认拒绝
原实现把 ProtocolEpoch 相等当作构建兼容证明:任何 40 位小写 hex SHA 加一个非空
display 都会被记成 compatible_upgrade 并允许激活,换一个 SHA 即可绕开同 SHA 的
display 绑定,构建身份仍是声明式。

收口为精确绑定运行完整 SHA:同 SHA 必须 display 相符,不同 SHA 一律失败关闭,
错误明确写"cross-sha compatible activation is disabled without a verifiable
protocol build membership proof"。不新建签名基础设施,也不引入第二份 allowlist;
使用点与激活点调用同一函数,行为一致。台账不重写、旧激活行保留(不匹配即 held)。
2026-11-02 21:16:45 +08:00
姚章浩 e61f05c98c test(library): 跨SHA兼容升级保留为拒绝RED
同协议批次下换一个合法 40 位 SHA 不能被 epoch 相等证明;激活与使用点都必须
拒绝。当前实现仍会接受(compatible_upgrade=true),此提交先把期望钉在拒绝上,
作为修复前的 RED 证据;同 SHA 正例与同 SHA 错 display 拒绝一并保留。
2026-11-02 21:14:21 +08:00
姚章浩 a9d5adf78f fix(library): 使用点核对恢复目标指纹而非维护窗口指纹
build / build (push) Successful in 1m40s
2026-11-02 20:58:18 +08:00
姚章浩 e8f8069473 test(library): 使用点区分维护窗口与恢复目标指纹 2026-11-02 20:56:55 +08:00
姚章浩 b7d6661a4e docs: 记录 D16 N2 真实 legacy 意图与缺失目标证据
build / build (push) Successful in 1m41s
2026-11-02 20:47:35 +08:00
姚章浩 97da6ceba8 test(library): N2 缺失边界只允许 legit 意图且零 marker
旧协议的标记 create 在传输层被拒,现场应只有 apply/restore 意图,没有
claimed/finalize/restored;索引 doc 必须缺失,转发计数为零。
2026-11-02 20:42:41 +08:00