DSH（DeepSeek Harness）采用插件化架构，一切皆可扩展。在使用原生设置面板配置智能体或工作流时，默认的窗口尺寸、背景透明度或配色方案有时难以满足实际查看需求。dsh-settings-ui 插件直接作用于原生设置窗口，允许调整其大小、背景透明度与背景色，并支持亮暗主题实时跟随。
插件定位¶
- 名称：
dsh-settings-ui - 维护者：
weibaohui - 分类：趣味换装
- 简介：dsh 插件 · 设置界面自定义：调整原生设置窗口大小、透明度与背景，支持亮暗主题实时跟随
- 许可证：MIT
核心功能¶
- 窗口大小：支持默认尺寸、大尺寸、特大尺寸、全屏模式或自定义宽高（最小 480×360，小屏自动收缩）。
- 背景不透明度：支持 30% 至 100% 的调节，配合亮暗主题可实现半透明毛玻璃效果。
- 背景设置：提供“主题默认”或“纯色”选项。插件内置亮色与暗色主题各一种预设颜色，切换主题时背景会实时跟随变化。
- 即时生效：在设置面板内修改配置后，设置立即生效。配置随 dsh profile 持久化保存。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add @weibaohui/dsh-settings-ui -w
安装完成后，需要重启 dsh web 命令行进程，插件才会生效。
典型用法¶
- 打开 DSH Web UI。
- 进入「设置」页面。
- 在左侧导航栏找到「设置界面」。
- 在该页面下调整尺寸、拖动滑块设置不透明度、选择背景风格。
- 关闭并重新打开设置窗口，即可看到调整后的效果。在全屏模式下，可以同时查看对话与设置内容。
注意事项¶
- 作用范围：尺寸、透明度与背景设置仅作用于原生设置窗口本身，不会影响 DSH 的其他界面（如主聊天窗口）。
- 技术细节：插件选择器使用了稳定的属性
[data-shortcut-modal="settings"]，不再依赖 CSS Module 的易变 hash 类名，因此即使 dsh 内部构建版本更新，选择器依然有效。 - 配置持久化：设置内容会随当前的 dsh profile 保存。若从旧版本升级，首次运行时会自动处理残留配置。
- 版本兼容：插件依赖
@deepseek-ai/dsh版本>=0.2.0-rc.2。
总结¶
如果你觉得原生设置窗口在复杂配置下难以操作，或者需要根据当前环境调整视觉体验，dsh-settings-ui 提供了一套轻量级的自定义方案。它通过修改 CSS 变量或样式注入，在不破坏原有逻辑的前提下，增强了设置界面的可用性。
