dsh-local-font-picker

English | 日本語

A community plugin for the DeepSeek Harness (DSH) Web UI that lets you choose installed local fonts for the interface and code surfaces.

This is a community-maintained plugin, not part of the DeepSeek Harness core distribution.

What it does

• Lists locally installed fonts through the Local Font Access API (window.queryLocalFonts()).
• Applies separate UI and code font choices through DSH Theme and Slot APIs.
• Stores only the selected font family names in browser localStorage.
• Falls back to manual font-name entry when the Local Font Access API is unavailable.
• Requires no changes to the DSH source tree and no plugin build step.

The host entry (index.js) is intentionally a no-op. All behavior runs in the Web client.

Compatibility

Latest DSH version with recorded runtime verification: 0.2.1-alpha.1. The package manifest also declares 0.2.1-alpha.2 as a compatibility target; it has not yet been runtime-verified.

DSH version	Verification
0.1.6-alpha.2	Slot/Theme contract compatibility, unload/reload cleanup, and saved-setting restore verified
0.1.7-alpha.2	Plugin load, inventory visibility, and font application verified
0.1.7-rc.1	Plugin load, inventory visibility, and font application verified
0.1.7-rc.2	Plugin load, inventory visibility, and font application verified
0.2.0-rc.1	Plugin load, inventory visibility, and font application verified
0.2.0-rc.2	Plugin load, inventory visibility, and font application verified
0.2.1-alpha.1	Plugin load, inventory visibility, and font application verified; E2E re-verified against current main 566a1b7 on 2026-10-07: clean plugin load, Settings rows visible, zero console errors, local-font permission granted then 107 PC fonts listed, UI and code fonts applied and restored after reload, and reset to defaults verified
0.2.1-alpha.2	Declared in engines.dsh; source-level compatibility reviewed, but plugin load, font application, persistence, and reset have not been runtime-verified on this version

DSH 0.2.1-alpha.2 adds built-in font-family settings. Interaction between the built-in settings and this plugin's Theme token overrides remains untested; competing settings may produce confusing display results. Other newer DSH versions are not assumed compatible until verified.

Install

Add a local checkout of this repository to the target DSH profile:

dsh plugin --profile web add <absolute-path-to-this-repository>

Restart DSH Web after installation.

Usage

Open Settings → General → Fonts.

• Use Load PC fonts to request access to the browser's local font list.
• Select or type an installed font family for the UI font and code font.
• Use Reset to default to remove the overrides and stored selections.

Button and status labels follow the copy language described above: the English list shows Load PC fonts, Japanese shows PCフォントを読み込む, and the same applies to the rest of the row.

Copy language follows the browser's preferred languages, not the DSH Language setting. The first usable preference decides: ja renders Japanese, anything else renders English.

Privacy and permissions

Using Load PC fonts invokes the browser Local Font Access API and may show a permission prompt. The browser can expose installed font metadata to this page after permission is granted.

This plugin:

• does not read or copy font files;
• does not upload font data;
• does not make network requests;
• stores only the selected font family names in localStorage, scoped to the current browser origin.

Limitations

• Local Font Access is primarily available in Chromium-based desktop browsers. Other browsers can still use manual font-name entry.
• Settings are stored per browser origin.
• DSH is still evolving rapidly, so client extension contracts can change between prerelease versions.
• The copy language is decided once when the row module loads. Changing the browser's preferred languages takes effect on the next page reload.

Check

npm run check

Contributing

Bug reports and focused pull requests are welcome. Please include the DSH version, browser, operating system, reproduction steps, and expected/actual behavior when reporting a compatibility issue.

License

MIT. See LICENSE.