dsh 换皮肤教程：client ui 主题安装与界面定制化
给 dsh 网页界面换肤有两条路：一键装现成主题（如流萤），或用 dsh-client-ui-custom 框架自己调壁纸、毛玻璃和透明度。每一步都配实拍截图，可深链回源视频对应秒数。
最近更新: 2026-10-02
dsh 默认网页界面干净但素——深色底、一个输入框，仅此而已。搜索联想里「dsh client ui」「dsh client ui aqua」都是真实查询，而搜索结果几乎全是 GitHub 仓库和 B 站视频，缺一篇能照着做的图文。本页就是这篇图文：怎么装一套现成主题皮肤、怎么用定制化框架调出自己的界面。文中安装与卸载命令均已于 2026-10-02 对照两个 GitHub README 逐字复核。
两条路线互不重叠：流萤这类主题皮肤一次安装整体换装——壁纸、开屏变身动画、音效全带上；dsh-client-ui-custom 这类定制化框架保留原生布局，把控制权交给你：主题预设、毛玻璃、壁纸、透明度、字体。想先浏览都有哪些界面插件，看 UI 合集。 DSH UI 插件合集
太长不看
- ▸三种装法：内置插件市场搜索安装、聊天框粘贴 GitHub 仓库链接，或一行命令。
- ▸dsh-theme-firefly（Liu-ZA-81）是一整套星穹铁道流萤皮肤：动态/静态壁纸、开屏变身动画、背景音乐与打字音效。
- ▸dsh-client-ui-custom（yoli-mi）是框架：六套主题预设、四档玻璃、任意壁纸、透明度滑杆——改动即时生效，无需重启。
- ▸主题互斥，后加载的赢；一条命令卸载或注释补丁文件里的一行，随时还原原生界面。
从素装 dsh 到主题化界面，逐步实操
第一部分 · 装一套现成主题（流萤）
- 1
找主题：市场搜索、粘贴链接或一行命令
打开 设置 → 插件 → 插件市场，搜「firefly」。Liu-ZA-81 的 dsh-theme-firefly 卡片（录制时 ★7，GitHub 现为 ★30）挂在「主题与外观」标签下：立绘/动态壁纸、萤火虫霓虹配色、开屏变身动画、萤火虫粒子、背景音乐、打字音效与按对话触发的表情包彩蛋。也可以把 GitHub 仓库链接直接粘进聊天框让 dsh 自主安装，或者跑 README 里的 npm 安装命令。
$dsh plugin --profile web add dsh-theme-firefly
路线 B：把插件仓库链接粘进聊天框，让 dsh 自主安装。（t=20）看源视频 0:20 
路线 A：设置 → 插件市场 → 搜「firefly」→ 在 dsh-theme-firefly 卡片上点安装。（t=40）看源视频 0:40 - 2
重启 dsh web，看开屏变身动画
装完重启 dsh web 并刷新页面：黑屏中央淡入绿色辉光标题卡——「流萤 // FIREFLY · 萤火归位 · 变身完成」。点任意处可跳过；按 README 说明每次刷新都会播放，系统开启「减弱动态效果」时自动跳过。
装完首次刷新：变身动画播放，点任意处跳过。（t=60）看源视频 1:00
第二部分 · 用 dsh-client-ui-custom 精调
- 4
装定制化框架 dsh-client-ui-custom
想突破一套固定皮肤，装 yoli-mi 的 dsh-client-ui-custom（GitHub ★38，2026-09-28 仍在更新；宣传视频就是插件作者本人录的）。它带七个相互独立的功能模块：外观、快捷键、用量统计、历史记录条、用户消息 Markdown 渲染、插件市场、动效。所有功能默认关闭——不配置时界面与原生完全一致——还可用 features 白名单只装想要的模块。
$dsh plugin --profile web add git+https://github.com/yoli-mi/dsh-client-ui-custom.git - 5
外观页：六套预设、玻璃档位、任意壁纸
设置 → 外观是核心页。六套内置预设——Ink Teal 黛青、Ink Blue 黛蓝、Dusty Rose 藕荷（帧内选中项）、Apricot Gold 杏金、Mist Gray 雾灰、Ink Violet 墨紫——一键整体换色；你自己的壁纸 URL 叠在预设之上。卡片下方是玻璃档位（off/轻玻璃/强毛玻璃/mica）、CSS 渐变叠加、暗色遮罩滑杆（帧内 16%）与壁纸调性。小窗预览和全屏预览（F2 退出）实时呈现，所有改动即时生效，无需重启。
框架核心页：上排预设卡，下面是自选壁纸与玻璃控制——全部实时生效。（t=122，源：九月在科普）看源视频 2:02 - 6
历史条、Markdown 渲染和其他开关
插件还扩展了原生「通用设置」页：新增悬浮历史条，位置可选（帧内为左侧）、条数可选最近 5/10/20 条或全部；另有你自己消息的 Markdown 渲染开关。设置侧栏也因此多出框架带来的「外观」「快捷键」「用量」三个新页。
不止换脸：框架还往原生设置里加了悬浮历史条与 Markdown 渲染开关。（t=70）看源视频 1:10 - 7
它的插件市场：3810 个 GitHub 插件免重启直装
dsh-client-ui-custom 在 设置 → 插件 里加了第二个市场：自动发现带 dsh-plugin 主题的 GitHub 仓库、按星标排序（录制时共 3810 个），marketplaceUrl 可换成自己的清单。点「安装」复制 YAML 配置，粘贴到 ~/.dsh/profiles/web/cordis.patch.yml——该文件被实时监听，保存即生效，无需重启。
第二个市场：按星标发现 GitHub 插件，经 cordis.patch.yml 免重启安装。（t=150）看源视频 2:30
第三部分 · 验收与还原
- 8
验收：主题化首页，侧栏和模型选择都在
回到首页：壁纸主题已整体套用，而功能件纹丝没动——工作区侧栏（演示、PDF-word、Quiz…）、新会话按钮、模型选择器（DeepSeek-V4-Flash）都在原位。皮肤换的是脸，不是应用本身，会话与工作区不受影响。
框架的承诺：壁纸配色是你的，布局行为还是原生的。（t=210）看源视频 3:30 - 9
还原：一条命令，或注释一行
不喜欢就卸载：跑下面这条 remove 命令后重启 dsh web。README 特别提醒主题互斥——每个主题都调用 setTheme 并注入 !important 令牌样式，后加载的赢——所以同时只开一个主题，想退回去就注释掉 ~/.dsh/profiles/web/cordis.patch.yml 里对应那一行。dsh-client-ui-custom 甚至不用卸载：清空配置即回到原生界面。
$dsh plugin --profile web remove dsh-theme-firefly
常见问题
装 dsh 皮肤之前，大家最常问的几件事。
dsh 的 client ui 和主题皮肤是官方的吗？
不是。dsh 官方网页界面只有朴素的浅色/深色样式，本页所有皮肤都是社区插件。「client-ui-*」是社区命名族而非官方命名空间——deepseek-ai 组织下没有任何 dsh-client-ui-* 仓库（2026-10-02 经 GitHub API 实查）。本页涉及的两个插件分别是 yoli-mi/dsh-client-ui-custom 与 Liu-ZA-81/dsh-theme-firefly。
「dsh client ui aqua」是什么？有 aqua 主题吗？
它是搜索联想词，我们没能证实存在对应产品：两份 README 都没提 aqua 主题，检索中也没有出现这样的仓库（2026-10-02）。想要青蓝色调的 dsh，可行路线是 dsh-client-ui-custom：设一张蓝青色壁纸、打开从壁纸自动取色，再存成自己的预设。
主题装错了或想还原默认界面怎么办？
跑 dsh plugin --profile web remove dsh-theme-firefly 后重启 dsh web，或者到 ~/.dsh/profiles/web/cordis.patch.yml 里注释掉对应插件行。反正同一时间只有一个主题生效（后加载的赢），停用一个不会弄坏另一个。dsh-client-ui-custom 清空配置即回到原生界面，七个模块默认全是关闭的。
这些主题手机浏览器上能用吗？
皮肤装在 dsh web 服务端的 profile 上，任何浏览器打开同一实例都会套用——流萤 README 也写明壁纸跨重启、跨浏览器持久。不过两支视频演示的都是桌面布局；手机排版另有同家族的社区 mobile-adapt 类插件。
能同时开两个主题插件吗？为什么我的主题装了没生效？
只开一个。每个主题都会调用 dsh 的 setTheme 并注入 !important 令牌样式，装两个时后加载的会悄悄覆盖前者——流萤 README 明确说了这点，建议把竞争主题的补丁行注释掉。如果只装了一个还是原生脸，检查 cordis.patch.yml 里补丁行是否真的写入了，并重启 dsh web。
装皮肤会动我的会话和数据吗？
框架自述为纯前端插件、零 shell 改动、所有功能默认关闭，卸载后即恢复原生界面。安装确实会往 web profile 补丁文件追加行，所以动手前备份一份 ~/.dsh/profiles/web/cordis.patch.yml 更稳妥——它也正是你还原时要编辑的那个文件。
相关攻略
dsh 界面与插件工具箱的其余部分。
来源与署名
全部截图来自两支 B 站实录，每张都深链回原视频对应秒数；正文为原创。九月在科普是 dsh-client-ui-custom 插件作者本人（片内烧录水印是其改名前昵称「爱偷懒的七月」）；文刀丞的视频是流萤 README 官方链接的演示视频。安装与卸载命令逐字引自两个 GitHub README，2026-10-02 经 GitHub API 复核；流萤插件在 2026-08 录制时显示 ★7，现为 ★30。