# dsh-any-background

[English](README.md) | 中文一个 **DeepSeek Harness** 外观插件：自定义主题色、背景壁纸（图片 / 视频 / 算法动态生成），以及逐表面的透明度与模糊度控制。当前版本面向 **DSH 0.1.5-rc.2**。 --- ## 截图

自定义主页 · 壁纸与主题色同时生效

主题色选择器 · PS 风格色轮 + 精确 HSL/RGB 输入

分部位透明度与模糊度 · 主背景、侧边栏、卡片、设置面板

背景编辑器 · 图片/视频壁纸支持拖动平移与滚轮缩放

动态生成背景 · 网格渐变 / Shader / 几何图案预设

几何背景低多边形模式
动态生成背景 · 几何低多边形模式预览

配置导出导入
配置的导出和导入进行分享

## 功能特性 - **PS 风格色轮** — 在色相环上选取色相，在内嵌方形中调整饱和度与明度，实时生成 30+ 个 CSS 设计令牌。 - **精确 HSL / RGB 输入** — 通过数值精确输入颜色，与色轮实时双向同步。 - **智能取色** — 一键从壁纸提取主题色：采样可见区域、量化像素、剔除灰色/近黑/近白，选出现量最大的鲜亮色。视频壁纸自动截帧参与取色。纯客户端完成。 - **吸管取色** — 在壁纸上悬停预览颜色，点击即可选为主题色。 - **背景壁纸** — 上传任意图片作为壁纸，在视口比例的编辑器中拖动平移、滚轮缩放（触屏上单指拖动、双指捏合缩放）。 - **视频壁纸** — 上传视频作为动态壁纸：静音循环播放、刷新不丢失（落盘持久化 + HTTP 流式播放，支持 Range seek）；自动截取一帧用于预览、主题色提取与位置编辑参考。 - **位置编辑器** — 图片与视频共用同一套编辑器：拖动平移、滚轮或双指缩放、一键重置；图片与视频的位置状态各自独立保存，互不覆盖。 - **布局模式** — 适应 / 填充 / 拉伸 / 平铺 / 居中五种排布，图片与视频通用；「适应」模式下编辑器提交的构图在窗口缩放、跨屏移动后保持一致。 - **动态生成背景** — 支持网格渐变、Shader、几何图案，可调节扩散范围、色彩强度并锁定种子。 - **分部位界面透明度** — 主背景、侧边栏、卡片面板（含对话框周围的选项框/菜单）、输入框与控件（发送框、Cordis 插件面板）、设置面板、对话文本框、轨迹页、better-sidebar 工作台、产出物/高亮内容各自独立滑块。 - **分部位界面模糊度** — 每个界面部位可独立调整毛玻璃 `backdrop-filter` 模糊（0–60 px），并通过宿主的稳定选择器为发送框、Cordis 面板与弹出层提供真实背景模糊。 - **产出物 / 高亮内容** — 对话正文里的代码块（含语言顶栏）、行内 `code` 高亮芯片与产出物 chip 共用一支滑块：透明度只**调制这些表面原本的背景色**（不会在旧背景上再叠一层新色），模糊度给同一层表面加磨砂，壁纸从内容后方透出来。 - **better-sidebar 工作台** — 安装 dsh-better-sidebar 时出现独立滑块（`panelOpacity` / `blurs.panel`），接管其底部工作台面板与原生右侧栏的表面令牌；未安装该插件时该行不显示，滑块无副作用。 - **侧边栏「主题」页面** — 安装 dsh-better-sidebar 后，它的侧边栏会多出一张「主题」卡片：点开是与设置面板**完全相同的五页**（色彩 / 界面 / 字体 / 背景 / 配置），外壳按侧边栏重做——全高、页面自带滚动区、导航收成一行紧凑标签（不放侧边，省下 150px 给内容）。**排版随面板宽度自适应**：卡片网格按可用宽度自动排成 2 / 3 / 4 列（约 430px 起两列），面板窄时才收紧内边距与标题字号并回到单列；类型卡片同理。两处共用同一套页面代码与同一份状态，改一处两边同步；未安装 better-sidebar 时静默不注册，不影响任何其它功能。 - **对话视图卡片** — 消息列表自动包裹为半透明卡片，轨迹页可整页调节透明度与模糊，让壁纸从内容后方透出来。 - **主题导出 / 导入** — 一键导出为自包含的 `dsh-any-theme.json`（配置 + 壁纸，视频以 data URL 内嵌），可随时导入还原。 - **外观预设与配置档案** — 六套一键预设（默认 / 毛玻璃 / 极简白 / 暗夜紫 / 赛博 / 暖阳），外加自定义命名档案：随时保存当前观感、随时套回，删除有二次确认保护。 - **壁纸轮换** — 把多张图片加入轮换池（缩略图选择器），按随机或顺序、每次刷新 / 每天 / 每周的频率自动更换；切换时服务端把所选图片复制进当前壁纸槽，导出/导入与取色管线完全不用改。 - **昼夜自动切换** — 指定日间与夜间两套配置，按固定时段或跟随系统深色模式自动切换。 - **自定义字体** — 上传一个 ttf / otf / woff / woff2 字体文件（上限 100 MB），通过 `@font-face` 应用到整个界面的文字；可随时停用或移除。字体按原始字节流式上传并持久化到插件数据目录，代码块仍保持等宽字体。 - **分组文字描边** — 沿用界面页那九个「透明度 / 模糊」分组，为每个分组单独加 `-webkit-text-stroke` 描边：粗细 0–4 px（0 = 关闭），颜色支持自动反色 / 灰 / 黑 / 白 / 主题色 / 自定义。代码块、`inline code` 与图标自动豁免，多色语法不会糊成一团。 - **强制界面明暗** — 无论主题色明暗如何，都能强制生成亮色/暗色整套令牌；「自动」下配色与字体方向由主题色明度驱动（深色 → 浅字，浅色 → 深字），未选主题色时按壁纸画面亮度判断。 - **文件持久化** — 所有设置保存到文件系统 `~/.dsh/.dsh-any-background-data/`，不再依赖 `localStorage`。 - **中英双语** — 完整的中英文界面，自动跟随语言设置。 - **主题守护** — 宿主重置主题后自动重新激活自定义主题。 ## 更新日志（最新两个版本） ### v0.2.10（最后一版0.15 rc2更新） - 侧边栏「主题」页：安装 dsh-better-sidebar 后，侧边栏会多出一张「主题」卡片，点开就是和设置面板一样的五页（色彩 / 界面 / 字体 / 背景 / 配置）。两边共用同一套页面和同一份状态，在哪边改都会同步。外壳按面板宽度自适应，卡片网格能排几列就排几列（面板 430px 左右起两列，更宽三列、四列），窄了才收紧内边距、回到单列。 - 设置面板适配手机宽度：内容列窄到一定程度后，标题、卡片内边距、色球和色轮卡都会收紧；各处卡片网格加了防溢出的最小宽度，背景类型卡片在窄屏改成按宽度自动排两列，不再挤成一条。 - 面板崩溃时直接把出错堆栈显示在兜底页里，不用再开开发者工具查原因。 - 修复部分环境下面板直接报错 `getSnapshot is not a function`：装着的 dsh-client-store 是旧版，`defineStore()` 返回的是声明而不是实例，代码把它当实例用就炸了，连带把状态同步整个关掉（设置面板会一直显示默认值）。现在启动时归一化成单个共享实例，两处读同一份状态；以后形状再变也只是告警并跳过侧边栏页。 - 修复手机上背景编辑器的拖动、捏合完全无效：监听器挂在 Portal 里的节点上，首帧拿不到节点，effect 依赖又是恒定的，所以永远不会再跑。现在弹窗节点改用 state 持有，出现即绑定；触摸监听同时从预览卡片挪到全屏遮罩，两指落在遮罩上不会再缩放整个页面；在预览图外松手也不会误关编辑器。 - 修复拖滑块时拇指弹回旧位置：同步 effect 的依赖里有内联箭头函数，任何父级重渲染都会把值写回上次提交的结果。现在格式化函数走 ref，只有数值真的变了才会动滑块。 - 修复套预设 / 导入主题后「界面」「字体」页滑块停在旧值：这两页此前没有订阅 store，现在跟随 `metaRev`（背景页的布局选项跟随 `bgRev`）。 - 修复配置文件被误判为损坏、整套设置静默丢失：之前文件被占用或权限失败也会把好文件改名归档，下次启动就按首次运行写入默认值。现在只有 JSON 解析失败才归档，读取失败只用默认值，不动磁盘上的文件。 - 修复上传超限毫无提示：服务端返回 413 但客户端从不读响应体。现在视频 / 壁纸 / 字体三个入口都会提示「文件过大，上限 100 MB」，超限视频也不会再「能播但不保存」。 - 修复夜间自动切换在缺少 `matchMedia` 的环境抛错，并因此反复中断启动恢复。 - 正常聊天时每个流式 token 都会触发一遍完整的模糊 / 透明度应用（观察器的短路条件在真实宿主上恒为假）。现在按帧合并，值和目标都没变就整帧跳过。 - 其它：配置写入改成原子写（tmp + rename，失败清理临时文件），解析结果按 mtime/size 缓存；修了一批泄漏和竞态（拖动中关面板遗留监听、动态背景旧帧覆盖新画面、轮换写回覆盖防抖保存、禁用后样式残留等）。 ### v0.2.9 - **修复：初次安装时透明度与模糊度滑块「要手动拖一次才生效」** —— 根因不是默认值，而是应用链路有两道门槛：① `applyCustomTokensNow()` 遇到没有调色板的情况直接 return，而**没选主题色且没强制明暗**时 `paletteTokens()` 正是返回 null，于是四个透明度滑块的 alpha 变量从头到尾没被写过；② `applyWp()` 外面还有一层 `rHasColor() || rBgDark() !== null || ...` 的门，初次安装全部落空，连 apply 都没调用。现在透明度无条件应用，没有自有调色板时回落去读宿主已解析的表面 token（`readHostOpacityTokens()`，与工作台面板 opacity 的宿主回落同源）——滑块只提供 alpha，配色仍由宿主皮肤决定。 - **默认值改为中档** —— 各分组透明度默认 0.5、模糊默认 30px（滑块量程 0–60px 的一半），初次安装即可看到滑块生效，不再是「看起来没反应」。**只影响首次安装**：已有 `theme-config.json` 的用户不受任何影响。壁纸本身的透明度（`wallpaperOpacity`）保持 100%，否则首次上传的壁纸会被直接压暗一半。服务端 `DEFAULT_CONFIG` 同步更新——两侧不同步正是 v0.2.8 静默丢字段的原因。 - **首次安装即落盘并强制重读一次** —— `read` RPC 检测到 `theme-config.json` 不存在时立刻把默认值写盘并返回 `firstRun`；客户端收到后 `persistConfig()` 写入浏览器侧的完整默认集，再 `loadPersisted()` 重读一次并 `applyWp()`，确保界面是从磁盘上真实存在的配置渲染出来的。 - **手机端背景位置调整适配** —— 背景编辑器此前只认鼠标，触屏设备上壁纸既拖不动也缩放不了。现在单指拖动画面、双指捏合缩放，且**捏合起手时手指下方的画面会始终钉在手指上**——所以「双指一边拖动一边缩放」由同一条关系式自然得出，不需要额外分支。触摸事件以 `passive: false` 原生挂载是有意为之：React 在根节点注册的 `touchmove` 是被动的，`preventDefault()` 在那里形同空操作，页面会在弹窗背后跟着滚动、浏览器还会把整个视口一起缩放；容器同时声明 `touch-action: none`，从声明式一侧兜住同样的行为。双指抬起其中一指时会以仍按住的那根手指重新建立平移基准，画面不会再按原偏移量弹回去。 - **新增「字体」设置页** — 设置面板在「界面」之后多出一页，收纳两组新能力：自定义字体与分组文字描边。 - **自定义字体** — 上传 ttf / otf / woff / woff2 文件应用到整个界面。文件以原始字节 POST 到 `/dsh-any-background/font/upload`（不走 RPC base64，上限 100 MB），服务端按魔数嗅探真实容器格式并据此命名落盘，再由 `/dsh-any-background/font` 提供 `@font-face` 源；宿主的基础字体令牌 `--dsw-font-family` 被收敛为 `'DAnyFont', <宿主原字体栈>`，代码块等宽字体不受影响。支持停用（保留文件）与移除（删除文件），上传失败会回滚到原有字体。字体文件与壁纸一样是本机资源，不进配置档案与导出包。 - **分组文字描边** — 九个界面分组各自独立的描边粗细（0–4 px，0.5 步进，0 = 关闭）与颜色；颜色存的是**预设键**而非解析后的色值：「自动」按字体明暗取反色（浅字配深描边），「主题色」跟随当前主色，二者都会随主题自动重算。代码块、行内 `code`、图标与 placeholder 显式豁免，多色语法着色不会糊。 - **已知取舍** — `-webkit-text-stroke` 在部分单行省略号容器边缘可能有 1px 级裁切；多行容器正常。 ## 安装 ### 方式一：npm 安装（推荐） ```sh # 已发布到 npm registry dsh plugin --profile web add dsh-any-background # 或直接安装 GitHub 仓库 dsh plugin --profile web add github:Tkingxiao/dsh-any-background ``` 然后启动： ```sh dsh web ``` 插件会出现在设置面板的 **“主题”** 分类中。 ### 方式二：npx（无需全局安装） ```sh npx @deepseek-ai/dsh plugin --profile web add dsh-any-background npx @deepseek-ai/dsh web ``` ### 方式三：本地构建（开发） `lib/` 目录已提交，安装后无需构建。修改 `src/` 后重新构建： ```sh git clone https://github.com/Tkingxiao/dsh-any-background.git cd dsh-any-background pnpm install pnpm run bundle pnpm dsh plugin --profile web add "dsh-any-background" pnpm dsh web ``` ## 兼容性 - **[`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` 也只声明这一项。 - **[DSHA](https://github.com/DSH-APP/DSHA)** — DeepSeek Harness 安卓启动器（免 ROOT、免 Termux）。其包内 dsh 同为 `0.1.5-rc.2`，即本插件的目标版本，故兼容；移动端界面由 `dsh-web-mobile` 提供。 - **[deepseek-harness-desktop](https://github.com/anywhere-labs/deepseek-harness-desktop)** — 支持 ## Star History [![Star History Chart](https://api.star-history.com/chart?repos=Tkingxiao/dsh-any-background&type=timeline&legend=bottom-right&sealed_token=f5MhnHibC049CC0Ed_nZX8rYpIq2wPTdTXUsPPafAiYxYKOeqyKyMFirxKppeLNJygxv1iw2BlsnCYOWgu9zN6ffr7kJlAG1SlRoQRmQivCIkPzZ2lhSBQ)](https://www.star-history.com/?repos=Tkingxiao%2Fdsh-any-background&type=timeline&legend=bottom-right) ## 许可 MIT