dsh-theme-admech

dsh-theme-admech — 机械神教 · 铸炉圣殿（纯 A / v0.9.3）

状态：v0.9.3。macOS 应用图标替换器现在可以在「App 管理」里授权后直接替换（无需退出 DSH，本机已实测成功并在 Dock 刷新）；同时保留 v0.9.2 的输入框精简（移除思考程度进度条）、v0.9.1 的展开命令行图标、v0.9.0 的图标 / 推荐标签 / 发送键修复。 Windows 适配细节见文末「Windows 适配（v0.7.0 · 实测）」，其中包含实测过的安装流程、失败模式与可复现的渲染审计脚本。 当前桌面 profile 以 link: 方式指向本仓库：client 半边的改动会被 HMR 热替换；宿主半边的启动前奏注入需要插件行重新挂载（或在「插件」页停用/启用一次），之后刷新页面即生效。 图标标准 = 你提供的齿轮-骷髅：只改颜色、等比缩放，不重绘。

v0.9.3：macOS 应用图标替换器（App 管理授权，无需退出 DSH）

macOS 会拦截对其它应用包的写入；把替换器 applet 加入「系统设置 → 隐私与安全性 → App 管理（App Management）」的允许列表后，就可以在 DSH 运行中直接替换图标（本机实测：icon.icns md5 9260bae121fd01f3261200d19a4c055e，icon.png 同步替换，Dock 已刷新）。

# 生成并打开替换器（首次会请求「允许修改其他 App」）
tools/build-macos-app-icon-fixer.sh

替换器逻辑：把 assets/app-icon/AppIcon.icns / icon-1024.png 复制到 /Applications/DeepSeek Harness.app/Contents/Resources/icon.icns 与 icon.png，touch 应用包、lsregister -f 刷新 LaunchServices、killall Dock；官方图标备份在 ~/.dsh-theme-admech/app-icon-backup/。

• 如果替换后 Dock 还是旧图标：退出并重新打开一次 DSH 即可（图标文件已经替换好，无需再授权）；
• 还原官方图标：tools/install-macos-app-icon.sh restore，或把备份目录里的两个文件手动拖回 Resources；
• DSH 更新会重置图标，更新后重新运行替换器一次即可。

v0.9.2：移除输入框内的思考程度进度条

按需求彻底删除会话框（输入框）里的「◆ 思考程度 · MAX ▾」进度条与点击交互：输入框恢复干净，只保留模型控件本身。

• 删除内容：输入框内的进度条绘制与 ::before 文案、点击打开滑块的自动钻取与悬浮定位、相关 CSS 动画与响应式规则、模型控件上的提示 title；
• 保留内容：模型 / 推理等级菜单里的离散滑块（Off / Low / High / Max）与拖拽 / 键盘调整完全不变；
• 顺带把占位提示的隐藏改为首帧确定性规则，避免 web / hero 占位文字在主题标记完成前与输入框重叠；layout_audit 连续两次 PASS（1440×900 + 390×844，0 errors）。

v0.9.1：展开后的运行命令图标 + 进度条直接改思考程度（v0.9.2 已移除其中输入框进度条）

1. 展开过程明细后，「运行命令」仍是原生 >_ 图标

根因：展开后的过程明细行使用的是一套 data-variant + data-sample 的组件（运行命令 / bash 行没有 data-tool），图标宿主是 [class*="iconIdle"]；主题此前的映射只看 data-tool / data-process-activity / data-variant="think"，所以这些行退回原生终端图标。

修复：新增 variant → 图标映射（bash / read / write / edit / search / web / code / plan / …），并对 iconIdle / iconActive / iconDone / iconError 宿主统一打主题 glyph；运行中、完成、折叠与展开状态都会保持主题图标。

2. 思考程度进度条可以直接改，不再需要打开模型设置

• 输入框内的「思考程度」进度条现在可点击：悬停时黄铜高亮并出现 ▾ 提示；点击后原地弹出与模型设置里完全相同的离散滑块（同一套 DOM / 样式 / 拖拽与 ← → / Home / End 操作），浮在进度条正上方。
• 选择或拖拽后立即提交，并同步更新进度条填充、档位文字与模型控件文案；点模型控件本身仍打开原来的模型 / 推理菜单。
• 实现：进度条点击 → 程序化展开原生「推理等级」钻取 → 复用同一个 slider 面板浮动定位到进度条上方；中间菜单在定位前隐藏，避免闪烁。

验证：

• 真机交互：点击进度条后浮层 data-admech-effort-float="true"、位于进度条正上方且水平居中、4 个档位；拖拽 Max → High 后 aria / 进度条同步更新，再次点击进度条可恢复 Max；模型控件原菜单不受影响。
• 展开命令行：data-admech-icon="terminal"，mask 与黄铜色生效。
• layout_audit 1440×900 + 390×844 PASS，0 errors（.layout-guard/runs/20261021-093454-dsg7-audit）；layout_assert（进度条打开同一滑块、4 档、提交 High、恢复 Max）PASS（.layout-guard/runs/20261021-093500-wkpc-assert）。

3.（回归修复）输入框提示文字重影

现象：智能体运行中、有排队消息时，输入框提示「Cmd/Ctrl+Enter 插话发送全部排队消息」出现两层重影，第二行被裁切。

根因：v0.9.0 为了让 web / hero 输入框的占位文字也被接管，把「把原生占位文字字号归零」的选择器从 [data-composer-placeholder][data-admech-placeholder="true"] 弱化成 [data-admech-placeholder="true"]。宿主自带规则 [data-composer-placeholder] { font-size: 14px !important } 在样式表中更靠后、特异性相同而获胜，于是原生占位文字（14px / 24px 行高）与主题的 ::before 副本同时绘制，行高翻倍后第二层被裁切 —— 纯套件回归，与 DSH 本身无关。

修复：恢复双属性高特异性选择器，同时保留 [data-admech-placeholder="true"][class*="placeholder"] 覆盖 web / hero 变体；v0.9.1 起提示文字只绘制一层。当前真机 computed 样式：原生占位 font-size: 0px，仅 ::before 以 14px/24px 绘制。按旧级联注入样式可稳定复现两层重影（下两图：上为重影复现，下为修复后）。

v0.9.0：DSH 应用图标 + 两处状态配色修复

1. macOS 应用图标：DSH 换成机械神教徽记

应用图标按 macOS 圆角方形规范重绘（1024px 画布、824px 内容、185px 圆角）：铁黑底 + 黄铜双框 + 尖拱 portal 线稿 + 发光的齿轮-骷髅 + 火星红封印，32px 下仍可辨认。

生成：python3 tools/build-macos-app-icon.py（Pillow + iconutil），产物在 assets/app-icon/：AppIcon.icns、icon-1024.png、icon-512.png、icon-256.png。

安装 / 还原（推荐方式，走「App 管理」授权，无需退出 DSH）：

tools/build-macos-app-icon-fixer.sh   # 生成并打开替换器；首次允许它「修改其他 App」
tools/install-macos-app-icon.sh status    # 查看当前状态
tools/install-macos-app-icon.sh restore   # 还原官方图标

说明：macOS 会拦截对正在运行的应用包的写入（直接 cp / root / installer 都会报 Operation not permitted）。解决办法是在「系统设置 → 隐私与安全性 → App 管理」中允许负责替换的 applet（tools/build-macos-app-icon-fixer.sh 生成的 AdmechIconFixer.app，或 Terminal）。授权后即可在 DSH 运行中直接替换（v0.9.3 实测通过）。安装器会把原始图标备份到 ~/.dsh-theme-admech/app-icon-backup/，替换 icon.icns / icon.png，刷新 LaunchServices 与 Dock。若 Dock 仍显示旧图标，退出重开一次 DSH；DSH 更新会恢复官方图标，更新后重新运行替换器即可。资源替换会让应用包的 codesign 校验失效（本地正常启动不受影响，需要时执行 restore）。Finder 手动替换包：macos-app-icon-drop/（双击打开后拖入 Resources 亦可）。

2. 问题卡片：推荐标签「推荐」文字不可见

宿主用 --dsw-specific-sidebar-nav-item-active-accent 做底色、用 --dsw-alias-button-info-fill 做文字色，而本主题把这两个 token 都设成了黄铜 → 金底金字。现在给推荐标签单独的黄铜描边 + 磷光文字配色，任何主题 token 调整都不会再吞掉文字。

3. 发送键在排队 / 插话状态变成纯金色圆点

发送键与「停止生成」共用宿主的 yhfFVG_primary 槽位，标签会随状态在 发送消息 / 排队发送 / 插话发送 / 停止生成 之间切换。主题此前只匹配 aria-label="发送消息"，所以智能体运行时输入文字，按钮退回到宿主默认的 --button-info-fill（本主题 = 黄铜）——一颗纯金圆点，而里面被 mask 成黄铜色的发送箭头也和底色融为一体，看起来像图标消失。

修复：按宿主主按钮 class 统一上火星红圆环样式，发送/排队/插话三种状态都保持红色 + 米白图标；排队与插话额外加琥珀色外环表示「插入正在运行的轮次」；停止状态继续使用红色脉冲圆环。

验证：真机取三种状态的计算样式，背景均为火星红径向渐变、图标为 #f7ecd5、尺寸 34px；推荐标签为 34×18px、文字 #e3c184 落在半透明黄铜底上。主题 CSS 改动后 layout_audit 重新 PASS（1440×900 + 390×844，0 errors）。

v0.8.0：一段式启动 + 机魂遥测条 + 思考程度滑块

1. 启动序列：只保留套件的点火动画

• 宿主半边（lib/index.js）通过 webserver/index-inject 向 index 注入启动前奏：暗色大教堂背景 + 齿轮-骷髅徽记 + 「铸造圣殿」标题 + 黄铜进度轨 + 实时百分比；前奏背景由 /theme-admech/forge-cathedral.svg 路由提供，并缓存一天；
• 同一份注入会把原生 HARNESS / Loading plugins… 启动屏隐藏（CSS :has + 注入脚本双保险），客户端未加载或加载失败时注入脚本自动撤掉前奏，绝不遮住原生错误页；
• 客户端 showSplash() 检测到前奏后原地接管：加 is-continue 关闭淡入、读取前奏进度并折算进启动计时，点火序列从当前百分比续播，随后无缝回到界面；
• prefers-reduced-motion 时保留静态前奏直到界面挂载；自动化用的 #admech-splash=0 会立即移除前奏并直接进入界面。

2. 底部机魂遥测条：速率 / 命中率 / 上下文

• 三个原生统计按钮重做成黄铜仪表：拉丁文 + 中文小标题（RAPIDITAS · 速率 / CACHE · 命中率 / MEMORIA · 上下文）、等宽数字读数、底部 2px 分段增益条；速率条随 tok/s 变化，命中率 / 上下文按阈值转为警戒黄 / 火星红，运行中速度图标呼吸；
• 会话统计、Token 用量、本轮用量、上下文面板统一为铁 + 黄铜仪器面板（标题细线、数据行、上下文分段色带与菱形图例）；
• 只写 data-* 与自定义属性，不向 React 节点插入 DOM，保持宿主 reconcile 安全。

3. 思考程度：滑块调整 + 输入框内进度条

• 模型菜单里的「推理等级」钻取列表改为横向离散滑块：Off / Low / High / Max 四个菱形档位落在黄铜轨道上，可用鼠标拖动、点击档位、← → / Home / End 调整；提交仍走原生 menuitemradio 按钮，键盘与读屏行为不变；
• 输入框内部（模型控件左侧）常驻「思考程度」进度条：显示当前档位名、按档位填充黄铜 → 磷光绿进度，选择/拖拽时实时更新；
• 模型与推理等级菜单、模型列表也套用仪器面板样式；移动端自动隐藏输入框内进度条，滑块保持单行可拖。

验证：

• 真机启动时序：prelude 50ms 出现，原生 boot 屏 display:none，568ms 客户端点火以 is-continue 无缝接管，全程只有一段套件动画；
• layout_audit（真实渲染页，隔离 profile）：1440×900 + 390×844 PASS，0 errors（.layout-guard/runs/20261021-091023-su9w-audit）；
• 会话态快照审计（遥测条 / 模型菜单 / 滑块 / 用量与上下文面板 / 移动端）：PASS，0 errors（.layout-guard/runs/20261021-091038-kovh-audit 等）；
• layout_assert 项目不变量全部 PASS：遥测条位于输入框下方且不越界、三仪表同排、输入框内进度条显示「思考程度 · Max」、滑块 4 档同排且填充到 Max、移动端进度条隐藏（.layout-guard/runs/20261021-091144-vdk4-assert 等）。

v0.4 重点

1. 输入框：去掉大弧线，改成尖顶神殿 crest

• 原先的宽弧形顶饰已删除；改为陡峭尖顶 + 双塔 + 尖拱窗 + 卷叶饰 + 你提供的齿轮-骷髅徽记；
• 装饰主体上移，只让底部山花压在上边框；不进入文字区域，不遮挡 placeholder / 输入内容；
• 保留黄铜双线框、四角花窗、圆形火星红发送键，输入区保持清晰；
• 顶部小铭文 “EX FERRO · EX IGNE” 只在卡片上沿，不压正文。

2. 背景：面式尖拱 portal，替代纯弧线

• 中央改为由直线段构成的尖拱大门（faceted pointed arch）：多层 archivolt 石带、锯齿/菱形雕饰、尖顶山花（gable）、卷叶饰（crockets）、两侧尖塔与扶壁、侧柱、雕像龛；
• 门内保留彩窗，但不再用大圆形玫瑰窗，也不用单一圆滑曲线；
• 两侧加入尖拱 arcade / triforium 小拱 / 束柱；
• 旗帜与背景多处使用你提供的齿轮-骷髅，并加入复杂祷文：OMNISSIAH / DEUS MACHINA / EX FERRO / EX IGNE / IN TENEBRIS / LUX AETERNA / SURGE MACHINA / MARS INVICTA；
• 地面、柱身、山花、门楣都有祷文铭刻；烛光、锻炉、光柱、尘埃、苔藓、裂缝、锈迹强化“黑暗中辉煌、腐朽中不屈”。

3. 小鲸鱼 → 齿轮-骷髅

• hero 标题前的 DeepSeek 小鲸鱼已替换为你提供的齿轮-骷髅；
• 品牌标识、旗帜、对话框徽章、输入框 crest、插件卡片统一使用同一标准徽记。

4. 对话框 / 会话框

• 设置等模态框使用尖顶徽章 + 四角花窗 + 标题装饰线 + 黄铜双框；
• 会话区四周使用尖顶式 conversation crest（不再是纯弧），两侧束柱轨、底部 arcade 饰带与纵向祷文；
• 聊天内容保持可读，装饰都带 pointer-events: none。

v0.4.2：关闭插件后图标恢复修复（v0.5.1 已改为更安全的方案）

问题：停用插件时，cleanup 只移除了主题 CSS 和根节点属性，没有恢复被替换的 SVG 图标（viewBox / fill / stroke / width / height / innerHTML），也没有恢复被替换成内联 SVG 的 img 元素；因此关闭插件后页面仍显示 Forge-Cathedral 图标，需要刷新才恢复。

修复：

• 最初方案：记录原始 attributes / innerHTML，cleanup 时恢复；该方案在 v0.5.1 因 React removeChild 冲突被移除；
• 现在不再改写 SVG 子节点，图标改用 CSS mask 绘制，关闭插件只需移除属性即可恢复；
• 对插件页里被替换的 img 元素记录父节点/兄弟节点，cleanup 时移除替代 SVG 并插回原 img；
• 清理所有 data-admech / data-admech-icon / data-admech-brand / data-admech-hero-mark / data-admech-placeholder 属性；
• 重新启用时重新记录并重新替换。

验证（真实 DSH 0.2.1-rc.2，隔离 profile）：

• 启用状态：28 个图标被替换；
• 连续停用两次后：svg[data-admech-icon] = 0，[data-admech-glyph] = 0，data-admech 属性 = 0；
• 品牌图标恢复为原生 DeepSeek 鲸鱼轮廓（viewBox 23.16 x 17.04），插件卡片恢复原生图标；
• 重新启用后：28 个图标再次替换，主题恢复；
• 停用状态截图：shots/disabled-native.png；
• 启用状态 layout_audit PASS：1440×900 + 390×844，报告 .layout-guard/runs/20261018-192646-l3en-audit/report.json。

v0.5.0：启动页 · 铸造圣殿点火序列（标题在 v0.5.3 改为“铸造圣殿”）

• 在 DSH 页面加载、主题插件激活后，显示全屏启动覆盖层；约 3 秒后自动淡出；
• 中央是尖拱/六边哥特框、侧龛、山花、底部 arcade、你提供的齿轮-骷髅、祷文铭刻；
• 逐行点火日志：NOOSPHERE LINK / COGITATOR CORE / FORGE SANCTUM / LITANY OF ACTIVATION；
• 黄铜进度轨 + 百分比、火星余烬、光柱、扫描线、轻微闪烁；
• 点击任意位置或按 Enter / Esc / Space 可跳过；
• 系统开启 prefers-reduced-motion 时自动缩短动画；
• 自动化截图 / layout audit 可通过 URL hash 跳过启动页：#admech-splash=0；
• 这是客户端启动覆盖层，不是 macOS/Windows 原生启动画面；不会缩短应用真实启动时间，只是在页面可用后播放约 3 秒的点火序列。

验证：

• 桌面 1440×900 / 移动 390×844 截图通过；
• 3 秒后自动移除，底层 UI 正常；
• 点击跳过验证通过；
• 跳过启动页后 layout_audit PASS：报告 .layout-guard/runs/20261018-193502-d7yl-audit/report.json；
• 浏览器控制台无错误；启动页不依赖 macOS 专用 API。

v0.5.1：修复发送消息后输入框永久消失（React removeChild）

现象：发送一条消息后，composer / 输入框永久消失；新建会话、切换其他会话也没有输入框，刷新才恢复。

根因：

• 原图标替换会直接改写 React 管理的原生 SVG 的 viewBox / fill / stroke / innerHTML；

• 从 hero 输入区切换到 chat composer 时，React 尝试移除已被我们替换掉的 SVG 子节点；

• 控制台出现：

  NotFoundError: Failed to execute 'removeChild' on 'Node' slot entry crashed in 'conversation.composer.bar'

• composer.bar 插槽崩溃后，输入框被永久卸载。

修复（v0.5.1）：

• 不再修改 React 管理的 SVG 子节点、viewBox、fill、stroke、width、height；
• 保留原生 SVG 树，仅加 data-admech-icon 标记，用 CSS mask + background-color: currentColor 绘制 Forge-Cathedral 图形；
• 原生 SVG 子节点只用 CSS opacity: 0 隐藏，DOM 结构保持完整，React reconcile 安全；
• 不再把插件页的 img 节点替换成 SVG（避免同类 removeChild 风险）；
• 关闭插件时只移除 data-admech 属性和 mask style，原生图标立即恢复（v0.4.2 的图标回归能力保留）。

验证（真实 DSH 0.2.1-rc.2，隔离 profile）：

• 连续发送两次消息：composer 与输入框始终存在（cardCount=1 / inputCount=1）；
• 新建会话：输入框存在；
• 切换会话：输入框存在；
• 控制台无错误，无 removeChild；
• 停用插件：data-admech 属性 0，mask style 移除，原生鲸鱼/图标恢复；
• 重新启用：图标与主题恢复；
• 启用状态 layout_audit PASS：1440×900 + 390×844，报告 .layout-guard/runs/20261018-193923-32op-audit/report.json。

v0.5.2：深度求索中 + 对话过程图标重设计

将 DeepSeek 的鲸鱼/内置过程图标替换为 Forge-Cathedral 原生图形：

• 深度求索中：隐藏原生 APNG 鲸鱼，复用原生 SVG 作为 mask 宿主，显示缓慢旋转的机魂之眼（齿轮 + 眼），保留呼吸式辉光；
• 进行中状态的文字改为衬线字体 + 黄铜色，并保留 shimmer；
• 对话过程步骤按 DSH 的 data-process-activity 映射：

实现方式仍是 CSS mask over untouched native SVG：不替换 React 节点、不改写 SVG 子节点，因此不会重新引入 composer 的 removeChild 崩溃；关闭插件时只移除属性与 mask style，原生图标恢复。所有动画在系统开启减少动态效果时关闭。

验证：

• 按 data-process-activity 全覆盖检查：12 个状态均映射到对应图标；
• 合成 DOM 渲染检查（含 running 状态）通过，控制台无错误；
• 真实发送消息后 composer 仍存在（cardCount=1 / inputCount=1）；
• 启用状态 layout_audit PASS：1440×900 + 390×844，报告 .layout-guard/runs/20261018-194539-yohz-audit/report.json。

v0.6.0：文件卡框体重设计 + 展开详情图标修正

文件卡 / 已编辑文件框

• 已编辑文件卡（data-changed-files）：黄铜遗物框、双线内框、四角花窗、标题衬线化、文件路径等宽字体、diff 行使用暗橄榄绿 / 暗火星红；
• 交付文件卡（data-presented-file）：同样的遗物框语言，图标盒改为黄铜边框 + 暗色底，文件名衬线化，说明文字等宽化；
• 行悬停、展开按钮、操作按钮都加了黄铜 hover 与内阴影；
• 不修改组件 DOM，只做 CSS 覆盖；不引入新的 React 节点。

展开详细内容后的图标

上一版只替换了 process 组头部的 activity 图标。展开 process 组后，内部 ToolRow 仍显示 DSH 原生工具图标，因此出现“展开后原型鄙陋”的问题。v0.6.0 追加：

• 按 ToolRow 的 data-tool / data-variant 映射到同一套 Forge-Cathedral 图标：
  • read_file → process_read
  • write_file → process_edit
  • terminal / bash → terminal
  • grep / search → search
  • web_fetch → process_web
  • run_code / code → process_code
  • subagent → trinity
  • plan → process_plan
• 对未知工具名增加前缀/关键字 fallback，避免展开后掉回原生图标；
• 仍然使用 CSS mask，SVG 原生树不替换，composer 崩溃修复保持。

验证：

• 8 种展开详情 ToolRow 全部命中对应图标；
• 文件卡合成 DOM 渲染检查通过；
• 真实发送消息后 composer 仍存在（cardCount=1 / inputCount=1），控制台 0 errors；
• layout_audit PASS：1440×900 + 390×844，报告 .layout-guard/runs/20261018-195243-qhye-audit/report.json。

v0.6.1：文件卡图标空白修复 + 展开“思考”图标

文件卡图标空白

v0.6.0 给文件卡图标的 SVG 加了较强的 sepia / brightness filter，把 FileTypeIcon 自身的白色底板和彩色字形一起洗白，最终出现“白色空方块”。

v0.6.1 移除这组洗白滤镜，只保留轻微阴影；图标盒仍保留黄铜边框与暗色衬底。文件类型图标恢复原本的颜色与字形。

展开后的“思考”图标

展开 process 组后，ReasoningRow 使用的是 DSH 原生 IconThinkOutlineRegular（原子/轨道图标），不属于 ToolRow，所以上次映射没有覆盖到。

v0.6.1 增加：

• 对 [data-variant="think"] 的 ReasoningRow，把 leading SVG 映射为 process_think（机魂之眼）；
• 思考行的标题/摘要同步使用衬线字体；
• ToolRow 与 process 组头部图标映射保持不变。

验证：

• 文件卡合成 DOM：FileTypeIcon 字形可见，不再空白；
• 展开思考行：data-admech-icon=process_think；
• 控制台 0 errors；
• layout_audit PASS：1440×900 + 390×844；
• 报告：.layout-guard/runs/20261018-195612-x4mu-audit/report.json。

v0.6.2：账户 / 查询用量 / 充值 的兼容性排查

隔离环境检查结果：

• 账号菜单可以正常打开；
• 菜单项的 pointer-events 是 auto，没有被主题装饰层遮挡；
• 点击“登录”时菜单项 click 事件正常触发（defaultPrevented=false），控制台无错误；
• 查询用量 / 充值在 Desktop 上通过 nativePlatform 打开 DSH 的 WebContentsView（DSH 宿主页面），不在主题 DOM/CSS 的范围内，主题无法拦截该页面的按钮。

v0.6.2 增加的防御性处理：

• 启动动画遇到 account / platform / billing / top-up / usage 等路径时直接跳过；
• 点击账号菜单中的用量、充值等操作时，如果启动动画仍存在，立即将其移除；
• 对菜单、对话框、账号区域的 a/button 显式设置 pointer-events: auto 与 z-index，避免装饰层继承/覆盖点击区域。

如果你的环境里仍打不开，请提供“点击后具体表现”（无反应 / 空白原生页 / 报错）以及 DevTools Console 错误；这通常需要区分是账号状态 links 缺失、WebContentsView 宿主问题，还是 DSH 版本问题。

v0.6.3：修复查询用量 / 充值原生页加载失败

根因

DSH Desktop 的“查询用量 / 充值”会挂载一个原生 Platform WebContentsView。它的宿主 DOM 是一个：

<div role="dialog" aria-modal="true">
  <header data-window-drag="true">…返回 DeepSeek Harness…</header>
  <div class="…viewport">…</div>
</div>

主题的通用 role=dialog 哥特框样式把它也当成了普通对话框，覆盖了它的：

position: fixed; inset: 0; overflow: visible; border; background; …

导致 PlatformOverlay 的 .viewport 尺寸/位置错误，bridge.open(page, bounds) 拿不到有效 bounds，加载失败，只显示“操作未完成，请重试 / 返回 DeepSeek Harness”。

修复

• 用 role=dialog:has(> header [data-window-drag]) 识别原生 Platform 宿主；

• JS 同时打上 data-admech-platform-overlay="true" 作为兼容标记；

• 对这两种选择器强制恢复：

  position: fixed; inset: 0; z-index: 1001; display: flex; flex-direction: column; background: var(--dsw-alias-bg-base); background-image: none; border: 0; border-radius: 0; box-shadow: none;

• 隐藏主题的 ::before / ::after（内框与徽章），不再影响原生页 bounds。

v0.7.12：机械神甫 SVG 素材 · 外轮廓 + 原始权杖左侧轮廓

• 最终结果只包含金色线条：所有元素 fill="none"，无照片填色、无白色/灰色块、无剪影填充、无红色；
• 按参考轮廓做金色线条描红：外轮廓与主要结构轮廓均由金色线描出；
• 无位图内嵌；底部金色底盘/基座完全移除；
• 文件：assets/tech-priest.svg（约 39KB，381×470 viewBox，透明底，可无损放大）；
• 背景仍是原来的铸炉圣殿，没有改动背景上的机械神甫；
• 这是独立素材，可用于后续替换背景人物、做启动页/卡片插画或单独导出 PNG。

授权注意：该 SVG 是从你提供的参考照片做的同人矢量重建，参考照片的权利状态未验证；仅建议自用/非商业，不纳入 MIT 或 CC 授权。

v0.7.13：背景图移除机械神甫

• 背景 SVG 中原有的 4 个机械神甫组已全部删除；
• 铸炉圣殿建筑、旗帜、文字、地砖与光效保持不变；
• 不再把独立的神甫素材放回背景；
• 客户端 bundle 已重新构建。

v0.7.14：停止按钮 / 图标闪烁 / 卸载弹窗

• 停止按钮：40×40（移动端 34×34）火星红圆形按钮，亮金边、金色 pause 双竖条和脉冲光晕，运行中明显可见；
• 原始图标闪烁：
  • 新增同步 tagProcessIcons()，MutationObserver 每批 DOM 变化先补标；
  • 监听 data-process-activity / data-tool / data-variant 等状态属性；
  • 打标前隐藏对应原生 SVG，思考/代码刚开始不再露出 DSH 原始图标；
  • 修复 observer 自触发死循环。
• 卸载弹窗：顶部 84px 徽章上移到弹窗外侧；移动端/矮视口 64px 同样外置，不再覆盖标题。

• 实际验证：运行中停止按钮图标为 process_pause；运行/思考容器未打标原生图标数 0；工具栏带 data-variant="think" 时正确显示 process_code；
• layout_audit desktop/mobile PASS（0 errors）。

v0.7.15：图标覆盖兜底

• 未知 data-process-activity：按关键字兜底到 process_code / process_web / process_think；
• 未知 data-tool：兜底到 tools，不再保留原生工具图标；
• 运行中容器、步骤图标、停止按钮的原生 SVG 在打标前隐藏；
• 工具行 / 思考行只隐藏 leading 图标，避免误伤工具结果里的其他图标；
• 合成状态验证：
  • 未知步骤 mystery_exec → process_code
  • 未知工具 mystery_tool → tools
  • 停止按钮 → process_pause
  • 原生未打标图标数 0

v0.7.17：修复 Windows 上「查询用量 / 充值」内嵌页黑屏

现象

Windows 11 上点「查询用量」或「充值」：返回栏出现、先显示加载转圈，随后内容区变黑，原生 Platform 页面始终加载不出来。macOS 上同一路径正常。

根因

DSH Desktop 的内嵌 Platform 页是一个原生 WebContentsView，宿主 DOM 为：

<div role="dialog" aria-modal="true">
  <header data-window-drag="true">…返回 DeepSeek Harness…</header>
  <div class="…viewport">…</div>
</div>

PlatformOverlay 在 useEffect 里用 .viewport 的 getBoundingClientRect() 作为传给主进程的 bounds。主题的通用 [role="dialog"] 哥特框会把宿主容器改成 position: relative（主题选择器优先级高于宿主自带的 .overlay），只有平台专用规则才能把它恢复成 position: fixed; inset: 0。

平台专用规则原来写的是：

[role="dialog"]:has(> header [data-window-drag])

这是 header 的后代；而 DSH 把 data-window-drag 放在 header 自己身上，所以该选择器永远不匹配。实际上要等主题 MutationObserver 的 tagNodes() 补上 data-admech-platform-overlay="true" 之后，CSS 才生效——已经晚于 React useEffect 读取 bounds 的时机。

实测（隔离环境，模拟 Windows 标题栏 40px，合成同一个 PlatformOverlay DOM）：

Windows 上原生视图按「高度 0、y=989（窗口外）」创建后，之后再 setBounds 也不会重新绘制，于是内容区一直是黑的；macOS 的合成器会重绘，所以之前只在 mac 上看不出问题。

修复

• CSS 增加 :has(> header[data-window-drag])（保留原来的后代形式兼容旧 DOM），让 host 在第一帧就是 position: fixed; inset: 0，::before/::after 也在第一帧隐藏；
• JS 打标改为遍历 [role="dialog"]，只给「直接子 header 带 data-window-drag（或 header 内含该属性）」的 dialog 打标，不再用 document.querySelector("[role=\"dialog\"] [data-window-drag]") 取全局第一个；
• 版本号 0.7.17；macOS 路径无变化。

验证

• 修正后合成 DOM 在挂载当帧即返回 bounds = {x:0, y:88, width:1440, height:812}（Windows 标题栏模拟，1440×900）；
• 无主题时同一 DOM 同为 {0,88,1440,812}，说明修复后与宿主原生布局一致；
• 主题 JS 打标仍能命中（data-admech-platform-overlay="true"），作为无 :has() 环境的兜底。

v0.7.16：停用/卸载后恢复原主题

• 插件启用前记录用户的真实主题偏好（light / dark / system / 第三方主题 id）；
• 插件强制 dark 期间不改写这个记录；
• 停用/卸载清理时调用 ctx.theme.setTheme(previousThemePreference)，恢复到启用前的主题；
• 同时移除 data-ds-dark-theme、color-scheme: dark 等强制暗色标记；
• 实测隔离 profile：停用插件后页面恢复为亮色（bodyBg: rgb(255,255,255)、colorScheme: light），不再出现“显示暗色但实际设置是亮色”。

v0.7.18：修复底部统计面板无法打开

• 背景：主题把通用 [role="dialog"] 全部套上弹窗边框和 position: relative !important；
• 底部的速率/用量统计面板、上下文用量面板、轮次 token 用量面板都是挂载到 body 的 position: fixed 浮动面板，被主题改成 relative 后位置错乱，看起来像点击无效；
• 修复：所有 [role="dialog"] 选择器加上 :not([class*="_panel"])，统计/上下文/token 面板不再套用模态弹窗框；
• 卸载确认弹窗等真正的模态 role="dialog" 不受影响（实测 class _dialog_o6lrb_33 仍使用主题边框和徽章）；
• 合成面板验证：修复后 position: fixed、无主题伪元素，触发按钮点击可正常显示。

验证

合成 PlatformOverlay DOM 检查：

• position: fixed，inset: 0；
• 900px 高窗口下 viewport 为 1440×852（header 48px 之后）；
• border: 0，border-radius: 0，background-image: none；
• 主题伪元素 display: none；
• layout_audit PASS，报告 .layout-guard/runs/20261018-200526-gdvk-audit/report.json。

验证

• 隔离 DSH Home 的 DSH 0.2.1-rc.2 profile 安装并启用；
• layout_audit PASS：1440×900 + 390×844，0 errors；
• 报告：.layout-guard/runs/20261018-200526-gdvk-audit/report.json；
• 控制台无插件报错；
• 图标替换：hero 页 24/33 个可见 SVG、插件页 28/35 个。
• Windows 11 真机（v0.7.0）：1440×900 @100%、1440×900 @125%、1920×1080 @150%、1280×800 @125%、Snap 1100×760 / 900×720、窄窗 760×640 共 9 个视口，均为 文字裁切 0 / 交互元素重叠 0 / 控制台 0 报错；另验收 Windows 标题栏条、高对比度主题、减少动态效果三条平台路径。详见文末「Windows 适配（v0.7.0 · 实测）」。

安装

1. 左侧栏 插件 → 添加插件（或箭头 → 安装第三方插件）

2. 路径：

   /Users/richard_dou/Desktop/插件工厂/admech-theme/plugin

3. 安装 → 立即启用；提示重启就重启 DSH。

构建与源码

src/icons.json            # 32 枚 UI 图标，emblem 使用你提供的图标
src/styles.css            # token / 输入框 shrine / 会话框 crest / 图标
src/client-template.js    # 主题、图标替换、徽记与装饰
src/build-client.mjs      # 生成 lib/client.js
assets/gear-skull-gold-*.png
assets/forge-cathedral.svg / .png

cd admech-theme/plugin
node src/build-client.mjs
node --check lib/client.js

边界

• 背景仍是矢量 SVG 插画，不是照片级 / 手绘原画；可以继续细化；
• 深色 only；设置页 / 仪式动画 / 音效未做；
• tool 卡 / 审批卡尚未逐组件精修；
• 桌面版尚未安装到你的日常 profile。

IP

粉丝向原创演绎；背景为原创 SVG；齿轮-骷髅来自你提供的素材，仅按你的要求用于自用主题。

从 GitHub 安装（公开仓库）

仓库地址：

https://github.com/RichardDou0607/dsh-theme-admech

DSH Desktop

1. 左侧栏 插件 → 添加插件（或箭头 → 安装第三方插件）；

2. 输入 Git 地址：

   github:RichardDou0607/dsh-theme-admech
   

   或：

   https://github.com/RichardDou0607/dsh-theme-admech
   

3. 安装 → 立即启用；提示重启就重启 DSH。

也可以直接下载仓库 ZIP，解压后以本地目录安装。

Windows 提示：github: 规格依赖 Git 与可用代理，在「代理失效 / 证书链不全」的机器上会直接失败（实测见文末）。Windows 上推荐「下载 ZIP → 本地 file: 安装」，完全离线且不需要 Git。

DSH Web / CLI

dsh plugin --profile web add "github:RichardDou0607/dsh-theme-admech"

Windows 上若上面这条因为代理 / 证书失败，改用本地目录（实测可用）：

dsh plugin --profile web add "file:C:\dsh-theme-admech\dsh-theme-admech-main"

许可 / IP（重要）

本仓库是混合许可，不是单一 OSI 开源许可：

• 代码（src、lib、构建脚本、cordis.patch.yml）：MIT，见 LICENSE；
• 原创主题素材（forge-cathedral.svg/png、手绘图标、输入/会话框 ornament、截图）：CC BY-NC-SA 4.0，仅限非商业使用，需署名并以相同方式共享；
• 你提供的齿轮-骷髅徽记：由仓库所有者提供，未纳入 MIT / CC 授权，权利状态请见 ASSETS-LICENSE.md；
• 非官方粉丝作品：与 Games Workshop 无关联，不含官方 logo / 官方插画；详见 DISCLAIMER.md；
• 非商业使用不等于没有版权/商标风险。公开分发前请确认素材授权；商业使用前建议替换掉一切 GW 风格名称/符号，并咨询知识产权律师。

Windows 适配（v0.7.0 · 实测）

实测环境：Windows 11（10.0.26300，中文系统，代码页 936）· DSH Desktop Web（运行时 0.2.1-rc.2，Electron 44.7.0）· Chromium 154 · 同一台机器的 100% / 125% / 150% 三档缩放。渲染与度量通过 tools/win-audit/ 里的 CDP 审计脚本完成（见文末「Windows 渲染审计」）。

v0.4.1 只加了字体回退，没有在 Windows 真机上跑过。v0.7.0 补上了真机验收，并修掉了下面这些只有 Windows 才会暴露的问题。

Windows 11 · 1440×900 · 100% 缩放。

1. Windows 窗口顶部的原生标题栏条

Windows 版 DSH 用 titleBarStyle: "hidden" + titleBarOverlay，宿主会在 html 上打 data-windows-titlebar 标记，并给整个 frame 加 padding-top: var(--dsh-windows-titlebar-height)（本机 40px）来给最小化/最大化/关闭让位。主题本身不碰这块，实测主题色（--dsw-specific-sidebar-fill）会自动铺满这条 40px 带，与侧边栏、会话区衔接正常，无需额外处理——但如果你换了 --dsw-specific-sidebar-fill，记得这条带是跟着它走的。

Windows 桌面：顶部 40px 原生标题栏条（data-windows-titlebar）与侧边栏、会话区的衔接。

2. 1px 花丝线在 125% / 150% 下发虚

Windows 最常见的缩放是 125%（笔记本）和 150%（1080p 屏）。1 CSS px 在这些缩放下落到 1.25 / 1.5 设备像素，Chromium 只能用抗锯齿去凑，结果就是铜色花丝比 macOS（2× 下 1px = 整整 2 设备像素）更暗、更糊。

• 新增 --admech-hairline：客户端半按 devicePixelRatio 计算，100% → 1px，125% → 0.8px，150% → 0.667px（都正好 1 设备像素），200% 及以上回到 1px；
• 主题里 45 处装饰性边框 / 内嵌描边（border*: 1px、inset 0 0 0 1px、焦点环）全部改成 var(--admech-hairline, 1px)；
• 移动窗口到另一块缩放不同的显示器时，resize 会重新计算，不用重启。

1920×1080 · 150% 缩放（CSS 视口 1280×720）。

实测：150% 下量同一列像素，边框亮带的过渡从「6 列渐变」收到「5 列、核心更亮」，视觉上是一条干净的线而不是一层雾。

3. 小尺寸花角（文件卡 26px / 交付卡 20px）几乎看不见

花角字形画在 48 单位的画布里，缩到 26px 时 stroke-width: 1.15 只剩 0.62 CSS px；macOS 2× 下还有 1.24 设备像素，Windows 100% 下只有 0.62 设备像素，等于一层鬼影。

• 新增密度校正