前言¶

DeepSeek Harness（DSH）的 Web 端界面由宿主主题与组件样式决定，换皮往往要改构建或硬编码 CSS，宿主一 rebuild 选择器就容易失效。若你希望在不改对话渲染逻辑的前提下，用预设皮肤、本地字体和可调背景把界面调成可读、可持久、可离线使用的样子，社区插件 dsh-simple-ui（仓库 Trouvaille-xx/dsh-Simple-UI）就是面向这件事的外观 bundle。下面按定位、能力、安装与用法说明它做什么、怎么用，以及需要注意的限制。

这是什么¶

dsh-simple-ui 由维护者 Trouvaille-xx 发布，在 SkillHub 等社区目录中归类为 趣味换装。它不改变 DSH 的核心对话流程，而是在浏览器侧为 DSH Web 客户端提供工业风预设、圆角、背景媒体（静图 / 动图 / 视频）、品牌色与中英文字体栈；配置写在 localStorage 与 IndexedDB，刷新与重启后仍保留，且不请求 CDN 或网络字体，首屏与离线场景下界面仍可正常渲染。

核心功能¶

设置页分为四个标签：Style / Background / Colors / Fonts。

Style（风格与圆角）¶

提供八套预设：[CC]、Apple silver、deep-space terminal、neon purple、Night City 2077、red-and-white、newspaper、sketch。圆角支持 sharp / small / standard / large / extra-large，另有 0–240% 滑块（100% 为宿主原生比例，按比例作用于 --dsw-radius-* 与窗口内容圆角）。

Background（背景与可读性）¶

支持静图、GIF / APNG、MP4 / WebM 视频；媒体存入 IndexedDB，不受 localStorage 配额限制，带开关、清除与恢复默认。视频默认静音、循环、自动播放，标签页隐藏时暂停。

文件夹轮播：可选本地文件夹为图源，按文件名自然排序，间隔 5–300 秒可调，支持上一张 / 下一张；文件夹内视频会跳过。最多保留 80 张图、合计 200 MB，超出部分会提示丢弃；轮播状态、当前页与间隔在重载后保持。

可读性：scrim（0–100%）控制画面上方的遮罩；panel opacity（0–100%）控制侧栏与对话区宿主表面色对背景的遮盖程度；scrim tone 可跟随主题或强制浅 / 深。遮罩按布局单元施加一次，避免嵌套把图片埋掉；对话框与设置面板保持不透明。Background 标签中的 Check 可报告匹配的宿主容器数量、宿主表面色、媒体层与 html 背景是否就绪。

Colors / Fonts¶

Colors：品牌 / 强调 / 中性 / 文本四行，首格为自由取色，其余为色板。Fonts：中文与英文字体分开配置，字体栈本地优先并带同风格回退，避免中文缺字成 tofu。

与宿主的关系¶

颜色通过 DSH 真实主题 API（theme.overrideTokens）应用，不重写宿主组件、不替换对话渲染器。选择器匹配 CSS Module 的 local-name 后缀（如 [class*="_centerCol"]、[class*="_sidebarCol"]），容器级 token 覆盖，避免在 bundle 里写死构建 hash，以降低宿主 rebuild 后皮肤失效的概率。

持久化与隐私¶

设置键为 localStorage 的 dsh-simple-ui.preset.v1（含上次打开的标签）；背景库为 IndexedDB 数据库 dsh-simple-ui。旧版写在 localStorage 的背景会自动迁移。插件不存储或渲染 API Key，不把皮肤与背景发到模型或会话，不序列化 live Host 对象。

安装与启用¶

安装后入口在 Settings → 外观皮肤 (Appearance)。README 给出四种方式，均使用 DSH 内置安装流程，不要手写 profile 的 package.json 或 cordis.patch.yml。

方式一：让智能体执行（README 示例版本为 v1.2.0）

Install dsh-simple-ui with plugin_manager install_bundle, target =
git+https://github.com/Trouvaille-xx/dsh-Simple-UI.git#v1.2.0

方式二：插件市场

在 Settings → Plugins → Discover 添加索引源：

https://raw.githubusercontent.com/Trouvaille-xx/dsh-Simple-UI/main/market/index.json

搜索 “Simple UI” 一键安装。若无法访问 GitHub，可在同一 URL 前加 https://gh-proxy.com/。

方式三：离线包

从 Releases 下载 dsh-simple-ui-<version>.zip，解压后将文件夹绝对路径交给 plugin_manager 的 install_bundle（或使用 .tgz 配合 pnpm add file:<path>）。

方式四：本地目录

plugin_manager install_bundle, target = <absolute path to this directory>

安装后重启 DSH，以便 manifest（图标、显示名）被加载，再打开 Settings → 外观皮肤。

仓库 package.json 当前版本为 1.4.1，许可证 MIT。选用发布包或 git 标签时，以你实际安装的 revision 为准。

典型用法¶

调背景可读性¶

插件只能调节 scrim 与面板 veil，选错图再调参也难读。README 建议：背景宜暗、柔和、留白多；高亮、繁杂的照片会吞掉文字。常见组合是暗色宿主主题 + 偏暗 scrim；panel 约 65–80%，scrim 约 35–55%。若要更多露出底图，应同时降低 panel 并提高 scrim；只降 panel 容易再度不可读。

需要 AI 出图时，README 给出一组可复用的英文提示（16:9、2560×1440 及以上、低对比深色盘等），可按需改写主题词后使用。

排错背景不显示¶

在 Background 标签点 Check，查看匹配容器数是否为 0。若为 0，可能是 DSH 重命名了 CSS Module 局部类名，需要等待插件更新。

适用场景与注意¶

适合希望在同一台机器上长期定制 DSH Web 外观、需要离线可用、又不想 fork 宿主的前端开发者或个人用户。与「一切皆插件」的 DSH 生态一致，SkillHub 等目录是社区站点，与 DeepSeek / 幻方无官方从属关系。

安装前建议自行查看源码与 MIT 许可证。插件以当前 DSH 进程在浏览器中执行的权限运行；背景与皮肤数据留在本机，但不等于可以跳过你对第三方仓库的信任判断。

已知限制（摘自 README）：IndexedDB 不可用（如部分隐私模式）时，背景仅当前会话有效，页面会说明；视频背景在低端设备上可能增加 GPU/CPU 占用；宿主大幅改动 DOM/CSS Module 命名时，需插件跟进。

结尾¶

dsh-simple-ui 把工业风预设、圆角、本地字体、IndexedDB 背景与 theme.overrideTokens 着色收进一个 Web 外观 bundle，强调离线、持久与尽量抗宿主 rebuild。社区目录页：https://www.skillhub.cn/plugins/Trouvaille-xx/dsh-Simple-UI；源码与完整说明：https://github.com/Trouvaille-xx/dsh-Simple-UI。