Closed
[蓝军] 设置导航图标重复:适配宿主 settings.section.icon 插槽 #2
ppypgrmAdd on  8 days agoClosed at  3 days ago
ppypgrm
ppypgrm
8 days ago Create

提报方:蓝军(外部代码审查)。红军同学修复后请直接在评论区回复本 issue;正文由蓝军维护,如需勘误请评论指出。

环境

  • dsh-dream-skin 11.7.0,GitCode main d642ac0
  • DeepSeek Harness 0.2.2-rc.1,DSH Web / Windows

现象

打开设置后,“个性化皮肤”导航项同时显示调色板图标和宿主默认齿轮图标。用户复测后确认导航项已只显示一个图标。

原因

主题插件的旧方案通过 DOM 标记和 ::before 在导航按钮前绘制调色板,并尝试隐藏按钮的直接子级 SVG。当前宿主 SettingsRoot 将导航图标包在 span 中,旧选择器无法隐藏其中的齿轮,于是两个图标同时显示。

宿主现在提供 settings.section.icon 插槽,按 settings.section 的 ID 匹配;注册图标后宿主会使用该图标替代默认齿轮。插槽本身不是重复的直接原因,重复源于旧 DOM 注入方案与当前导航结构共存。

建议修复

  • 为 dream-skin 设置分区注册同 ID 的 settings.section.icon,在组件中返回随宿主指定尺寸缩放的调色板 SVG。
  • 成功注册后停用旧 DOM 图标钩子,避免与宿主插槽同时绘制;旧宿主没有插槽或注册失败时保留降级方案。
  • 验证插槽注册、失效后降级恢复、插件卸载清理,以及旧宿主的图标钩子生命周期。

本地测试覆盖了插槽注册、注册失败、插槽移除、卸载,以及旧钩子清理。截图展示了修复前的重复图标和用户复测时的单图标效果;正式插槽方案还应由上游在实际宿主中复核。

截图

修复前:

修复前

修复后:

修复后

likedislike
ppypgrmppypgrm
8 days ago Associated pull request
LLLAAAAA
LLLAAAAACollaborators
3 days ago Comments:

已修复,感谢报告。这一版已随 11.14.0 正式发布到 npm。

根因:宿主把设置导航图标下沉到 settings.section.icon 插槽后,插件仍在用旧 DOM 钩子注入自己的图标,于是调色板/齿轮出现两份。

改动:社区 PR #2 注册 settings.section.icon 宿主插槽(DreamSkinNavIcon,id dream-skin),在有 seat 的宿主上于 apply() 同步停用 legacy nav hook;对没有 seat 的旧宿主保留 > svg:first-child + :has(> svg) 的 legacy CSS 兜底,并配浏览器计算样式用例。

评审补充:PR #2 把 181 条 smoke 用例的夹具默认切成了「有图标插槽」,等于悄悄绕开旧路径;本轮把默认改回无 seat,另补一条带反向变异的集成用例(tests/nav-icon-slot.test.cjs)——删掉停用调用必须翻红,并让设置渲染夹具记录 inject() 的插槽名,防止插槽名拼错也不红。

升级:dsh plugin --profile web add dsh-dream-skin@11.14.0

likedislike
LLLAAAAALLLAAAAACollaborators
3 days ago Close issue
LLLAAAAALLLAAAAACollaborators
1 day ago Change title to "[蓝军] 设置导航图标重复:适配宿主 settings.section.icon 插槽", originally titled "设置导航图标重复:适配宿主 settings.section.icon 插槽".
LLLAAAAALLLAAAAACollaborators
1 day ago Modify description of issue
LLLAAAAA
LLLAAAAACollaborators
1 day ago Comments:

🔵 蓝军 · 复审确认

确认:默认夹具改回无 seat(不让 smoke 用例悄悄绕开旧路径)+ 反向变异(删掉停用调用必须翻红)+ 夹具记录 inject() 插槽名(防插槽名拼错也不红)——把「看起来修了、实际绕开了」的三种形态全部堵死。本条维持关闭。

likedislike