dsh-any-background 0.2.6 → 0.2.7
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.
- package/README.md +163 -162
- package/README.zh.md +163 -162
- package/lib/client.js +284 -36
- package/lib/client.js.map +1 -1
- package/lib/index.js +10 -4
- package/package.json +2 -9
package/README.zh.md
CHANGED
|
@@ -1,162 +1,163 @@
|
|
|
1
|
-
# dsh-any-background
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<a href="https://
|
|
5
|
-
<a href="https://
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
<
|
|
23
|
-
<
|
|
24
|
-
<
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
<
|
|
29
|
-
<
|
|
30
|
-
<
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
<
|
|
35
|
-
<
|
|
36
|
-
<
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
<
|
|
41
|
-
<
|
|
42
|
-
<
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
<
|
|
47
|
-
<
|
|
48
|
-
<
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
<
|
|
53
|
-
<
|
|
54
|
-
<
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
|
|
98
|
-
### v0.2.
|
|
99
|
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
|
|
112
|
-
## 安装
|
|
113
|
-
|
|
114
|
-
### 方式一：npm 安装（推荐）
|
|
115
|
-
|
|
116
|
-
```sh
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
pnpm
|
|
147
|
-
pnpm
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
- **[
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
1
|
+
# dsh-any-background
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://www.npmjs.com/package/dsh-any-background"><img alt="npm 版本" src="https://img.shields.io/npm/v/dsh-any-background?color=4d6bfe"></a>
|
|
5
|
+
<a href="https://www.npmjs.com/package/dsh-any-background"><img alt="npm 月下载量" src="https://img.shields.io/npm/dm/dsh-any-background?color=4d6bfe"></a>
|
|
6
|
+
<a href="https://github.com/Tkingxiao/dsh-any-background/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/npm/l/dsh-any-background?color=4d6bfe"></a>
|
|
7
|
+
<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本：0.1.5-rc.2" src="https://img.shields.io/badge/DSH-0.1.5--rc.2-4d6bfe" /></a>
|
|
8
|
+
<a href="https://github.com/topics/dsh-better-sidebar"><img alt="插件生态：GitHub topic dsh-better-sidebar" src="https://img.shields.io/badge/%E6%8F%92%E4%BB%B6%E7%94%9F%E6%80%81-topic%20dsh--better--sidebar-4d6bfe" /></a><br /><br />
|
|
9
|
+
<a href="https://github.com/Tkingxiao/dsh-any-background"><img src="https://img.shields.io/github/stars/Tkingxiao/dsh-any-background?style=social" alt="GitHub stars"></a>
|
|
10
|
+
<a href="https://dsh.directory/plugins/tkingxiao/dsh-any-background"><img src="https://dsh.directory/badges/listed.svg" alt="dsh.directory listed"></a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
[English](README.md) | 中文
|
|
14
|
+
|
|
15
|
+
一个 **DeepSeek Harness** 外观插件：自定义主题色、背景壁纸（图片 / 视频 / 算法动态生成），以及逐表面的透明度与模糊度控制。当前版本面向 **DSH 0.1.5-rc.2**。
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 截图
|
|
20
|
+
|
|
21
|
+
<p align="center">
|
|
22
|
+
<img src="example_img/image.png" alt="自定义主页" width="720">
|
|
23
|
+
<br/>
|
|
24
|
+
<em>自定义主页 · 壁纸与主题色同时生效</em>
|
|
25
|
+
</p>
|
|
26
|
+
|
|
27
|
+
<p align="center">
|
|
28
|
+
<img src="example_img/image-2.png" alt="主题色选择器" width="720">
|
|
29
|
+
<br/>
|
|
30
|
+
<em>主题色选择器 · PS 风格色轮 + 精确 HSL/RGB 输入</em>
|
|
31
|
+
</p>
|
|
32
|
+
|
|
33
|
+
<p align="center">
|
|
34
|
+
<img src="example_img/image-3.png" alt="分部位透明度与模糊度" width="720">
|
|
35
|
+
<br/>
|
|
36
|
+
<em>分部位透明度与模糊度 · 主背景、侧边栏、卡片、设置面板</em>
|
|
37
|
+
</p>
|
|
38
|
+
|
|
39
|
+
<p align="center">
|
|
40
|
+
<img src="example_img/image-4.png" alt="背景编辑器" width="720">
|
|
41
|
+
<br/>
|
|
42
|
+
<em>背景编辑器 · 图片/视频壁纸支持拖动平移与滚轮缩放</em>
|
|
43
|
+
</p>
|
|
44
|
+
|
|
45
|
+
<p align="center">
|
|
46
|
+
<img src="example_img/image-6.png" alt="动态生成背景" width="720">
|
|
47
|
+
<br/>
|
|
48
|
+
<em>动态生成背景 · 网格渐变 / Shader / 几何图案预设</em>
|
|
49
|
+
</p>
|
|
50
|
+
|
|
51
|
+
<p align="center">
|
|
52
|
+
<img src="example_img/image-9.png" alt="几何背景 低多边形模式" width="720">
|
|
53
|
+
<br/>
|
|
54
|
+
<em>动态生成背景 · 几何 低多边形模式预览</em>
|
|
55
|
+
</p>
|
|
56
|
+
|
|
57
|
+
<p align="center">
|
|
58
|
+
<img src="example_img/image-10.png" alt="配置导出导入" width="720">
|
|
59
|
+
<br/>
|
|
60
|
+
<em>配置的导出和导入进行分享</em>
|
|
61
|
+
</p>
|
|
62
|
+
|
|
63
|
+
## 功能特性
|
|
64
|
+
|
|
65
|
+
- **PS 风格色轮** — 在色相环上选取色相，在内嵌方形中调整饱和度与明度，实时生成 30+ 个 CSS 设计令牌。
|
|
66
|
+
- **精确 HSL / RGB 输入** — 通过数值精确输入颜色，与色轮实时双向同步。
|
|
67
|
+
- **智能取色** — 一键从壁纸提取主题色：采样可见区域、量化像素、剔除灰色/近黑/近白，选出现量最大的鲜亮色。视频壁纸自动截帧参与取色。纯客户端完成。
|
|
68
|
+
- **吸管取色** — 在壁纸上悬停预览颜色，点击即可选为主题色。
|
|
69
|
+
- **背景壁纸** — 上传任意图片作为壁纸，在视口比例的编辑器中拖动平移、滚轮缩放。
|
|
70
|
+
- **视频壁纸** — 上传视频作为动态壁纸：静音循环播放、刷新不丢失（落盘持久化 + HTTP 流式播放，支持 Range seek）；自动截取一帧用于预览、主题色提取与位置编辑参考。
|
|
71
|
+
- **位置编辑器** — 图片与视频共用同一套编辑器：拖动平移、滚轮缩放、一键重置；图片与视频的位置状态各自独立保存，互不覆盖。
|
|
72
|
+
- **布局模式** — 适应 / 填充 / 拉伸 / 平铺 / 居中五种排布，图片与视频通用；「适应」模式下编辑器提交的构图在窗口缩放、跨屏移动后保持一致。
|
|
73
|
+
- **动态生成背景** — 支持网格渐变、Shader、几何图案，可调节扩散范围、色彩强度并锁定种子。
|
|
74
|
+
- **分部位界面透明度** — 主背景、侧边栏、卡片面板（含对话框周围的选项框/菜单）、输入框与控件（发送框、Cordis 插件面板）、设置面板、对话文本框、轨迹页、better-sidebar 工作台、产出物/高亮内容各自独立滑块。
|
|
75
|
+
- **分部位界面模糊度** — 每个界面部位可独立调整毛玻璃 `backdrop-filter` 模糊（0–60 px），并通过宿主的稳定选择器为发送框、Cordis 面板与弹出层提供真实背景模糊。
|
|
76
|
+
- **产出物 / 高亮内容** — 对话正文里的代码块（含语言顶栏）、行内 `code` 高亮芯片与产出物 chip 共用一支滑块：透明度只**调制这些表面原本的背景色**（不会在旧背景上再叠一层新色），模糊度给同一层表面加磨砂，壁纸从内容后方透出来。
|
|
77
|
+
- **better-sidebar 工作台** — 安装 dsh-better-sidebar 时出现独立滑块（`panelOpacity` / `blurs.panel`），接管其底部工作台面板与原生右侧栏的表面令牌；未安装该插件时该行不显示，滑块无副作用。
|
|
78
|
+
- **对话视图卡片** — 消息列表自动包裹为半透明卡片，轨迹页可整页调节透明度与模糊，让壁纸从内容后方透出来。
|
|
79
|
+
- **主题导出 / 导入** — 一键导出为自包含的 `dsh-any-theme.json`（配置 + 壁纸，视频以 data URL 内嵌），可随时导入还原。
|
|
80
|
+
- **外观预设与配置档案** — 六套一键预设（默认 / 毛玻璃 / 极简白 / 暗夜紫 / 赛博 / 暖阳），外加自定义命名档案：随时保存当前观感、随时套回，删除有二次确认保护。
|
|
81
|
+
- **壁纸轮换** — 把多张图片加入轮换池（缩略图选择器），按随机或顺序、每次刷新 / 每天 / 每周的频率自动更换；切换时服务端把所选图片复制进当前壁纸槽，导出/导入与取色管线完全不用改。
|
|
82
|
+
- **昼夜自动切换** — 指定日间与夜间两套配置，按固定时段或跟随系统深色模式自动切换。
|
|
83
|
+
- **强制界面明暗** — 无论主题色明暗如何，都能强制生成亮色/暗色整套令牌；「自动」下配色与字体方向由主题色明度驱动（深色 → 浅字，浅色 → 深字），未选主题色时按壁纸画面亮度判断。
|
|
84
|
+
- **文件持久化** — 所有设置保存到文件系统 `~/.dsh/.dsh-any-background-data/`，不再依赖 `localStorage`。
|
|
85
|
+
- **中英双语** — 完整的中英文界面，自动跟随语言设置。
|
|
86
|
+
- **主题守护** — 宿主重置主题后自动重新激活自定义主题。
|
|
87
|
+
|
|
88
|
+
## 更新日志
|
|
89
|
+
|
|
90
|
+
### v0.2.7
|
|
91
|
+
|
|
92
|
+
- **新增「产出物 / 高亮内容」滑块** — 对话里的代码块（含语言顶栏）、行内 `code` 高亮芯片与产出物 chip 现在共用一支透明度 + 模糊度滑块。透明度是这些表面**自身背景色的 alpha**：100% 与宿主原样逐色一致，下调时淡出的就是它原本那块颜色，而不是在旧背景上再叠一层新色（此前代码块外层仍不透明，滑块只是在原色上混入插件调色板颜色，模糊也因此看不见效果）；模糊度用 `backdrop-filter` 给同一层表面加磨砂。文档预览里不在 `.md-code-block` 内、只靠 `--shiki-background` 上色的代码块也一并覆盖。
|
|
93
|
+
- **新增 better-sidebar 工作台滑块** — 通过 `[data-dsh-bottom-panel]` 与 `[data-sidebar-right-panel]` 为 dsh-better-sidebar 的底部工作台面板提供独立的透明度（`panelOpacity`）与模糊度（`blurs.panel`）；面板表面按插件调色板重新着色，并新增强度更高的可复用规则（面板令牌重映射 + 面板模糊）。未安装该插件时该行不显示，滑块无副作用。
|
|
94
|
+
- **弹出层模糊归位** — 新增 `POPOVER_BLUR_RULE`：「卡片」模糊滑块现在同时落到下拉菜单 / 弹出层这类弹出表面，不再只影响对话框内的面板。
|
|
95
|
+
- **宿主支持收敛** — 只面向 **DSH 0.1.5-rc.2**（已在该版本上验证）：`engines.dsh` 与 `dsh.compatibility.dshReleases` 只声明这一项，README 删除旧的 8 版本矩阵；`panelOpacity` 进入档案 / 导出导入 / 昼夜切换的完整链路。
|
|
96
|
+
- **六套预设同步新参数** — 工作台透明度随预设给出（毛玻璃 0.85 / 暗夜紫 0.8 / 暖阳 0.75 等），产出物滑块默认 100%（即宿主原样）。
|
|
97
|
+
|
|
98
|
+
### v0.2.6
|
|
99
|
+
|
|
100
|
+
- **修复窄视口（移动端布局）顶栏与内容区割裂** — 窄视口下宿主在对话列之外另有一个 52px 高的固定会话标题条（`.dsh-mobile-app-header`），主背景不透明度此前只写在三列上，该标题条便直接透出清晰壁纸，与下方半透明的内容区明显割裂（[#11](https://github.com/Tkingxiao/dsh-any-background/issues/11)）。现在标题条复用插件自有的 `--dsh-any-op-bg` 变量，自动跟随「主背景不透明度」滑块与主题切换；未设置时回退宿主默认外观。
|
|
101
|
+
- **主背景模糊镜像到 `:root`** — 新增全局变量 `--dsh-any-part-blur-global`（跟随「主背景模糊」滑块），顶栏据此同步磨砂效果；第三方样式也可直接引用，与既有全局变量 `--dsh-any-input-blur` / `--dsh-any-blur-settings` / `--dsh-any-blur-card-panels` 一致（元素级的 `--dsh-any-part-blur` 在列子树之外继承不到）。
|
|
102
|
+
- **启动提速，告别白屏等待** — 壁纸不再以 base64 走 RPC 通道。上传以原始字节流直接落盘，持久化的图片通过 HTTP 路由由浏览器原生解码显示，与普通 `<img>` 完全一致。共享解码缓存把同一张壁纸的四次按 URL 解码（取色、明暗判定、拖动降采样、尺寸读取）合并为一次。大壁纸启动恢复从 ~5.5 s 降到 ~1.2 s（RPC 读取 3010 ms → ~170 ms，首次解码 1464 ms → ~780 ms）。
|
|
103
|
+
- **原地替换壁纸后必然显示新图** — 上传、网址下载与轮换都发生在同一个 serve URL 背后，此前所有按 URL 键控的缓存——图层重设守卫、解码缓存、明暗判定与低清拷贝——都还握着旧像素。图片槽现与视频槽一样携带查询串版本号，每次替换都会得到新 URL、触发新解码。
|
|
104
|
+
- **自动取色无竞态** — 取色解码期间壁纸被替换时，旧图颜色不再有机会覆盖新图（与明暗判定采用同一套单调守卫）。
|
|
105
|
+
- **上传更健壮** — 视频上传上限 2 GB、使用独立临时文件（并发的壁纸上传不会损坏它）、并在服务端立即记录 MIME；两个上传路由与 RPC 通道一样加上了 Host/Origin 围栏。
|
|
106
|
+
- **四个新动态背景预设** — Shader 新增**星空**（缓慢星云幕布上的三层闪烁星点）；几何图案新增**雨滴**（下落的光痕）、**等高线**（漂移的地形流线）与**流体光斑**（缓慢漂移的柔光色球），均与既有预设一样可调参数、可锁种子。
|
|
107
|
+
- **动态背景可暂停** — 「重新生成」旁新增暂停/播放按钮，直接停掉画布动画循环而不拆除背景（仅当前会话有效，重新生成或刷新后恢复播放）。
|
|
108
|
+
- **尊重系统减弱动态偏好** — 系统开启 `prefers-reduced-motion` 时，动态背景只渲染首帧、不再运行动画循环。
|
|
109
|
+
- **网络视频 URL 壁纸** — 「从网址」流程现可识别视频链接：服务端以流式下载写入视频槽（上限 2 GB、60 秒无数据超时，MIME 取自 Content-Type 或扩展名）并写入配置；播放、截帧与取色沿用既有 serve 路由。
|
|
110
|
+
- **清理** — 移除启动性能探针与静态快照死代码；网址下载的壁纸直接写盘，不再经过临时 base64 字符串。
|
|
111
|
+
|
|
112
|
+
## 安装
|
|
113
|
+
|
|
114
|
+
### 方式一：npm 安装（推荐）
|
|
115
|
+
|
|
116
|
+
```sh
|
|
117
|
+
# 已发布到 npm registry
|
|
118
|
+
dsh plugin --profile web add dsh-any-background
|
|
119
|
+
|
|
120
|
+
# 或直接安装 GitHub 仓库
|
|
121
|
+
dsh plugin --profile web add github:Tkingxiao/dsh-any-background
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
然后启动：
|
|
125
|
+
|
|
126
|
+
```sh
|
|
127
|
+
dsh web
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
插件会出现在设置面板的 **“主题”** 分类中。
|
|
131
|
+
|
|
132
|
+
### 方式二：npx（无需全局安装）
|
|
133
|
+
|
|
134
|
+
```sh
|
|
135
|
+
npx @deepseek-ai/dsh plugin --profile web add dsh-any-background
|
|
136
|
+
npx @deepseek-ai/dsh web
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### 方式三：本地构建（开发）
|
|
140
|
+
|
|
141
|
+
`lib/` 目录已提交，安装后无需构建。修改 `src/` 后重新构建：
|
|
142
|
+
|
|
143
|
+
```sh
|
|
144
|
+
git clone https://github.com/Tkingxiao/dsh-any-background.git
|
|
145
|
+
cd dsh-any-background
|
|
146
|
+
pnpm install
|
|
147
|
+
pnpm run bundle
|
|
148
|
+
pnpm dsh plugin --profile web add "dsh-any-background"
|
|
149
|
+
pnpm dsh web
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
## 兼容性
|
|
153
|
+
|
|
154
|
+
- **[`dsh web`](https://github.com/deepseek-ai/deepseek-harness) 0.1.5-rc.2** — 当前版本只面向 `0.1.5-rc.2`（已在该版本上验证）；`package.json` 的 `engines.dsh` 与 `dsh.compatibility.dshReleases` 也只声明这一项。
|
|
155
|
+
- **[deepseek-harness-desktop](https://github.com/anywhere-labs/deepseek-harness-desktop)** — 支持
|
|
156
|
+
|
|
157
|
+
## Star History
|
|
158
|
+
|
|
159
|
+
[](https://www.star-history.com/?repos=Tkingxiao%2Fdsh-any-background&type=timeline&legend=bottom-right)
|
|
160
|
+
|
|
161
|
+
## 许可
|
|
162
|
+
|
|
163
|
+
MIT
|