Skip to content

docs(adr): 书面接受主/备用屏 margin 的原生可见性差异 (#41) - #260

Merged
JavaZeroo merged 1 commit into
mainfrom
docs/r2-margin-known-difference
Oct 31, 2026
Merged

JavaZeroo merged 1 commit into
mainfrom
docs/r2-margin-known-difference

Conversation

@JavaZeroo

Copy link
Copy Markdown
Owner

问题与最终行为

#41「裁决 ConPTY 主/备用屏 margin 恢复差异」需要把已取得的 A/B 结论落成产品边界,否则 #27/#28 的终端模式验收会一直被原生层差异挡住。

最终行为(书面接受,不是修复):

  • 固定官方 ConPTY 在源控制台保留 2;3r / 4;5r,末端恢复 REGION_C / REGION_D / BOTTOM_FIXED;源控制台 CHAR_INFO 的 margin 仍与系统后端同为不匹配。
  • ADR-0007 新增「已知差异」小节:现象、边界(依赖原生 Console API 的应用可能与端末不同步)、重启条件([R2][终端] 确定保留原合同的原生 API 与末端 margin 处理路径 #56 重新评估上游修复或可维护 fork)。
  • R2-local-terminal.md 的终端模式门槛拆成 VT/transport/末端层(仍须符合原版合同)与 原生控制台层(记为已知差异)。

两者必须同一次提交:只写 ADR 或只改门槛表都会造成静默降低验收标准。

验证

  • 引用目标全部存在:docs/adr/0006、docs/adr/0008、docs/research/conpty-margin-backends.md
  • 门槛表仍为合法表格行,新增链接使用相对路径 ../adr/0007-bundled-microsoft-conpty.md#已知差异
  • 未改动任何证据文件、测试或源码;VT/transport/末端层要求原样保留
  • 依据文档在 main 上:docs/research/conpty-margin-backends.md 记录系统后端 REGION_CIXED、VT-off 反例、旧 passthrough flag 拒绝与固定官方后端的四阶段结果

性能影响(如适用)

不适用。纯文档改动,无构建与运行影响。

来源与限制

#41 的裁决落为文档边界,而不是继续等待原生层修复。

固定官方 ConPTY 在源控制台保留 2;3r / 4;5r,末端恢复
REGION_C / REGION_D / BOTTOM_FIXED;但源控制台 CHAR_INFO 的 margin
仍与系统后端同为不匹配。端末正确不能被读作原生 API 已修复。

改动成对出现:
- ADR-0007 新增「已知差异」小节,写明现象、边界与重启条件(#56)
- R2-local-terminal.md 的终端模式门槛拆成 VT/transport/末端层与原生控制台层,
  原生层差异指向该小节

只写 ADR 或只改门槛表都会造成静默降门槛,因此同一次提交完成。
不改变任何验收证据,也不放宽 VT/transport/末端层的要求。
@JavaZeroo
JavaZeroo merged commit de89f3e into main Oct 31, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant