dsh-settings-ui

@weibaohui/dsh-settings-ui

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

界面预览

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

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

暗色 + 不透明度 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 从未手动设置过时执行一次）

联系我 :飞书群

版本兼容性

本插件与 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 声明最低支持版本；本表记录实际验证版本，二者配合使用。