exmachina67/dsh-theme

dsh-theme

为 DeepSeek Harness（DSH）Web 界面「美容」的插件：深色玻璃拟态主题 + 天蓝强调色 + 可选的背景视频/图片，附带圆角滚动条、柔和选中高亮与过渡动画。

功能

- 深色玻璃主题：半透明面板 + 侧边栏毛玻璃（backdrop-filter 模糊）。
- 背景视频 / 图片：autoplay + muted + loop，铺满屏幕，可换本地文件或 http(s):// 链接。
- 三个实时滑块：背景透明度、面板透明度、毛玻璃模糊。
- 背景文件夹选择器：扫描任意本地目录里的视频 / 图片，下拉一键切换。
- FFmpeg 转码：把任意视频转成浏览器可播的 MP4（需本机已安装 FFmpeg）。
- 一键开关：随时「启用美化皮肤」或「恢复官方默认皮肤」，选择存进浏览器 localStorage，刷新后保持。

安装

推荐从 GitHub 安装：

npx @deepseek-ai/dsh plugin --profile web add github:exmachina67/dsh-theme

或用本地目录安装：

npx @deepseek-ai/dsh plugin --profile web add

装完后重启 DSH Web：

npx @deepseek-ai/dsh web

然后进入 设置 → 插件 → 页面美化 标签页即可配置。

原理：package.json 的 dsh.bundle.patch 让 dsh plugin 自动把包名写进
dsh.profile.bundles；cordis.patch.yml 把插件挂进组合；dsh.client 声明让
浏览器加载 client.js（主题 CSS + 设置标签页）。

使用

进入 设置 → 插件 → 页面美化：

| 控件 | 说明 |
| --- | --- |
| 背景文件夹 | 填一个本地目录，点「刷新」列出其中的视频 / 图片 |
| 从文件夹选择 | 下拉选择某个文件作为背景 |
| 背景文件 | 直接填文件名 / 本地绝对路径 / http(s):// 链接；留空用默认视频 |
| 转换为 MP4 | 用 FFmpeg 把「背景文件」里填的视频转成可播 MP4 |
| 背景透明度 | 视频上方可读性遮罩的强度（左不透明 / 右透明） |
| 面板透明度 | 面板的透明程度 |
| 毛玻璃模糊 | 面板 / 侧边栏的模糊半径 |
| 启用 / 恢复 | 一键启用美化，或恢复官方默认外观 |

所有选择存进浏览器 localStorage（键前缀 dsh-theme:），刷新后保持。

默认背景

默认背景视频读取 assets/wallpaper.mp4（或 .webm），由 host 半的
/dsh-theme/video 路由以 HTTP Range 流式提供（支持拖动 / 循环，不会把整个
文件读进内存）。

⚠️ 本仓库不包含大体积视频（GitHub 单文件上限 100MB）。请把背景视频放到
assets/wallpaper.mp4，或直接用设置里的「背景文件夹」指向你自己的目录。

技术实现

| 文件 | 职责 |
| --- | --- |
| index.js（host 半） | 注册 /dsh-theme/video、/dsh-theme/assets、/dsh-theme/local、/dsh-theme/list、/dsh-theme/convert 等路由；视频用 HTTP Range 流式，本地文件路由仅回环可用 |
| client.js（浏览器半） | 注入主题 CSS、注册「页面美化」设置标签页、读取 / 写入 localStorage |
| cordis.patch.yml | 组合补丁，把插件挂进 DSH |
| convert.js | dsh-theme-convert 命令，用 FFmpeg 转码 |