dsh-client-ui-skin-denia

一句话定位

为 DSH Web 客户端套上《鸣潮》达妮娅主题的整套视觉皮肤，把界面换成粉紫渐变、泡泡与锁链装饰的同人风格，并提供右下角可视化调色板让你自定义每个细节。

核心能力

• 切换界面整体配色：覆盖背景、玻璃卡片层级、侧栏 Q 版吉祥物、左右角色立绘、链状边框、四角星与彩虹装饰条
• 切换为达妮娅双形态：布景之形（亮色，慵懒校园氛围）/ 幻灭之形（暗色，共鸣解放虚质星空），切换时播放约 4–5 秒的形态变换动画
• 装饰场叠加：背景磨砂薄纱 + 双层虹彩泡泡粒子场（数量与速度可调）+ 跟随侧栏宽度的深紫锁链边框
• 文本与按钮重命名：把 DSH 的浅色/深色切换按钮文案替换为「布景之形 / 幻灭之形」，工作区与会话标题改成粉紫渐变
• 新会话欢迎界面注入：聊天为空时显示「达妮娅」标题 + 副标题 + 台词气泡
• 可视化调色板：界面右下角抽屉式面板，所有参数滑杆/开关/上传即时生效，刷新不丢
• 智能联动淡出：右侧 workbench 面板打开或 DevTools 停靠时，立绘和 Q 版自动淡到 20% 不挡视线
• 自动更新检查：每次加载时调 GitHub Releases API 比对版本，调色板底部提示有无可用更新

技术实现

• 语言: JavaScript (ESM，浏览器端单文件包)
• 关键依赖: @deepseek-ai/cordis (peer) 作为插件宿主契约；不依赖任何 npm 运行时包，所有素材都是内联 base64
• 架构模式: Cordis 纯客户端插件：node 端入口 lib/index.js 仅提供空的 apply() 占位（不挂任何 node 服务），全部实现在 lib/client.js，通过 window.__ModuleLoader__.load({ id, factory }) 注入到 DSH Web 浏览器上下文；通过 ctx.effect(dispose) 注册反注册钩子，在切换皮肤时把注入的 DOM、data-* 属性、<style>、<meta theme-color> 等全部复原
• 入口文件: cordis.patch.yml（把 ui-skin-denia 注册进 web profile 的 client 注入白名单）+ lib/client.js（浏览器端主逻辑）

适用场景

想把 DSH Web 界面换成自己喜欢风格的二次元/游戏角色主题用户，或者希望在 DSH 默认极简风之外获得更强视觉氛围、同时希望保留完整对话功能的用户；尤其适合鸣潮达妮娅粉丝或喜欢粉紫/泡泡装饰风格的审美向用户。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:Ewnscat-ya/dsh-client-ui-skin-denia

配置项

本插件无需 config.json。所有配置均通过界面右下角圆形紫色按钮唤起的「调色板」面板调节，结果自动写入浏览器 localStorage（键 denia-palette-settings）。面板分两组：

常见问题

Q: 安装后在哪里切换皮肤？

A: 重启 DSH Web 后进入设置 → 皮肤，选择「达妮娅 · 虚无之泡」即可；如果列表里看不到该条目，确认 cordis.patch.yml 中 ui-skin-denia 行未被 disabled: true 注释掉，或手工 cd <harness>/profiles/web && npm i ../dsh-client-ui-skin-denia 强制重新链接。

Q: 启用了但界面没有变化怎么办？

A: 皮肤通过给 <body> 注入 data-dsh-denia 属性挂载，被另一款皮肤或互斥逻辑覆盖时该属性会被清掉。可以在 DevTools 控制台执行 document.body.dataset.dshDenia === '' 验证；为 undefined 说明被其它皮肤抢占了。

Q: 支持 DSH 桌面端（host profile）吗？

A: 不支持。package.json 中 dsh.client.platform 限定为 web，bundle patch 也只插入 web 的 client 注入清单；host 端加载不到该包。

Q: 能否商用？

A: 仓库采用 CC BY-NC-SA 4.0 协议，禁止商业使用；达妮娅 / 鸣潮为 Kuro Games 商标，本皮肤为粉丝同人作品，与库洛游戏无关，详见 NOTICE 文件的署名链。

Q: 调色板里改了设置会同步到其他设备吗？

A: 不会。所有参数都存在浏览器本地 localStorage 的 denia-palette-settings 键中，换设备或清缓存都需要重调；如果想出厂重置，点击面板底部「♻ 恢复默认设置」按钮。

Q: 为什么有时候看不到立绘和 Q 版？

A: 皮肤会监听右侧 workbench 面板与 DevTools 停靠状态，它们打开时立绘/Q 版会自动淡到 20% 透明度以免遮挡内容；关闭后会恢复（client.js:798-803 的 MutationObserver）。

Q: 皮肤会自动更新吗？

A: 不会自动下载。每次加载时皮肤会请求 GitHub Releases API（15s 超时，HTTP 403/网络错误静默失败）比对最新 tag，发现新版本只在调色板底部显示一条「✨ vX.Y.Z 可用 →」链接，需要你手动执行安装命令升级。

Q: 怎么完全卸载？

A: 删除 profiles/web/node_modules/@dsh-external/dsh-client-ui-skin-denia/ 目录，或跑 dsh plugin remove @dsh-external/dsh-client-ui-skin-denia（如该命令在你版本的 DSH 可用），然后重启 DSH Web 即可；皮肤的反注册钩子（client.js:1481-1514）会清理注入的 DOM、CSS 变量、<style>、<meta theme-color> 等所有副作用。

上手难度

入门 — 安装重启后在「设置 → 皮肤」中选择即可启用，所有可调项都在界面右下角调色板里，点开就有中文提示，无需写代码或编辑配置文件。

已知问题与限制

• DevTools 停靠模式下，左/右立绘和侧栏 Q 版会被强制淡至 20% 透明度以避免遮住控制台（已在 v0.0.4 引入；client.js:798-803），调试排错时可暂时关闭 DevTools 或先关掉立绘开关
• 早期版本（v0.0.2 之前）曾出现：刷新后 Q 版不显示、对话宽度滑块不生效、立绘闪烁；触发根因均为 DSH Web 的 React 异步渲染与哈希化的 className 与皮肤假设的稳定选择器对不上，已通过 getBoundingClientRect 替代 getComputedStyle、加 2 秒延迟重试、改为匹配 _centerCol/_viewArea/_composerSeat 真实 DOM 解决（README.md v0.0.2 更新日志）
• 历史上的「回响涟漪 + 虚质侵蚀」两项动效因会引起悬停抖动被主动移除，改为当前调色板开关控制的「消息文本框」装饰（client.js:312-314）
• 调色板版本检查依赖访问 api.github.com，在 15 秒内无响应会静默放弃；如果你的网络受限（例如代理/VPN 拉长 TLS 握手），新版本提示可能不显示，需要手动比对
• 仅支持 Web 客户端；不支持 host/桌面 profile，且对 DSH Web 版本敏感（dsh.client.version 卡在 0.1.0-rc.6 – 0.1.0-rc.7），未来 DSH 大版本升级可能导致皮肤失效

DeepSeek Harness Web GUI 的鸣潮达妮娅主题皮肤。

效果预览

点击图片可查看完整尺寸。

特性

• 双形态切换：布景之形（亮色）/ 幻灭之形（暗色），含形态切换动画
• 左右全身立绘 + Q版动态 GIF 吉祥物
• 玻璃卡片层级：root 半透明 + backdrop-filter 模糊
• 泡泡粒子场：双层虹彩气泡上浮
• 锁链边框：深紫锁链，跟随侧栏宽度
• 渐变文字：工作区/会话标题粉紫渐变
• 装饰条 + 四角星：侧边栏彩虹渐变装饰
• 深色/浅色按钮文字替换：布景之形 / 幻灭之形
• 新会话欢迎界面注入：达妮娅标题 + 副标题 + 台词
• 侧栏收起/展开自适应布局：立绘 + Q版 + 文字居中联动
• 黑白娅分别背景图

版权所有人

*背景 / 角色 / 画框素材及预览截图来自用户本地素材库。本皮肤为同人创作，与 Kuro Games 无关联。

安装

懒人版

对你的 dsh 说：

安装一下这个皮肤包：https://github.com/Ewnscat-ya/dsh-client-ui-skin-denia

手动安装

git clone https://github.com/Ewnscat-ya/dsh-client-ui-skin-denia
cd <harness>
dsh plugin --profile web add ../dsh-client-ui-skin-denia

或手动将本包放入 DSH 的 profiles/web/node_modules/@dsh-external/dsh-client-ui-skin-denia/ 目录下，然后在 cordis.patch.yml 中添加：

- id: ui-skin-denia
  disabled: false

重启 DSH 后在设置 → 皮肤中选择"达妮娅 · 虚无之泡"。

调色板

皮肤加载后，界面右下角会出现一个可折叠的调色板面板。所有设置自动保存在浏览器 localStorage，刷新不丢失。

亮色 / 暗色（分形态独立控制）

通用（亮暗两形态同时生效）

点击「♻ 恢复默认设置」可一键还原所有选项。

兼容性

• DSH Web：0.1.0-rc.6、0.1.0-rc.7（dsh-web-frontend）
• 平台：Web
• 最近验证日期：2026-08-18

更新日志

v0.0.4 — 2026-08-18

新增

• 打开 DevTools 控制台（停靠状态）时，左/右立绘和侧栏 Q版自动淡出至 20% 透明度，关闭后恢复
• 版本检查超时从 5s 增加到 15s，修复代理/VPN 用户因延迟导致更新提示不显示

v0.0.3 — 2026-08-17

修复

• 侧边栏底部区域固定高度导致兼容性 bug：其他插件（如 API 余额显示）向 footer 添加内容时设置按钮被挤出画面。改为 flex:0 0 auto 自适应高度，保留 min-height 兜底

v0.0.2 — 2026-08-17

修复

• 对话宽度滑块不生效：CSS 选择器改为匹配 DSH Web 真实 DOM（_centerCol / _viewArea / _composerSeat）
• 左侧立绘闪烁：移除 getComputedStyle() 强制样式重算，改用 getBoundingClientRect() 位置检测
• 刷新后 Q版不出现：添加 2 秒延迟重试，应对 DSH React 异步渲染时序

新增

• 右侧 workbench 面板打开时，左立绘和 Q版表情包自动淡出至 20% 透明度，关闭后恢复
• 调色板新增控件：表情大小（60–240px）、表情竖直偏移（−200–200px），亮暗双形态同时生效
• 调色板底部显示当前版本，自动检查 GitHub Release，有新版时提示更新
• README 兼容性声明、package.json dsh.client.version 字段

v0.0.1

• 初始发布

致谢

*反馈问题尽可能在 issue 中发起。

许可

本仓库以 CC BY-NC-SA 4.0（署名-非商业性使用-相同方式共享）发布，禁止商业性使用。署名链见 NOTICE。

Character "Denia" (达妮娅) and "Wuthering Waves" (鸣潮) are trademarks of Kuro Games. This skin is a fan work and is not affiliated with or endorsed by Kuro Games.