bauerelizabeth07139/tangsan ↗★ 0
tangsan
TangSan mascot appearance layer for the DeepSeek Harness web GUI: wears a generated TangSan portrait as the chat background (surface fade, opacity, blur and scrim controls) and injects it as the sidebar and conversation brand mark, with a Settings section driving it all. 适合想要将 DSH 界面主题和图标定制为唐三形象的用户。
Install
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:bauerelizabeth07139/tangsanREADME
Read the full README ↗Configuration
The config lives at $DSH_HOME/tangsan.json (default ~/.dsh/tangsan.json) and is edited by the Settings section; it is also reachable over HTTP.
| Field | Default | Meaning |
|---|---|---|
wallpaper | true | Wear the TangSan artwork as the GUI background |
brand | true | Replace the sidebar and hero logos with the TangSan avatar |
surfaceOpacity | 60 | Shell surface opacity in % — lower shows more of the wallpaper, higher keeps the shell opaque (25–100) |
blur | 0 | Gaussian blur applied to the wallpaper, in px (0–24) |
scrim | 35 | Palette-matched wash over the wallpaper — black in the dark theme, white in the light theme — for a readable transcript, in % (0–90) |
position | center | Wallpaper background-position: center, left, right, top, bottom |
| Route | Method | Purpose |
|---|---|---|
/api/tangsan/config | GET / PUT | Read / write the config (writes are same-origin only) |
/api/tangsan/wallpaper | GET | The 16:9 background artwork |
/api/tangsan/mark | GET | The square avatar artwork |
/api/tangsan/diag | GET / POST | Last browser-side diagnostic report (mount state, surface overrides, errors) |
Every value is clamped server-side; unknown keys are dropped.
配置
配置文件为 $DSH_HOME/tangsan.json（默认 ~/.dsh/tangsan.json），字段与取值范围见上方英文表格；服务端会做钳制并丢弃未知字段。