dsh-any-background

English | 中文

一个 DeepSeek Harness 外观插件，让你完全自定义 Web 端的主题色、背景壁纸，以及分部位精细的透明度与模糊度控制。

---

截图

功能特性

• PS 风格色轮 — 在色相环上选取色相，在内嵌方形中调整饱和度与明度，实时生成 30+ 个 CSS 设计令牌。
• 精确 HSL / RGB 输入 — 通过数值精确输入颜色，与色轮实时双向同步。
• 智能取色 — 一键从壁纸提取主题色：采样可见区域、量化像素、剔除灰色/近黑/近白，选出现量最大的鲜亮色。视频壁纸自动截帧参与取色。纯客户端完成。
• 吸管取色 — 在壁纸上悬停预览颜色，点击即可选为主题色。
• 背景壁纸 — 上传任意图片作为壁纸，在视口比例的编辑器中拖动平移、滚轮缩放。
• 视频壁纸 — 上传视频作为动态壁纸：静音循环播放、刷新不丢失（落盘持久化 + HTTP 流式播放，支持 Range seek）；自动截取一帧用于预览、主题色提取与位置编辑参考。
• 位置编辑器 — 图片与视频共用同一套编辑器：拖动平移、滚轮缩放、一键重置；图片与视频的位置状态各自独立保存，互不覆盖。
• 布局模式 — 适应 / 填充 / 拉伸 / 平铺 / 居中五种排布，图片与视频通用；「适应」模式下编辑器提交的构图在窗口缩放、跨屏移动后保持一致。
• 动态生成背景 — 支持网格渐变、Shader、几何图案，可调节扩散范围、色彩强度并锁定种子。
• 分部位界面透明度 — 主背景、侧边栏、卡片面板、设置面板与壁纸各自独立滑块。
• 分部位界面模糊度 — 每个界面部位可独立调整毛玻璃 backdrop-filter 模糊（0–60 px）。
• 对话视图卡片 — 消息列表自动包裹为半透明卡片，轨迹页可整页调节透明度与模糊，让壁纸从内容后方透出来。
• 主题导出 / 导入 — 一键导出为自包含的 dsh-any-theme.json（配置 + 壁纸，视频以 data URL 内嵌），可随时导入还原。
• 文件持久化 — 所有设置保存到文件系统 ~/.dsh/.dsh-any-background-data/，不再依赖 localStorage。
• 中英双语 — 完整的中英文界面，自动跟随语言设置。
• 主题守护 — 宿主重置主题后自动重新激活自定义主题。

近期优化

• 视频壁纸全链路 — 视频按 MIME 改名落盘（wallpaper.mp4/webm/...），经插件自建 HTTP 路由流式播放；刷新、重启后自动恢复，导出配置时视频一并内嵌分享。
• 大视频二进制直传 — 上传改走 HTTP 二进制 POST 流式落盘，不再 base64 绕行 RPC（突破通道 body 上限，任意大小可传），中断自动清理临时文件。
• 视频位置编辑 — 以截帧为参考图的位置编辑器，支持缩放/移动，与五种布局模式适配；图片与视频构图各自独立持久化。
• 对话视图卡片化 — 消息列自动上卡片（边框/圆角/内边距），轨迹页整页透明度与模糊可控，视图切换时旧宿主自动还原。
• 消除启动闪屏 — 主题令牌改为通过独立的 !important 样式表注入，可抵御宿主主题服务的重置。
• 修复色轮覆盖 — 色相环绘制在饱和度/明度方形之上，方形四角不再遮挡色环。
• 灵感色板选中重置 — 在色轮中选取主题色后，灵感色板中的之前选中状态自动清除。
• 移除调试埋点 — 清理了临时的启动日志与 MutationObserver 探针代码。
• 分部位模糊隔离 — 模糊效果施加在 ::before 伪元素上，避免影响宿主固定定位的设置弹窗。

安装

方式一：npm 安装（推荐）

dsh plugin --profile web add github:Tkingxiao/dsh-any-background
# 若已发布到 registry：
dsh plugin --profile web add dsh-any-background

然后启动：

dsh web

插件会出现在设置面板的 “主题” 分类中。

方式二：npx（无需全局安装）

npx @deepseek-ai/dsh plugin --profile web add github:Tkingxiao/dsh-any-background
npx @deepseek-ai/dsh web

方式三：本地构建（开发）

lib/ 目录已提交，安装后无需构建。修改 src/ 后重新构建：

git clone https://github.com/Tkingxiao/dsh-any-background.git
cd dsh-any-background
pnpm install
pnpm run bundle
pnpm dsh plugin --profile web add "dsh-any-background"
pnpm dsh web

兼容性

• dsh web — 完全支持。
• deepseek-harness-desktop — 支持；已知 Electron 打包问题导致左侧边栏与中心区域透明度显示相反，需等待桌面端更新修复。

Star History

许可

MIT