dsh-theme-songgrid

Songgrid · 宋律

Song-dynasty aesthetics × Swiss International Style — a theme for the DeepSeek Harness Web UI.

中文 ｜ English

---

The two variants, captured live (the sidebar is the Eight Standing Seats board). Card areas are redacted.

Why "Songgrid"

The warm white of rice paper, the celadon of Ru ware, the warning red of cinnabar — disciplined by Swiss International Style: a 4pt spacing scale, 2/4px radii, and type sizes locked to line heights.

This is not ancient styling pasted onto a UI. Every traditional colour is placed on the functional role it can actually hold.

Two accents, two jobs

The one decision in this theme that looks like a duplicate but must not be collapsed:

Celadon passes WCAG AA, so it can carry "can I click this / is this selected". Kiln copper does not pass AA for body text, so it only carries "is this worth a second look". Their hues sit 174° apart — they were never two candidates for one role.

Two variants

Palette

Xuanzhi · light

Yemo · dark

The dark ground is a cool blue-black, tuned together with the celadon. Swapping it for a warm black means re-tuning the entire dark variant.

Typography

• Chinese runs on a Song serif (Noto Serif SC); Latin stays sans-serif — each script gets its own face, never mixed
• Sizes are defined in pairs with their line heights (body / secondary / caption)
• Emphasis comes from colour roles (celadon vs. kiln copper), not from stacking bolds

Structure layers

Three layers; two of them are orthogonal to colour — future palette work never touches them:

Install

dsh plugin --profile web add dsh-theme-songgrid

Then refresh the page and pick 「宋律 · 宣纸」/「宋律 · 夜墨」/ follow-system under Settings → General → Theme. The choice persists in the song-grid-theme settings namespace (the host plugin entry id).

The entry URL decides whether the choice survives across browsers. The DSH client only writes settings back to the host when the page hostname is localhost / ::1 / 127.x (isLoopbackHostname in dsh-client-connection). Opened through dsh.localhost, a LAN name or a reverse-proxy domain, the whole settings surface degrades to in-page memory — which looks like "I picked the theme, refreshed, and it was gone", and it affects the official theme preference, locale and notification settings just the same. To have the choice remembered across browsers/machines, open http://localhost:8080/ (or http://127.0.0.1:3080/?token=…). Per-browser remembering works on any entry (the plugin keeps its own localStorage mirror).

Compatibility

• Requires DSH ≥ 0.2.0-rc.2 (@deepseek-ai/dsh); verified on 0.2.0-rc.2 — on 0.1.5-rc.2 install dsh-theme-songgrid@0.1.0
• Implemented purely by overriding host design tokens — no host source is patched, no raw values
• Not affiliated with DeepSeek

Porting notes (0.1.5-rc.2 → 0.2.0-rc.2)

• settingsScope was removed: the theme preference scope is now ctx.configForms.get("songgrid") (the snapshot is still { status, value })
• The built lib/client.js must register under the package name in __ModuleLoader__.load({ id }) — rebuild the bundle after any rename, or the boot aborts with duplicate factory registration

Development

lib/index.js     host half: registers the songgrid settings namespace
lib/client.js    browser half: theme tokens + three CSS layers + theme picker
assets/          landscape backgrounds (ink / ink-night / celadon)

• Structure layer: tokens live in :root; add a step there. New styles take var(--sg-gap-*) / var(--sg-radius-*) — never raw values
• Icons: <span class="sg-icon sg-icon-check"></span>, 46 glyphs in ICON_CSS; sizes via .sm / .lg / .xl or --sg-icon-size
• More editorial emphasis: --sg-accent-editorial already exists in SEMANTIC_CSS; add selectors — the only rule is never on an interactive control, that slot belongs to the functional accent

License

MIT