@taosee258/dsh-client-ui-skin-qingxiao

Readme

# 清宵 · 弦凝清霄 — DSH 美化包

以《鸣潮》角色**清宵**（3.6 版本登场的五星气动·迅刀共鸣者，瑝珑「镇玄司骑」，琴剑双修的隐世剑仙）为主题的 DeepSeek Harness (DSH) Web 界面皮肤。

> 「弦凝千古寂，剑起满天清」

配色调色板取自清宵的形象：**冰蓝**（发色）、**青碧**（发饰流苏）、**月白**（衣装）、**玄夜蓝**（暗色形态）、**鎏金**（金饰点缀）。

![亮色 · 清昼庭院](preview/screen-light.png)

![暗色 · 玄夜剑鸣](preview/screen-dark.png)

## 这个皮肤有什么

- **背景画卷**：默认铺一张清宵插画当背景，亮色、暗色模式都能透出它。可以在设置面板里分别为两种模式换成你自己的图（PNG / JPG / WebP / GIF，7MB 以内），也能一键换回默认。
- **全套配色重制**：侧边栏、按钮、输入框、对话区、代码块、滚动条……界面每一处都按清宵的配色重新调过；暗色模式是专门的「玄夜剑鸣」氛围。
- **毛玻璃效果**：打开插件的小窗口（比如用量统计）、左右两侧面板、设置弹窗时，窗口背后的画面会被柔和地虚化掉——壁纸的轮廓透得出来，但绝不跟文字打架。想多糊可以多糊（0–30 档随意调），不想要可以整体关掉，也可以只关插件窗或只关侧栏。
- **字永远看得清**：文字颜色专门为「压在插画背景上」调校过——正文浓黑/亮白，次要文字也比 DSH 原生的灰色深两档；背景还有可调浓度的柔光遮罩兜底。
- **剑气流光**：可选的粒子装饰，青碧或鎏金两种色调；系统开了「减少动态效果」会自动静止。
- **亮暗切换动画**：切换主题时有一抹剑光扫过屏幕的小动画，浏览器标签栏颜色和图标也会跟着换。
- **新会话迎宾页**：打开空会话时，屏幕中央浮现「清 宵 · 镇玄司骑 · 徒儿，你来了……」的题字，开始对话后自动退场。
- **设置跟着账号走**：所有偏好保存在 DSH 的数据目录里，换个浏览器、重启电脑都还在。

## 设置面板

点界面右上角的**清宵剑钰圆形按钮**打开调色盘。按钮可以拖到任意位置，位置会记住；面板底部有「回到右上角」一键复位。

| 分区 | 能调什么 |
| --- | --- |
| 背景画卷 | 亮/暗两种模式的背景图更换与复原 |
| 阅读清晰度 | 文字柔光开关 · 背景遮罩浓淡 · 面板实透 · 正文字号大小 |
| 界面琉璃 | 对话区宽度 · 面板磨砂底 |
| 毛玻璃虚化 | 总开关 · 插件窗/侧栏面板分开控制 · 虚化强度 0–30（0＝关） |
| 剑气流光 | 开关 · 粒子数量 · 流动速度 |
| 复原 | 全部恢复默认 |

## 版本

各版本改动见 [CHANGELOG.md](CHANGELOG.md)。

## 安装

### 懒人版

直接对你的 DSH 说：
```
安装一下这个皮肤包：@taosee258/dsh-client-ui-skin-qingxiao
```

### 手动安装

**命令行安装**（任选其一）：

```sh
# 方式 A（推荐）：从 npm 安装
dsh plugin --profile web add @taosee258/dsh-client-ui-skin-qingxiao
```

```sh
# 方式 B：用 git URL 安装（始终对应仓库最新版）
dsh plugin --profile web add https://github.com/taoser258/dsh-client-ui-skin-qingxiao
```

```sh
# 方式 C：先克隆到本地任意位置，再把实际路径交给 dsh
git clone https://github.com/taoser258/dsh-client-ui-skin-qingxiao.git
dsh plugin --profile web add /path/to/dsh-client-ui-skin-qingxiao
```

**手动放置安装**：把本包整个文件夹复制到 DSH 的 `profiles/web/node_modules/@taosee258/dsh-client-ui-skin-qingxiao/` 下，然后在 profile 的 `cordis.patch.yml` 里追加一条（与本包自带的 `cordis.patch.yml` 保持一致）：

```yaml
- insert:
    - id: ui-skin-qingxiao
      name: '@taosee258/dsh-client-ui-skin-qingxiao'
```

重启 DSH 即可。

## 兼容性

- DSH Web：0.1.0-rc.6 至 0.1.2-alpha.1
- 平台：Web
- 最近验证：2026-09-04（亮/暗两种模式真机实测）

## 版权所有人

| 版权所有人 | 版权所有内容 |
|---|---|
| Kuro Games（库洛游戏） | 「鸣潮」游戏作品及清宵（Qingxiao）角色形象原作 |
| Fumi（pixiv） | 默认背景插画（`assets/qx.jpg`）原作 |
| taoser | 皮肤实现（配色、毛玻璃、粒子装饰与界面逻辑） |

\*本皮肤为同人创作，与 Kuro Games 无关联。

## 署名与许可

- 默认背景插画来自 **pixiv 画师 Fumi** 的《鸣潮》清宵同人插画（`assets/qx.jpg`），角色设定与游戏内容版权归库洛游戏所有。本皮肤仅供个人美化学习使用，与官方无关，请勿商用。
- 插件代码与结构在 CC BY-NC-SA 4.0 下发布，请勿用于商业用途。