docs: 记录已接受的游标与 clean 边界
build / build (push) Successful in 1m24s

写入用户明确接受的两项边界:发布前旧分页游标在发布后失效(刷新重新分页,不改
WeKnora、不声称后端可识别无代次游标);ES 已写成功但回执丢失且无法证明归属时
保持维护锁定并走人工核验/恢复,不承诺自动收敛,禁止凭相同正文或 seq_no 推断归属、
补写 receipt、跳过校验、强制开门或删除未知内容。可证明归属的自动补偿不回退。
This commit is contained in:
姚章浩
2026-11-01 17:21:42 +08:00
parent 99055a582e
commit 90ab1c3a5e
2 changed files with 9 additions and 0 deletions
+2
View File
@@ -1263,6 +1263,8 @@
### Fixed
- 发布作业详情在目标仍被维护时返回维护状态与人为处置说明(持有作业、入口状态、目标身份、下一步),不提供"强制成功"入口;缺归属证据的收尾保持维护锁定。
- 发布或恢复完成后,Wiki 与日志页面的分页游标视为失效:页面提示刷新后重新分页(本地编号会被重新编排),不把旧游标的错位当成数据损坏。
- 发布在预备份后、规划前与首笔写入前按治理库授权行重新判定:授权被撤销或过期即停,保留预备份且不写目标;不再只信内存里的有效期。
- 整库发布绑定序列归属及完整迁移目录,识别分块与 Wiki 的规范嵌套引用;未知结构或跨父引用在写入前拒绝,保留正常资料的发布与恢复路径。
- 发布使用执行时真实时钟,在预备份后与首个业务阶段前复核授权;预备份绑定对象精确版本,拒绝读取期间被替换的对象(包括同字节新版本)。
+7
View File
@@ -80,3 +80,10 @@ Wiki日志pages_affected仅支持消费者已有的字符串slug数组和{slug,t
- **晚阶段失败与对象**:Wiki 阶段失败回滚后,本次新建对象不残留,**已有对象的精确版本**(versionId + SHA256 + 字节数)不变。
- **clean 归属能力(实测)**:两个不同操作写入完全相同的字节后,索引侧只剩同一份 `_source`;`_seq_no`/`_version` 是分片提交计数,不绑定原 operation。因此"相同正文"或"seq_no+1"都不能证明是同一次 clean,缺服务端归属证据时继续 held(探针:`b19-capability-probe.json`)。
- **旧外部游标**:游标是裸数字 id(`next_cursor` → `id < cursor`),发布按源数值升序重排本地 id。目标自己发出的游标在同代内正确;发布前或来自其它实例的游标没有代次信息,无法自动翻译,会静默错位而非报错。详见交付 `a04-cursor-semantics-r12.md` 的 A/B 决策。
## 8. 已接受的可用性边界(r13,用户明确接受)
- **旧分页游标跨发布失效**:`next_cursor` 是裸数字 id(`id < cursor`),发布按源数值升序重排本地 id,请求里没有代次信息。发布前/跨实例游标无法翻译,回传会静默错位而非报错。已接受做法:发布或恢复后刷新页面、重新从第一页分页;不改 WeKnora 源码/Schema。同代内游标与引用重映射仍然正确。
- **clean-finalization 缺归属证据时保持 held**:真实 ES 探针显示两个不同操作写入相同字节后只剩同一份 `_source`,`_seq_no`/`_version` 是分片提交计数、不绑定 operation。此分支保持维护锁定并走人工核验/恢复,不承诺自动收敛;**不允许**凭相同正文或 seq_no+1 推断归属、补写 receipt、跳过校验、强制开门或删除未知内容。带原 marker/before-image/CAS/不可变 receipt 的 unknown 仍走既有自动补偿,不因本边界回退。
配套只读诊断:`GET /api/v1/library/jobs/{id}` 在作业失败且目标仍被本作业持有时返回 `maintenance`(held/owner/state/ingress/target_identity/note)与 `next_step` 文本,明确"按预备份与校验证据人工核验后再放行",且不提供任何强制成功入口;作业本身仍带 operation_id/attempt_epoch/backup/target 快照与错误、恢复说明。