自定义你的DSH
给 DSH 换一套界面主题
把设计 Token 变成所见即所得的「DIY 主题」设置面板。配色、字体、背景、阴影、圆角,改完立即生效,不用写一行代码。
DeepSeek Harness(DSH)是 DeepSeek 推出的 AI 编程助手框架。通过 dsh web 启动浏览器界面,就能和 AI 对话、读写文件、执行命令、规划任务。功能强大,但外观一直比较朴素,默认只有浅色、深色、跟随系统三档。
我写了一个插件 dsh-ui-customizer,把界面定制做成了所见即所得的「主题设置面板」:进入 设置 → DIY 主题,改任何一项,界面立即生效,不需要改代码、不需要重启。
它是纯浏览器端插件:主题配置和我的方案保存在 localStorage,上传的图片放在 IndexedDB,不会上传到 DSH 服务器。安装也简单——只需要 Node.js,甚至不需要 git 和 pnpm。
效果演示
实时应用主题,改到哪亮到哪。点击下方视频封面可新标签页播放插件的实际运行效果。
它能改什么
从「总开关」「换肤中心」到配色、字体、背景、组件与「我的方案」,覆盖日常外观定制的全部诉求。
总开关
一键开启 / 关闭 DIY 主题。关闭时会移除全部覆盖,界面恢复成 DSH 官方默认外观。
换肤中心
内置 8 套一键主题模板,点击即换。选完之后仍可继续手动微调,两不冲突。
配色
品牌、强调、成功、警告、错误 5 个基础色(取色器 + 十六进制),外加中性色倾向:蓝灰、冷灰、暖灰、石墨。
字体
界面字体与代码字体下拉选择(预设字体栈),另有整体缩放(80%–140%)和文字缩放(80%–130%)两个独立控制。
背景
支持图片 URL(http(s): 或 data:,保存在浏览器内),配面板通透度与毛玻璃模糊强度。
组件风格
阴影层级与圆角滑杆,调节深度与圆润度,作用于按钮、输入框、下拉框、对话框等组件。
我的方案
把整套主题保存为完整方案并随时切换;给配置起个名字,下次一键召回。
可读性优先设计
环境表面(主背景、侧边栏)跟随通透度变透明,露出背景图;覆盖层(对话框、菜单、输入框、提示气泡)固定保持约 94% 的不透明度。无论背景调得多透明,弹窗里的文字始终清晰可读。
首次使用:面板怎么工作
安装并重启后,进入「设置 → DIY 主题」,一切修改都是实时试穿预览,点一下才算保存。
-
1
启动并完成引导启动 DSH,走完内置的模型 / API Key 初始化引导
-
2
打开面板右上角「设置」→「DIY 主题」
-
3
实时试穿所有改动立即预览,所见即所得(Try on)
-
4
保存或还原点「Apply」保存生效,「Revert」撤销未保存改动,「Reset to default」恢复出厂值
界面长什么样
装上之后,它和官方界面无缝融合。
安装(网页端插件)
只需要 Node.js(带 npx)即可运行 DSH Web profile;最简单的路径不需要 git 或 pnpm。
方案 A:安装脚本(只需 Node.js)
-
1
下载仓库 ZIP 并解压获取代码与 install-web.ps1 脚本
-
2
运行安装脚本在 PowerShell 中 cd 到解压目录后执行,脚本会把插件复制进 web profile 并登记 loader,可重复运行
-
3
启动 DSH Web
-
4
在浏览器打开「设置」→「DIY 主题」
若 PowerShell 提示脚本未签名无法加载:Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass(仅对当前窗口生效,关闭后自动恢复),或使用 powershell -ExecutionPolicy Bypass -File .\install-web.ps1。
方案 B:DSH 插件命令(需 git + pnpm)
-
1
安装插件依赖
dsh plugin add只安装依赖;本插件是 classic bundle(无 dsh.bundle),不会自动激活 -
2
手动登记 loader编辑 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml,否则面板不会出现
-
3
完全重启 DSH Web 并刷新停掉后重新运行,再刷新浏览器
若 dsh 不在 PATH 中,用 npx @deepseek-ai/dsh plugin --profile web add "git+https://github.com/Final-LX/dsh-ui-customizer"。注册 loader 时确保 cordis.patch.yml 包含:
只运行 dsh plugin add 而没有 loader 行,面板不会显示。首次使用仍需按 DSH 的模型 / API Key 引导完成配置。
让 AI 帮你安装
想让 DeepSeek Harness、Claude、ChatGPT 等 AI 代理帮你装?把下面这段自包含的提示词复制给 AI 即可,它会按步骤完成安装与验证。
数据、安全与兼容性
数据只存本地
主题配置与我的方案保存在 localStorage,上传的媒体(如有)存放在 IndexedDB,不会上传到 DSH 服务器。
远程图片加载
远程图片 URL 能否加载取决于 scheme、浏览器安全策略,以及服务器的 CORS / Referrer 响应。
随 DSH 演进
DSH 迭代很快,官方 Token、Slot 与页面结构可能变化并影响兼容性。升级后若某个设置失效,可重跑测试并提交差异。
更换平台不同步
主题数据归属浏览器。不同浏览器 / profile 各自保留一份;DSH 服务器上的会话数据因为是服务端存储,才会跨端同步。
常见问题与排查
装好了却看不到效果?先看这里。
dsh web 再刷新。npm test(执行 tools/test-tokens.cjs)可定位差异,并把列出的 Token 提交为 Issue。