特蕾西娅主题 wanxi123w/dsh-theme-theresa

特蕾西娅主题 · 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 写入自己的文案（26px / 500，与宿主一致）。文案与开关都在设置页，随时可改；文案进 CSS 字符串前会去掉引号、反斜杠与控制字符 |
| 设置页 | 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 刷新页面即可。

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

调整

| 想改 | 改哪里 |
| 背景浓淡 | 设置页的「色纱浓度」滑杆（写进 --tre-dim，0 最实 / 0.85 最淡） |
| 换背景 | 把图片（webp/png/jpg/avif/gif）放进 Background/，重载后设置页会出现新缩略图 |
| 主色 | src/client.js 里的 ALIAS_LIGHT / ALIAS_DARK |
| 花瓣数量 | 设置页滑杆（0–14） |
| 花瓣形状/颜色 | 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。
- 背景上传还没做（P1 剩余项），目前用文件放进 Background/ 的方式。
- 依赖宿主提供的 [data-slot] / [data-conversation-scroll] 等 DOM 钩子；这些钩子缺失时，只有毛玻璃与文字光晕失效，配色与背景仍成立。