dsh-backdrop

给 DeepSeek Harness 的 Web 界面添加本地背景图片。

中文 · English

兼容性

面向 DSH 0.2.0-rc.2 的设置接口，要求 Node.js 22.19 或更高版本。不兼容旧版 installSection 设置接口；后续 DSH 版本需要另行确认兼容性。

功能

• 选择或拖入多张本地图片，点击缩略图切换。
• 整体背景与左侧边栏、主内容区、右侧边栏可分别设置图片。
• 支持填充、适应、拉伸、平铺、居中和九宫格对齐。
• 调整背景透出程度、分区图片不透明度、模糊、变暗、亮度、对比度和饱和度。
• 支持 30 秒、5 分钟、30 分钟、1 小时轮播，以及随机顺序。
• 可将当前图片用作浏览器标签页图标。

安装

在已安装 DSH 的环境中，从 npm 安装到 Web profile：

dsh plugin --profile web add [email protected]
dsh web

也可以安装收到的文件包：

dsh plugin --profile web add "<dsh-backdrop-0.1.0.tgz 的路径>"

打开 设置 → dsh-backdrop（背景）。插件当前面向 Web 界面；桌面端未完成兼容性验证。

卸载插件：

dsh plugin --profile web remove dsh-backdrop

从源码安装

本仓库直接包含 JavaScript 插件代码，无需编译。在本仓库目录中准备依赖：

npm install

在已安装 DSH 的环境中，将本仓库加入 Web profile：

dsh plugin --profile web add "<本仓库绝对路径>"
dsh web

本地链接安装需要保留源码目录和它的依赖目录，不要再手工链接 DSH 的内部依赖。

使用说明

• 启用所有背景是总开关，关闭后整体与分区背景都会隐藏。
• 背景透出程度调整界面面板的透明程度，也影响分区背景的可见程度；上限为 84%，保留文字底色。
• 分区的图片不透明度控制该分区图片与整体背景的混合；“跟随整体背景”跟随图片选择，分区效果仍独立设置。
• 修改会即时预览。刷新或关闭页面前，等待显示设置已保存。
• 保存失败时可重试；提示其他页面已修改设置时，重新加载会读取服务端设置，并放弃本页尚未保存的改动。
• 清空图片库会删除当前浏览器中本插件保存的所有图片，关闭背景，但保留效果参数。

数据与限制

图片以 data URL 存在当前浏览器的 IndexedDB 中，不上传至 DSH 服务端。图片按浏览器及站点来源隔离；换浏览器、访问地址或端口，需要重新添加。清除站点数据也会删除图片。

设置由 DSH 官方设置服务写入当前 profile 的 cordis.patch.yml。同一 profile 的设置共享，图片文件不共享；找不到已选图片时，临时显示本地第一张，不自动覆盖共享选择。

配置接口使用 DSH 连接服务的访问认证。通过认证的远程 Web 页面也会将插件设置保存到该 profile。

可以在 profile patch 中覆盖插件配置，例如：

- id: dsh-backdrop
  config:
    enabled: true
    imgOpacity: 30
    regions:
      sidebar:
        on: true

这是 profile 的用户配置示例；仓库中的同名文件负责注册插件。界面保存依赖可写的官方设置服务，失败时不会切换到另一份存储。若配置被 home patch 或命令行覆盖层覆盖，DSH 可能拒绝界面写入。

其他限制：

• 图片最长边超过 2560px 时等比例缩放。缩放与分区模糊使用 PNG，保留透明通道；动图经过处理后可能失去动画。
• 分区通过界面布局识别，布局变化可能影响识别；未识别到的区域使用整体背景。
• 旧浏览器配置仅在当前 profile 没有本插件的用户覆盖配置时迁移，成功保存后才删除旧副本。
• 旧版 $DSH_HOME/dsh-backdrop/config.json 不会自动导入或删除。需要恢复时，将其中设置字段复制到本插件的 profile 配置中。

文件结构

lib/index.js       宿主配置接口与校验
lib/client.js      背景渲染、图片存储与设置界面
locale/            插件名称与描述的中英文元数据
cordis.patch.yml   DSH 插件注册配置
package.json       插件入口与依赖声明
icon.svg           插件图标
README.md          中文说明
README.en.md       英文说明
LICENSE            MIT 许可

仓库不包含本地依赖、发布副本或测试脚本。package.json 的 files 限定发布包内容，Git 历史及本地凭据不进入 npm 包。

打包与发布

本仓库已包含发布入口，无需安装依赖或编译即可打包：

npm pack --dry-run --ignore-scripts
npm pack --ignore-scripts

检查文件包内容后，由已登录的 npm 账号发布：

npm publish ./dsh-backdrop-0.1.0.tgz --access public --registry=https://registry.npmjs.org
npm view [email protected] version dist.integrity --registry=https://registry.npmjs.org

每次发布需要使用未发布过的版本号。包内不声明个人作者信息，但 npm 平台仍会显示发布账号。插件声明 dsh.bundle.patch，由 DSH 安装时激活；流程见官方打包与安装文档。

许可

MIT