Skip to main content

deepseek-harness-desktop/packages/skins/harbor

156Stars5Forks6Issues0Watchers

Provides a "Evening Harbor" dusk port theme for dsh web GUI: anime-style port painting background, deep twilight blue base with sunset orange as the primary color, semi-transparent panels—all without affecting model requests and conversation data.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the ningbainb/deepseek-harness-desktop monorepo — stars and activity count the whole repository.

Language
TypeScript
License
BSD-3-Clause
Branch
main
ai-agentai-coding-assistantcodexdeepseekdeepseek-harnessdesktop-appdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add --allow-build=@linxin666/dsh-client-ui-skin-harbor github:ningbainb/deepseek-harness-desktop#path:packages/skins/harbor

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin ningbainb/deepseek-harness-desktop/packages/skins/harbor for me: review the repository at https://github.com/ningbainb/deepseek-harness-desktop first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Description

「Harbor」 is a theme skin plugin for the dsh web GUI, porting the original dsh-skins Harbor skin to give the entire interface an anime-style twilight harbor painting background, with a color palette of deep twilight blue base + sunset orange primary color. It only modifies DOM appearance without affecting model requests or conversation data.

Core Features

  • Mounts a harbor twilight painting background across the full browser viewport (base64 embedded WebP, no network download required)
  • Remaps the dsh theme palette to deep twilight blue #141a2e series base + sunset orange #ff9d5c / #ffb46b primary colors (complete CSS alias token rewrite)
  • Makes large surface areas like main panel, sidebar, and menus semi-transparent to let the background painting show through
  • Injects a custom favicon (inline SVG: deep blue rounded base, sunset orange sun disk, dark water surface)
  • Real-time switching of light/dark masks following the host's base theme, with MutationObserver listening to data-ds-dark-theme changes for automatic redraw
  • Complete rollback on dispose: removes body attributes, restores background image to original value, removes injected favicon

Technical Implementation

  • Language: TypeScript + CSS Modules
  • Key Dependencies: @deepseek-ai/cordis (type-only import for effect lifecycle), lightningcss (CSS compilation), tsdown (build)
  • Architecture Pattern: DSH client-side plugin; apply(ctx) registers disposer via ctx.effect(...), reverts all writes according to ThemePresenter spec on close; does not inject any cordis services or emit events
  • Entry Files: src/index.ts (host-side empty shell) + src/client/index.ts (core logic, 102 lines)

Use Cases

Regular users who enjoy twilight harbor anime illustrations and warm twilight color schemes, wanting to give the dsh web GUI a more atmospheric visual style. After installation and activation, the entire interface background becomes a harbor twilight painting, panels become frosted semi-transparent, deep twilight blue base paired with sunset orange accent colors—without affecting any conversations or model behavior. Suitable for daily long-term use and users who want their interface to have more storytelling appeal.

Prerequisites and Compatibility

DependencyMinimum VersionDescription
DSHNot declaredNo specific DSH version declared in package; as an official bundle plugin, requires DSH to have client plugin mechanism enabled
Node.js^22.19.0 || >=24.0.0From repository root package.json#engines
PlatformCross-platformDSH web GUI client; macOS / Windows / Linux can all run the host
Native ModulesNonePure browser-side implementation, no Node native module dependencies

Installation

dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/skins/harbor

Activation is also required after installation:

dsh-skin use harbor

Configuration

No additional configuration required. The plugin automatically registers a disposer via ctx.effect(...) internally in apply(), with no need for manual lifecycle management.

FAQ

Q: Does this skin affect my conversation history or model requests?

A: No. It only modifies browser DOM (background image, panel colors, favicon), does not inject any cordis services, does not make requests, does not touch model APIs, and does not modify KV Cache behavior.

Q: Can I enable multiple skins at the same time?

A: No. Only one skin can be active at a time. When switching, the new skin takes over and the old skin is completely unloaded; switch using dsh-skin use harbor.

Q: Will it leave traces after closing?

A: No. The effect disposer reverts everything it wrote: removes body attributes, reads and restores background image to its original value according to CSSOM spec, removes the injected favicon—the original page style is fully restored. This is guarded by the "retracts everything on dispose" test case in tests/apply.spec.ts.

Q: Why doesn't the interface change after installation?

A: Installing to the profile alone does not equal activation. You still need to run dsh-skin use harbor to apply the skin.

Q: Does it support dark mode?

A: Yes. The skin follows the host's base theme for switching: in dark mode the mask becomes deep sea night sailing veil (rgba(11,14,26,...) series), in light mode it's twilight veil (rgba(20,26,46,...) series), with MutationObserver listening to body[data-ds-dark-theme] for real-time background redraw without requiring re-mounting.

Q: Where does the harbor background image come from? Why is the installation package small yet can display offline?

A: The image is embedded as base64 data URL in src/client/art.ts (~83KB of 1600×900 WebP), the skin has zero dependency on any external static resources and works offline. To change the artwork, regenerate by following the script comment at file header: node scripts/embed-skin-art harbor HARBOR_ART <imagePath> 1600.

Q: Do I need to build locally for first-time installation?

A: No. When installing via git link, the prepare script automatically builds lib/; however, with pnpm ≥10, first-time installation of git dependencies may require adding the printed package key to the allowBuilds list in pnpm-workspace.yaml and retrying.

Q: How is it different from other skins?

A: This skin's core selling point is the twilight harbor anime illustration background and deep twilight blue base with sunset orange color scheme; the same repository also has other skins available like blue-fantasy, miku, minecraft, each with different background artwork and color schemes.

Difficulty Level

Beginner — one command to install, one command to activate, no configuration items, easy for regular users.

Known Issues and Limitations

  • Only one skin can be active at a time; switching completely unloads the current skin
  • Intentionally avoids using backdrop-filter to blur ancestor elements: this would break the containing block of fixed-position overlays (like settings panels), trapping them within parent containers
  • Harbor background image is embedded base64 (~83KB), adds some bundle volume
  • No explicit known issues like TODO / FIXME / HACK found in current source code

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/ningbainb/deepseek-harness-desktop/packages/skins/harbor)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory