Closed
[蓝军] 设置导航图标仍重复:宿主 0.2.2-rc.1 把图标下沉了一层,> svg:first-child 全面失效 #3
Max-NullAdd on  5 days agoClosed at  3 days ago
Max-Null
5 days ago Create

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

环境

  • dsh-dream-skin 11.7.0(npm 最新,即 lib/client.js 里 [data-dsh-dream-skin-nav] > svg:first-child{display:none} 这一版)
  • DeepSeek Harness 0.2.2-rc.1,Windows / Web 端
  • 对照版本:0.2.1-rc.4(同一插件当时显示正常)

现象

设置面板里「个性化皮肤」一行同时出现调色板和宿主默认齿轮两个图标。#2 描述过这个现象;这里补的是宿主侧的源码级根因、以及插槽方案的实测结果。

根因(宿主两版源码对比)

同一文件 packages/client/ui-settings-general/src/client/SettingsRoot.tsx:

0.2.1-rc.4 —— svg 就是按钮的直接子元素:

<button ...>
  {navIcon(row.id)}                       // <svg class="...navIcon" .../>
  <span className={css.navLabel}>{row.label}</span>
</button>

0.2.2-rc.1 —— 图标被 span 包住,并新增 settings.section.icon 插槽(fallback 仍是齿轮):

<button ...>
  <span className={css.navIcon} aria-hidden="true">
    {renderSlot('settings.section.icon', { size: 16, active: row.id === active },
      { only: row.id, fallback: navIcon(row.id) })}
  </span>
  <span className={css.navLabel}>{row.label}</span>
</button>

插件侧的钩子匹配的是 [MARKER] > svg:first-child(直接子元素),而当前 svg 已经在 span.navIcon 里,选择器完全不命中——齿轮不再被隐藏,::before 的调色板照旧绘制,于是两个图标并存。插槽本身不是重复的原因,重复来自「旧 DOM 钩子 + 新结构」共存。

推荐方案:注册 settings.section.icon(#2 已提,这里补验证)

ctx.slots.inject('settings.section.icon', () => ctx.slots.register({
  name: 'settings.section.icon',
  id: 'dream-skin',                 // 必须等于 settings.section 的 id
  order: 10,
  label: () => sectionNavLabel(),   // 与 section 同源
}, ({ size }) => <PaletteIcon size={size} />))

同时把旧钩子(SETTINGS_NAV_MARKER / NAV_ICON_CSS / MutationObserver)整段删掉——注册成功时宿主不会再渲染默认齿轮,旧钩子的 ::before 反倒会变成新的重复源。

已实测:在 0.2.2-rc.1 的隔离实例里,另外四个用同一套 ::before + mask 方案的插件(dsh-memory、dsh-skill-mcp-center、dsh-achievements、dsh-ssid-panels)改成插槽注册并删除旧钩子后,导航行 DOM 变为「一个 span.navIcon + 一个 <svg> + ::before 为 none」,视觉上单图标;而 11.7.0 的「个性化皮肤」行仍是 ::before 调色板(16px)+ 宿主 fallback 齿轮并存。改前改后在同一实例里是并行对照。

过渡方案(如果插槽重构要排队)

把选择器扩成两段,先止血:

- "[" + MARKER + "] > svg:first-child{display:none}"
+ "[" + MARKER + "] > svg:first-child," +
+ "[" + MARKER + "] > *:first-child > svg:first-child{display:none}"

旧结构走第一段,新结构走第二段。旁证:@max-null/dsh-plugin-center 早前因为另一次结构变化就是这么写的,它在 0.2.2-rc.1 下图标正常。

建议的落地顺序

  1. 合 PR #2(插槽注册 + 删旧钩子),两者必须同一次改完——只删不移或只移不删都会留下一个重复源;
  2. 发一个补丁版(如 11.7.1):npm 上的 11.7.0 仍是双图标版本,装它的人每次开设置都会看到;
  3. 若插槽重构排期较长,先合过渡方案里的一行选择器改动。
likedislike
LLLAAAAA
LLLAAAAACollaborators
3 days ago Comments:

已修复,感谢把 0.2.2-rc.1 的结构变化写得这么清楚——这条正是「PR #2 只解决了一半」的那一半。这一版已随 11.14.0 正式发布到 npm。

根因:宿主把图标再下沉一层后,原来 > svg:first-child 的形状全面失效,只靠宿主插槽的新路径覆盖不到没有 seat 的宿主。

改动:legacy CSS 兜底扩到 > svg:first-child, > span:first-child:has(> svg),并新增 tests/nav-icon.browser.test.cjs 在真实引擎里量计算样式;有 seat 的宿主走插槽并在 apply() 当场停用 legacy 钩子,两条路径都有用例。

同一轮的宿主漂移:census 已重测到 DSH 0.2.2-rc.1(329 包 / 1226 文件);宿主撤掉的 --dsw-specific-sidebar-nav-item-hover 没有从八套皮肤里删掉(兼容矩阵仍支持旧宿主),而是作为「已退休宿主插槽」把旧 census 读数钉到固定提交,并配四条反向变异防止它变成免死金牌。

你建议「补丁版让 npm 用户立即受益」,本轮已采纳:11.14.0 已发布到 npm 与 GitCode Release。升级: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 "[蓝军] 设置导航图标仍重复:宿主 0.2.2-rc.1 把图标下沉了一层,> svg:first-child 全面失效", originally titled "设置导航图标仍重复:宿主 0.2.2-rc.1 把图标下沉了一层,> svg:first-child 全面失效".
LLLAAAAALLLAAAAACollaborators
1 day ago Modify description of issue
LLLAAAAA
LLLAAAAACollaborators
22 hours ago Comments:

🔵 蓝军 · 复审确认

确认:legacy 兜底扩到 > svg:first-child, > span:first-child:has(> svg) 且两条路径都有真实引擎计算样式用例;退休宿主插槽的 census 钉到固定提交 + 四条反向变异防止变成免死金牌——「已退休」有档案、有防止复活判错的手段,这套处理值得沉淀成宿主适配的标准模式。本条维持关闭。

likedislike