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 the selected UI and code fonts through the built-in DSH Theme API (
ctx.theme.setFontFamily(role, value)); persistence, CSS application, and reload restore belong to the DSH core settings.
- Keeps no settings of its own — no
localStorage, no Theme token overrides. The built-in font settings and this plugin row always read and write the same core state.
- 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
Since 0.3.0 this plugin delegates font state to the DSH core (ctx.theme.setFontFamily); it stores nothing of its own. Earlier plugin releases kept their own copy in localStorage plus Theme token overrides. The table records runtime verification per listed state; rows up to 0.2.1-alpha.1 were recorded on the pre-0.3.0 mechanism.
Latest DSH version with recorded runtime verification: 0.2.1-alpha.3, runtime-verified against the live app on 2026-10-15.
| 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 | engines.dsh requires the core font-family settings added in this version; core-delegation behavior has not been runtime-verified on this version |
| 0.2.1-alpha.3 | 0.3.0 core-delegation behavior verified: plugin load, font settings rows, core apply, persistence across reload, and defaults restore |
DSH 0.2.1-alpha.2 added built-in font-family settings. Since 0.3.0 this plugin writes exactly those core settings, so no competing plugin-side state remains; earlier plugin releases (0.1.x–0.2.x) kept their own overrides in parallel and were never verified against the built-in settings. 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; the value is written to the DSH built-in font settings and stays in sync with the built-in font rows.
- Use Reset to default to hand both roles back to the built-in font list.
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 no settings of its own — selected font family names are persisted by the DSH core settings, not by plugin-managed
localStorage.
Limitations
- Local Font Access is primarily available in Chromium-based desktop browsers. Other browsers can still use manual font-name entry.
- Font settings live in the DSH core settings and are shared with the built-in font rows; this plugin adds no separate storage.
- Requires DSH 0.2.1-alpha.2 or newer — the core font-family settings the plugin delegates to were added there.
- 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.
