dsh-acrylic

配置

配置分为两处：cordis.patch.yml 中的挂载行，以及构建期烘焙进浏览器半边的 dev/background.json。

挂载行配置

挂载行在 cordis.patch.yml 中声明。dsh web 由宿主半边实时读取；桌面应用的浏览器半边不接收加载行的 config:，需要重建 lib/client.js（见“开发”）。

- insert:
    - id: dsh-acrylic
      name: dsh-acrylic
      config:
        enabled: true
        acrylic: true
        panelAcrylic: true
        square: true
        wash: false

全部键均为可选，缺省时回退到 lib/css.js 中的 RECIPE_DEFAULTS。布尔键接受 false / 'false' / 0 / '0' 表示关闭，其余值视为开启；noiseOpacity 与 bgDim 会被截断到 0..1。

键	默认值	说明
enabled	true	false 时完全不注入样式
acrylic	true	亚克力材质总开关
panelAcrylic	true	面板容器的材质开关；弹出菜单由令牌驱动，不受此开关影响
square	true	全站零圆角
wash	false	没有背景图时，用两层径向渐变代替
bgImage	''	任意 CSS `` 值；空字符串表示不使用背景图
bgDim	0.25	背景图上的压暗层，0..1
bgBlur	'0px'	对背景图本身预先模糊；0px 表示关闭
bgSize / bgPosition / bgRepeat	cover / center / no-repeat	背景图定位
noiseOpacity	0.03	噪点强度，0..1
blur	30px	亚克力模糊半径
saturate	120%	亚克力饱和度
brightnessLight / brightnessDark	100% / 100%	默认不施加亮度倍数：在接近极值的画布上 120% / 80% 会分别钳到 255 与 25，丢掉全部背景细节
tintLight / tintDark	rgba(242, 242, 242, 0.35) / rgba(31, 31, 31, 0.35)	面板填充色
fallbackLight / fallbackDark	rgba(242, 242, 242, 0.97) / rgba(31, 31, 31, 0.97)	不支持 backdrop-filter 时使用的近不透明填充

面板的合成结果为 backdrop-filter: blur(30px) brightness(100%) saturate(120%) 加半透明填充；弹出菜单使用的令牌版本是 blur(30px) saturate(120%) 加同名色相的 0.35 填充。

背景与构建期配置

桌面应用的浏览器半边在构建期把配置写进 lib/client.js，来源是 dev/background.json。该文件还接受 bgClear（逗号分隔的选择器列表，用于追加需要置为透明的画布选择器）。scripts/set-background.mjs 会写入该文件并重建 lib/client.js，DSH 会热重载客户端包，因此在下一次刷新后即可看到结果。

### 挂载行配置

挂载行在 [`cordis.patch.yml`](https://github.com/N3kOk0/dsh-acrylic/blob/c7d129b6afa52e95c6ba1ae4773d6669551cbcc3/cordis.patch.yml) 中声明。`dsh web` 由宿主半边实时读取；桌面应用的浏览器半边不接收加载行的 `config:`，需要重建 `lib/client.js`（见“开发”）。

```yaml
- insert:
    - id: dsh-acrylic
      name: dsh-acrylic
      config:
        enabled: true
        acrylic: true
        panelAcrylic: true
        square: true
        wash: false

全部键均为可选，缺省时回退到 lib/css.js 中的 RECIPE_DEFAULTS。布尔键接受 false / 'false' / 0 / '0' 表示关闭，其余值视为开启；noiseOpacity 与 bgDim 会被截断到 0..1。

键	默认值	说明
enabled	true	false 时完全不注入样式
acrylic	true	亚克力材质总开关
panelAcrylic	true	面板容器的材质开关；弹出菜单由令牌驱动，不受此开关影响
square	true	全站零圆角
wash	false	没有背景图时，用两层径向渐变代替
bgImage	''	任意 CSS `` 值；空字符串表示不使用背景图
bgDim	0.25	背景图上的压暗层，0..1
bgBlur	'0px'	对背景图本身预先模糊；0px 表示关闭
bgSize / bgPosition / bgRepeat	cover / center / no-repeat	背景图定位
noiseOpacity	0.03	噪点强度，0..1
blur	30px	亚克力模糊半径
saturate	120%	亚克力饱和度
brightnessLight / brightnessDark	100% / 100%	默认不施加亮度倍数：在接近极值的画布上 120% / 80% 会分别钳到 255 与 25，丢掉全部背景细节
tintLight / tintDark	rgba(242, 242, 242, 0.35) / rgba(31, 31, 31, 0.35)	面板填充色
fallbackLight / fallbackDark	rgba(242, 242, 242, 0.97) / rgba(31, 31, 31, 0.97)	不支持 backdrop-filter 时使用的近不透明填充

面板的合成结果为 backdrop-filter: blur(30px) brightness(100%) saturate(120%) 加半透明填充；弹出菜单使用的令牌版本是 blur(30px) saturate(120%) 加同名色相的 0.35 填充。

背景与构建期配置

桌面应用的浏览器半边在构建期把配置写进 lib/client.js，来源是 dev/background.json。该文件还接受 bgClear（逗号分隔的选择器列表，用于追加需要置为透明的画布选择器）。scripts/set-background.mjs 会写入该文件并重建 lib/client.js，DSH 会热重载客户端包，因此在下一次刷新后即可看到结果。