接口参考

known_issues.md · 已知限制 · 4/5

按同一接口文件归组浏览,展开条目查看声明、使用说明和版本边界。

阅读相关开发指南 →

这里保留接口声明及来源。逐项运行验证范围以条目记录为准;源文件中的内部实现候选不代表免费 SDK 的交付承诺。

docs/known_issues.md
T-DEBT-PERF-EVIDENCE-PATH-HEADROOM
已知问题3.61.7C++

实验证据路径在默认输出目录下只剩 19 字符余量

验证范围

docs/known_issues.md:240

反馈此接口问题 →
T-DEBT-POSIX-LSP-EXEC-MISSING-DETECTION
已知问题3.61.7C++

POSIX LSP 可执行文件缺失检测

验证范围

docs/known_issues.md:382

反馈此接口问题 →
T-DEBT-PRE-BLOCK-ANONYMOUS-IFC
已知问题3.61.7C++

统一 <pre>/pre-wrap/break-spaces 中 block sibling 的匿名 IFC 与保留换行

验证范围

docs/known_issues.md:146

反馈此接口问题 →
T-DEBT-PRE-WRAP-JUSTIFY-PRESERVED-SPACES
已知问题3.61.7C++

pre-wrap + justify 连续保留空格的 justification opportunity、块高与源码映射一致

验证范围

docs/known_issues.md:147

反馈此接口问题 →
T-DEBT-RAW-FONT-PATH-FAMILY-TABLE
已知问题3.61.7C++

raw SkFont 测量路径仍是第三张字体族表,回退字形与段落路径不一致

验证范围

docs/known_issues.md:264

反馈此接口问题 →
T-DEBT-REAL-APP-CORPUS-COVERAGE-GAPS
已知问题3.61.7C++

真实应用语料的三处覆盖缺口:Lua 生成的内容没对照 Chrome、性能测量页面顶部带加载器导航栏、forge-ims 没进

验证范围

docs/known_issues.md:360

反馈此接口问题 →
T-DEBT-RELAB-FIRST-PLAY-MAX-FRAME-NOISE
已知问题3.61.7C++

对上一版交替对照把动画首播最大帧当阻断指标,阈值比同构建噪声窄,会误报阻断

验证范围

docs/known_issues.md:361

反馈此接口问题 →
T-DEBT-REPLACED-BLOCK-INTRINSIC-KEYWORD-CONSTRAINT
已知问题3.61.7C++

替换图片的块轴 min/max 固有关键字约束未按确定宽度转移自然比例

验证范围

docs/known_issues.md:111

反馈此接口问题 →
T-DEBT-REPLACED-INTRINSIC-SIZING-PARITY
已知问题3.61.7C++

替换元素尺寸主路径已修复,残留收窄为未加载 img 路径统一及 NativeGui iframe 默认边框约定

验证范围

docs/known_issues.md:110

反馈此接口问题 →
T-DEBT-RTL-ELLIPSIS-VISUAL-END
已知问题3.61.7C++

direction:rtl 段落里 LTR 内容溢出时,text-overflow 截掉的是逻辑末尾而不是视觉上溢出行尾边的那一截

验证范围

docs/known_issues.md:190

反馈此接口问题 →
T-DEBT-RTL-HANGING-WHITESPACE-AT-VISUAL-END
已知问题3.61.7C++

RTL pre-wrap 段落里同时包着文字与行尾保留空格的行内元素,少一个画在视觉行尾的片段

验证范围

docs/known_issues.md:339

反馈此接口问题 →
T-DEBT-RTL-NATIVE-ELLIPSIS-INLINE-DECORATION-EXTENT
已知问题3.61.7C++

RTL 段落旧式 line-clamp 原生省略号落在带背景/边框的行内元素截断点时,该元素的装饰区域不排除省略号

验证范围

docs/known_issues.md:209

反馈此接口问题 →
T-DEBT-RTL-PLACEHOLDER-REORDER-INDEX-QUERIES
已知问题3.61.7C++

双向重排过的行里,按 UTF-16 下标查占位符矩形(选区高亮、光标命中)拿到的是别的原子盒 / 边距的槽位

验证范围

docs/known_issues.md:333

反馈此接口问题 →
T-DEBT-RTL-STATIC-POSITION-ALIGNMENT
已知问题3.61.7C++

RTL/logical direction 下 absolute static-position、self-alignment 与 Flex/Grid 对齐能力

验证范围

docs/known_issues.md:116

反馈此接口问题 →
T-DEBT-SCOPE-FLAGS-ARE-DECLARATIVE-ONLY
已知问题3.61.7C++

KUI_DISABLE_MULTICOL / KUI_DISABLE_SHAPES / KUI_DISABLE_SUBGRID 三个宏没有任何代码读,config.h 却声称「NOT COMPILED IN and its code paths are gated out」

验证范围

docs/known_issues.md:286

反馈此接口问题 →
T-DEBT-SCOPE-FRAGMENTATION-FLEX-GRID-TABLE
已知问题3.61.7C++

Flex / Grid / Table 的分页 fragmentation 未实现

验证范围

docs/known_issues.md:126

反馈此接口问题 →
T-DEBT-SCOPE-REOPEN-MULTICOL-SHAPES-SUBGRID
已知问题3.61.7C++

multicol / CSS Shapes / subgrid 三项编译期禁用能力由「范围外」改为「未实现待排期」

验证范围

docs/known_issues.md:125

反馈此接口问题 →
T-DEBT-SCROLL-ANCHORING-SPEC-GAPS
已知问题3.61.7C++

滚动锚定与 CSS Scroll Anchoring / Chrome 仍有的差距

验证范围

docs/known_issues.md:124

反馈此接口问题 →
T-DEBT-SCROLL-CONTAINER-FIRST-BASELINE-GATED
已知问题3.61.7C++

scroll container 的首基线被 overflow 门挡掉,flex / grid 基线对齐取错行

验证范围

docs/known_issues.md:119

反馈此接口问题 →
T-DEBT-SCROLL-OFFSET-DEVICE-PIXEL-SNAP
已知问题3.61.7C++

滚动偏移不按设备像素吸附:scrollTop / scrollLeft 可以是任意小数,小数布局里滚到底时 scrollTop + clientHeight 比 scrollHeight 小不到 1px

验证范围

docs/known_issues.md:277

反馈此接口问题 →
T-DEBT-SDK-C-PACKAGE-PLATFORM-PARITY
已知问题3.61.7C++

补齐 C SDK 跨平台打包一致性

验证范围

docs/known_issues.md:377

反馈此接口问题 →
T-DEBT-SDK-EXAMPLES-GATE-USES-INTREE-FLAG
已知问题3.61.7C++

SDK 示例门禁解除对旧仓内 3D 开关的耦合

验证范围

docs/known_issues.md:378

反馈此接口问题 →
T-DEBT-SDK-EXT-DLL-NO-VERSION-RESOURCE
已知问题3.61.7C++

扩展与媒体后端 DLL 仍无 VS_VERSION_INFO 与 build id

验证范围

docs/known_issues.md:287

反馈此接口问题 →
T-DEBT-SEGMENT-IFC-NO-PER-LINE-FLOAT-EXCLUSION
已知问题3.61.7C++

块叠放循环把浮动两侧的行内内容拆开排,前面的文字与后面的行内元素不在同一行

验证范围

docs/known_issues.md:120

反馈此接口问题 →
T-DEBT-SEGMENT-INLINE-ROOT-LINE-RELATIVE-ATOMIC
已知问题3.61.7C++

逐段排版里 span 内 top / bottom 对齐的原子盒贴的是 span 自己段落的行,不是外层行

验证范围

docs/known_issues.md:329

反馈此接口问题 →
T-DEBT-SELECT-ENHANCE
已知问题3.61.7C++

选择性布局剩余增强

验证范围

docs/known_issues.md:219

反馈此接口问题 →
T-DEBT-SELECTION-LINE-END-HIGHLIGHT-PARITY
已知问题3.61.7C++

跨行选区中间行行尾 / 块尾的「换行高亮」与 Chrome 差约一个空格宽

验证范围

docs/known_issues.md:368

反馈此接口问题 →
T-DEBT-SELECTIVE-INLINE-TABLE-OOF-ONLY-CHILD-LINE-HEIGHT
已知问题3.61.7C++

display:inline-table 唯一的 display:table-cell 子盒改成 position:absolute 后,增量路径把所在行撑高 8px

验证范围

docs/known_issues.md:347

反馈此接口问题 →
T-DEBT-SELF-OVERFLOW-MODIFIER-ITEMS-PARITY
已知问题3.61.7C++

items 的 unsafe 修饰符与 auto self 传递尚未保留,非abspos物理修饰组合继续旧用值

验证范围

docs/known_issues.md:128

反馈此接口问题 →
T-DEBT-SKIA-CPU-OPTS-NON-WINDOWS-UNVERIFIED
已知问题3.61.7C++

Linux / macOS 上还没有启用 Skia 的运行时 CPU 分派(SkGraphics::Init()),需在当地验证像素后再开

验证范围

docs/known_issues.md:393

反馈此接口问题 →
T-DEBT-SKPARAGRAPH-CROSS-BLOCK-SHAPING-CONTEXT
已知问题3.61.7C++

SkParagraph 按字体块整形不带块外上下文,跨字体 / 跨格式的连接文字靠展示形兼容层兜底,覆盖不全

验证范围

docs/known_issues.md:266

反馈此接口问题 →
T-DEBT-SKPARAGRAPH-ELLIPSIS-GHOST-SPACE-OFFSET
已知问题3.61.7C++

line-clamp 原生省略号的行尾悬挂空白偏移(剩余边界已收窄)

验证范围

docs/known_issues.md:200

反馈此接口问题 →
T-DEBT-SKPARAGRAPH-LINE-ROUNDING-EATS-ATOMIC-ASCENT
已知问题3.61.7C++

SkParagraph 把行高取整的零头记在上伸侧,比文字高的原子盒顶最多伸出行顶 0.5px

验证范围

docs/known_issues.md:328

反馈此接口问题 →
T-DEBT-SOFT-WRAP-LEFT-ALIGN-CEIL-PARITY
已知问题3.61.7C++

物理左对齐段落的软换行宽度上取整到整像素,小数宽度上比 Chrome 多放一个词

验证范围

docs/known_issues.md:161

反馈此接口问题 →
T-DEBT-STYLE-MEMCMP-PADDING
已知问题3.61.7C++

ComputedStyle::operator== 的 memcmp 快路径会被对齐填充里的残留骗到

验证范围

docs/known_issues.md:270

反馈此接口问题 →
T-DEBT-SUPPORTS-NESTED-GENERAL-ENCLOSED
已知问题3.61.7C++

@supports 括号内既不是声明也不是合法条件的嵌套形状按 invalid 处理,规范要求 general-enclosed(求值为假)

验证范围

docs/known_issues.md:281

反馈此接口问题 →
T-DEBT-TABLE-CELL-BASELINE-SKIPS-BLOCK-DESCENDANTS
已知问题3.61.7C++

表格单元格的首基线不下探块级子盒里的行盒

验证范围

docs/known_issues.md:86

反馈此接口问题 →
T-DEBT-TABLE-CELL-INTRINSIC-KNOWN-BOX-SNAPSHOTS
已知问题3.61.7C++

C2 候选护栏的 45 个已知差盒暂用独立 KUI 精确快照

验证范围

docs/known_issues.md:94

反馈此接口问题 →
T-DEBT-TABLE-CELL-INTRINSIC-LEGACY-FALLBACK
已知问题3.61.7C++

C2 候选内容统一测量仍保留非原子 inline / 嵌套 CSS 直属 cell 的试排边界

验证范围

docs/known_issues.md:93

反馈此接口问题 →
T-DEBT-TABLE-FLOAT-FORCED-BREAKS
已知问题3.61.7C++

浮动旁逐段排版的 span 丢失 br,多行内容只剩一行(不限于表格)

验证范围

docs/known_issues.md:96

反馈此接口问题 →
T-DEBT-TABLE-NATURAL-MINIMUM-LOST-IN-ROW-FLEX-CONTRIBUTION
已知问题3.61.7C++

行向 flex 父容器固有贡献丢失表格自然最小宽

验证范围

docs/known_issues.md:64

反馈此接口问题 →
T-DEBT-TABLE-WRAPPER-INTRINSIC-WHOLE-PIXEL-CEIL
已知问题3.61.7C++

inline-block 包表格的收缩适应外框仍整像素上取整

验证范围

docs/known_issues.md:95

反馈此接口问题 →
T-DEBT-TEST-DEVTOOLS-SERVER-PORT-NO-RETRY
已知问题3.61.7C++

test_devtools_server 的端口取法撞上被占用的端口就失败,不重试

验证范围

docs/known_issues.md:396

反馈此接口问题 →
T-DEBT-TEST-VSYNC-IMAGE-LOAD-GATE-WARMUP-FLAKY
已知问题3.61.7C++

VsyncFrameGateWindow.ImageLoadStartedWhileGatedShowsPromptly 在并行全量里偶发预热断言失败

验证范围

docs/known_issues.md:399

反馈此接口问题 →
T-DEBT-TEST-VSYNC-LOTTIE-OVERSHOOT-P90-FLAKY
已知问题3.61.7C++

VsyncFrameGateWindow.LottieOnlyPostsAroundFrameChanges 在并行全量里偶发 p90 超出容差

验证范围

docs/known_issues.md:398

反馈此接口问题 →
T-DEBT-TEST-WALLCLOCK-ANIMATION-SAMPLING-NOT-DETERMINISTIC
已知问题3.61.7C++

动画 / 性能类测试按墙钟采样,未优化的 Debug 构建下帧数与耗时前提不成立

验证范围

docs/known_issues.md:395

反馈此接口问题 →
T-DEBT-TEST-WINFORMS-ROUNDED-SHADOW-LAYER-REUSE-FLAKY
已知问题3.61.7C++

Win32WindowFeedback.RoundedShadowLayerCompositeUpdatesAllCorners 偶发 layerRootReuses == 0

验证范围

docs/known_issues.md:397

反馈此接口问题 →
T-DEBT-TEXT-ALIGN-LAST-LINE
已知问题3.61.7C++

text-align-last 的末行识别、logical 对齐与 justify

验证范围

docs/known_issues.md:149

反馈此接口问题 →
T-DEBT-TEXT-DECORATION-SKIP-SPACES-PROPERTY
已知问题3.61.7C++

text-decoration-skip-spaces 属性未实现,跳过的空白集合与规范不同

验证范围

docs/known_issues.md:364

反馈此接口问题 →
T-DEBT-TEXT-INDENT-GLUE-RESIDUAL-SHAPES
已知问题3.61.7C++

text-indent 胶水 carrier 没有覆盖的形状:首词放不下时仍在缩进之后断开等

验证范围

docs/known_issues.md:179

反馈此接口问题 →
T-DEBT-TEXT-MARKER-PARAGRAPH-PHASE
已知问题3.61.7C++

文字列表标记(decimal 等序号、::marker 内容)仍按段落绘制相位定位,首行基线不在 strut 上时偏离 Chrome

验证范围

docs/known_issues.md:216

反馈此接口问题 →
T-DEBT-TEXT-UNDERLINE-POSITION-UNDER
已知问题3.61.7C++

text-underline-position 只认 auto / from-font,under、left、right 被忽略

验证范围

docs/known_issues.md:330

反馈此接口问题 →
T-DEBT-TRANSFORM-TRANSITION-MIXED-UNIT-TRANSLATE-DISCRETE
已知问题3.61.7C++

transform 过渡里 translate 某分量一端是非 0 的 px、另一端是非 0 的百分比时按离散值在一半处换

验证范围

docs/known_issues.md:363

反馈此接口问题 →
T-DEBT-UA-BLOCKIFIED-BUTTON-INTRINSIC
已知问题3.61.7C++

建立 BrowserCompat blockified/semi-replaced button 的 intrinsic sizing 矩阵

验证范围

docs/known_issues.md:137

反馈此接口问题 →
T-DEBT-UA-FORM-CONTROL-BASELINE-MATRIX
已知问题3.61.7C++

建立 BrowserCompat 全控件 intrinsic height/baseline/line-box 矩阵

验证范围

docs/known_issues.md:138

反馈此接口问题 →
T-DEBT-UA-NATIVE-MATRIX-LINUX-MACOS
已知问题3.61.7C++

建立 Linux/macOS BrowserCompat 原生控件几何矩阵

验证范围

docs/known_issues.md:285

反馈此接口问题 →
T-DEBT-VERTICAL-ALIGN-WRAPPED-EDGE-TEXT-SPAN
已知问题3.61.7C++

自己跨行的 vertical-align:top/bottom 文字 span 的位置与行盒高度和 Chrome 不同

验证范围

docs/known_issues.md:334

反馈此接口问题 →
T-DEBT-VISUAL-TEST-OUTPUT-TRACKED
已知问题3.61.7C++

全量普通测试会改写受版本管理的 tests/visual/output/typography_actual.png / typography_diff.png

验证范围

docs/known_issues.md:391

反馈此接口问题 →
T-DEBT-WHITESPACE-PRESERVED-TRAILING-GEOMETRY
已知问题3.61.7C++

pre-wrap/break-spaces 的尾随空格 advance、换行所有权与行盒/绘制一致性

验证范围

docs/known_issues.md:178

反馈此接口问题 →
T-DEBT-WINDOW-GPU-TEARDOWN-LINUX-MACOS
已知问题3.61.7C++

Linux / macOS 的 Window 销毁时同样不交还 GPU 资源(GLX 上下文 / Metal 设备与 GrDirectContext 留到线程退出)

验证范围

docs/known_issues.md:291

反馈此接口问题 →
T-DEBT-WINDOWS-LCD-PARAGRAPH-ELIGIBILITY-STABILITY
已知问题3.61.7C++

稳定 Windows LCD paragraph eligibility 与捕获 phase

验证范围

docs/known_issues.md:261

反馈此接口问题 →
T-DEBT-WINDOWS-NORMAL-LINE-COMPONENTS-NOT-ROUNDED-LIKE-CHROME
已知问题3.61.7C++

Windows 下 normal 行的 strut 上 / 下伸与原子盒内文字基线保留小数,靠整行补整凑 Chrome 的整数行高

验证范围

docs/known_issues.md:177

反馈此接口问题 →
T-DEBT-WORD-GUARD-NON-UAX14-SEGMENTS
已知问题3.61.7C++

整词保护按空白 / ASCII 标点分词:片段里另有断行机会(表意文字、连字符、斜杠、泰文)时被整体保护或被切开

验证范围

docs/known_issues.md:159

反馈此接口问题 →
T-DEBT-WPT-BLOCK-IN-INLINE-GENERATED-QUOTE-OFFSET
已知问题3.61.7C++

收敛 block-in-inline 前导 fragment 的生成内容 inline 起点

验证范围

docs/known_issues.md:145

反馈此接口问题 →
T-DEBT-WPT-LINE-CLAMP-036-CHROME-DISAGREES
已知问题3.61.7C++

text-overflow:ellipsis + 旧语法 line-clamp 的最后一行,第一个词就放不下时:KUI 保留 WPT webkit_line_clamp_036 / F-WPT-FIX-924 的口径(回退到软换行机会、整词被挤出、只剩 …),同机 Chrome 153 按字素截断(supercali…)

验证范围

docs/known_issues.md:205

反馈此接口问题 →
T-DEBT-WPT-MIXED-FONT-NORMAL-LINEBOX-UNION
已知问题3.61.7C++

统一 mixed fallback custom font 与拆分 inline 的 line-height:normal union 取整

验证范围

docs/known_issues.md:144

反馈此接口问题 →
T-DEBT-WPT-SIZE-ADJUST-FALLBACK-FRACTIONAL-PHASE
已知问题3.61.7C++

治理 font-size-adjust + unicode-range + system fallback 的 fractional phase/baseline

验证范围

docs/known_issues.md:260

反馈此接口问题 →
T-DOC-KNOWN-CHROME-DIFFS-REGISTRY
已知问题3.61.7C++

未达登记门槛的已知与 Chrome 差异清单(34 条旧 T-BUG 已搬出本表)

验证范围

docs/known_issues.md:392

反馈此接口问题 →
T-PERF-BREAK-SPACES-FORCED-BOUNDARY-RELAYOUT
已知问题3.61.7C++

break-spaces 的宽度相关断行修正每强制一个断点就把整段重排一次,同一路径里还有 U+2028 修正片段的逐码点同行查找

验证范围

docs/known_issues.md:354

反馈此接口问题 →
T-PERF-CPU-MIX-BLEND-FALLBACK-SUBTREES
已知问题3.61.7C++

CPU 混合图层的回退集合(DstIn / mask / 滤镜 / 阴影 / 非平移文字 / 波浪线 / 未知操作)与 GPU / PDF 仍是整幅大图层

验证范围

docs/known_issues.md:232

反馈此接口问题 →
T-PERF-DL-PER-BOX-SAVE-RESTORE-OPS
已知问题3.61.7C++

绘制列表里每个盒都带一组 save / translate / restore,即使这个盒什么也不画

验证范围

docs/known_issues.md:356

反馈此接口问题 →
T-PERF-EVAL-APP-SHELL-EXPERIMENTS
已知问题3.61.7C++

性能实验矩阵缺少真实应用形状与「与规模无关」的预算

验证范围

docs/known_issues.md:239

反馈此接口问题 →
T-PERF-EVAL-CONSUMER-INTERACTION-TRACES
已知问题3.61.7C++

实践工程只参与 SDK 发版验证、不采集交互性能

验证范围

docs/known_issues.md:242

反馈此接口问题 →
T-PERF-EVAL-GENERATIVE-STRUCTURES
已知问题3.61.7C++

用组合结构自动寻找「单脏盒 → 工作量随规模增长」

验证范围

docs/known_issues.md:241

反馈此接口问题 →
T-PERF-FIRST-OPEN-COMPOSITE-SPIKE
已知问题3.61.7C++

首次打开小浮层 / 表单时合成多出 6~9 ms

验证范围

docs/known_issues.md:229

反馈此接口问题 →
T-PERF-FIXED-ROOT-NOT-DAMAGE-CULLED
已知问题3.61.7C++

固定定位元素不参与按脏区剔除;可见溢出的容器在脏区外仍录自己的背景 / 边框

验证范围

docs/known_issues.md:357

反馈此接口问题 →
T-PERF-GPU-PARTIAL-REPLAY-FIRST-FRAME-OVERHEAD
已知问题3.61.7C++

GPU 上大量透明度层的局部重放首帧仍比整帧重画多约 5 ms

验证范围

docs/known_issues.md:349

反馈此接口问题 →
T-PERF-IFC-FLOAT-GAP-DOUBLE-LAYOUT
已知问题3.61.7C++

浮动旁的整段排版段落先按全宽排一遍、判定稳定后再按缺口宽排一遍

验证范围

docs/known_issues.md:348

反馈此接口问题 →
T-PERF-LINE-CLAMP-SOFT-LINE-ELLIPSIS-WIDTH-CHANGE-PROBE
已知问题3.61.7C++

旧语法软换行 clamp 每帧换宽度时,额外行尾探测与绘制重建增加工作量

验证范围

docs/known_issues.md:223

反馈此接口问题 →
T-PERF-LUA-OFFSCREEN-CANVAS-RGBA-SURFACE
已知问题3.61.7C++

Lua OffscreenCanvas 的部分画法仍走慢速 RGBA 通用光栅管线

验证范围

docs/known_issues.md:233

反馈此接口问题 →
浏览同类接口 →