dsh-font-plugin

A DeepSeek Harness (dsh) plugin: font family and ligature controls for the Web UI, rendered in Settings → Plugins → Plugin configuration with the official card style.

Features

• Font Family : Editor — overrides --dsw-font-family (UI + Markdown body text)
• Font Family : Code — overrides --ds-font-family-code (code blocks / commands / logs)
• Font Ligatures — Auto (theme default) / On / Off

Font families are entered as comma-separated font stacks (e.g. MiSans, Microsoft YaHei, sans-serif); quoted or unquoted names both work, and single names are quoted automatically with a system fallback. Saving stores exactly what you typed (a value equal to the official default is still written — an override is marked by the field's presence in the user layer, per the official plugin-configuration contract); Reset returns a field to the theme default.

Weight and size are provided by the official theme settings (Appearance) since dsh 0.1.2; this plugin intentionally leaves those to the official surface.

Defaults mirror the official @deepseek-ai/dsh-client-ui-theme base stylesheet. Changes apply after Save and persist in the dsh settings document ($DSH_HOME/settings.yaml, namespace dsh-font). UI copy is localized (zh / en) through the official ctx.locale mechanism.

Install

From npm

dsh plugin --profile web add dsh-font-plugin

From GitHub

dsh plugin --profile web add github:wtksana/dsh-font-plugin

Prebuilt bundles (lib/) are committed, so no build step or prepare authorization is required at install time.

Local development

dsh plugin --profile web add ./path/to/dsh-font-plugin

Then start dsh (restart required after bundle edits, since client bundle revisions are computed at boot):

dsh --profile web

Configuration

Open Settings → Plugins → Plugin configuration in the Web UI, expand the dsh-font-plugin card, edit the fields and press Save.

Or edit $DSH_HOME/settings.yaml directly:

dsh-font:
  editorFont: MiSans
  codeFont: MiSans
  ligatures: auto

dsh plugin remove dsh-font-plugin uninstalls both the package and its patch layer.

Development notes

This package is a dual-face plugin:

• lib/index.js — host half: registers the dsh-font settings namespace via ctx.settings.register('dsh-font', FontSettingsSchema, { applies: 'live' }). The schema is exported as FontSettingsSchema, deliberately not as Config: Cordis validates a row's own config against a plugin's Config export, and a settings schema with a required field would fail the row at boot.
• lib/client.js — browser half: dsh.client bundle (__ModuleLoader__.load + exports.apply). The style tags are created at factory materialization with data-plugin / data-plugin-css markers so the client module system inventories them for HMR teardown; the card registers into settings.plugin.item keyed by the namespace, and fonts apply via CSS variables with !important (the ui-theme base stylesheet may inject after our style tag).

Card semantics follow the official plugin-configuration contract: a field counts as overridden by its presence in the raw user layer, a Reset stages a clear (targeting the composition base, falling back to the bundled default), and saving a value equal to the official default still stores it instead of silently clearing it. The bundled defaults (DEFAULT_CFG, FONT_TOKENS) mirror the host schema defaults and the ui-theme base stylesheet — when you change a default, update both halves.

Client bundle revisions are computed at boot — restart dsh after bundle edits.

License

MIT