@cabeta/dsh-image-theme
受 Warp 启发的图像转主题插件，适用于 DeepSeek Harness Web 客户端。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Carpon39038/dsh-image-theme#25c70fcd31b0cf36f8a0ff57b0413223daaf5d27
Image Theme 以 @cabeta/dsh-image-theme 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A Warp-inspired image theme plugin for the DeepSeek Harness web client.
Upload or drag in a picture and the plugin will:
ctx.theme.overrideTokens()—no hard-coded edits to the host UI.localStorage; nothing is uploaded.The repository includes prebuilt lib/ artifacts, so a DSH profile can install it directly from GitHub:
dsh plugin --profile <profile-name> add github:Carpon39038/dsh-image-theme
Use DSH 0.1.2-rc.1 with this plugin version. To upgrade the CLI:
npm install --global @deepseek-ai/dsh@0.1.2-rc.1
dsh --version
Restart or refresh the DSH web client, then open Settings → Image theme. Start the default Web profile with dsh web.
To install a local checkout while developing:
pnpm install
pnpm build
dsh plugin --profile <profile-name> add link:$PWD
The included .npmrc disables automatic peer installation: DSH supplies Cordis, React, and the client UI services at runtime. Development dependencies pin the official DSH 0.1.2-rc.1 packages so TypeScript checks the actual published APIs.
The browser downsamples the image to at most 96 × 96, samples at most 6,000 opaque pixels, converts RGB to CIE Lab, and runs deterministic k-means with farthest-point seeding. Five clusters are sorted by population.
This follows the same broad model as Warp's open-source theme creator, which uses Lab-space Hamerly k-means with k = 5. This implementation is written independently for the browser and uses deterministic seeding so the same pixels always produce the same palette.
The plugin keeps the image, the dark surface color, the foreground, and the accent as separate roles:
image → five-color palette → darkest color → light/dark glass surfaces
↘ selected color → contrast-safe accent
It overrides DSH's public alias tokens, including:
--dsw-alias-bg-base--dsw-alias-bg-layer-1--dsw-alias-bg-layer-2--dsw-alias-bg-overlay--dsw-alias-border-l1 / --dsw-alias-border-l2--dsw-alias-brand-primary--dsw-alias-label-primary / --dsw-alias-label-secondary--dsw-specific-sidebar-fillEvery override contains separate light and dark values, as required by the DSH theme runtime. Light mode uses a pale surface and dark text; dark mode uses a dark surface and light text. System mode follows the active host palette.
A plugin-owned fixed backdrop sits behind the DSH root. The application tokens stay translucent, allowing the image to show through while the overlay and surface opacity protect readability. Unloading or disabling the plugin disposes the token layer and removes the backdrop cleanly.
Requirements: Node.js 22+ and pnpm 10+.
pnpm install
pnpm typecheck
pnpm test
pnpm test rebuilds the distributable first, then runs palette tests and integration checks against the published DSH ThemeRuntime, LocaleRuntime, and SlotRegistry. The integration checks load the actual lib/client.js wrapper in a simulated DOM, restore an existing saved wallpaper, mount the settings component, and exercise locale changes, theme updates, disabling/re-enabling, settings-slot remounts, and plugin disposal. These checks do not start a Web server or replace a visual browser review.
The interactive design preview is in playground/:
cd playground
npm install
npm run dev
The preview imports the same palette and role-mapping modules used by the real plugin. Its generated concert background is a clean demonstration asset, not a copy of Warp UI.
src/client/palette.ts Lab conversion and deterministic k-means
src/client/theme.ts DSH token and contrast mapping
src/client/controller.ts lifecycle, persistence, backdrop, token disposal
src/client/storage.ts IndexedDB image + localStorage settings
src/client/ImageThemeSection.tsx
DSH settings page
playground/ runnable interactive visual preview
Plugin 0.1.1 targets DeepSeek Harness 0.1.2-rc.1 and Cordis 4.0.2. Client contexts now come from @deepseek-ai/cordis, and the slots service comes from @deepseek-ai/dsh-client-ui-renderer; the removed dsh-client-runtime package is no longer requested. Only packages with a browser plugin entry appear in dsh.client.inject. DSH is still moving quickly; verify the published client APIs before upgrading further.
Existing version-1 image settings and IndexedDB images are retained. The earlier light-mode contrast fix is included.
The plugin is web-only. Images and preferences are local to each browser profile and are not synchronized between devices.