配置

配置存 localStorage['dsh-backdrop-config']（JSON）。首次加载用默认值； 通过 window.__backdrop.setConfig() 修改会自动持久化。

{
  "enabled": true,
  "opacity": 1,
  "layers": { "fluid": true, "whale": true, "fish": true, "grid": true },

  "fluid": {
    "glowIntensity": 0.07, "lightCore": 0.1, "lightHalo": 0.12,
    "vignette": 0.42, "interactive": false
  },

  "whale": {
    "density": 60, "spin": false, "loose": 1,
    "swim": true, "swimSpeed": 1.35, "swimTurn": 0.6,
    "light": { "x": 4.5, "y": 5.5, "z": 3, "range": 14, "shadeMin": 0.2, "shadeMax": 1.35, "followX": 1.05 },
    "mouse": { "radius": 4.9, "strength": 0.8, "decay": 0.2, "distort": 5 },
    "offsetRight": 0,
    "glitch": {
      "enabled": true, "burstWidth": 0.06, "intensity": 1,
      "rgbSplit": 26, "slices": 8, "maxShift": 56,
      "flash": true, "ghost": true, "flicker": true,
      "scanlines": false, "scanAlpha": 0.5, "sliceEdges": false,
      "noise": 0.5, "vBars": false
    }
  },

  "fish": {
    "count": 55, "density": 40, "scaleMin": 0.22, "scaleMax": 0.5,
    "speedBase": 2.6, "speedVary": 1.3,
    "schoolSpeed": 1.25, "schoolRadius": 6.0, "opacity": 0.95,
    "light": { "x": 4.5, "y": 5.5, "z": 3, "range": 14, "shadeMin": 0.3, "shadeMax": 1.5, "followX": 1.05 },
    "color": { "r": 0.62, "g": 0.82, "b": 1.0 }
  },

  "grid": { "lineOpacity": 0.06, "dotOpacity": 0.12 },

  "themeMode": "force-dark"
}

字段说明

字段	含义	备注
layers.*	四层独立开关	whale 与 fish 可同时开
opacity	背景层整体透明度	0~1，聊天时调低可降存在感
fluid.interactive	流体鼠标笔刷（flowmap）	聊天场景必须 false，否则"一团光斑跟手"
fluid.glowIntensity	鼠标光晕强度	0 关闭
whale.swim	是否让鲸鱼自由漫游	false 时鲸鱼停在初始位置
whale.swimSpeed	鲸鱼漫游速度系数	默认 1.35，越大游得越快
whale.swimTurn	鲸鱼转弯/漫游幅度	默认 0.6
whale.glitch.enabled	循环接缝赛博朋克故障开关	false = 保留生硬接缝（还原旧行为）
whale.glitch.burstWidth	故障爆发窗口（循环比例）	默认 0.06 = 循环前后各 6%（≈±0.35s），峰值命中接缝
whale.glitch.intensity	故障整体幅度主控	0~1
whale.glitch.rgbSplit	RGB 色差峰值（px）	默认 26
whale.glitch.slices/maxShift	横向切片数 / 位移峰值	默认 8 / 56（切片越少越厚、切口越明显）
whale.glitch.flash	接缝白闪	默认开
whale.glitch.ghost	品红残影错位	默认开
whale.glitch.flicker	掉帧/闪烁（坏帧跳变）	默认开
whale.glitch.scanlines/scanAlpha	扫描横线开关 / 强度	默认关（嫌横线多），想开设 true
whale.glitch.sliceEdges	切片分隔横线	默认关（靠平移缺口已够明显），想开切块描边设 true
whale.glitch.noise	噪点小方块强度	0~1，默认 0.5
whale.glitch.vBars	CRT 竖条（满高竖线）	默认 false（嫌竖线多，关掉）；想开设 true
whale.density/light/mouse/offsetRight	旧版 WebGL 瓦片参数	新版 Canvas 渲染已不使用，保留仅为兼容旧配置
fish.count	鱼数量	默认 55 条
fish.scaleMin/Max	鱼的大小比例	相对视口尺寸，默认 0.22~0.5
fish.speedBase/Vary	游动速度系数	默认 2.6 / 1.3
fish.schoolSpeed	鱼群中心漫游速度	默认 1.25
fish.schoolRadius	鱼群散布半径	默认 6.0，越大鱼群越散
fish.opacity	鱼群整体透明度	默认 0.95
fish.density/light	旧版瓦片参数	新版 Canvas 渲染已不使用，保留仅为兼容旧配置
themeMode	force-dark 强制暗色 / follow 跟随用户主题	force-dark 才能保证可读性

最小配置示例

只要鲸鱼、其他全关：

__backdrop.setConfig({
  layers: { fluid: false, whale: true, fish: false, grid: false },
  opacity: 0.8,
});

只要鱼群、鲸鱼也留：

__backdrop.setConfig({
  layers: { fluid: false, whale: true, fish: true, grid: false },
});

---

最小配置示例

只要鲸鱼、其他全关：

__backdrop.setConfig({
  layers: { fluid: false, whale: true, fish: false, grid: false },
  opacity: 0.8,
});

只要鱼群、鲸鱼也留：

__backdrop.setConfig({
  layers: { fluid: false, whale: true, fish: true, grid: false },
});

---

· patch 未写入正式配置 → 用 overlay（见"安装启用 → 快速预览"）

dsh --patch "C:\Users\www13.dsh\profiles\web\overlay-backdrop.yml" --profile web --port 3090