retmon2333/dsh-background

dsh-background

Listed on dsh-plugin.org
License: MIT
Profile: web
topic: dsh-plugin

一句话价值：给 DeepSeek Harness Web 换上本机壁纸（单图 / 文件夹轮播），可调透明、模糊、遮罩与樱花／雪花特效，侧栏与输入框也能半透出壁纸。

DeepSeek Harness（DSH）Web 背景壁纸插件。标准 DSH bundle + client 插件，可通过 dsh plugin 安装／卸载。社区项目，非 DeepSeek 官方出品。

截图

设置页

主界面

特性

- 启用开关：关闭后还原默认 UI，设置项变灰
- 单张图片 / 文件夹轮播：本机路径；顺序或随机；间隔与叠化
- 画面调节：填充方式、透明度、模糊、遮罩颜色／透明度、面板透明度
- 扩展半透明：左侧栏、消息输入框（均默认开）；对话列与轨迹等主区透出壁纸
- 特效：樱花／雪花飘落（密度、速度可调）
- 设置入口：设置 → 背景

目录结构

dsh-background/
├── package.json           # DSH bundle + client 元数据
├── cordis.patch.yml       # 插件挂载声明
├── README.md
├── LICENSE
├── 1.jpg … 4.jpg          # README 截图
├── assets/
│   └── default-wallpaper.jpg   # 默认单图（可替换）
├── lib/
│   ├── index.js           # Host：settings + 图片 HTTP
│   └── client.js          # Client：设置页 + 壁纸层 + 特效
└── src/                   # TypeScript 源码（开发用）

安装

Profile：web

装完后请完整重启 dsh web，再 F5 刷新浏览器，打开 设置 → 背景。用 github: 安装后，也可在 DSH 插件管理页更新。

方式 A：从 GitHub 安装（推荐）

dsh plugin --profile web add github:retmon2333/dsh-background

需要代理时：

$env:http_proxy="http://:"; $env:https_proxy="http://:"
dsh plugin --profile web add github:retmon2333/dsh-background

方式 B：本地 link 安装

在仓库根目录（有 package.json 的目录）先构建再安装：

pnpm install
pnpm build
dsh plugin --profile web add link:.

路径含空格时，建议先建无空格 junction：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.dsh\plugins" | Out-Null
cmd /c mklink /J "$env:USERPROFILE\.dsh\plugins\dsh-background" "D:\你的路径\dsh-background"
dsh plugin --profile web add "link:$env:USERPROFILE\.dsh\plugins\dsh-background"

方式 C：npm 包名（发布到 npm 后）

dsh plugin --profile web add dsh-background

给 AI 的安装说明（可直接复制）

请帮我安装 DSH 插件 dsh-background。

步骤：
1. 确保 pnpm 可用
2. 安装（任选）：
- GitHub：dsh plugin --profile web add github:retmon2333/dsh-background
- 本地：在插件根目录 pnpm build 后执行 dsh plugin --profile web add link:.
3. 完整重启 dsh web，浏览器 F5
4. 打开 设置 → 背景 验证

自检：dsh --profile web --dump-config 应能看到 dsh-background

默认壁纸

可选替换：

/assets/default-wallpaper.jpg

首次安装默认单图模式指向该路径。若本机 settings.yaml 里已有 dsh-background 段，以已保存配置为准。

卸载

dsh plugin --profile web remove dsh-background
然后重启 dsh web。

卸载不会删除用户配置。若要恢复出厂默认，编辑 %USERPROFILE%\.dsh\settings.yaml，删除其中的 dsh-background: 整段。

更新

GitHub 安装的包
dsh plugin --profile web update dsh-background

或重新 add
dsh plugin --profile web remove dsh-background
dsh plugin --profile web add github:retmon2333/dsh-background

本地 link: 安装：改源码 → pnpm build → 重启 dsh web。

功能一览

| 能力       | 说明                             |
| ---------- | -------------------------------- |
| 启用开关   | 关闭后还原默认界面               |
| 单张图片   | 本机绝对路径，宿主 HTTP 读取     |
| 图片文件夹 | 系统选夹；顺序／随机；间隔与叠化 |
| 填充       | 居中／覆盖／包含／拉伸           |
| 画面       | 透明度、模糊、遮罩、面板透明度   |
| 扩展       | 侧栏、消息输入框半透明           |
| 特效       | 樱花／雪花（密度、速度）         |

配置存放位置

| 项         | 路径                                                                      |
| ---------- | ------------------------------------------------------------------------- |
| 用户设置   | %USERPROFILE%\.dsh\settings.yaml（Linux/macOS：~/.dsh/settings.yaml） |
| 本插件分节 | 文件内 dsh-background:                                                  |

权限与兼容性

| 项       | 说明                                             |
| -------- | ------------------------------------------------ |
| Profile  | web                                          |
| 本地文件 | 读取配置的图片／文件夹；可选系统文件／目录选择器 |
| 网络     | 壁纸不经第三方；仅本机 /dsh-background/...     |
| 外部服务 | 无                                               |
| 导出     | Host：apply(ctx)；Client：dsh.client 注入    |

验证

dsh --profile web --dump-config | Select-String -Pattern "background"

- dump-config 中可见 dsh-background
- 重启并 F5 后出现 设置 → 背景
- 配置图片后主界面透出壁纸／特效

HTTP 路由自检（宿主启动后、http://127.0.0.1:3080）：

单图模式：返回图片字节（未配置时 400 image-not-configured）
curl.exe -o NUL -w "%{http_code}n" http://127.0.0.1:3080/dsh-background/file

文件夹模式：返回 JSON { folder, images[] }（未配置时 400）
curl.exe http://127.0.0.1:3080/dsh-background/folder/list

macOS/Linux 用 curl -o /dev/null -w "%{http_code}\n" ...。

常见问题

- 设置里没有「背景」：确认 add 成功且 dump-config 有条目；必须完整重启 dsh web，再 F5。
- pnpm 报 allowBuilds／ignored build scripts：DSH 默认拦截 git 插件的 prepare 构建脚本。把报错里打印的包名（通常是本插件 dsh-background）加进 profile 的 pnpm-workspace.yaml：

allowBuilds:
- dsh-background

文件位于 %USERPROFILE%\.dsh\profiles\web\pnpm-workspace.yaml（Linux/macOS：~/.dsh/profiles/web/pnpm-workspace.yaml），改完重新 dsh plugin --profile web add github:retmon2333/dsh-background。

- Windows 装失败报 ERR_PNPM_EPERM: symlink：多为系统符号链接权限问题。开启「开发者模式」（设置 → 隐私与安全 → 开发者选项），或以管理员身份运行终端；或改用无空格路径的 link: 本地安装。
- 改了代码不生效：pnpm build 后重启宿主（不要只刷页面）。
- 路径含空格装失败：用 junction 的无空格 link:。
- 重装后还是旧设置：删 settings.yaml 里的 dsh-background: 段。
- 默认壁纸不显示：确认 assets/default-wallpaper.jpg 存在，且未被用户配置覆盖。
- GitHub 安装 404：仓库须公开，仓库名与 github:用户/仓库 一致。

开发

pnpm install
pnpm build
pnpm watch

License

MIT