dsh-liquid-glass 0.2.0 → 0.4.0

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 CHANGED
@@ -6,9 +6,9 @@ English | [中文](README.zh.md)
6
6
  [![license](https://img.shields.io/github/license/Ultroncn/dsh-liquid-glass)](LICENSE)
7
7
  [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-4b68ff)](https://github.com/deepseek-ai/deepseek-harness)
8
8
 
9
- **Liquid glass for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** — one toggle, and the whole interface turns to glass.
9
+ **Theme backgrounds for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** — translucent surfaces with image or local video backgrounds.
10
10
 
11
- Translucent theme surfaces and scoped frosted menus over your own background image, with material presets, tint, wallpaper controls, and system accessibility response. The working-tree features below are unreleased; the package version has not changed.
11
+ Translucent theme surfaces and scoped frosted menus over your own background image, with material presets, tint, wallpaper controls, and system accessibility response. Current version: **0.4.0**. A community plugin that reuses the host’s official controls where available.
12
12
 
13
13
  ## Install
14
14
 
@@ -16,30 +16,50 @@ Translucent theme surfaces and scoped frosted menus over your own background ima
16
16
  dsh plugin --profile web add dsh-liquid-glass
17
17
  ```
18
18
 
19
- Open **Settings → General** — a **Liquid Glass** row appears. It is ON by default; restart once after install.
19
+ Run the command in a terminal. In the app’s Add plugin field, enter only `dsh-liquid-glass`.
20
20
 
21
- ## Preview
21
+ Open **Settings → General → Theme background**, immediately below Appearance. Expand the official chevron for basic options; advanced options remain collapsed. The switch controls glass and image/video backgrounds together, retaining preferences when disabled. Restart the host after upgrading. Enter `dsh-liquid-glass@0.4.0` in the app’s plugin field, not the full terminal command.
22
22
 
23
- | Settings | Glass shell | Wallpaper |
24
- | --- | --- | --- |
25
- | ![Liquid Glass settings](assets/screenshots/1-settings.png) | ![Translucent DeepSeek Harness shell](assets/screenshots/2-glass-shell.png) | ![Custom wallpaper controls](assets/screenshots/3-settings-wallpaper.png) |
23
+ ## Screenshots
24
+
25
+ Captured from the actual package in official DSH 0.2.2-rc.2 Web, using original local demonstration media. Reading protection is enabled. Light appearance uses Clear (65% transparency); dark appearance uses Frost (22%) with a still video frame.
26
+
27
+ ![Collapsed entry below Appearance](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/01-settings-collapsed.jpg)
28
+
29
+ ![Material cards and background settings](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/02-settings-background.jpg)
30
+
31
+ ![Dark background appearance](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/03-dark-background.jpg)
32
+
33
+ ![Separate appearances, reading protection and still video](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/04-video-background.jpg)
26
34
 
27
35
  ## What you get
28
36
 
37
+ - **Reading protection**: enabled by default, now keeps dialogs and overlay surfaces opaque and content/code/menu surfaces at least 94% opaque. Base and sidebar transparency remain adjustable. Turn it off in Advanced for the previous fully translucent style. It also retains automatic background dimming.
38
+ - **Separate light/dark settings**: optionally enable in Advanced. Both start from your current appearance; subsequent edits and Reset affect only the active scheme, including system and custom theme switching. Disabling applies the current appearance to both. Background files and the manual video pause are shared.
39
+ - **Still video frame**: choose Motion or Still frame in Advanced after saving a video. Still frame retains the current frame, or loads the first frame after reopening. It keeps the video element loaded; no CPU/GPU or battery-saving claim is made.
40
+
41
+ - **Host controls**: reuse Switch, Button, Input, Checkbox, Menu, Modal and chevron icons. No public settings-row or slider component exists; a small layout adapter handles these without private CSS classes.
42
+ - **Local video backgrounds**: select MP4/WebM up to 100 MiB, with a browser-supported codec. Validated files preview immediately and are saved locally only after Save; playback loops muted; pause, resume and removal are available. Hidden pages and reduced-motion preferences pause playback. No video URLs, audio or playlists.
43
+ - **Visual cards**: three material previews and one permanent image/video uploader, with click or drag-and-drop selection. Replace and red remove controls sit over the thumbnail; no separate filename or media-description row.
44
+ - **Background drafts**: add, replace or remove to preview immediately; Save commits the selection. Closing settings, switching menus or collapsing the section prompts Save and leave, Discard changes or Keep editing. Discard restores the saved background.
45
+ - **Compact defaults**: presets, transparency and background selection; tint, frost, fit and reading protection live under Advanced. Reset preserves the background and master switch.
46
+
29
47
  - **Theme surface transparency** through the official ThemeRuntime tokens, with a 3%–95% transparency slider.
30
48
  - **Regular, Clear, and Frost presets**, plus cool white, warm gray, and ink tints. Manual transparency fine-tunes the selected preset.
31
49
  - **Scoped menu frost** with an independent switch, a settings-card rim color, and a material preview with an inset highlight. Host filter placement stays unchanged.
32
- - **Wallpaper controls**: cover/contain/fill, nine positions, brightness 20%–200%, and manual dim 0%–60%. Bright local or same-origin images automatically receive at least 35% dim; cross-origin links use manual dim only. Large static uploads are compressed; GIF data is preserved.
50
+ - **Wallpaper controls**: cover/contain/fill, nine positions, brightness 20%–200%, and manual dim 0%–60%. With reading protection enabled, videos and bright local or same-origin images receive at least 35% dim; cross-origin links use manual dim only. Large static uploads are compressed; GIF data is preserved.
33
51
  - **System accessibility response**: reduced transparency or increased contrast selects effective Frost material and limits transparency to 50%, without overwriting saved preferences.
34
52
  - **Keyboard toggle**: Ctrl/Cmd+Shift+G through the host shortcut service. Change or remove “Toggle Liquid Glass” in the host Keyboard shortcuts settings. Linux Web starts unbound; conflicting defaults fall back to an unbound command.
35
53
 
36
- Independent user/assistant opacity floors and general host-panel blur/highlights are not implemented: verified official extension hooks are missing. See [local API evidence and validation limits](docs/v0.2.0-local-evidence.md). Live DSH regression testing remains outstanding. Existing screenshots show the older interface.
54
+ Independent user/assistant opacity floors and general host-panel blur/highlights are not implemented: verified official extension hooks are missing. See [local API evidence and validation limits](docs/v0.2.0-local-evidence.md). See [0.4.0 validation](docs/v0.4.0-validation.md) for this release.
37
55
 
38
56
  ## Privacy and compatibility
39
57
 
40
- - Settings and uploaded backgrounds stay in this browser's `localStorage`; the plugin has no server component and sends no telemetry.
58
+ The host has no public settings leave-guard API. Unsaved-change protection uses a small adapter for the 0.2.2-rc.2 settings structure and needs regression checks after host updates.
59
+
60
+ - Preferences and images use origin-local `localStorage`; video Blobs use IndexedDB. Media is not shared across browsers or origins, and clearing site data deletes saved videos; the plugin has no server component and sends no telemetry.
41
61
  - The UI integrates through DeepSeek Harness's public client runtime, locale, slot, theme, and shortcut APIs. Shortcut bindings use host-managed device-local storage (localStorage on Web; keybindings.json on Desktop).
42
- - Light and dark color schemes are supported. A DSH restart is required once after installation so the client bundle can be loaded.
62
+ - Light and dark color schemes are supported. Appearance profiles use a versioned local record; legacy settings remain intact, but downgrading to 0.3.x restores those older values. A DSH restart is required once after installation so the client bundle can be loaded.
43
63
 
44
64
  ## Verify from source
45
65
 
@@ -55,7 +75,7 @@ node test/smoke.test.mjs
55
75
  dsh plugin --profile web remove dsh-liquid-glass
56
76
  ```
57
77
 
58
- Preferences live in this browser's localStorage and are left behind harmlessly.
78
+ Remove the background in settings before uninstalling if desired. Uninstalling does not automatically clear localStorage or IndexedDB; saved videos still consume local storage. Do not erase all host site data just to clean this plugin.
59
79
 
60
80
  ## License
61
81
 
package/README.zh.md CHANGED
@@ -6,9 +6,9 @@
6
6
  [![license](https://img.shields.io/github/license/Ultroncn/dsh-liquid-glass)](LICENSE)
7
7
  [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-4b68ff)](https://github.com/deepseek-ai/deepseek-harness)
8
8
 
9
- **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的液态玻璃**——点一下,整个界面通透起来。
9
+ **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的主题背景插件**:调整界面通透效果,设置图片或视频背景。
10
10
 
11
- 通过官方主题接口提供表面透明化、局部菜单磨砂、自定义壁纸、质感预设、色调和系统无障碍响应。下列工作区新功能尚未发布,package.json 版本号未改动。
11
+ 通过官方主题接口提供表面透明化、弹出菜单模糊、自定义壁纸、质感预设、色调和系统无障碍响应。当前版本 **0.4.0**。社区插件,界面尽量复用宿主提供的官方组件。
12
12
 
13
13
  ## 安装
14
14
 
@@ -16,30 +16,48 @@
16
16
  dsh plugin --profile web add dsh-liquid-glass
17
17
  ```
18
18
 
19
- 打开 **设置 → 通用**,出现「液态玻璃」设置行。默认开启;装完重启一次。
19
+ 终端中运行上面的命令;如果使用应用的「添加插件」输入框,只填 `dsh-liquid-glass`。
20
20
 
21
- ## 效果预览
21
+ 入口为 **设置 → 通用 → 外观下方的「主题背景」**,默认折叠。点击官方箭头展开基础选项;高级选项再次折叠。开关同时控制透明效果和图片/视频背景,关闭不丢失偏好。升级后重启宿主。应用内安装框填写 `dsh-liquid-glass@0.4.0`,不要粘贴完整终端命令。
22
22
 
23
- | 设置 | 玻璃界面 | 自定义壁纸 |
24
- | --- | --- | --- |
25
- | ![液态玻璃设置](assets/screenshots/1-settings.png) | ![半透明 DeepSeek Harness 界面](assets/screenshots/2-glass-shell.png) | ![自定义壁纸设置](assets/screenshots/3-settings-wallpaper.png) |
23
+ ## 截图
24
+
25
+ 实际安装包在官方 DSH 0.2.2-rc.2 Web 宿主中的截图;背景为本地原创演示素材。开启阅读保护;浅色使用“清透”(65% 透明度),深色使用“磨砂”(22%)与视频静止画面。
26
+
27
+ ![折叠入口:位于外观下方](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/01-settings-collapsed.jpg)
28
+
29
+ ![质感卡片与背景设置](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/02-settings-background.jpg)
30
+
31
+ ![深色模式下的背景效果](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/03-dark-background.jpg)
32
+
33
+ ![浅深色独立设置、阅读保护与静止画面](https://raw.githubusercontent.com/Ultroncn/dsh-liquid-glass/v0.4.0/assets/screenshots/v0.4.0/04-video-background.jpg)
26
34
 
27
35
  ## 功能
28
36
 
37
+ - **阅读保护**:默认开启;现在让对话框与浮层保持不透明,内容、代码与菜单至少 94% 不透明,主背景和侧边栏继续跟随透明度。高级设置中关闭后恢复原来的全透明风格,并保留原有背景自动暗化功能。
38
+ - **浅深色分别记忆**:在高级设置中选用;开启时两套设置都复制当前外观,之后编辑或恢复默认只影响当前浅色/深色方案,跟随系统和自定义主题同样适用。关闭后两种方案都使用当前外观。背景文件和手动暂停状态共用。
39
+ - **视频静止画面**:保存视频后,在高级设置中选择“动态播放/静止画面”。静止模式保留当前帧,重新打开时显示首帧;仍保留视频元素,不承诺未经测量的省电或性能收益。
40
+
41
+ - **统一的设置控件**:复用宿主 Switch、Button、Input、Checkbox、Menu、Modal 和折叠图标。宿主没有公开设置行或滑块组件,相关布局仅作小范围适配,不导入内部样式类。
42
+ - **本地视频背景**:选择 MP4/WebM(不超过 100 MiB,需浏览器支持对应编码)验证后立即预览,点击“保存”后写入本地;静音循环,可暂停/播放、移除。页面不可见或系统启用“减少动态效果”时自动暂停。暂不支持视频 URL、声音、播放列表。
43
+ - **卡片式选择**:三张质感预览卡片;图片和视频共用常驻上传卡片,支持点击或拖放。更换和红色移除按钮位于缩略图浮层内,不再额外显示文件名或媒体描述。
44
+ - **背景草稿**:添加、更换和移除立即预览,点击“保存”才持久化。关闭设置、切换菜单或收起主题背景时,有未保存更改会弹出“保存并离开/放弃更改/继续编辑”;放弃会恢复已保存背景。
45
+ - **精简默认界面**:仅展开预设、透明度和背景选择;色调、弹出菜单模糊、背景适配与阅读保护放在高级设置。恢复效果默认值保留背景和总开关。
46
+
29
47
  - **主题表面透明化**:经官方 ThemeRuntime token 覆盖层生效,透明度主滑块范围为 3%–95%。
30
48
  - **标准、清透、磨砂三档预设**,另有冷白、暖灰、墨色;可用透明度滑块微调。
31
- - **局部菜单磨砂**:可独立关闭;设置卡片使用官方描边色,插件预览面板带内侧高光。宿主原有滤镜作用位置不变。
32
- - **壁纸控制**:铺满/完整显示/拉伸、九个位置、20%–200% 亮度、0%–60% 手动暗化。明亮的本地或同源图片自动至少暗化 35%;跨域链接只使用手动暗化。静态大图自动压缩,GIF 保留原始数据。
49
+ - **弹出菜单模糊**:可独立关闭;设置卡片使用官方描边色,插件预览面板带内侧高光。宿主原有滤镜作用位置不变。
50
+ - **壁纸控制**:铺满/完整显示/拉伸、九个位置、20%–200% 亮度、0%–60% 手动暗化。启用阅读保护时,视频和明亮的本地或同源图片至少暗化 35%;跨域链接只使用手动暗化。静态大图自动压缩,GIF 保留原始数据。
33
51
  - **系统无障碍响应**:减透明或增强对比度启用时,临时使用磨砂质感并将透明度限制为最高 50%,不覆盖用户保存的偏好。
34
52
  - **快捷键切换**:经宿主快捷键服务注册 Ctrl/Cmd+Shift+G,在宿主「键盘快捷键」设置中可更改或移除「切换液态玻璃」。Linux 网页端默认不绑定;默认组合冲突时退为未绑定命令。
35
53
 
36
- 人/助手独立消息不透明度下限,以及任意宿主面板的磨砂/内侧高光,因缺少已核实的官方扩展接口而未实现。参见[本地 API 证据与验证限制](docs/v0.2.0-local-evidence.md)。真实 DSH 回归测试仍待完成,现有截图展示的是旧界面。
54
+ 人/助手独立消息不透明度下限,以及任意宿主面板的磨砂/内侧高光,因缺少已核实的官方扩展接口而未实现。参见[本地 API 证据与验证限制](docs/v0.2.0-local-evidence.md)。本版验证记录见 [0.4.0 验证](docs/v0.4.0-validation.md)。
37
55
 
38
56
  ## 隐私与兼容性
39
57
 
40
- - 设置和上传的背景仅保存在当前浏览器的 `localStorage` 中;插件没有服务端组件,也不发送遥测数据。
41
- - 界面仅通过 DeepSeek Harness 的公开客户端运行时、语言、插槽、主题和快捷键 API 集成。快捷键绑定由宿主管理,网页端用 localStorage,桌面端用设备本地 keybindings.json。
42
- - 支持亮色和暗色方案。安装后需要重启一次 DSH,以便加载客户端 bundle。
58
+ - 偏好和图片保存在当前站点的 `localStorage`,视频 Blob 保存在 IndexedDB 中;不同浏览器或站点不共享,清除站点数据会删除保存的视频;插件没有服务端组件,也不发送遥测数据。
59
+ - 主要通过 DeepSeek Harness 的公开客户端运行时、语言、插槽、主题和快捷键 API 集成。宿主暂未公开设置离开拦截接口,未保存提示使用面向 0.2.2-rc.2 设置结构的小范围适配,宿主升级后需回归验证。快捷键绑定由宿主管理,网页端用 localStorage,桌面端用设备本地 keybindings.json。
60
+ - 支持亮色和暗色方案。独立外观使用带版本的本地记录,旧设置保留;降级至 0.3.x 会恢复旧版本保存的值。安装后需要重启一次 DSH,以便加载客户端 bundle。
43
61
 
44
62
  ## 从源码验证
45
63
 
@@ -55,7 +73,7 @@ node test/smoke.test.mjs
55
73
  dsh plugin --profile web remove dsh-liquid-glass
56
74
  ```
57
75
 
58
- 偏好保存在本浏览器 localStorage,卸载后无害残留。
76
+ 卸载前可在设置中移除背景。卸载插件不会自动清理站点的 localStorage 或 IndexedDB;保留的视频仍占用本地存储。不要为了清理本插件而删除宿主的全部站点数据。
59
77
 
60
78
  ## 许可证
61
79