DSH Eye Care
English | 中文
Warm Light, Warm Dark, System-Aware.
A DeepSeek Harness Web profile bundle that replaces cool white interface colors with six warm semantic themes while leaving the native Appearance preference intact.
DSH Eye Care settings row in warm light mode with Day and Warm selected
DSH Eye Care settings row in warm dark mode with Auto and Warm selected
What it does
DSH Web's built-in Light and Dark themes are cool-toned. Eye care adds a warm light palette, a warm dark palette, and an automatic scheme without a global sepia filter or image transform.
- Four operating modes:
off, auto, light, and dark.
- Three warmth levels:
soft, balanced, and warm.
- Six concrete themes registered through the official ThemeService.
- Real semantic tokens for backgrounds, text, borders, buttons, sidebar, bubbles, inputs, code blocks, scrollbars, and Shiki colors.
- Native Appearance stays authoritative: choosing Light, Dark, or System turns eye care off and keeps that newly selected theme.
- Loopback persistence stores the selection in Host settings; remote browsers keep the selection in the current process.
Preview
The screenshots above show the General settings row in warm day mode and warm night mode. Day and Night are explicit; Auto follows prefers-color-scheme at the selected warmth. The row also renders an aria-live status and keyboard-visible focus states.
Install
Install the public npm package into the Web profile:
dsh plugin --profile web add @anionex/dsh-eye-care
For local development, replace the package name with the checkout's absolute path or a locally packed tarball. DSH_HOME defaults to ~/.dsh; point it at a temporary directory to try the bundle without changing your main profiles.
Restart or start the Web UI:
dsh web
Open Settings → General → Eye care and choose a mode and warmth.
Theme matrix
| Scheme | Soft | Balanced | Warm |
|---|
| Light | eye-care-light-soft | eye-care-light-balanced | eye-care-light-warm |
| Dark | eye-care-dark-soft | eye-care-dark-balanced | eye-care-dark-warm |
How it works
The Host half uses the legacy eye-care Settings namespace or the modern dsh-eye-care Config projection, and exposes the loopback-only /eye-care RPC route. Writes are serialized and fenced by expectedRevision; a conflict re-reads the Host snapshot and retries the latest intent.
The browser half registers six palettes and injects the General-settings row. On newer hosts it uses the public theme token layer so ConfigForms refreshes cannot clear the warmth. The original built-in Appearance preference is retained across reloads and restored on disable. Legacy hosts continue using registered themes. The controller removes its listeners, themes, and token layer on disposal. Remote browsers keep preferences process-local.
Compatibility and limitations
- Candidate 0.1.2 targets DSH
0.2.0-rc.2; Web installation, loading, mode changes, and persistence were tested, with a 0.1.5-rc.1 regression profile. Publication is pending.
- Requires a DeepSeek Harness Web profile with the standard
settings, connection, locale, slots, and theme services.
- A native Appearance change is treated as an explicit opt-out by design.
- Remote browser sessions do not persist eye care back to the Host.
- There is no global color filter; all colors come from named semantic tokens.
- The package is pre-release and follows the profile bundle format; its generated theme ids are stable while the bundle is installed.
Development
cd dsh-eye-care
pnpm install --frozen-lockfile
pnpm run check
pnpm run test
pnpm run build
Run the optional clean-profile installation test:
DSH_EYE_CARE_PROFILE_E2E=1 pnpm exec vitest run tests/profile-install.e2e.spec.ts
License
MIT
