fix: DOM 通道多表面兼容——rc.6 异形宿主不再静默丢围栏 (issue #6) - #7
Merged
Conversation
…k surfaces (issue #6) Fence discovery relied on a single-surface contract: the selector only matched .md-code-block and the language label only matched a leaf <div>. DSH 0.1.0-rc.6 deployments with a deepsuite-style render stack paint fences as .code-block / .code-block-small with a <span> label and a wrapped body — the channel found nothing, so every dsh-ui fence stayed a plain code block with zero console output (exactly the report). Discovery is now multi-surface: - selector union .md-code-block, .code-block, .code-block-small with outermost-element dedup (modifier children never double-count); - structural backstop: any element whose banner labels it dsh-ui (leaf div/span outside the <pre> body — a code body literally containing 'dsh-ui' must not self-identify) and contains a <pre> is a fence surface, so unlisted host classes still render; - drift diagnostic: a one-time console.warn when the backstop matches an unknown surface class, so host DOM drift is never silent again; - known surfaces keep full streaming takeover (content-identified, label-verified at settle); unlisted surfaces render the moment the label materialises. Docs: README/README.zh-CN dual-channel section + CHANGELOG 0.8.3. Tests: +7 multi-surface regressions (code-block / code-block-small / structural backstop + one-shot drift warning / body-literal dsh-ui non-false-positive / nested modifier dedup / sibling surfaces / alien surface streaming takeover). 370 total, all green.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
解决的问题
Closes #6 —— dsh-ui 围栏在 DSH 0.1.0-rc.6 的部分部署上静默不渲染：保持为代码块、控制台零报错。
根因
DOM 渲染通道的围栏发现依赖单一表面契约：
.md-code-block.code-block/.code-block-smalldivspan<pre>直接在表面下→ 插件在异形宿主上完全找不到围栏：
renderBlock根本不会被调用，无任何日志（与报告「静默失败」完全一致）。修复（0.8.3）
多表面发现，三层递进：
.md-code-block, .code-block, .code-block-small（最外层去重——修饰类子元素不会双计）；dsh-ui（div/span 均可，且必须在<pre>正文之外——代码体里出现dsh-ui字面量不得误判）且含<pre>的元素都被识别为围栏表面——未来任何宿主类名漂移都照常渲染；console.warn（每次安装一条），「静默失败」从此有迹可查。已知类名表面保留完整流式能力（按内容流式接管 + 落定标签复核）；未知类名表面在标签出现（落定）后立即渲染，不丢内容。
验证
.code-block接管 /.code-block-small/ 结构兜底 + 一次性漂移告警 / 代码体含dsh-ui字面量不误判 / 嵌套修饰去重 / 同行兄弟围栏 / 异形表面流式接管与落定复核），370 测试全绿；.code-block+ span 标签 + 包裹正文的异形围栏 → 新 client.js 正确接管并渲染出组件内容；旧 bundle 同样注入则无任何反应。