# @weibaohui/dsh-settings-ui

[![DSH plugin](https://img.shields.io/badge/dsh-plugin-green)](https://github.com/topics/dsh-plugin)
[![npm version](https://img.shields.io/npm/v/@weibaohui/dsh-settings-ui)](https://www.npmjs.com/package/@weibaohui/dsh-settings-ui)

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

![dsh-settings-ui：设置窗口尺寸 / 不透明度 / 纯色背景，亮暗主题实时跟随](https://cdn.jsdelivr.net/gh/weibaohui/dsh-settings-ui@main/docs/demo.gif)

## 界面预览

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

![亮色主题](https://cdn.jsdelivr.net/gh/weibaohui/dsh-settings-ui@main/docs/light.png)

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

![暗色主题](https://cdn.jsdelivr.net/gh/weibaohui/dsh-settings-ui@main/docs/dark.png)

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

![暗色半透明](https://cdn.jsdelivr.net/gh/weibaohui/dsh-settings-ui@main/docs/dark-translucent.png)

**暗色 + 全屏**：

![暗色全屏](https://cdn.jsdelivr.net/gh/weibaohui/dsh-settings-ui@main/docs/dark-fullscreen.png)

## 核心功能

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

## 安装

```bash
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](https://foruda.gitee.com/images/1774880015525784725/4fd67005_77493.png "link")

## 版本兼容性

本插件与 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`@deepseek-ai/dsh`）的版本对应关系：

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