xiao-ui-theme-ts

Usage & configuration

• Open DSH Web → Settings → Xiao Theme: master toggle, accent color, voice (work sessions), template language, custom prompt, roleplay space (entertainment), avatar path, mascot title/subtitle, theme management, frosted background (on / path / upload / blur / opacity; GIF or MP4/WebM/MOV/M4V video auto-detected as a dynamic background, with a sound toggle for video), UI opacity, sidebar opacity.
• Voice (work sessions): the built-in Chinese/English templates are tone only — the substance, tools and execution stay exactly the same, and no character identity is written into a work session. The custom prompt is different: it is inserted verbatim as an extra system-prompt section in every work session, so whatever you write really takes effect. Keep it tone-only — tool, permission, identity or "always refuse X" instructions there will degrade your normal sessions.
• Roleplay space (entertainment): its own settings group, deliberately kept apart from the voice prompt:
  • Toggle (off by default): turning it on generates / updates the preset from the role text below; turning it off removes the preset (sessions already running on it keep running). The theme's own master switch (Enable Xiao theme) also gates it — while that is off nothing is installed and the preset is removed, so "theme off" really means off.
  • Allow web lookup (off by default): when on, the roleplay preset mounts exactly one extra model-facing row — DSH's 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.
  • Role system prompt: empty uses the built-in English Xiao card; paste any full character prompt to switch roles (saved and synced to the preset automatically).
  • Apply / update preset: force a rewrite (useful after hand-editing the generated file).
  • Reset to default role (Xiao) / Open preset folder: restore the role text, or open ~/.dsh/.agent-presets/xiao-roleplay/ in your file manager.
  • How to enter character: start a new session and pick "角色空间（娱乐）" in the new-session preset chip — DSH only allows switching a preset while a session has produced nothing, so an existing session can never be turned into a roleplay one.
• Accent color: pick an accent with the color wheel (default jade green #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.
• Mascot: badge title (default "靖妖傩舞") and subtitle (default "别挡路") can be set to any text; an empty title falls back to the default. The avatar image path accepts a plugin-relative path or a local absolute path, and you can upload an image directly to replace the avatar. The avatar also supports animated GIFs — an uploaded GIF plays as an animation with no separate toggle.
• Uploads (picker): click "Choose/upload background" or "Choose/upload avatar" to open an asset window — pick an existing upload to reuse it (backgrounds re-derive the dynamic flag automatically), or upload a new one right there; the new file is auto-selected. The Open upload folder button lets you manage the files directly. The Reset theme color and Reset mascot buttons restore those fields to defaults.
• UI opacity: controls the main content area, range 0.3–0.9, capped so at least ~10% of the background stays visible.
• Sidebar opacity: independently controls the left/right sidebars, range 0–1, up to 100% fully opaque. The left is DSH's own sidebar; the right is DSH's native right-sidebar panel (stable anchor 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.
• Changes take effect immediately, no DSH restart needed.
• Settings are saved to 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).