五条反馈全部落进设计与代码,CI 绿
预检从三态变四态,语义改了:blocked 只表示「物理上做不到」,不表示「我不让你做」。
| 态 | 含义 | 用户怎么办 |
|---|---|---|
| ok | 已满足 | — |
| autofixable | 我们代做(可逆、不动数据、不重启) | 点一次确认 |
| warn | 有风险,但照跑 | --accept-risk 或交互确认 |
| blocked | 读不到变更流 / 没权限 / 连的是副本 —— 现在物理上做不到 | 给可执行动作;做完即通 |
`_ds_` 是早期按 "dbsync" 起的前缀,项目定名津梁后就不合适了。全量改成 _jl_(jinliang),文档/示例/代码一致。
| 旧 | 新 | 用途 |
|---|---|---|
_ds_meta | _jl_meta | 阶段、权威位点、schema 指纹、水位 |
_ds_lease | _jl_lease | 租约(防双写) |
_ds_chunk / _ds_conflict / _ds_dead_letter / _ds_event / _ds_action | _jl_* | 断点 / 冲突 / 死信 / 事件 / 审计 |
slot ds_job_1 | jl_job_1 | 我们建的同步书签 |
旧设计写「视图只支持快照」是错的,已改。
| 能力 | 视图 | 说明 |
|---|---|---|
| 一次性快照 | ✓ | 就是一条 SELECT |
| 定时增量(interval) | ✓ | 你指定一个水位列(如视图里的 updated_at)+ 重叠回看,不需要变更流 |
| 实时增量(CDC) | ✗ | 视图没有自己的变更流水 —— 物理事实,不是我们的限制 |
| 简单投影视图 | ✓ | 跟随基表 CDC + 列映射(二期) |
所以选 continuous 时会提示「视图没有变更流,建议改定时增量」,而不是拦下来。
dead_letter 术语给你。顺带把「位点 / 书签 / 快照 / 命名空间」都加进了术语表,提示里出现必须同时给白话解释。
按你说的 —— 用户不会读文档,还不如让 AI 助手看代码和日志。
DocURL 只给开发者。--json 输出升级为一等接口:字段稳定、结构化、便于 CI 与 AI 助手直接读。docs/ 只服务贡献者与未来的维护者。设计仍完整(15 份文档),四个包/文件带真测试进 CI:typemap(15 用例,含未覆盖类型 text 兜底)、phase(17 断言)、以及新加的 warn 状态贯穿契约。
可以开 M1只做 PG→PG 闭环CI 双绿 · 47a581c