Files
knowledge-governance/docs/evidence/2026-10-30-real-sync-restore
姚章浩 cf3f4662cc
build / build (push) Successful in 1m25s
docs: 记录写集合与定位符陷阱并归档真作业证据
两条陷阱都是这次真作业里查出来的,且都被"只测内层/只喂裸 key"的用例盖住过:
包装层丢掉可选接口导致写集合静默跳过;对象存储四个入口吃不同定位符形状。

docs/evidence/2026-10-30-real-sync-restore 只放脱敏结果:作业/阶段/版本/维护窗口、
22 个资源与桶内字节、归档三处 sha256 对拍、以及"归档根下没有 writesets/"这个事实。
2026-10-30 01:34:41 +08:00
..

真实同步 / 恢复之后的持久证据(2026-10-29 UTC,本机测试栈)

这两次作业都是父在 8088 管理员页面点的,不是脚本模拟、也不是 helper 杀进程演练:

作业 类型 结果 目标
libsync-internal-1793292008635856030 sync succeeded / finalize 源测试封存 fc595511c738… → 目标 kgseal-1029a(tenant 10001,KB e64e82b5…)
librestore-internal-1793293164573204381 restore succeeded / finalize 恢复到预备份 4b720eb42fca…(恢复前先备份成 089676a09107…)

本目录只放脱敏结果:没有口令、没有令牌、没有连接串。涉及凭据的核验都在进程内完成 (对象字节比对用 tmp/verifyresource 探针,凭据只从环境变量读、不打印)。

文件

  • jobs.txt — 两条 library_jobs 原始行(state/stage/actor/幂等键/两个快照号/时间)。
  • stages.txt — 两条作业的 library_job_stages(每阶段 total/completed/bytes)。
  • versions.txt — library_versions 三类版本(test_sealed / production_effective / production_prebackup)+ evidence。
  • maintenance.txt — 实例级与库级维护窗口(谁持有、入口状态、原运行状态、释放时间)。
  • archive-integrity.txt — 归档清单的内容寻址自校验(文件字节 sha256 == 快照号), 以及"归档根下没有 writesets/ 台账"这个事实。
  • resources-verify.json — 目标库 22 个资源逐条:行内 size、桶里对象的 size/sha256、 绑定/授权计数,以及归档里资源分项的 blob sha256 三处对拍。
  • retrieval.txt — 文档/分块/Wiki 计数、ES live 索引的文档归属、资源与绑定统计。

复现命令(只读)

# 作业与阶段
docker exec knowledge-governance-p1-postgres-1 psql -U governance -d governance \
  -c "select id,state,stage,snapshot_id,target_snapshot_id from library_jobs order by created_at desc limit 5"

# 资源三处对拍(需要目标库 DSN、对象密钥、归档根;全部从环境变量读,不打印)
go build -o /tmp/verifyresource ./tmp/verifyresource
KG_TARGET_DSN=… KG_OBJECT_ENDPOINT=… KG_OBJECT_ACCESS_KEY=… KG_OBJECT_SECRET_KEY=… \
KG_OBJECT_BUCKET=kgseal-1029a KG_ARCHIVE_ROOT=/var/lib/knowledge-governance/library \
KG_SNAPSHOT_ID=4b720eb42fca… /tmp/verifyresource

# 检索侧只有恢复后的那 2 个分块
curl -s "http://127.0.0.1:19200/kgseal_1029_chunks/_search?size=5&_source=knowledge_id"

结论边界

  • 资源计数 22 是"1 份恢复后的资源 + 21 份本次同步上传的对象字节仍在桶里"。行层面 只有 1 条绑定、0 条授权;21 条资源行 state=active 但无绑定、无引用,分块/索引/Wiki 三层都查不到它们。
  • 恢复只回滚行、不删对象:对象字节保留是设计语义(删除不在授权范围内), "保留"不等于"可检索"。
  • 目标实例 models 表为空、tenant_api_keys 为空,/run/release-secrets/target_weknora_api_key 被目标 401 拒绝 —— 这是 external 范围拿不到"合法模型 + 合法服务令牌"的实证。