dsh-FreeBackground

DeepSeek Harness WebUI 背景美化插件 —— 自由设置 WebUI 界面的背景图片。

A WebUI background customizer plugin for DeepSeek Harness: upload images or pick a folder, show a single picture or run a slideshow, and tune transparency and blur — adapted to both light and dark themes.

功能特性 / Features

• 上传本地图片：单张/多选上传，或直接选择整个文件夹批量导入（每张 ≤ 12MB，最多 100 张）
• 组件透明化：侧栏、面板、卡片等所有界面表面半透明，背景图完整透出；下拉/弹层（模型选择、命令等）保持近不透明，文字不会与背景重叠
• 两种播放模式：单张图片 / 幻灯片播放；顺序或随机切换，间隔 1–600 秒可调
• 透明度与模糊：图片透明度、界面透明度、图片模糊度（0–30px）独立调节
• 深浅色适配：浅色/深色主题自动匹配；深色模式下弹层为深底浅字，不会出现白底白字

安装 / Install

1. 构建（需要 esbuild；在 dsh 源码树内构建可设置 DSH_HARNESS_ROOT 指向 checkout 路径）：

   pnpm install -D esbuild    # 或使用环境内已有的 esbuild
   pnpm build
   

2. 将包放入 dsh profile 的解析链（示例为 web profile）：

   ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-free-background
   

3. 在 ~/.dsh/profiles/web/cordis.patch.yml 中追加插件行（配置热更新，无需重启）：

   - insert:
       - id: free-background
         name: 'dsh-free-background'
   

4. 刷新浏览器页面（F5），插件即生效。卸载：删除 patch 行并移除符号链接。

使用方法 / Usage

打开 设置（左下角）→ 背景 页签：

控件	说明
启用背景图	总开关；关闭后界面恢复默认不透明外观
播放模式	单张图片 / 幻灯片播放
上传图片 / 选择文件夹	导入图片到图片库（幻灯片模式轮播图库全部图片）
播放顺序 / 切换间隔	顺序或随机；间隔 1–600 秒
图片透明度 / 界面透明度 / 图片模糊	三个独立滑块，实时生效
图片库	缩略图、设为背景、删除、清空

刷新页面后背景与设置自动恢复（状态保存在 dsh 进程内）。

项目结构 / Layout

src/index.ts            # Host 半区：/freebg JSON API（webServer 路由，内存存储）
src/client/index.tsx    # 浏览器半区：背景样式引擎 + 幻灯片 + 设置页
scripts/build.cjs       # esbuild 构建（产出 lib/index.js 与 lib/client.js）

lib/client.js 为 DeepSeek Harness Web 插件标准格式（window.__ModuleLoader__.load 闭包工厂，外部依赖仅为平台模块表）。

License

MIT