deepseek-harness-background 0.5.2 → 0.5.4
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 +172 -168
- package/README.zh.md +170 -165
- package/lib/client.js +550 -1538
- package/lib/client.js.map +1 -1
- package/lib/index.js +1 -100
- package/package.json +85 -85
package/README.zh.md
CHANGED
|
@@ -1,165 +1,170 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<picture>
|
|
3
|
-
<source media="(prefers-color-scheme: dark)" srcset="docs/banner-zh-dark.svg">
|
|
4
|
-
<img src="docs/banner-zh.svg" alt="DeepSeek Harness Background" width="720">
|
|
5
|
-
</picture>
|
|
6
|
-
</p>
|
|
7
|
-
|
|
8
|
-
# DeepSeek Harness Background
|
|
9
|
-
|
|
10
|
-
[](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
|
|
11
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background/stargazers)
|
|
12
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background/releases)
|
|
13
|
-
[](https://www.npmjs.com/package/deepseek-harness-background)
|
|
14
|
-
[](https://www.npmjs.com/package/deepseek-harness-background)
|
|
15
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background/actions)
|
|
16
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background/issues)
|
|
17
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background/commits)
|
|
18
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background/graphs/commit-activity)
|
|
19
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background)
|
|
20
|
-
[](https://github.com/HaoyueQin/deepseek-harness-background)
|
|
21
|
-
[](LICENSE)
|
|
22
|
-
|
|
23
|
-
[English](README.md) | 中文
|
|
24
|
-
|
|
25
|
-
一个 **DeepSeek Harness Web GUI**（`dsh web`）的**自定义背景图片插件**：上传一张本地图片，或粘贴一个图片链接，把它绘制在整个应用界面背后，并可调节**不透明度**、**可读性遮罩**、**面板透明**与**毛玻璃模糊** —— 全部在设置面板内实时预览、松手自动保存。
|
|
26
|
-
|
|
27
|
-
外观（固定壁纸层 + 主题自适应遮罩 + 由 `--dsw-*` 设计 token 驱动的半透明玻璃面板）借鉴了社区 `dsh-wallpaper-engine` 的实现。
|
|
28
|
-
|
|
29
|
-
<p align="center">
|
|
30
|
-
<img src="docs/demo-zh.svg" alt="演示：上传壁纸后全站变毛玻璃，并在会话时间线的轮次之间平滑跳转">
|
|
31
|
-
</p>
|
|
32
|
-
|
|
33
|
-
## 截图
|
|
34
|
-
|
|
35
|
-
| | |
|
|
36
|
-
| --- | --- |
|
|
37
|
-
| **首页** | <img src="docs/images/home.jpg" alt="首页上的自定义背景" width="640"> |
|
|
38
|
-
| **会话界面** | <img src="docs/images/conversation.jpg" alt="会话背后的自定义背景" width="640"> |
|
|
39
|
-
| **设置界面** | <img src="docs/images/settings.jpg" alt="带实时预览的背景设置行" width="640"> |
|
|
40
|
-
|
|
41
|
-
## 功能
|
|
42
|
-
|
|
43
|
-
- **本地上传** —— 从电脑选择 JPG / PNG / WebP / GIF 图片；插件存入 harness home 目录，经同源路由提供（仅当声明的 MIME、探测到的文件签名与扩展名三者一致才被接受）。
|
|
44
|
-
- **粘贴 URL** —— 输入 `http(s)` 图片链接后回车即可。
|
|
45
|
-
- **面板内实时预览** —— 设置行顶部有预览卡：图片 + 遮罩 + 毛玻璃气泡；拖动任意滑块即时重绘，所见即所存。
|
|
46
|
-
- **阻尼滑块** —— 比例类滑块按 **5% 步进**、模糊类按 1/2px 步进吸附；拖动过程只改画面，**松手才保存**（每次手势一次写入，不再抖动）。
|
|
47
|
-
- **五个调节项** —— 壁纸不透明度、可读性遮罩、面板不透明度、毛玻璃模糊、壁纸模糊。
|
|
48
|
-
- **填充方式** —— `cover`（铺满、裁剪）或 `contain`（完整、留白）。
|
|
49
|
-
- **主题自适应遮罩** —— 浅色主题用白色纱帘（把图片提亮保持深色文字对比度），深色主题自动换成黑色纱帘（压暗图片保持浅色文字对比度）。
|
|
50
|
-
- **毛玻璃（白名单制）** —— 启用背景后，只有以小卡片/小按钮形态悬浮在壁纸上的表面才会变成半透明玻璃（顶部白色高光渐变 + `backdrop-filter`）：输入框卡片与消息气泡、代码块 / 终端 / diff / 工具 IO 卡 / 技能与 MCP 调用卡与行内代码、agent 任务条及其接管面板（审批 / 提问 / 计划评审）、三个铬件按钮（新会话、输入框加号、回到底部）、「加载更早」历史按钮、标题栏展开的子代理列表面板、侧栏构建徽标，以及首页右上角的「预览版」徽标——每块玻璃面都带完整配方（填充 + 高光 + 模糊），绝无"只透明不磨砂"的残缺面。阅读型表面——对话框、设置界面、菜单、Tooltip、Toast、悬停填充与所有强调色（发送键保持品牌蓝）——一律保留**官方不透明样式**，保证可读性（唯一例外：时间线导航轨的悬浮预览卡，它是画在壁纸上的导航铬件，加入玻璃配方）。模糊半径由「毛玻璃模糊」滑块驱动；「面板不透明度」调至 100% 时白名单表面也恢复官方原样。
|
|
51
|
-
- **第三方毛玻璃接口** —— 内置毛玻璃注册表（`window.__DSH_BACKGROUND_GLASS__` 全局 + `dsh-background-glass:ready` 事件）：任何插件都可把自家面板的选择器注册进来，套上与内置表面完全一致的配方——`token` 模式为已使用被覆盖 `--dsw-*` 填充的面板补齐高光+模糊链，`fill` 模式连填充一并接管；规则统一挂在 `data-dsh-bg-glass` 门控下随玻璃自动开关。消费方零依赖、未安装本插件时优雅降级，本插件卸载时整桥拆除。详见 [docs/GLASS_API.zh.md](docs/GLASS_API.zh.md)。
|
|
52
|
-
- **会话时间线** —— 长会话右缘的 DeepSeek 官网风格轮次导航轨：每一轮一个刻度，悬停或聚焦时预览该轮的问题。
|
|
53
|
-
- **持久化到官方设置文档** —— 存于 `$DSH_HOME/settings.yaml`，跨重启保留。
|
|
54
|
-
- **干净卸载** —— 关闭、清除或卸载后完整恢复原背景；插件只移除自己写过的内容。
|
|
55
|
-
|
|
56
|
-
##
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
dsh
|
|
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
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
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
|
-
│
|
|
147
|
-
│
|
|
148
|
-
│
|
|
149
|
-
│
|
|
150
|
-
│
|
|
151
|
-
│
|
|
152
|
-
│ ├──
|
|
153
|
-
│ ├──
|
|
154
|
-
│ ├──
|
|
155
|
-
│
|
|
156
|
-
└──
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/banner-zh-dark.svg">
|
|
4
|
+
<img src="docs/banner-zh.svg" alt="DeepSeek Harness Background" width="720">
|
|
5
|
+
</picture>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
# DeepSeek Harness Background
|
|
9
|
+
|
|
10
|
+
[](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
|
|
11
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background/stargazers)
|
|
12
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background/releases)
|
|
13
|
+
[](https://www.npmjs.com/package/deepseek-harness-background)
|
|
14
|
+
[](https://www.npmjs.com/package/deepseek-harness-background)
|
|
15
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background/actions)
|
|
16
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background/issues)
|
|
17
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background/commits)
|
|
18
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background/graphs/commit-activity)
|
|
19
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background)
|
|
20
|
+
[](https://github.com/HaoyueQin/deepseek-harness-background)
|
|
21
|
+
[](LICENSE)
|
|
22
|
+
|
|
23
|
+
[English](README.md) | 中文
|
|
24
|
+
|
|
25
|
+
一个 **DeepSeek Harness Web GUI**（`dsh web`）的**自定义背景图片插件**：上传一张本地图片，或粘贴一个图片链接，把它绘制在整个应用界面背后，并可调节**不透明度**、**可读性遮罩**、**面板透明**与**毛玻璃模糊** —— 全部在设置面板内实时预览、松手自动保存。
|
|
26
|
+
|
|
27
|
+
外观（固定壁纸层 + 主题自适应遮罩 + 由 `--dsw-*` 设计 token 驱动的半透明玻璃面板）借鉴了社区 `dsh-wallpaper-engine` 的实现。
|
|
28
|
+
|
|
29
|
+
<p align="center">
|
|
30
|
+
<img src="docs/demo-zh.svg" alt="演示：上传壁纸后全站变毛玻璃，并在会话时间线的轮次之间平滑跳转">
|
|
31
|
+
</p>
|
|
32
|
+
|
|
33
|
+
## 截图
|
|
34
|
+
|
|
35
|
+
| | |
|
|
36
|
+
| --- | --- |
|
|
37
|
+
| **首页** | <img src="docs/images/home.jpg" alt="首页上的自定义背景" width="640"> |
|
|
38
|
+
| **会话界面** | <img src="docs/images/conversation.jpg" alt="会话背后的自定义背景" width="640"> |
|
|
39
|
+
| **设置界面** | <img src="docs/images/settings.jpg" alt="带实时预览的背景设置行" width="640"> |
|
|
40
|
+
|
|
41
|
+
## 功能
|
|
42
|
+
|
|
43
|
+
- **本地上传** —— 从电脑选择 JPG / PNG / WebP / GIF 图片；插件存入 harness home 目录，经同源路由提供（仅当声明的 MIME、探测到的文件签名与扩展名三者一致才被接受）。
|
|
44
|
+
- **粘贴 URL** —— 输入 `http(s)` 图片链接后回车即可。
|
|
45
|
+
- **面板内实时预览** —— 设置行顶部有预览卡：图片 + 遮罩 + 毛玻璃气泡；拖动任意滑块即时重绘，所见即所存。
|
|
46
|
+
- **阻尼滑块** —— 比例类滑块按 **5% 步进**、模糊类按 1/2px 步进吸附；拖动过程只改画面，**松手才保存**（每次手势一次写入，不再抖动）。
|
|
47
|
+
- **五个调节项** —— 壁纸不透明度、可读性遮罩、面板不透明度、毛玻璃模糊、壁纸模糊。
|
|
48
|
+
- **填充方式** —— `cover`（铺满、裁剪）或 `contain`（完整、留白）。
|
|
49
|
+
- **主题自适应遮罩** —— 浅色主题用白色纱帘（把图片提亮保持深色文字对比度），深色主题自动换成黑色纱帘（压暗图片保持浅色文字对比度）。
|
|
50
|
+
- **毛玻璃（白名单制）** —— 启用背景后，只有以小卡片/小按钮形态悬浮在壁纸上的表面才会变成半透明玻璃（顶部白色高光渐变 + `backdrop-filter`）：输入框卡片与消息气泡、代码块 / 终端 / diff / 工具 IO 卡 / 技能与 MCP 调用卡与行内代码、agent 任务条及其接管面板（审批 / 提问 / 计划评审）、三个铬件按钮（新会话、输入框加号、回到底部）、「加载更早」历史按钮、标题栏展开的子代理列表面板、侧栏构建徽标，以及首页右上角的「预览版」徽标——每块玻璃面都带完整配方（填充 + 高光 + 模糊），绝无"只透明不磨砂"的残缺面。阅读型表面——对话框、设置界面、菜单、Tooltip、Toast、悬停填充与所有强调色（发送键保持品牌蓝）——一律保留**官方不透明样式**，保证可读性（唯一例外：时间线导航轨的悬浮预览卡，它是画在壁纸上的导航铬件，加入玻璃配方）。模糊半径由「毛玻璃模糊」滑块驱动；「面板不透明度」调至 100% 时白名单表面也恢复官方原样。
|
|
51
|
+
- **第三方毛玻璃接口** —— 内置毛玻璃注册表（`window.__DSH_BACKGROUND_GLASS__` 全局 + `dsh-background-glass:ready` 事件）：任何插件都可把自家面板的选择器注册进来，套上与内置表面完全一致的配方——`token` 模式为已使用被覆盖 `--dsw-*` 填充的面板补齐高光+模糊链，`fill` 模式连填充一并接管；规则统一挂在 `data-dsh-bg-glass` 门控下随玻璃自动开关。消费方零依赖、未安装本插件时优雅降级，本插件卸载时整桥拆除。详见 [docs/GLASS_API.zh.md](docs/GLASS_API.zh.md)。
|
|
52
|
+
- **会话时间线** —— 长会话右缘的 DeepSeek 官网风格轮次导航轨：每一轮一个刻度，悬停或聚焦时预览该轮的问题。 本插件**不渲染任何自己的界面**——从 dsh 0.1.2-rc.1 起内核自带官方导航轨，插件只增强其行为（按导航轨自己发布的度量做能力探测，绝不比较版本号）： 对**已加载**轮次的点击由官方的瞬时跳转改为**平滑滑动**（缓入缓出、按距离定时长、读者一滚动立刻接管、`prefers-reduced-motion` 下直接定位）； 官方轨的全量阶梯（`turnOutline` 大纲 + 已加载窗口）中，**未加载**轮次的刻度交给内核自己的穿越加载跳转，且当内核跳转仍在翻页（`aria-busy` 脉冲）时插件整体让位； 官方悬浮预览卡是实心底，在壁纸门控下改为与输入卡同配方的毛玻璃（受「毛玻璃模糊」滑块驱动）； 刻度列加上 DeepSeek 网页版式的上下渐隐（仅绘制层，不影响命中测试）。 导航轨的高亮状态仍归内核自己维护——滑动走的是真实滚动容器，官方滚动处理会持续更新活动轮次与持久化滚动位置； 滑动前都会先解除宿主的底部跟随状态（流式增长、轮次结束重渲染都不会把视图拽回底部）。用设置行里的时间线开关可关闭。
|
|
53
|
+
- **持久化到官方设置文档** —— 存于 `$DSH_HOME/settings.yaml`，跨重启保留。
|
|
54
|
+
- **干净卸载** —— 关闭、清除或卸载后完整恢复原背景；插件只移除自己写过的内容。
|
|
55
|
+
|
|
56
|
+
## 版本兼容
|
|
57
|
+
|
|
58
|
+
| 本插件版本 | 支持的 dsh 版本 |
|
|
59
|
+
| --- | --- |
|
|
60
|
+
| **当前版本（≥ 0.5.3）** | **dsh 0.1.2-rc.1 与 0.1.3-alpha.x（已在 alpha.2 验证），另支持 0.1.5-alpha.1** |
|
|
61
|
+
| 0.5.2 | dsh 0.1.1-rc.2 与 0.1.2-alpha.1 ~ alpha.5 |
|
|
62
|
+
|
|
63
|
+
⚠️ **使用旧版 dsh（0.1.1-rc.2、0.1.2-alpha.x 或更早）请安装本插件的旧版本**
|
|
64
|
+
（`dsh plugin --profile web add deepseek-harness-background@0.5.2`），本插件已停止对旧内核的适配。
|
|
65
|
+
|
|
66
|
+
## 安装
|
|
67
|
+
|
|
68
|
+
这是一个标准的 out-of-tree dsh bundle，已发布到 npm：
|
|
69
|
+
|
|
70
|
+
```sh
|
|
71
|
+
dsh plugin --profile web add deepseek-harness-background
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
从本地 checkout 安装（开发用）：
|
|
75
|
+
|
|
76
|
+
```sh
|
|
77
|
+
dsh plugin --profile web add /path/to/deepseek-harness-background
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
从源代码检出安装：
|
|
81
|
+
|
|
82
|
+
```sh
|
|
83
|
+
pnpm dsh plugin --profile web add /path/to/deepseek-harness-background
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
或从 git 安装：
|
|
87
|
+
|
|
88
|
+
```sh
|
|
89
|
+
dsh plugin --profile web add github:<you>/deepseek-harness-background#<commit>
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
安装后重启：
|
|
93
|
+
|
|
94
|
+
```sh
|
|
95
|
+
dsh --profile web
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## 使用
|
|
99
|
+
|
|
100
|
+
1. 启动 Web UI（`dsh --profile web`）并在浏览器打开。
|
|
101
|
+
2. 打开 **设置**（左下角）→ **通用** → 找到 **自定义背景** 一行（与「外观」行同一区域）。
|
|
102
|
+
3. **上传**图片或**粘贴 URL** —— 背景立即生效，面板顶部的预览卡同步显示。
|
|
103
|
+
4. 调整控件，滑块均为阻尼步进、**松手才保存**：
|
|
104
|
+
|
|
105
|
+
| 控件 | 说明 |
|
|
106
|
+
| --- | --- |
|
|
107
|
+
| 不透明度 | `0..100%` 图片不透明度（5% 步进）；调低让壁纸向表面色淡出。 |
|
|
108
|
+
| 遮罩 | `0..95%` 图片上方的可读性纱帘（5% 步进），浅色主题白色、深色主题黑色。 |
|
|
109
|
+
| 面板不透明度 | `0..100%` 表面透明程度（5% 步进）；为 `100%` 时官方面板保持不透明（无玻璃）。 |
|
|
110
|
+
| 毛玻璃模糊 | `0..40px` 半透明表面上的 `backdrop-filter` 模糊（1px 步进）。 |
|
|
111
|
+
| 壁纸模糊 | `0..60px` 壁纸图片本身的模糊（2px 步进）。 |
|
|
112
|
+
| 填充方式 | `cover`（铺满）或 `contain`（完整）。 |
|
|
113
|
+
| 会话时间线 | 会话时间线的开关（默认开启）。dsh ≥ 0.1.2-rc.1 上该项显示为**会话时间线增强**：官方导航轨保留，插件只优化其行为（已加载轮次的平滑跳转），关掉即恢复官方原样。 |
|
|
114
|
+
|
|
115
|
+
5. 点 **清除背景** 移除背景，恢复默认外观。
|
|
116
|
+
|
|
117
|
+
## 原理
|
|
118
|
+
|
|
119
|
+
- **设置行**位于官方「通用」设置分区的 `settings.general.item` 槽中，紧挨「外观」行。控件样式全部使用 `--dsw-alias-*` 设计 token（按钮 / 胶囊 / 分段控件 / 滑块轨道与官方 chrome 一致），滑块为原生 `input[type=range]` 的 5% / 1–2px 步进 + 松手提交。
|
|
120
|
+
- **会话时间线**注册进 `conversation.input.dock` 槽位（绑定每会话生命周期）。判定是对槽位 props 的能力探测，而不是比较版本号： 官方导航轨正是由 `ui-chat` 以会话 hook 形式发布的同一份索引渲染的（`useChat(s => s.navigation.items())`，dsh ≥ 0.1.2）， 所以这个 hook 存在**就是**官方导航轨存在 —— 而且它能扛住预发布版、fork 以及挂载了其它会话目标的部署。 hook 存在时插件什么都不渲染，只在**捕获阶段**拦截官方导航轨**已加载刻度**的点击（React 18 在冒泡阶段由根容器派发 `onClick`， 所以导航轨上的捕获监听先执行，`stopImmediatePropagation()` 让官方处理器根本收不到事件）——点击索引按内核实际渲染的合并阶梯解析（`turnOutline` 大纲 + 已加载窗口，与 `ui-chat` 的 `mergeTurnRailItems` 同构），已加载窗口之外（无锚键）的刻度交给内核自己的穿越加载跳转——且当内核跳转仍在翻页（标记以 `aria-busy` 脉冲）时插件整体让位：内核的已加载分支落点前会先取消自己的在途跳转，拦截会绕过这一取消。 官方导航轨的悬浮预览在壁纸门控下加入毛玻璃配方（与输入卡片同一显式填充配方），刻度列带 DeepSeek 网页版式上下渐隐。 支持基线为 dsh ≥ `0.1.2-rc.1`；更旧的 dsh（0.1.2-alpha.x 与 0.1.1-rc.2 及更早）请安装本插件旧版本（见「版本兼容」）。
|
|
121
|
+
- 插件自有的 host 路由（`/api/bg-wallpaper/*`：`settings`、`upload`、`image/<id>`）负责读写设置与提供上传图片，带同源校验、大小上限、MIME/签名校验与路径穿越防护。使用自定义路由族，是因为 api-proxy 的 settings 白名单不向第三方命名空间开放 settings RPC。
|
|
122
|
+
- 背景以 `body` 上一张固定的 `z-index:-2` 壁纸层 + `z-index:-1` 遮罩绘制，由 `data-dsh-bg` 属性开关；遮罩在注入样式表里按 `data-ds-dark-theme` 切换白/黑纱帘。毛玻璃为白名单制：仅对输入/气泡/代码/任务条等白名单表面覆盖 `--dsw-*` surface token，其余表面通过 `data-dsh-bg-glass` 门控的显式规则补齐整套配方（填充 + 高光 + 模糊滤镜链）：三个 chrome 按钮、「加载更早」历史按钮、composer 坞列家族——agent 任务条（TodoPanel / GoalBar / QueueDock）与接管面板（审批 / 提问 / 计划评审，token 变半透明后由这里补上模糊）、子代理列表弹出层、首页「预览版」徽标、侧栏构建徽章——全部官方 token 与阅读型界面（菜单/对话框/tooltip/toast）保持原样。
|
|
123
|
+
- **第三方玻璃注册表**（`src/client/glass-registry.ts`）：客户端 apply 时即在 `window.__DSH_BACKGROUND_GLASS__` 发布注册 api 并派发 `dsh-background-glass:ready`；`register({ plugin, selectors, mode })` 按 `(plugin, mode, selector)` 三元组幂等登记，把 `body[data-dsh-bg-glass]` 门控的显式配方规则合成进独立的 `<style data-plugin-css>` 标签；选择器先做结构性校验（禁 `{} ; @ < > ,` 与反斜杠、500 字符上限），违规条目逐条警告并丢弃、不影响兄弟条目；fiber dispose 时整桥拆除（样式表、条目、window 键全清）。契约文档见 `docs/GLASS_API.md` / `GLASS_API.zh.md`，行为由 `tests/glass-registry.spec.ts` 锁定。
|
|
124
|
+
- 上传文件存放在 `$DSH_HOME/deepseek-harness-background/`（内容寻址 id）。切换新图片或清除背景时，被替换的旧上传文件会被自动回收，正常使用下目录不会堆积死图片。（例外：上传后从未保存进设置——例如上传后立刻关闭标签页——会留下一个孤儿文件。）关闭 / 卸载后不留残留。
|
|
125
|
+
|
|
126
|
+
## 开发
|
|
127
|
+
|
|
128
|
+
```sh
|
|
129
|
+
pnpm install # 首次；会运行 prepare（构建）
|
|
130
|
+
pnpm run typecheck # tsc
|
|
131
|
+
pnpm test # vitest 契约测试
|
|
132
|
+
pnpm run build # tsdown：lib/index.js（host）+ lib/client.js（浏览器 bundle）
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
deepseek-harness-background/ # 插件仓库（包名保留 npm 风格 id）
|
|
137
|
+
├── package.json # dsh.bundle.patch + dsh.client.inject 声明
|
|
138
|
+
├── cordis.patch.yml # 向 web 插件名册插入 deepseek-harness-background 一行
|
|
139
|
+
├── tsdown.config.ts # 官方 clientBundle 预设
|
|
140
|
+
├── src/
|
|
141
|
+
│ ├── index.ts # host 半部：ui-background 命名空间 + API 路由
|
|
142
|
+
│ ├── routes.ts # /api/bg-wallpaper/{settings,upload,image/<id>}
|
|
143
|
+
│ ├── schema.ts # host 侧 schemastery schema
|
|
144
|
+
│ ├── settings.ts # 两端共享的常量/类型
|
|
145
|
+
│ ├── harness-home.ts # $DSH_HOME / ~/.dsh 解析
|
|
146
|
+
│ └── client/
|
|
147
|
+
│ ├── index.ts # painter 生命周期 + 设置行注册
|
|
148
|
+
│ ├── backdrop.ts # 固定壁纸层 + 遮罩 + 玻璃表面 + 预览变量
|
|
149
|
+
│ ├── background-css.ts # 注入的样式表（层、玻璃、明暗遮罩、变量、read_image 卡）
|
|
150
|
+
│ ├── glass-registry.ts # 第三方毛玻璃注册表（window 桥 + 门控规则合成）
|
|
151
|
+
│ ├── timeline/
|
|
152
|
+
│ │ ├── index.tsx # 停靠入口：官方轨能力探测与再导出
|
|
153
|
+
│ │ ├── official-enhance.tsx # dsh>=0.1.2-rc.1：已加载刻度平滑跳转拦截
|
|
154
|
+
│ │ ├── jump.ts # 共享跳转引擎（翻页 + 滑动）
|
|
155
|
+
│ │ ├── rail-pointer.ts # 帧式刻度几何与全量阶梯合并
|
|
156
|
+
│ │ └── types.ts # 共享类型契约
|
|
157
|
+
│ ├── SettingsRow.tsx # 通用设置中的设置行（预览卡 + 阻尼滑块）
|
|
158
|
+
│ ├── SettingsRow.module.css # 设置行样式（官方 token）
|
|
159
|
+
│ ├── settings-client.ts# fetch 传输层（读/写/上传）
|
|
160
|
+
│ └── locales.ts # 中/英文案
|
|
161
|
+
└── tests/ # 契约测试（schema、routes、apply/painter、设置行、时间线）
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## Activity
|
|
165
|
+
|
|
166
|
+
[](https://gitstock.org/HaoyueQin/deepseek-harness-background)
|
|
167
|
+
|
|
168
|
+
## License
|
|
169
|
+
|
|
170
|
+
MIT
|