设置窗口外观 weibaohui/dsh-settings-ui

@weibaohui/dsh-settings-ui

dsh 设置界面自定义：调整 dsh 原生设置窗口的大小、透明度与背景。设置项就在设置窗口里（左侧导航「设置界面」），改动即时生效。

dsh-settings-ui：设置窗口尺寸 / 不透明度 / 纯色背景，亮暗主题实时跟随

界面预览

亮色主题（大尺寸，主题默认背景）：

亮色主题

暗色主题——同一设置不刷新页面，切换主题实时跟随：

暗色主题

暗色 + 不透明度 70%（半透明毛玻璃）：

暗色半透明

暗色 + 全屏：

暗色全屏

核心功能

- 窗口大小：默认（800×800）/ 大（1080×780）/ 特大（1280×960）/ 全屏 / 自定义宽高（≥480×360，小屏自动收缩）
- 背景不透明度：30%–100%，半透明毛玻璃效果（跟随明暗主题）
- 背景：主题默认 / 纯色（亮、暗主题各存一色，切换主题实时跟随）
- 改动即时生效，随 dsh profile 保存（换浏览器不丢）；「恢复默认」一键还原

安装

dsh plugin --profile web add @weibaohui/dsh-settings-ui -w

装完重启 dsh web 即生效。

使用

打开 Web UI → 设置 → 左侧导航「设置界面」→ 选尺寸、拖不透明度、选背景。关掉重开设置窗口即可看到效果；全屏模式适合小屏或需要同时看对话的场景。

说明

- 尺寸/透明度/背景只作用于原生设置窗口本身，不影响其他界面
- 选择器改用设置面板的稳定属性 [data-shortcut-modal="settings"][role="dialog"]（dsh-client-ui-settings-general），不再依赖 CSS-module 易变 hash 类名（0.2.0 desktop 构建把 VOzbGW_panel 重生成为 Dws9Sa_panel，旧选择器命中 0 元素致静默失效）；属性 hash 无关，dsh 0.2.0+ 实测一致
- 设置随 dsh profile 持久化（0.1.7 起经 settings 文档写入 profile patch）。从 dsh ≤0.1.6 升级后首次运行会自动把 settings.yaml.imported 里残留的 settings-ui 节迁移回来（仅当本 profile 从未手动设置过时执行一次）

联系我 :飞书群

link

版本兼容性

本插件与 DeepSeek Harness（@deepseek-ai/dsh）的版本对应关系：

| 插件版本 | 适配 dsh 版本 | 备注 |
| 0.2.11 | 0.2.1-rc.2 | 修复 issue #2：冷启动约半数概率设置无法持久化——插件转 ESM（src/index.mjs，top-level await 动态 import schemastery：与宿主共享同一份 in-flight 模块记录，消除 ERR_REQUIRE_ESM_RACE_CONDITION；加载失败仍归一成 undefined 退回进程内兜底，静态 import 会让整个插件含悬浮球 UI 加载失败）；package.json 声明 @deepseek-ai/schemastery ~3.18.5（此前零声明，全靠别的包 hoist 顺带）；persist 失败回 503 + ok:false、client 保存失败显示错误不再闪"已保存"；已在 @deepseek-ai/dsh@0.2.1-rc.2 下核对宿主行为（插件经 import() 加载、registry.plugin 注册时快照 Config——事后回填无效），并发 import 模拟冷启动 8/8 拿到 Config |
| 0.2.10 | 0.2.0-rc.2 | 选择器改用稳定属性 [data-shortcut-modal="settings"]（hash 无关），修复 0.2.0 desktop app 面板 hash 由 VOzbGW 变 Dws9Sa 致 CSS 命中 0 元素、尺寸/透明度/背景全失效；engines.dsh 提升到 >=0.2.0-rc.2 |
| 0.2.9 | 0.1.7-rc.2 | 修复降级路径 Config 导出 null——宿主 settings schema() 不排除 null，会炸 settings.describe() 拖垮整份设置文档（同 dsh-continue#4） |
| 0.2.6 | 0.1.7-rc.2 | 修复宿主将 volatile 字段物化为 {} 导致的设置毒化（saneConfigValues 清洗 + 移除 Config 兼容字符串字段） |
| 0.2.5 | 0.1.7-rc.2 | 适配 0.1.7 settings 模型（导出 volatile Config，ctx.settings.update 持久化），自动迁移 settings.yaml.imported 残留设置 |
| 0.2.3 / 0.2.4 | 0.1.7-rc.2 | settings 改动只在本次运行内生效（0.1.7 移除了 ctx.settings.register），重启还原 |

发版约定：每次发布新版本时，请在上表追加一行，记录该插件版本实际验证所用的 @deepseek-ai/dsh 版本。package.json 的 engines.dsh 声明最低支持版本；本表记录实际验证版本，二者配合使用。