特蕾西娅主题 · Theresa theme for DSH

给 DeepSeek Harness 的 Web GUI 换上一套特蕾西娅的配色与氛围：象牙白 / 墨 / 淡玫瑰 / 古金，整页背景图 + 毛玻璃面板 + 飘落花瓣 + 黑冠徽记。

这是一个素材可自备的插件：背景图、侧栏立绘、开屏动画都不随包（第三方素材）。缺素材时会自动降级，装上即可用。素材怎么命名、放哪个文件夹，见 DEPLOY.md。

架构（v2）

机制	位置	说明
色板	`lib/client.js` 注入的作用域样式表	压在 `body[data-dsh-theresa]` 下，`--dsw-alias-bg-base` 设为 `transparent`；不走 `ctx.theme.overrideTokens`，所以 `rgba()` / 渐变 / `backdrop-filter` 都能写，也不会和宿主的偏好写入抢状态
背景图	`body` 子元素 `.tre-bg`（`fixed` + `z-index:-1`）	图在内容之下，永远不会把文字冲淡
出图	Host 路由 `/theresa/background/<file>`	不做 base64 内联，直出 2560×1440 原图（带 ETag / 304）
玻璃	`backdrop-filter`	只给侧栏、终端面板、弹窗、`[data-shell-overlay] > *`；不加在对话列与 `shell.overlay` 宿主上（会成为 fixed 后代的包含块，导致悬停闪烁）
文字	`text-shadow` 光晕 + 气泡加厚	正文容器 `[data-conversation-scroll]` 里的段落/列表/表格加一圈亮（或暗）光晕；靠局部衬底保可读，不靠把图调淡
设定	`~/.dsh/theresa-theme.json`	`rev` 版本号防多窗口互相覆盖（旧 rev → 409 + 最新快照）
开屏	`Background/opening.mp4` → `GET /theresa/opening`	启动时全屏播一次：点击 / Esc / 空格 / 回车即跳过；自动播放被拒、视频出错、播完都会立刻收尾；`prefers-reduced-motion` 时整段不播；有首帧图 `opening-poster.webp` 时先铺底再淡入视频
落款	`Background/signature-*.png` → `GET /theresa/signature/<file>`	右下角中文签名在上、英文签名在下，中间一条细金线，末尾一枚朱印。素材是「墨 / 金」两层 alpha 蒙版，颜色交给主题，所以明暗共用一份、金线也保得住；素材缺失时自动退回竖排文字「特蕾西娅」
欢迎页文案	作用域 CSS 覆盖 `[class*="titleGroup"] > span:first-child`	宿主那句「探索未至之境」由 `dsh-client-ui-conversation` 渲染（locale key `hero.headline`）。不替换宿主组件、不碰 React：把那个 span 的字号归零、用 `::after` 写入自己的文案（29px / 400，行高 38），上方是黑冠 + 一道 64px 金线。文案与开关都在设置页，随时可改；文案进 CSS 字符串前会去掉引号、反斜杠与控制字符
构图	`background.fit / focus / zoom / substrate`	「铺满」按 `cover` 铺满并允许裁切，「完整」按 `contain` 保留整张；焦点写成 `background-position` + `transform-origin`，缩放用 `transform`，所以不破坏 cover 语义。阅读衬底是一层从左边缘起的方向性渐变，强度 = 色纱档位 × 衬底滑杆
玻璃	`--tre-glass-blur` / `--tre-glass-sat`	由 `data-tre-glass`（0/1/2）覆盖，同一套规则覆盖侧栏、浮窗、弹窗与 `shell.overlay` 子项；对话列仍不加 `backdrop-filter`
总开关	`enabled`	关掉时移除 `body[data-dsh-theresa]` 整层，并动态注销两个 `priority -1` 的徽记槽位，把品牌位置交还宿主；重新打开时重新注册
设置页	`settings.section`（id `theresa`，order 40）	总开关 / 背景网格 + 上传 / 双档色纱浓度 / 花瓣与黑冠 / 落款与画框 / 欢迎页文案 / 开屏

明暗不设独立开关：主题只跟随宿主「设置 → 外观」，读 body[data-ds-dark-theme] 切换两套值。

安装与生效

plugin_manager install_bundle  target = <此目录的绝对路径>

改到 Host 半（lib/index.js、package.json）→ 必须完全退出 DSH 再打开。
只改 Client 半（lib/client.js）→ 按 Ctrl+R 刷新页面即可。

装好后在「设置」左侧会多出一页「特蕾西娅 · 主题」。

调整

想改	改哪里
背景浓淡	设置页的「色纱浓度」滑杆（0 最实 / 0.85 最淡），白昼/长夜各一档
背景构图	设置页「背景图 → 构图」：铺满/完整、缩放 100–180%、水平/垂直焦点、阅读衬底强度
正文可读性	「阅读衬底」滑杆：越大，正文那一侧压得越厚、画退得越远
面板材质	「外观 → 玻璃强度」三档（清淡 / 标准 / 厚重）
画面通透度	「外观 → 画面通透度」0–100 + 「原画 / 平衡 / 沉浸」预设；只放大面铺底的 alpha
升级兼容	DSH NEXT 把 `bg-layer-1` 铺到整页/整列；0.3.1 起画布级容器显式透明，避免"白一层"
换背景	把图片（webp/png/jpg/avif/gif）放进 `Background/`，重载后设置页会出现新缩略图
主色	`src/client.js` 里的 `ALIAS_LIGHT` / `ALIAS_DARK`
花瓣数量	设置页滑杆（0–14，默认 8）
花瓣形状/颜色	`src/client.js` 里 `.tre-petal` 的 `background-color` 与 `PETAL` 掩码
换开屏视频	用 ffmpeg 转成 `-an -vf fps=30`、`+faststart` 的 mp4 放进 `Background/opening.mp4`（命令见 ASSETS.md）；设置页有「再看一次」可即时预览

改完重建：

python tools/build_client.py          # 内联王冠路径 → lib/client.js
node --check packages/theme-theresa/lib/client.js

自检

node packages/theme-theresa/test/host.smoke.mjs   # 路由 / rev / 越界 / 目录穿越
node packages/theme-theresa/test/contrast.mjs     # 12 组 token 对的 WCAG 对比度

contrast.mjs 会把半透明面板按 alpha 合成到"最不利的背景像素"上再算对比度（浅色侧取纯白与她的深色头发，深色侧取页面墨底与画面里的白鸽），目前最差一项 6.74:1，全部达标。

素材与授权

先看 ASSETS.md。 背景图派生自官方美术 / 同人图，仅限本地个人使用，不可再分发；开源前必须按该文档替换。

已知限制

主题不改字体。想要宋体质感，在「设置 → 通用 → 外观 → 正文字体」填 Noto Serif SC。
背景上传已支持（落到 Background-custom/，同名文件会自动改名为 name-2.ext，不会覆盖旧图）。
侧栏折叠（宽度 0）时立绘保持上次宽度，宁可露一点边缘也不隐藏；这是刻意的取舍。
依赖宿主提供的 [data-slot] / [data-conversation-scroll] 等 DOM 钩子；它们缺失时只有毛玻璃与文字光晕失效，配色与背景仍成立。

特蕾西娅主题 · Theresa theme for DSH

给 DeepSeek Harness 的 Web GUI 换上一套特蕾西娅的配色与氛围：象牙白 / 墨 / 淡玫瑰 / 古金，整页背景图 + 毛玻璃面板 + 飘落花瓣 + 黑冠徽记。

这是一个素材可自备的插件：背景图、侧栏立绘、开屏动画都不随包（第三方素材）。缺素材时会自动降级，装上即可用。素材怎么命名、放哪个文件夹，见 DEPLOY.md。

架构（v2）

机制

位置

说明

色板

lib/client.js 注入的作用域样式表

压在 body[data-dsh-theresa] 下，--dsw-alias-bg-base 设为 transparent；不走 ctx.theme.overrideTokens，所以 rgba() / 渐变 / backdrop-filter 都能写，也不会和宿主的偏好写入抢状态

背景图

body 子元素 .tre-bg（fixed + z-index:-1）

图在内容之下，永远不会把文字冲淡

出图

Host 路由 /theresa/background/<file>

不做 base64 内联，直出 2560×1440 原图（带 ETag / 304）

玻璃

backdrop-filter

只给侧栏、终端面板、弹窗、[data-shell-overlay] > *；不加在对话列与 shell.overlay 宿主上（会成为 fixed 后代的包含块，导致悬停闪烁）

文字

text-shadow 光晕 + 气泡加厚

正文容器 [data-conversation-scroll] 里的段落/列表/表格加一圈亮（或暗）光晕；靠局部衬底保可读，不靠把图调淡

设定

~/.dsh/theresa-theme.json

rev 版本号防多窗口互相覆盖（旧 rev → 409 + 最新快照）

开屏

Background/opening.mp4 → GET /theresa/opening

启动时全屏播一次：点击 / Esc / 空格 / 回车即跳过；自动播放被拒、视频出错、播完都会立刻收尾；prefers-reduced-motion 时整段不播；有首帧图 opening-poster.webp 时先铺底再淡入视频

落款

Background/signature-*.png → GET /theresa/signature/<file>

右下角中文签名在上、英文签名在下，中间一条细金线，末尾一枚朱印。素材是「墨 / 金」两层 alpha 蒙版，颜色交给主题，所以明暗共用一份、金线也保得住；素材缺失时自动退回竖排文字「特蕾西娅」

欢迎页文案

作用域 CSS 覆盖 [class*="titleGroup"] > span:first-child

宿主那句「探索未至之境」由 dsh-client-ui-conversation 渲染（locale key hero.headline）。不替换宿主组件、不碰 React：把那个 span 的字号归零、用 ::after 写入自己的文案（29px / 400，行高 38），上方是黑冠 + 一道 64px 金线。文案与开关都在设置页，随时可改；文案进 CSS 字符串前会去掉引号、反斜杠与控制字符

构图

background.fit / focus / zoom / substrate

「铺满」按 cover 铺满并允许裁切，「完整」按 contain 保留整张；焦点写成 background-position + transform-origin，缩放用 transform，所以不破坏 cover 语义。阅读衬底是一层从左边缘起的方向性渐变，强度 = 色纱档位 × 衬底滑杆

玻璃

--tre-glass-blur / --tre-glass-sat

由 data-tre-glass（0/1/2）覆盖，同一套规则覆盖侧栏、浮窗、弹窗与 shell.overlay 子项；对话列仍不加 backdrop-filter

总开关

enabled

关掉时移除 body[data-dsh-theresa] 整层，并动态注销两个 priority -1 的徽记槽位，把品牌位置交还宿主；重新打开时重新注册

设置页

settings.section（id theresa，order 40）

总开关 / 背景网格 + 上传 / 双档色纱浓度 / 花瓣与黑冠 / 落款与画框 / 欢迎页文案 / 开屏

明暗不设独立开关：主题只跟随宿主「设置 → 外观」，读 body[data-ds-dark-theme] 切换两套值。

安装与生效

plugin_manager install_bundle target = <此目录的绝对路径>

改到 Host 半（lib/index.js、package.json）→ 必须完全退出 DSH 再打开。

只改 Client 半（lib/client.js）→ 按 Ctrl+R 刷新页面即可。

装好后在「设置」左侧会多出一页「特蕾西娅 · 主题」。

调整

想改

改哪里

背景浓淡

设置页的「色纱浓度」滑杆（0 最实 / 0.85 最淡），白昼/长夜各一档

背景构图

设置页「背景图 → 构图」：铺满/完整、缩放 100–180%、水平/垂直焦点、阅读衬底强度

正文可读性

「阅读衬底」滑杆：越大，正文那一侧压得越厚、画退得越远

面板材质

「外观 → 玻璃强度」三档（清淡 / 标准 / 厚重）

画面通透度

「外观 → 画面通透度」0–100 + 「原画 / 平衡 / 沉浸」预设；只放大面铺底的 alpha

升级兼容

DSH NEXT 把 bg-layer-1 铺到整页/整列；0.3.1 起画布级容器显式透明，避免"白一层"

换背景

把图片（webp/png/jpg/avif/gif）放进 Background/，重载后设置页会出现新缩略图

主色

src/client.js 里的 ALIAS_LIGHT / ALIAS_DARK

花瓣数量

设置页滑杆（0–14，默认 8）

花瓣形状/颜色

src/client.js 里 .tre-petal 的 background-color 与 PETAL 掩码

换开屏视频

用 ffmpeg 转成 -an -vf fps=30、+faststart 的 mp4 放进 Background/opening.mp4（命令见 ASSETS.md）；设置页有「再看一次」可即时预览

改完重建：

python tools/build_client.py # 内联王冠路径 → lib/client.js node --check packages/theme-theresa/lib/client.js

自检

node packages/theme-theresa/test/host.smoke.mjs # 路由 / rev / 越界 / 目录穿越 node packages/theme-theresa/test/contrast.mjs # 12 组 token 对的 WCAG 对比度

已知限制

主题不改字体。想要宋体质感，在「设置 → 通用 → 外观 → 正文字体」填 Noto Serif SC。

背景上传已支持（落到 Background-custom/，同名文件会自动改名为 name-2.ext，不会覆盖旧图）。

侧栏折叠（宽度 0）时立绘保持上次宽度，宁可露一点边缘也不隐藏；这是刻意的取舍。

依赖宿主提供的 [data-slot] / [data-conversation-scroll] 等 DOM 钩子；它们缺失时只有毛玻璃与文字光晕失效，配色与背景仍成立。

wanxi123w/dsh-theme-theresa

特蕾西娅主题 · Theresa theme for DSH

架构（v2）

安装与生效

调整

自检

素材与授权

已知限制

Community comments

wanxi123w/dsh-theme-theresa

特蕾西娅主题 · Theresa theme for DSH

架构（v2）

安装与生效

调整

自检

素材与授权

已知限制

Community comments