Field Terminal for DeepSeek Harness

An unofficial, drop-in visual theme for the DeepSeek Harness (dsh) Web UI. Field Terminal gives the local interface a lemon-yellow industrial command-deck aesthetic inspired by Arknights: Endfield, without modifying the generated React bundle files.

Highlights

Area	Design treatment
Color	Lemon yellow #FFF44F replaces the original blue accent.
Geometry	Square corners, hard black edges, clipped message and button corners, and industrial grayscale surfaces.
Depth	Offset button shadows and layered black-and-yellow shadows for dialogs and floating panels.
Navigation	A yellow sidebar rail, brand strip, textured panels, and a five-color status bar.
Content	Yellow Markdown accents, terminal-style labels, custom selection colors, and a striped scrollbar.
Atmosphere	A 42 px grid, top-left ambient glow, and contour-line texture in dark mode.
Typography	Bundled HarmonyOS Sans SC, Space Grotesk, Novecento Wide, Gilroy, and Roboto fonts.
Themes	A dark “terminal cabin” treatment and a lighter “paper workbench” treatment.

Relationship to DeepSeek Harness

This repository is a community theme for the official DeepSeek Harness, an open-source agent harness developed by DeepSeek AI. It targets the Web UI started with:

npx @deepseek-ai/dsh web

The Web UI is served at http://127.0.0.1:3080 by default. See the official DeepSeek Harness Web UI guide for setup and usage.

Field Terminal is not maintained by or affiliated with DeepSeek AI. It is a direct theme overlay rather than an official dsh plugin.

Install

Prerequisites

• Node.js and a working DeepSeek Harness Web UI installation.
• Bash on macOS, Linux, WSL, or a compatible shell.

Apply the theme

git clone https://github.com/INnoVationEE/dsh-endfield-theme.git
cd dsh-endfield-theme
./install.sh

Keep the Web UI running, then perform a hard refresh in your browser (Cmd+Shift+R on macOS or Ctrl+Shift+R on Windows/Linux). No server restart is normally required.

The installer is idempotent: it creates first-run backups, copies the theme assets into the detected dsh-web-frontend/dist directory, and injects the stylesheet and helper scripts into index.html.

Reapply after an update

DeepSeek Harness upgrades can replace its generated frontend files. Run the installer again after an upgrade:

./install.sh

Remove the theme

./revert.sh

Hard-refresh the Web UI after reverting.

How it works

• endfield.css overrides the Web UI's --dsw-* static and semantic design tokens for both light and dark modes.
• Additional structural CSS adds the square geometry, clipped corners, industrial shadows, grid and texture layers, sidebar treatment, and Markdown accents.
• theme-assets.js replaces the sidebar wordmark with the bundled Field Terminal artwork and restores it after React remounts the brand area.
• usage-monitor.js adds a self-contained DeepSeek balance and usage widget above the sidebar settings control.
• install.sh adds only stylesheet and script tags to index.html; it does not rewrite the application's component bundles.

Usage monitor

The optional fields in the sidebar widget support two data sources:

• API balance: calls the official GET https://api.deepseek.com/user/balance endpoint every 60 seconds. The API key is stored in this Web UI origin's browser localStorage and is sent only to api.deepseek.com by the widget.
• Platform token usage: calls an undocumented platform.deepseek.com/api/v0/usage/amount endpoint using an optional platform userToken. This best-effort integration may fail because of CORS, WAF rules, authentication changes, or endpoint changes; balance reporting continues independently.

Security notes:

• Never commit an API key or platform token to this repository.
• Browser localStorage is readable by scripts running on the same origin. Configure the widget only in a trusted local Web UI session.
• To clear stored credentials, open the widget settings, empty both credential fields, and save.
• The usage monitor fails gracefully when its requests are unavailable; it does not block the rest of the theme.

Repository layout

Path	Purpose
endfield.css	Main design-token and structural style overlay.
usage-monitor.js	Self-contained API balance and token-usage widget.
theme-assets.js	Sidebar logo injection and remount handling.
assets/	Logo, panel textures, button texture, and decorative artwork.
fonts/	Bundled interface and display fonts.
endfield-texture.png	Contour-line background texture.
favicon.svg	Lemon-yellow Field Terminal favicon.
docs/field-terminal-preview.png	Privacy-safe repository preview image.
install.sh	Idempotent theme installer.
revert.sh	Restores the saved frontend files and removes injected assets.

Troubleshooting

dsh-web-frontend/dist cannot be found

Start the official Web UI at least once with npx @deepseek-ai/dsh web, then rerun ./install.sh. The installer searches the local npm npx cache for the frontend distribution.

If your frontend distribution is stored elsewhere, set its path explicitly:

DSH_DIST=/absolute/path/to/dsh-web-frontend/dist ./install.sh

The old theme is still visible

Perform a hard refresh. If you edited endfield.css, rerun ./install.sh so the updated file is copied into the frontend distribution.

The layout breaks after a DeepSeek Harness update

Run ./revert.sh, confirm the stock Web UI works, and then run ./install.sh again. If upstream markup or design tokens changed, open an issue with the installed @deepseek-ai/dsh version and a screenshot.

Credits and disclaimer

• Built for the official DeepSeek Harness Web UI.
• Visual direction was adapted from grad-research-workbench.
• Theme artwork in assets/ and endfield-texture.png was created with generative-image assistance.
• The visual treatment is inspired by Arknights: Endfield. This is an unofficial fan-made project and is not affiliated with, endorsed by, or sponsored by DeepSeek AI, Hypergryph, GRYPHLINE, or their affiliates. All product names and trademarks belong to their respective owners.