前言¶
在 DSH 桌面端里长时间写智能体、调插件，界面往往是默认主题加纯色底。想换壁纸或做一点半透明面板，常见做法是改宿主样式或 fork 主题，回滚成本高，也容易和后续 DSH 更新打架。社区插件 DSH UI Beautify（包名 dsh-ui-beautify）把改动收在插件自己的 DOM 与样式里：不碰布局、不改宿主代码，设置落在本机 localStorage，卸载或关模式可以逐层拆掉。下面介绍它是什么、能做什么，以及如何在 Windows 上安装与日常使用。
这是什么¶
DSH UI Beautify 由维护者 Rad-Weed 发布，在 SkillHub 插件目录 中归类为「趣味换装」。当前资料中的版本为 v0.8.15，路由前缀 /dsh-ui-beautify/*，页面侧全局对象为 __DSHUI__，配置键前缀 __dshui.*。
定位可以概括为：给 DSH 桌面端页面加壁纸与毛玻璃效果的轻量美化；附带开屏动画、方块光标、标题栏「重启」键与屏幕内诊断，并适配 DSH 深浅色主题。支持环境为 Windows 10/11 与 DSH 桌面端（Chromium/Electron）；引擎要求 DSH >=0.2.0-rc.0、Node >=18（开发与测试侧）。
核心功能¶
功能以 README 中的说明为准，本节只列已核实项。
壁纸与浓度¶
| 模式 | 说明 |
|---|---|
| 纹理（multiply） | 整页乘法混合，白底正文仍较清晰 |
| 背景（backdrop） | 图片铺在最底层，面板自然叠在图上 |
两种模式各自有浓度滑块，换图带淡入淡出。深色与浅色主题的浓度默认值不同（例如深色纹理默认 0.85、背景 0.7；浅色为 0.49 / 0.5），滑块按主题分别保存。
毛玻璃与气泡¶
可对主表面、二级面板、问答窗口、输入框、气泡等做模糊、白层与透明度调节。气泡会取原色，并支持透明、模糊与自定义颜色；代码块与 chat 高亮同样做适配。
深浅色主题¶
主题判定以 DSH 的 body[data-ds-dark-theme] 为主；color-scheme、token 亮度与系统偏好仅作兜底。深色壁纸优先读桌面上的 DeepSeek 暗夜模式.png（兼容大小写变体），没有则用包内 assets/deepseek-dark.webp。浅色仍使用原来的两张壁纸（如 deepseek 4k、deepseek 黑白无水面）。主题切换时会重算图层、毛玻璃、气泡与面板配色。
开屏、光标与 AI 视效¶
- 开屏：六幕授权序列、欢迎卡片与音效；可重播、跳过或关闭，跳过不阻塞启动。
- 方块光标：命令提示符风格；
Ctrl+Shift+Alt+M可开关动效。 - AI 思考视效：在纹理/背景模式下，思维链与回复左侧细线加淡渐变，便于逐行阅读。
重启键与诊断¶
标题栏可注入原生「重启」按钮；启用时可能通过随包脚本对 app.asar 做可还原的壳补丁（需完全退出 DSH 一次）。与独立插件 dsh-restart-key 可共存：对方已提供按钮时本插件让位，否则接管（约 1.8s 重试）。
诊断不依赖控制台：屏幕内面板，或访问 /dsh-ui-beautify/status.json、/dsh-ui-beautify/diag.json，页面 hash #dshui-diag（旧 #dsniang-diag 仍兼容）。
副作用与隐私（README 声明）¶
| 项 | 说明 |
|---|---|
app.asar |
仅在启用重启键相关链路时修改，带标记与双 SHA 备份，可还原 |
| 网络 | 无请求、无遥测 |
| 用户数据 | 设置仅存本机 localStorage（__dshui.*） |
许可证为 MIT；开屏结构参考了 MIT 项目 dsh-startup-screen，视觉与实现为本仓库原创。DSH 为各自权利人产品，本项目与官方无隶属关系。
安装与启用¶
官方 README 未提供 dsh plugin add github:... 一类命令，安装方式为本地目录安装。
要求：Windows 10/11、DSH 桌面端。
- 下载发布包
dsh-ui-beautify-0.8.15.zip并解压； - 在 DSH 插件管理中选择安装本地目录，
target使用绝对路径，例如：
file:C:/path/to/dsh-ui-beautify
- 重启 DSH 一次。
安装会在 profile 的 node_modules/dsh-ui-beautify 写入一项并启用 bundle；不安装系统服务、不写计划任务。若使用 pnpm 且遇到 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION，安装时可指定官方 registry：https://registry.npmjs.org/。
注意：插件以当前 DSH 进程权限运行；启用重启键会涉及壳补丁与 PowerShell 安装器（见 README「外部副作用」）。安装前建议阅读仓库源码与 LICENSE，自行评估是否接受对 app.asar 的可还原修改。
典型用法¶
左上角胶囊面板¶
点一下胶囊可开/关设置面板；按住可拖动位置。面板内可：
- 在「关闭 / 纹理 / 背景」之间切换模式；
- 按当前主题选择壁纸（深浅偏好分开保存）；
- 调节浓度、白层、毛玻璃、气泡等，即时生效并自动保存；
- 查看快捷诊断、重启键状态、开屏开关等。
快捷键¶
Ctrl+Shift+Alt+1：关闭美化Ctrl+Shift+Alt+2：纹理模式Ctrl+Shift+Alt+D：打开面板Ctrl+Shift+Alt+I：诊断Ctrl+Shift+Alt+M：光标动效开关
控制台 API¶
在页面中可通过 window.__DSHUI__ 调用，例如：
__DSHUI__.status()
__DSHUI__.setMode('off') // 'off' | 'multiply' | 'backdrop'
__DSHUI__.setOpacity(0.5)
__DSHUI__.setFrostEnabled(true)
__DSHUI__.switcher()
__DSHUI__.splash.replay()
__DSHUI__.restart.state()
完整 API 表见 GitHub README；diagnose()、setScrim、setFrostBlur、setBubbleFx、splash.skip() 等用法以仓库文档为准。
适用场景与注意¶
适合：在 Windows 上使用 DSH 桌面端、希望壁纸与毛玻璃美化且不想改宿主布局的开发者；需要本机诊断与可选标题栏重启入口的用户。
不适合或需谨慎：非 Windows 环境（README 仅声明 Win10/11）；无法接受重启键链路对 app.asar 补丁的用户应只使用视觉功能或关闭重启相关选项，并阅读 restart/README.md 与 restart/USAGE.txt。
仓库自测（README 记载）：host 30/30、client 102/102、reload-ui 6/6（离线）。开发与出包可参考：
node test/host.test.mjs
node test/client.test.mjs
powershell -ExecutionPolicy Bypass -File tools/build-dist.ps1
结尾¶
DSH UI Beautify 把壁纸、毛玻璃、主题适配和诊断收在一个 MIT 插件里，改动限定在插件节点与可选壳补丁，并声明无网络与无遥测。若要查看分类与简介，可打开 SkillHub 目录页；安装包、版本说明与 HANDOFF 开发记录见 GitHub：Rad-Weed/DSH-UI-Beautify。
