@taosee258/dsh-client-ui-skin-qingxiao 0.1.3 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/LICENSE +25 -25
  2. package/README.md +46 -44
  3. package/lib/client.js +486 -59
  4. package/lib/index.js +190 -174
  5. package/package.json +6 -5
  6. package/preview/screen-dark.png +0 -0
  7. package/preview/screen-light.png +0 -0
  8. package/skin.json +30 -30
package/LICENSE CHANGED
@@ -1,25 +1,25 @@
1
- Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
2
-
3
- Copyright (c) 2026 the qingxiao skin authors
4
-
5
- You are free to:
6
-
7
- Share — copy and redistribute the material in any medium or format
8
- Adapt — remix, transform, and build upon the material
9
-
10
- Under the following terms:
11
-
12
- Attribution — You must give appropriate credit, provide a link to the
13
- license, and indicate if changes were made.
14
-
15
- NonCommercial — You may not use the material for commercial purposes.
16
-
17
- ShareAlike — If you remix, transform, or build upon the material, you
18
- must distribute your contributions under the same license as the original.
19
-
20
- Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
21
-
22
- Note: the bundled artwork (assets/qx.jpg) depicts the character 清宵 (Qingxiao)
23
- from Wuthering Waves (Kuro Games). It is included for personal, non-commercial
24
- decoration only and is not covered by the code license above; all rights
25
- belong to their respective owners.
1
+ Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
2
+
3
+ Copyright (c) 2026 the qingxiao skin authors
4
+
5
+ You are free to:
6
+
7
+ Share — copy and redistribute the material in any medium or format
8
+ Adapt — remix, transform, and build upon the material
9
+
10
+ Under the following terms:
11
+
12
+ Attribution — You must give appropriate credit, provide a link to the
13
+ license, and indicate if changes were made.
14
+
15
+ NonCommercial — You may not use the material for commercial purposes.
16
+
17
+ ShareAlike — If you remix, transform, or build upon the material, you
18
+ must distribute your contributions under the same license as the original.
19
+
20
+ Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
21
+
22
+ Note: the bundled artwork (assets/qx.jpg) depicts the character 清宵 (Qingxiao)
23
+ from Wuthering Waves (Kuro Games). It is included for personal, non-commercial
24
+ decoration only and is not covered by the code license above; all rights
25
+ belong to their respective owners.
package/README.md CHANGED
@@ -1,82 +1,73 @@
1
1
  # 清宵 · 弦凝清霄 — DSH 美化包
2
2
 
3
- 以《鸣潮》角色**清宵**（3.6 版本「蜃云灯影，凡尘剑心」登场的五星气动·迅刀共鸣者，瑝珑「镇玄司骑」，琴剑双修的隐世剑仙）为主题的 DeepSeek Harness (DSH) Web 界面皮肤。
3
+ 以《鸣潮》角色**清宵**（3.6 版本登场的五星气动·迅刀共鸣者，瑝珑「镇玄司骑」，琴剑双修的隐世剑仙）为主题的 DeepSeek Harness (DSH) Web 界面皮肤。
4
4
 
5
5
  > 「弦凝千古寂，剑起满天清」
6
6
 
7
- 调色板取自清宵的形象设定：**冰蓝**（发色）、**青碧**（发饰与流苏）、**月白**（衣装）、**玄夜蓝**（暗色形态）、**鎏金**（金饰点缀）。
7
+ 配色调色板取自清宵的形象：**冰蓝**（发色）、**青碧**（发饰流苏）、**月白**（衣装）、**玄夜蓝**（暗色形态）、**鎏金**（金饰点缀）。
8
8
 
9
9
  ![亮色 · 清昼庭院](preview/screen-light.png)
10
10
 
11
11
  ![暗色 · 玄夜剑鸣](preview/screen-dark.png)
12
12
 
13
- ## 功能
13
+ ## 这个皮肤有什么
14
14
 
15
- - **默认背景画卷**：工作区提供的清宵插画（`assets/qx.jpg`）作为 DSH 使用界面的默认背景，亮暗两种形态共用。
16
- - **自由更换背景**：设置面板内可分别为亮色 / 暗色形态上传自定义背景（PNG / JPG / WebP / GIF，≤7MB），一键复原默认画卷。
17
- - **全局清宵主题**：侧边栏、按键、输入框、对话区、会话详情栏、滚动条、代码块、链接、选区等全部按冰蓝·青碧·月白·鎏金配色重制；暗色形态映射玄夜剑鸣氛围。
18
- - **文字清晰度保障**：背景之上叠加可调浓度的渐变遮罩（scrim），内容面板使用半透明磨砂玻璃层；默认开启「文字对比增强」，亮色用墨青色文字、暗色用月白色文字，任何背景下都不糊字。
19
- - **剑气流光**：可选的青碧/鎏金流光粒子装饰（遵循系统「减少动态效果」偏好）。
20
- - **亮暗形态联动**：跟随 DSH 亮 / 暗主题切换，带一抹剑光扫幕过渡动画，浏览器 chrome 颜色与图标（玉青剑钰）同步更换。
21
- - **新会话迎宾页**：空会话中央浮现「清 宵 · 镇玄司骑 · 徒儿，你来了……」迎宾题字，有消息后自动隐去。
22
- - **设置持久化**：所有偏好通过 `/api/dsh-qingxiao/settings` 保存到 DSH profile 数据目录，换浏览器、重启后依然生效；接口不可用时自动回退到 localStorage。
23
-
24
- ## 版本
25
-
26
- 各版本改动见 [CHANGELOG.md](CHANGELOG.md)。
15
+ - **背景画卷**：默认铺一张清宵插画当背景，亮色、暗色模式都能透出它。可以在设置面板里分别为两种模式换成你自己的图（PNG / JPG / WebP / GIF，7MB 以内），也能一键换回默认。
16
+ - **全套配色重制**：侧边栏、按钮、输入框、对话区、代码块、滚动条……界面每一处都按清宵的配色重新调过；暗色模式是专门的「玄夜剑鸣」氛围。
17
+ - **毛玻璃效果**：打开插件的小窗口（比如用量统计）、左右两侧面板、插件页/自动化任务页等整页视图、设置弹窗乃至窗口顶栏，背后的画面都会被柔和地虚化掉——壁纸的轮廓透得出来，但绝不跟文字打架。想多糊可以多糊（0–30 档随意调），不想要可以整体关掉，也可以只关插件窗或只关侧栏。
18
+ - **字永远看得清**：文字颜色专门为「压在插画背景上」调校过——正文浓黑/亮白，次要文字也比 DSH 原生的灰色深两档；背景还有可调浓度的柔光遮罩兜底。
19
+ - **剑气流光**：可选的粒子装饰，青碧或鎏金两种色调；系统开了「减少动态效果」会自动静止。
20
+ - **亮暗切换动画**：切换主题时有一抹剑光扫过屏幕的小动画，浏览器标签栏颜色和图标也会跟着换。
21
+ - **新会话迎宾页**：打开空会话时，屏幕中央浮现「清 宵 · 镇玄司骑 · 徒儿，你来了……」的题字，开始对话后自动退场。
22
+ - **设置跟着账号走**：所有偏好保存在 DSH 的数据目录里，换个浏览器、重启电脑都还在。
27
23
 
28
24
  ## 设置面板
29
25
 
30
- 点击界面右上角的**清宵剑钰圆形按钮**展开设置面板（调色盘）。按钮支持自由拖动，位置跨重启持久保存，面板底部提供「回到右上角」一键复位：
26
+ 点界面右上角的**清宵剑钰圆形按钮**打开调色盘。按钮可以拖到任意位置，位置会记住；面板底部有「回到右上角」一键复位。
31
27
 
32
- | 分区 | 控件 |
28
+ | 分区 | 能调什么 |
33
29
  | --- | --- |
34
- | 背景画卷 | 亮色 / 暗色形态背景更换与复原默认 |
35
- | 阅读清晰度 | 文字对比增强开关 · 背景遮罩浓度 20–95% · 面板不透明度 30–100% · 正文字号缩放 85–125% |
36
- | 界面琉璃 | 对话区宽度 500–1000px · 面板磨砂玻璃开关 |
37
- | 剑气流光 | 启用开关 · 数量 0–60 · 速度 20–200% |
30
+ | 背景画卷 | 亮/暗两种模式的背景图更换与复原 |
31
+ | 阅读清晰度 | 文字柔光开关 · 背景遮罩浓淡 · 面板实透 · 正文字号大小 |
32
+ | 界面琉璃 | 对话区宽度 · 面板磨砂底 |
33
+ | 毛玻璃虚化 | 总开关 · 插件窗/侧栏面板分开控制 · 虚化强度 0–30（0＝关） |
34
+ | 剑气流光 | 开关 · 粒子数量 · 流动速度 |
38
35
  | 复原 | 全部恢复默认 |
39
36
 
40
- ## 版权所有人
41
-
42
- | 版权所有人 | 版权所有内容 |
43
- |---|---|
44
- | Kuro Games（库洛游戏） | 「鸣潮」游戏作品及清宵（Qingxiao）角色形象原作 |
45
- | Fumi（pixiv） | 默认背景插画（`assets/qx.jpg`）原作 |
46
- | taoser | 皮肤覆盖层实现（CSS 配色、剑气流光、迎宾页与 DOM 装饰逻辑） |
37
+ ## 版本
47
38
 
48
- \*本皮肤为同人创作，与 Kuro Games 无关联。
39
+ 各版本改动见 [CHANGELOG.md](CHANGELOG.md)。
49
40
 
50
41
  ## 安装
51
42
 
52
43
  ### 懒人版
53
44
 
54
- 对你的 DSH 说：
45
+ 直接对你的 DSH 说（桌面端、网页端都适用，会装进当前档案）：
55
46
  ```
56
- 安装一下这个皮肤包：https://github.com/taoser258/dsh-client-ui-skin-qingxiao
47
+ 安装一下这个皮肤包：@taosee258/dsh-client-ui-skin-qingxiao
57
48
  ```
58
49
 
59
50
  ### 手动安装
60
51
 
61
- **命令行安装**（任选其一）：
52
+ **命令行安装**（任选其一；`--profile` 按目标填：桌面端 `desktop`、网页端 `web`）：
62
53
 
63
54
  ```sh
64
- # 方式 A（推荐）：直接用 git URL 安装
65
- dsh plugin --profile web add https://github.com/taoser258/dsh-client-ui-skin-qingxiao
55
+ # 方式 A（推荐）：从 npm 安装
56
+ dsh plugin --profile desktop add @taosee258/dsh-client-ui-skin-qingxiao
66
57
  ```
67
58
 
68
59
  ```sh
69
- # 方式 B：先克隆到本地任意位置，再把实际路径交给 dsh
70
- git clone https://github.com/taoser258/dsh-client-ui-skin-qingxiao.git
71
- dsh plugin --profile web add /path/to/dsh-client-ui-skin-qingxiao
60
+ # 方式 B：用 git URL 安装（始终对应仓库最新版）
61
+ dsh plugin --profile desktop add https://github.com/taoser258/dsh-client-ui-skin-qingxiao
72
62
  ```
73
63
 
74
64
  ```sh
75
- # 方式 C：从 npm 安装
76
- dsh plugin --profile web add @taosee258/dsh-client-ui-skin-qingxiao
65
+ # 方式 C：先克隆到本地任意位置，再把实际路径交给 dsh
66
+ git clone https://github.com/taoser258/dsh-client-ui-skin-qingxiao.git
67
+ dsh plugin --profile desktop add /path/to/dsh-client-ui-skin-qingxiao
77
68
  ```
78
69
 
79
- **手动放置安装**：将本包完整复制到 DSH 的 `profiles/web/node_modules/@taosee258/dsh-client-ui-skin-qingxiao/` 目录下，然后在 profile 的 `cordis.patch.yml` 中追加一条 insert 项（与本包自带的 `cordis.patch.yml` 保持一致）：
70
+ **手动放置安装**：把本包整个文件夹复制到 DSH 的 `profiles/<档案名>/node_modules/@taosee258/dsh-client-ui-skin-qingxiao/` 下（桌面端档案为 `desktop`），然后在 profile 的 `cordis.patch.yml` 里追加一条（与本包自带的 `cordis.patch.yml` 保持一致）：
80
71
 
81
72
  ```yaml
82
73
  - insert:
@@ -84,13 +75,24 @@ dsh plugin --profile web add @taosee258/dsh-client-ui-skin-qingxiao
84
75
  name: '@taosee258/dsh-client-ui-skin-qingxiao'
85
76
  ```
86
77
 
87
- 重启 DSH。
78
+ 重启 DSH 即可。
88
79
 
89
80
  ## 兼容性
90
81
 
91
- - DSH Web：0.1.0-rc.6 至 0.1.2-alpha.1（dsh-web-frontend）
92
- - 平台：Web
93
- - 最近验证日期：2026-09-01（无头 Edge + CDP 实测亮/暗两形态）
82
+ - DSH Web / 桌面端：0.1.0-rc.6 至 0.2.0-rc.2
83
+ - 自 0.2.0 起针对官方桌面端 0.2.0-rc.2 深度适配：字号令牌新基准、顶栏毛玻璃横带与原生窗口按钮融合、插件/任务等整页视图毛玻璃背板、开关与徽章配色对齐
84
+ - 平台：Web / Windows 桌面端（设置保存在各自档案的 `data/` 目录下）
85
+ - 最近验证：2026-10-01（0.2.0-rc.2 桌面端亮/暗两态真机实测）
86
+
87
+ ## 版权所有人
88
+
89
+ | 版权所有人 | 版权所有内容 |
90
+ |---|---|
91
+ | Kuro Games（库洛游戏） | 「鸣潮」游戏作品及清宵（Qingxiao）角色形象原作 |
92
+ | Fumi（pixiv） | 默认背景插画（`assets/qx.jpg`）原作 |
93
+ | taoser | 皮肤实现（配色、毛玻璃、粒子装饰与界面逻辑） |
94
+
95
+ \*本皮肤为同人创作，与 Kuro Games 无关联。
94
96
 
95
97
  ## 署名与许可
96
98