xiao-ui-theme-ts
适用于 DeepSeek Harness Web UI 的可自定义主题插件。默认采用 Xiao 风格的玉色调；强调色、吉祥物徽章文本、注入语音和磨砂背景均可配置。使用 TypeScript 和 pnpm 构建。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add xiao-ui-theme-ts@0.11.0
Xiao Ui Theme Ts 以 xiao-ui-theme-ts 发布，当前版本为 0.11.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A highly customizable theme plugin for DeepSeek Harness (ships with a "Xiao" jade-green look by default). It themes the DeepSeek Harness web UI: colors, mascot badge, background, and injected voice are all configurable. The background supports static images, animated GIFs, and looping videos (MP4/WebM/MOV/M4V) — an uploaded animated GIF is auto-detected and used as a live/dynamic background, and an uploaded video is auto-detected and played as a full-screen looping background. Out of the box it's a Xiao-style jade/emerald theme, but the accent color, badge text, voice, and background are all tweakable — make it your own.
Gives the DeepSeek Harness web UI a heavily customizable theme. By default it's the jade-green "Xiao" look (jade palette + mascot badge + Xiao-style voice + frosted background), but every part is adjustable: accent color, badge text, voice toggle/language/content, background image and transparency. It also optionally injects a "Xiao-style voice" into the session — turn it on if you want the assistant to speak like Xiao, off if not. It only changes tone/style, never the substance of the answer. On top of that it ships a separate roleplay space (entertainment): an independent, tool-free agent preset for actually chatting in character, kept deliberately apart from work sessions — a work session only ever gets tone, never a character identity.
~/.dsh/.agent-presets/xiao-roleplay/, shown as "角色空间（娱乐） / Roleplay (entertainment)"); start a new session and pick that preset at the top to enter character. The default role is an English Xiao card, and any full character prompt you paste replaces it. The preset's own composition mounts no file, command or task tools, so a roleplay session never gets your work tools and you never trade away a work session's real capability for it; the two sides keep separate histories. (Tools registered by profile-level plugins sit outside every preset and still appear — see the notes below.) One-click toggle — turning it off removes the preset.max(interval, video length). Switching uses a fixed ~0.7s cross-fade. With a single background nothing changes: no timer, no fade, exactly the old behaviour..json file.dsh available) — tested on 0.1.1-rc.2 and 0.1.5-rc.1 (see Version compatibility)Both ends of the last upgrade are supported — the previous versions and the current ones:
| Component | Tested / supported | How the theme adapts |
|---|---|---|
| DeepSeek Harness | 0.1.1-rc.2 (previous) → 0.1.5-rc.1 (current) | Left sidebar: the sidebarCol class-name suffix. Right sidebar: the old column name detailsCol and the native panel data-sidebar-right-panel (0.1.5-rc.1) — both anchors are kept, so either DSH works. |
| better-sidebar (third-party) | 0.17.1 (previous) → 0.19.0 (current) | 0.17.1 drew its own right panel, matched through data-dsh-panel / data-dsh-pane; 0.19.0 registers its tabs into DSH's native right sidebar, matched through data-sidebar-right-panel. The newer bottom workbench panel (which also carries data-dsh-panel) is explicitly excluded and stays opaque. |
Verified on 2026-09-10 against both pairs — dsh 0.1.1-rc.2 + better-sidebar 0.17.1 and dsh 0.1.5-rc.1 + better-sidebar 0.19.0: the sidebar opacity slider drives the left and right sidebars on either pair, and every compatibility anchor is kept, so upgrading or rolling back does not break it. Older better-sidebar releases (0.14.x / 0.16.x) use the same data-dsh-panel anchor and are expected to work as well, but were not tested.
dsh command is available.dsh plugin --profile web add xiao-ui-theme-ts
Or install directly from a GitHub release tarball:
dsh plugin --profile web add https://github.com/jinxlux/xiao-theme-dsh-ui-plugin/releases/latest/download/xiao-ui-theme-ts.tgz
git clone <copied-repo-url>
cd xiao-ui-theme-ts
pnpm install # install build dependencies
pnpm run build # produce lib/ (ESM Host + ModuleLoader Client + declarations)
pnpm run check # optional: verify the artifact satisfies the dsh plugin contract
Then attach it as a bundle to a DSH profile:
# relative path (run from a sibling directory)
dsh plugin --profile web add "./xiao-ui-theme-ts"
# or an absolute path
dsh plugin --profile web add "D:/.../xiao-ui-theme-ts"
dsh plugin addinstalls the package into the profile and, thanks to itsdsh.bundledeclaration, automatically hooks it into the bundle stack — no manual config needed. Refresh / restart DSH Web for the theme to take effect.
web_search / web_fetch tools — so the character can look up the latest plot, design and lore before playing. File, command and task access stay blocked. Whatever role text you provide is used verbatim, and the plugin then appends its own short rules section after it — the tool gate for this switch plus the "never name your source" rule. Your role text cannot replace or turn that off, so don't put tool instructions in it: they would only conflict with the appended rules. (A profile-level web plugin, if installed, supplies the search provider — see the notes below.) Looked-up material is only background knowledge for the character: it stays in character and never mentions the web, a search, a source or a link. Off (the default) web lookup is simply not allowed: the role text orders the character to use no tools at all — that block lives in the prompt, not in the tool set.dsh plugin add ./xiao-ui-theme-ts, which DSH stores as a link: dependency), then later switch to a remote install (package name or tarball), remove the leftover link first — otherwise pnpm may follow it back to your local node_modules and fail with a symlink EPERM (@types/node). Remove it and retry:
dsh plugin --profile web remove xiao-ui-theme-ts
dsh plugin --profile web add xiao-ui-theme-ts
lib/ is build output, not committed. After clone, run pnpm install && pnpm run build first, then dsh plugin add; adding an unbuilt directory fails because lib/ is missing.resource/avatar.png), readable across machines; keep resource/ at the same level as lib/ after building (current layout works). resource/bg.svg is legacy and no longer used..mp4, or VP8/VP9 in .webm. Some browsers can't decode HEVC (H.265) .mp4/.mov; .avi/.mkv aren't accepted.http://127.0.0.1:3080) via the AutoplayAllowlist enterprise policy, or launch the browser with --autoplay-policy=no-user-gesture-required (debug flag). Otherwise just leave the sound toggle off and the background stays purely muted. See Autoplay policy in Chrome.systemPrompt assembly. If the agent preset filters the prompt down to only a persona, or uses a , the voice may not appear in that session (that's preset behavior, not a plugin bug).LICENSE); study, modify, and redistribute as permitted.resource/ (bg.svg, avatar.png, plus user-uploaded background images) come from public online sources, provided only for demo / customization of this theme.resource/ and theme showcases) may not be used commercially or repurposed without permission. To redistribute or use commercially, obtain a license from miHoYo first; removing or replacing the assets in resource/ avoids this constraint. See the "Character Image & Setting Intellectual Property Notice" in LICENSE.~/.dsh/.agent-presets/xiao-roleplay/#2E8B72); the panel surfaces, borders, brand color, sidebars and background gradient all shift in sync. Semantic state colors (error / warning / success) stay fixed and don't follow the accent.data-sidebar-right-panel), which is also exactly where better-sidebar ≥ 0.19 mounts its tabs — so one slider covers both. Older better-sidebar releases (< 0.19) drew their own panel and are still matched through data-dsh-panel / data-dsh-pane. When neither is present the rules simply do nothing.xiao-theme.json under the DSH home — ~/.dsh by default, $DSH_HOME when that is set; uploaded background images/videos go to xiao-theme-uploads/ right beside it (user-level, not shipped with the repo). An install that already has data at ~/.dsh keeps using it, so upgrading never looks like a settings reset (see Notes). Uploads are streamed to disk and sized by purpose: avatars/images keep a 20MB cap, backgrounds (including videos) allow up to 200MB. Unsupported or mismatched formats are rejected with a clear message shown in the settings page (instead of silently failing).sidebarCol column and the native right-sidebar panel (data-sidebar-right-panel). Older DSH releases named that column detailsCol, and older better-sidebar releases drew their own panel tagged data-dsh-panel / data-dsh-pane; both anchors are kept for compatibility. The newer better-sidebar bottom workbench panel also carries data-dsh-panel, so it is explicitly excluded (:not([data-dsh-bottom-panel])) and stays opaque. The sidebar rules themselves are CSS-only — the anchors are stable data attributes / class-name suffixes, never hashed class prefixes. (A small JS fallback separately locates the shell frame to apply the frosted-panel blur when the CSS selector misses; it is not used for, and does not affect, the sidebar anchors.)xiao-voice is an ordinary unscoped system-prompt section, not a mode. A preset that filters assembly down to its persona (or sets complete: true on it) removes it — so if the tone disappears under a particular preset, that is the preset's behavior, not a broken toggle.agent.cordis.yml and preset.yml under ~/.dsh/.agent-presets/xiao-roleplay/ (agent.cordis.yml is generated — do not hand-edit it; change the role through the settings text box instead). Turning the toggle off deletes those two files (a non-recursive removal, so anything else you placed in that directory is left alone). The preset's persona is the complete system prompt (complete: true plus no runtime context). Its own composition mounts no work-tool rows (no file, shell, subagent, task or plan), and Allow web lookup adds just one row (web_search / web_fetch). This governs the preset's own layer only: tools registered by profile-level plugins (host-plane rows such as a web-search plugin like modsearch, or plugin-vet) belong to no preset and appear in every session, roleplay included — the preset cannot hide them. That is a supported setup: leave such a plugin installed if you want the extra reach — its own tools work in a roleplay session, and with Allow web lookup on, web_search uses the provider it supplies (modsearch does exactly this). Uninstall or disable it from the profile only if you would rather the roleplay session not have it. That root is resolved the way DSH resolves it at the user level — a non-blank $DSH_HOME replaces ~/.dsh — so the preset always lands where DSH scans. The theme's own settings and uploads deliberately stay at ~/.dsh, so upgrading never looks like a settings reset.xiao-theme.json and compile-time defaults. ($DSH_HOME is read only to locate that data root, never to configure the theme.)