xiao-ui-theme-ts

dsh plugin --profile web add xiao-ui-theme-ts

语言 / Language： [English](./README.md) · 简体中文（当前） · [日本語](./README.ja.md) · [한국어](./README.ko.md)

xiao-ui-theme-ts

✅ 已适配最新桌面版（DSH Desktop，实测 0.1.7-rc.2）与 Web 版（实测 0.1.5-rc.3）。 只要 DSH 是 v0.1.5-alpha.1 及更新（自带官方右栏的版本）即可；更早的版本请用主题 0.11.x —— 见[版本兼容](#版本兼容)。

DeepSeek Harness 的可自定义主题插件（默认带一套「魈」青玉风）—— 给 DeepSeek Harness 的

Web 界面做主题：配色、吉祥物徽章、背景、注入语气都能自己调。背景同时支持静态图片、动态 GIF 与循环视频（MP4/WebM/MOV/M4V）——上传动画 GIF 会自动识别为动态背景，上传视频也会自动识别并作为全屏循环背景播放。默认是一套魈的青玉/翠青风格，但主色、徽章文字、语气、

背景等都可配置，改出来就是你的专属主题。

这是什么

把 DeepSeek Harness 的 Web 界面换上一套可高度自定义的主题视觉。默认是魈的青玉风（青玉配色 +

吉祥物徽章 + 魈式语气 + 磨砂背景），但每一样都能改：主色、徽章上的文字、语气开关/语言/内容、

背景图与透明度。也支持在会话里可选注入「魈式语气」——想让助手带魈的口吻就开着，不带就关掉，

且仅改变语气风格，绝不改变回答内容。另有一个独立的「角色空间」（娱乐）：一个不挂工作工具（可选联网检索）、可以真正

以角色身份聊天的独立 agent 预设，与工作会话刻意分开——工作会话永远只拿语气，不拿角色身份。

示例

<details open>

<summary><b>桌面版（DSH Desktop，最新版适配）</b></summary>

<img width="1279" height="739" alt="魈主题——桌面版适配示例（徽章里可见声音按钮）" src="./resource/screenShortsReadMe/desktopExample.png" />

</details>

<details open>

<summary><b>浅色模式（魈，默认）</b></summary>

<img width="2515" height="1288" alt="魈主题——浅色模式（默认）" src="https://github.com/user-attachments/assets/3998f58b-53db-4349-80f3-3d993c6ad3c3" />

</details>

<details>

<summary><b>深色模式</b></summary>

<img width="1873" height="912" alt="魈主题——深色模式" src="./resource/screenShortsReadMe/xiaoDarkMode.png" />

</details>

<details>

<summary><b>切换其它主题</b></summary>

<img width="1864" height="936" alt="切换到其它主题" src="./resource/screenShortsReadMe/otherThemeSwitch.png" />

</details>

<details>

<summary><b>设置页</b></summary>

<img width="1183" height="871" alt="主题设置页——上半" src="./resource/screenShortsReadMe/settingPageCNUp.png" />

</details>

<details>

<summary><b>设置页（下半）</b></summary>

<img width="1195" height="856" alt="主题设置页——下半" src="./resource/screenShortsReadMe/settingPageCNButtom.png" />

</details>

功能

• 可自定义配色（默认青玉/翠青）：浅色 / 深色两套青玉色板，主色先用圆形色盘自定义，设置页可一键关闭。
• 吉祥物徽章：可拖动、可收起的小徽章（底部右侧），标题 / 副标可改成任意文字，头像图也可直接上传替换。头像同样支持 GIF 动图，上传 GIF 即以动图播放。另有「恢复吉祥物默认」一键把头像路径、标题、副标都还原到出厂默认。视频背景时，徽章里会多出 🔊/🔇 按钮与一根音量滑杆（在关闭按钮左侧），点喇叭即可静音 / 取消静音，拖滑杆即可当场调音量 —— 它们和设置页的「视频背景声音 / 视频背景音量」是同一组字段，两边随时同步；静态图与 GIF 背景不显示这两个控件。
• 魈式语气（工作会话）：向系统提示注入一段魈式语气说明（可开关），语言可选中文 / 英文模板，也可填自定义提示词。只改语气：内容、工具与执行方式完全不变，不注入任何角色身份。
• 角色空间（娱乐，默认关闭）：一个独立的角色扮演会话，与你干活的工作会话彻底分开——不打开开关就什么都不装，所以升级不会凭空多出一个 agent preset。开启后插件会把「角色系统提示词」变成一个独立的 DSH agent preset（显示名「角色空间（娱乐） / Roleplay (entertainment)」）：DSH ≥ 0.1.7 用 agentPresets 注册表声明，≤ 0.1.6 写成 ~/.dsh/.agent-presets/xiao-roleplay/ 目录；开一个新会话、在顶部选中该预设即可进入角色。默认角色是英文的「魈」设定，把文本框改成任意角色的完整设定即可换角色。该预设自己不挂文件 / 命令 / 子代理 / 任务这些工作工具（打开「允许网络检索」后只多挂 web_search / web_fetch 两个网络工具），所以它拿不到你的工作能力，也不需要牺牲工作会话的真实能力；两边历史互不相通。（注意：以 host 面 / profile 级挂载的第三方插件工具不属于任何预设，会出现在所有会话里——包括角色会话，见下方「注意事项」。）一键开关，关掉即移除该预设。
• 磨砂背景：可配置背景图（支持相对插件目录或本地绝对路径，也可直接上传），并调节模糊强度与界面的不透明度。上传 GIF 动图 会自动识别并作为 动态背景（动画铺满）；上传 MP4 / WebM / MOV / M4V 视频 也会自动识别并作为全屏循环视频背景播放（视频背景可选是否播放声音，并可用音量滑杆调大小）；静态图片或单帧 GIF 仍按静态磨砂背景处理。
• 多背景轮播：在背景列表里加上第 2 项即自动轮播。静态图与 GIF 按可调的「切换间隔」到点即切；视频在「间隔 ≤ 时长」时播完才切、「间隔 > 时长」时循环播到点再切（即切换时间 = max(间隔, 视频时长)）。切换用固定约 0.7 秒的交叉渐变。只有 1 张背景时行为完全不变：无定时器、无渐变，与旧版单背景一致。
• 界面与侧栏透明控制：界面不透明度（0.3–0.9）控制主内容区；侧栏不透明度（0–1）单独控制左右侧栏，可拉到 100% 完全不透明，且无论怎么调背景图都始终透出一部分。
• 主题颜色：默认魈的青玉绿，也可用圆形色盘任意自定义主色；整套青玉色板（面板底色、边框、品牌色、侧栏、背景渐变）会随主色协调变化，设置后持久保存。也可一键「恢复主题颜色默认」回到魈的青玉绿。
• 主题管理（多主题）：把当前所有设置另存为命名主题，可切换 / 重命名 / 删除（内置「魈」主题不可删除）、一键恢复当前主题为默认，并支持对任一主题一键导入 / 导出 .json。设置页左侧的分区标题现在会跟随当前主题名：显示为「当前主题名 + 界面语言后缀」（中文「主题」、英文「 Theme」），因此切换到别的主题、或重命名当前主题后，左侧标题会立即同步。主题名原样使用、不做翻译，只有后缀随界面语言变化；内置「魈」主题保持双语的「魈主题」/「Xiao Theme」不变。
• 上传文件管理（选择器）：背景/头像的上传入口改为一个选择器窗口，列出所有已上传文件（缩略图、大小、修改时间、被哪些主题引用），既可点选已有文件直接复用，也可在窗口内上传新文件（上传成功后自动选中）。底部「打开上传文件夹」用系统文件管理器打开该目录，可直接增删改。不会自动删除任何文件——上传目录完全由用户自己管理。
• 设置页：总开关、主题颜色、语气（工作会话）、模板语言、自定义提示词、角色空间（娱乐）（开关 / 允许网络检索 / 角色系统提示词 / 应用更新预设 / 恢复默认角色 / 打开预设文件夹 / 安装状态）、头像路径、吉祥物标题/副标、主题管理、磨砂背景（开关/路径/上传/模糊/透明度，GIF 或 MP4/WebM/MOV/M4V 视频自动识别为动态背景，视频背景可选声音并调音量）、界面与侧栏不透明度。

环境要求

• DeepSeek Harness（dsh 可用）—— DSH v0.1.5-alpha.1 及更新（即自带官方右栏的版本）推荐优先使用本版本及之后版本；v0.1.5-alpha.1 之前请使用本版本之前的 0.11.x（见[版本兼容](#版本兼容)）
• better-sidebar（可选第三方插件）—— 仅 0.19.x；旧版 ≤ 0.18（自绘右栏）不再适配
• Node.js（建议 ≥ 18）
• pnpm

版本兼容

按你的 DSH 版本选主题版本 —— 分界线是「有没有官方右栏」（dsh-client-ui-sidebar-right，v0.1.5-alpha.1 引入）：

你的环境 · 建议装的主题版本 · 说明

DSH v0.1.5-alpha.1 及更新（已自带官方右栏） · 本版本 0.12.0 及之后版本（优先推荐） · 着色模型覆盖官方右栏的两种形态：面板自绘（v0.1.5-alpha.1 ~ 0.1.6-alpha.2）、面板不画而由内部表面画（0.1.7-alpha.1 起）

DSH v0.1.5-alpha.1 之前（还没有官方右栏） · 本版本之前的 0.11.x · 那一代的右栏列与锚点和本版本对不上，旧版更稳

⚠️ 不按上表选也不会崩溃：插件照常加载、DSH 照常启动，但可能出现界面 bug —— 例如侧边栏 / 右栏的底色与透明度不对（偏平、偏不透、左右不一致，或整块透出背景）。

- 自带官方右栏（v0.1.5-alpha.1 及更新）→ 本版本及之后版本。

- v0.1.5-alpha.1 之前 → 本版本之前的 0.11.x。

- CSS 里保留了旧锚点（data-dsh-panel / data-dsh-pane），所以旧组合不会报错或崩溃，只是观感不保证。

在线安装（在线快速安装）

1. 确保安装 dsh 命令

2. 按包名安装（npm，推荐）：

dsh plugin --profile web add xiao-ui-theme-ts

或直接从 GitHub release 安装 tgz：

dsh plugin --profile web add https://github.com/jinxlux/xiao-theme-dsh-ui-plugin/releases/latest/download/xiao-ui-theme-ts.tgz

克隆源代码后安装（从 git clone 开始）

git clone <copied-repo-url>
cd xiao-ui-theme-ts

pnpm install       # 安装构建所需依赖
pnpm run build     # 生成 lib/（ESM Host + ModuleLoader Client + 声明文件）
pnpm run check     # 可选：校验产物是否符合 DSH 插件契约

然后把它作为 bundle 挂到 DSH profile：

# 相对路径（在仓库同级目录执行）
dsh plugin --profile web add "./xiao-ui-theme-ts"
# 或绝对路径
dsh plugin --profile web add "D:/.../xiao-ui-theme-ts"

dsh plugin add 会把包装进 profile，并因其 dsh.bundle 声明自动接入 bundle 层栈，无需手动改配置。

刷新 / 重启 DSH Web 后主题生效。

使用与配置

• 打开 DSH Web → 设置 → 魈主题 页：总开关、主题颜色、语气（工作会话）、模板语言、自定义提示词、

角色空间（娱乐）、头像路径、吉祥物标题/副标、主题管理、磨砂背景（开关 / 路径 / 上传 / 模糊 / 透明度，

…(truncated)