dsh-background-swapper
DeepSeek Harness 插件：将照片设为 Harness 的背景，为照片库命名并分页浏览，还可对上层界面进行着色、模糊或淡化处理。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:DevTarlow/dsh-background-swapper#819ee767d55d2e4eeae8a6bb4208910155f62555
Background Swapper 以 dsh-background-swapper 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Put your own photo behind the DeepSeek Harness.
The DeepSeek Harness with an ocean photo behind the interface The DeepSeek Harness with a blurred space photo behind the interface
Two different backgrounds. The space photo on the right has Blur turned up.
Swap Background sits just above Settings in the left sidebar. Click it and a small panel opens where you add a photo, give it a name, and keep a set of favorites. Three presets set the balance between the interface and the photo in one click, five sliders fine-tune how the photo looks and how much of it shows through, and any balance you like can be saved under its own name.
You need the DeepSeek Harness, running either in a browser or in the desktop app.
In the Harness, open Plugins in the left sidebar.
Press Install.
Paste this repository's address:
https://github.com/DevTarlow/dsh-background-swapper
Install it, then refresh the page.
If you would rather work from a local copy, clone the repository and paste the folder's full path instead. The install dialog accepts a GitHub address, a package name, or a local folder.
The plugin is added to your Harness, so it stays available in every session until you remove it.
Press Escape or click anywhere outside the panel to close it.
Your photos live with the Harness, not inside the plugin:
~/.dsh/storages/background-swapper/
├── index.json your names, the current photo, the slider settings, and your saved looks
└── images/ one file per photo
The Harness keeps its data in ~/.dsh unless you have moved it. On Windows the
folder is %USERPROFILE%\.dsh\storages\background-swapper.
Because the photos are stored there, the same library and the same look appear in every browser you open and in the desktop app, as long as they are pointed at the same Harness.
To back your library up, copy that folder somewhere safe. To start over, delete it: the plugin recreates it the next time it loads.
These four values are read from cordis.patch.yml when the plugin loads. Change one and restart the Harness.
| Setting | Default | What it does |
|---|---|---|
pageSize | 6 | How many photos show per page in Recent. |
maxImageBytes | 16777216 (16 MB) | The largest photo that can be uploaded. |
maxDimension | 2560 | The longest side a photo is scaled down to before it is saved. |
dataDir | empty | Where the photos go. Empty means the folder shown above. |
If you would rather keep your own values, put the same override in your Harness profile's patch file instead, so a later reinstall cannot replace it:
- id: background-swapper
config:
pageSize: 9
maxImageBytes: 33554432
A new install starts on the Wallpaper preset — Background opacity 20%,
Element opacity and Sidebar opacity 85% — with Tint None and
Blur off. The Reset link beside each slider returns it to those values,
which is the balance Wallpaper sets. Looks you save start empty and live in
index.json with the rest of your settings.
The photo is too faint, or too strong. Use Background opacity. Lower shows more photo in the open page, higher makes that page more solid. At 100% the photo only shows through the panels and the sidebar; with Element opacity and Sidebar opacity at 100% as well nothing shows at all, and the panel says so.
The interface is too see-through to read. Raise Element opacity, or Sidebar opacity if it is the left column that is the problem. Either solidifies its own layer without taking the photo off the page, so you no longer have to choose between the two. The sliders fade different layers: Background opacity the page everything sits on, Element opacity the panels over it, Sidebar opacity the left column beside it.
Text is hard to read over the photo. Set Tint to darken it, or Blur to soften it. Both keep the effect; raising an opacity slider only hides more of the photo behind that layer.
What do the presets change? Only the three opacity sliders — the shipped ones and anything you save. Tint and Blur stay exactly where you left them, so trying a preset never undoes a tuned photo. Solid keeps the photo selected but hides it behind a fully opaque interface; Turn off clears the photo instead. Both leave it in Recent, and one click brings it back.
I saved a look. Where did it go? Into the preset row, beside Wallpaper,
Glass and Solid, with a small × on its right to remove it. It is stored
in index.json with the rest of your settings, so it is there in every browser
and in the desktop app. Six is the most that are kept.
Why does the sidebar look darker than the rest? Two see-through surfaces sit behind the sidebar and only one behind the main area, so at the same slider setting it always reads a little more solid. Lower Sidebar opacity to even them up.
Does it work in another browser? Yes. The library and the settings are stored with the Harness, so any browser pointed at it sees the same thing.
Can each session have its own background? No. One background applies to the whole app.
What image types can I use? PNG, JPEG, WebP, GIF and AVIF. Animated GIFs keep animating. SVG files are refused.
My photo looks different after uploading. Anything longer than 2560 pixels on a side is scaled down before it is saved, and a scaled photo is re-encoded, which drops camera metadata such as the date and location. Animated GIFs are never scaled.
Open Plugins, find dsh-background-swapper, and uninstall it. The interface goes back to normal immediately. Your photos stay in the folder above, so delete that folder yourself if you also want the disk space back.
Two files plus a storage helper, and no build step.
| File | Runs in | Owns |
|---|---|---|
| index.js | the Harness | apply(ctx, config) and the /__background-swapper routes |
| store.js | the Harness | index.json and images/ on disk |
| client.js | the browser | the background painter and the sidebar panel |
Things to know before changing it:
dsh with no build.html::before, a fixed pseudo-element behind
everything, so the application's own elements are left alone.color-mix() of the same palette tones they already point to. The aliases are
split into the ground the frame and body paint, the panels raised over it, and
the sidebar column, and each slider fades one group. No application class name
is targeted, so renaming one breaks nothing. A saved look is exactly that
group of alphas plus a name, which is why loading one changes nothing else.document.body or appends a stylesheet
by hand.maxImageBytes is enforced on the Harness side and
maxDimension in the browser.PATCH /state refuses a field it does not know instead of ignoring it.
The two halves ship together but load separately — a browser half a version
ahead would otherwise have its write answered 200 and dropped, which the
panel shows as a setting that saved and then vanished at the next reload.DEFAULT_SETTINGS in
store.js, and are served with every GET /list so the panel's
Reset links cannot drift away from them. The panel's Wallpaper preset
repeats those same numbers, so a fresh library and a Reset both light it up:
change one and the other belongs in the same commit.npm test
Both harnesses run in under a second and need no browser.
test/host.test.mjs mounts the routes on a bare node:http
server and drives the whole surface over real HTTP.
test/client.test.mjs loads the browser bundle against a
stub module loader and checks the registrations, the exact CSS the painter
emits, and the panel's preset row: loading a shipped look, saving one of your
own, and removing it.
Edit client.js and refresh the page. Edit index.js, store.js or
cordis.patch.yml and restart the Harness. AGENTS.md has the full
loop.
MIT.