前言¶
DeepSeek Harness（DSH）的 UI 在日常使用中容易显得单调。主题插件可以改变配色、图标和面板材质，但多数主题只是静态配色，换一张壁纸，整个界面颜色往往不匹配。姬子的星月夜（Himeko’s Starry Night）在默认深色主题基础上，把星云壁纸与「液态玻璃」材质绑定在一起，并为 DSH Web UI 注入了一套动态取色与全屏适配机制，让界面颜色随壁纸变化，同时保持可读性。
插件定位¶
插件名：姬子的星月夜（Himeko’s Starry Night）
维护者：Yoimiya-Lover-0621-01
分类：趣味换装
简介：DeepSeek Harness 星云壁纸 + 液态玻璃主题插件
星标：0
动态配色与暗色锁定¶
每张壁纸先被还原成一枚「种子色」（CIELAB 里彩像素的面积加权色相 + 平均彩度），主题里所有颜色保留自己的明度、改用种子色的色相、并按种子彩度缩放。换什么壁纸，整张皮就长在什么颜色上；低饱和/黑白图会退化为中性深色，不会乱跳。取色在浏览器里完成，图片只为本机显示存一份。
插件在 bundle 层把 DSH 的「外观」偏好默认设为深色。新机器第一次装好、重启 DSH 后就直接进入深色（不管系统本身是浅色还是深色）；页面处于深色时，设置里的浅色/暗色选择会被隐藏。如果某台机器因为别处的手动配置仍是浅色，这一栏会保持可见，可以手动切回深色。
液态玻璃与全屏适配¶
输入框、消息气泡、新会话按钮、二级菜单（账号/权限/模型/命令/更多/智能体团队）、左侧栏行与当前对话、设置导航与设置弹窗、代码块、右侧栏入口卡片与图标，都使用液态玻璃材质。
进入全屏时自动隐藏聊天输入框与底部用量条，退出后恢复。设置弹窗是一整块不透明平面：内容区不叠玻璃、行和卡片无底色、左栏选中项只是一层淡色块——弹窗里从头到尾只有一层材质，不会再出现「框中框」。
Windows 标题栏的最小化/窗口化/关闭三枚原生按钮的底色改为透明，直接浮在壁纸上；「应用 / 编辑」按钮的悬停与展开态使用同一套玻璃高亮。「应用 / 编辑」下拉改为插件自绘的液态玻璃菜单，编辑菜单的撤销/重做/剪切/复制/粘贴/删除/全选均可用。
背景与启动屏¶
设置里新增「背景」栏（面板名叫「星辰画布」）：把本机的一张照片或一段视频铺成整扇窗的宇宙——照片缓慢漂移（Ken Burns），视频静音循环；底图之上仍是同一层深蓝玻璃蒙版，面板可读性不变。支持 JPG/PNG/WebP/GIF/AVIF 与 MP4/WebM，上限 512 MB；文件只写在本机（~/.dsh/star-wallpaper/），不走网络、不进安装包；「恢复星云」一键回到姬子的星云。设置壁纸后，启动屏的底图也会跟着换成这张照片。
默认星云同样参与取色：没放照片时也会从星云里取种子色，图标和主题色不会和背景脱节。
启动屏通过宿主端的 webserver/index-inject 注入一层 [data-dsh-boot] 作用域的样式。启动页不再是纯黑 HARNESS：星云壁纸 + 液态玻璃胶囊 + 官方 deepseek HARNESS 标志 + 鲸鱼尾巴加载动画 + 「正在点亮星月夜…」+ 底部主题落款。dsh web 首帧即生效；桌面端在下一次启动时由 boot payload 注入（应用启动时采集，装好后重启一次即可看到）。
兼容性¶
1.2.0 起，皮肤层不再按 DSH 的完整哈希类名书写，而是改成语义钩子：data-* 属性、aria-label、role，以及类名里稳定的语义后缀（如 _card / _entry / _iconButton）。DSH 再重哈希前缀时，这些规则仍然命中；真正失效时只会「局部褪色」，不会整片崩掉。
支持的 DSH Web 版本：>=0.2.1-rc.3 <0.3.0（在 0.2.1-rc.3 的 Web 版与桌面端实测完整适配）。更旧的版本（如 0.2.1-rc.2）会退到「部分适配 / 基础模式」：壁纸、动态配色与基础变量仍然生效。
插件启动时会做一次「UI 指纹」检查。设置 → 关于 里会显示「兼容状态」和「界面锚点」：
- 完整：当前 DSH 前端与主题构建时一致，全部皮肤生效；
- 部分适配 / 基础模式：检测到 DSH 前端已变化，插件会如实显示降级状态；壁纸与基础变量继续生效，组件皮肤静默失效，不会把宿主拖崩。
控制台会打印一行 [star-wallpaper] DSH <版本> · compat <等级> · anchors <n>/<m>；也可以在页面控制台查看 window.__SWS_COMPAT__ 核对当前状态。稳定锚点：输入框、发送/添加按钮、会话头部控件等核心组件会在运行时被标上 data-sws-*，玻璃样式同时挂在锚点上。
安装与启用¶
从 GitHub 安装（推荐）：
dsh plugin add https://github.com/Yoimiya-Lover-0621-01/himeko-starry-night
或从本地目录安装：
dsh plugin add "D:\path\to\dsh-star-wallpaper"
或在 Harness 的「插件 → 添加插件」里选择本目录。安装后重启/刷新 Web UI 生效。
安装（或更新）本插件后请重启一次 DSH：「外观偏好默认值」写在 bundle 层，只在宿主启动时读取；只刷新页面的话，皮肤会更新，但外观默认值要等下一次启动才生效。如果重启后仍是浅色，说明当前 profile 的 cordis.patch.yml 里有一条显式的 ui-theme 外观配置覆盖了插件默认值——把它删掉，或直接在设置 → 通用 → 外观里手动选「深色」。
版权与素材¶
星云壁纸（assets/nebula.jpg、assets/boot.jpg）：取自游戏《崩坏：星穹铁道》4.4 版本的 CG，版权归米哈游（miHoYo）所有。这里仅作个人欣赏与主题装饰使用，不做任何商业用途；如果要二次分发或商用，请自行替换为拥有授权的图片。
deepseek HARNESS 标志（assets/brand-lockup.svg）与鲸鱼尾巴加载动画（assets/whale-tail.png）：取自 DeepSeek Harness 官方前端资源，版权归 DeepSeek 所有，这里只用于本主题的界面装饰。
README 例图里的自定义背景（preview-background.jpg）：取自游戏《原神》的官方美术，版权归米哈游（miHoYo）所有，仅用于演示「自定义背景」效果。
其余 CSS / JS 代码与 icon.svg 为本项目原创，使用 MIT 许可证。
目录¶
client.js：构建产物（勿手改）index.js：宿主半边，负责往启动页注入样式，并提供「背景」需要的本机存图路由；启动不依赖它也能正常进入应用tools/client.template.js：样式与逻辑源文件tools/build-client.mjs：构建脚本（把壁纸与鲸鱼尾巴内联成 base64）tools/selectors-report.mjs：类名选择器清单（适配新 DSH 版本时比对用）assets/nebula.jpg：裁切后的星云画作（3051x1295）assets/boot.jpg：启动屏用压缩壁纸（1600x679）assets/brand-lockup.svg：从官方品牌组件提取的 deepseek HARNESS 标志assets/whale-tail.png：官方 28×28 鲸鱼尾巴 APNG（从 ui-chat 运行时样式提取）assets/whale-tail-still.svg：同一只尾巴的静态 SVG（reduced-motion 回退）preview.png/preview-settings.png/preview-plugins.png/preview-background.jpg：README 里的界面截图（浏览器版，侧栏个人会话已隐去）cordis.patch.yml：把本插件挂进 bundle，并把外观偏好默认设为深色
示例用法¶
- 安装插件后重启 DSH，观察默认深色主题与星云壁纸的配合。
- 在设置 → 背景中上传一张本地照片或视频，观察照片漂移效果与 UI 色相跟随变化。
- 在控制台查看
window.__SWS_COMPAT__与插件启动日志，确认兼容状态。
适用场景与注意¶
本插件以当前 DSH 进程权限运行，建议安装前检查源码与许可证。素材版权归属米哈游与 DeepSeek，仅限个人欣赏与主题装饰使用。
总结¶
姬子的星月夜为 DSH 提供了一套完整的动态壁纸 + 液态玻璃主题方案，从启动屏到主界面、从输入框到加载指示器，全部纳入同一套材质与取色逻辑。默认深色锁定与兼容性降级机制，让它在旧版本上也能以基础模式运行。
- 插件目录页：https://www.skillhub.cn/plugins/Yoimiya-Lover-0621-01/himeko-starry-night
- GitHub：https://github.com/Yoimiya-Lover-0621-01/himeko-starry-night
