← 返回列表
未验证
为 DSH Desktop 添加自定义背景壁纸与系统字体选择能力的插件。
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/26 · 已提供中文文档
DSH-Wallpaper 背景壁纸和系统字体选择器插件，适用于 DSH Desktop。仅插件源码，不含 DSH 核心。
综合分
28.3
GitHub 分
28.3
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add mengzhangj/dsh-wallpaper该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
数据截至 2026/9/18（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-ui-theme@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-api-remotes用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
DSH-Wallpaper
为 DSH Desktop 添加自定义背景壁纸与系统字体选择能力的插件。
重要声明：本仓库只开源 DSH-Wallpaper 插件源码，不包含 DSH Desktop 本体程序（DSH Desktop.exe、其 resources 内置的 DSH 框架代码等）。DSH 本体是 DeepSeek 官方闭源产品，与本插件无关。
功能
- 背景壁纸
- 图片背景：本地图片（PNG/JPG/WebP/GIF）→ 页面背景，支持不透明度调节。
- 本地视频背景：填写本地视频文件完整路径（mp4/webm/mov/mkv），宿主以流式（HTTP Range）提供，浏览器 直接播放。
- Wallpaper Engine 联动：扫描本地 Wallpaper Engine 壁纸库（Steam 创意工坊 431960 + 本地 projects），在「壁纸设计」面板中选择视频 / 网页 / 图片壁纸作为页面背景；场景壁纸降级为静态预览图。
- 亮 / 暗主题自动适配（{light, dark} token 覆盖）。
- 系统字体选择器
- 自动扫描本机全部已安装字体（权威来源：宿主读取 Windows 注册表字体键，浏览器无法直接枚举系统字体目录）。
- 下拉选择界面字体 / 代码字体，选择后立即预览生效；一键恢复默认。
- 中文字体名 UTF-8 原样处理（不乱码）；所选字体不可用时自动回退微软雅黑。
- 持久化
- 背景与字体设置保存在宿主 settings（settings.yaml），重启应用依然生效（不依赖浏览器 localStorage，规避 DSH 每次启动随机端口导致的 localStorage 隔离丢失）。
插件结构
| 文件 | 说明 |
|---|---|
| client.js | 客户端模块（浏览器侧）：背景层渲染、字体探测/选择 UI、token 覆盖；样式内联（宿主 /plugins// 只服务 client.js）。 |
| index.js | 宿主模块（Node 侧）：注册 ui-background 设置命名空间、/dsh-background/media 视频流路由、/dsh-background/fonts 系统字体清单接口。 |
| style.css | 样式交付副本（与 client.js 内联样式一致，供参考）。 |
| package.json | 插件 manifest：dsh.client 声明、依赖注入、exports["./client"] 入口。 |
| build.bat | 一键打包 zip 脚本。 |
安装方法
方式一：从本地 zip 安装（推荐）
1. 双击 build.bat，生成 dsh-wallpaper-v1.0.0.zip。
2. 打开 DSH Desktop → 设置 → 插件 → 从本地 zip 安装 → 选择该 zip。
3. 重启 DSH Desktop。
方式二：手动放置（开发者）
1. 把插件目录放进 web profile 的 node_modules：
profiles\web\node_modules\dsh-wallpaper\
2. 在 profile 组合层（如 cordis.patch.yml）加入：
- insert:
- id: dsh-wallpaper
name: dsh-wallpaper
3. 重启 DSH Desktop。
注意：客户端模块在启动时快照，修改 client.js 后必须重启应用才生效。
使用方法
1. 设置 → 通用设置 → 背景壁纸
- 模式切换：图片 / 视频。
- 图片：点「选择图片」上传本地图。
- 视频：粘贴本地视频文件完整路径（如 D:\Videos\bg.mp4），点「应用视频」。
- 不透明度滑块 + 清除按钮。
2. 设置 → 通用设置 → 字体
- 界面字体 / 代码字体下拉框 = 本机真实安装的全部字体（自动扫描）。
- 选中立即生效，预览框同步展示。
3. 左侧边栏 → 壁纸设计
- Wallpaper Engine 壁纸库浏览 / 搜索 / 重新扫描，点选即应用为页面背景。
- 面板可调不透明度、作用范围（整页 / 主内容区）、填充、模糊、暗角、帧率、视差等。
原理说明
网页运行在浏览器沙箱中，无法直接读取 C:\Windows\Fonts 目录来枚举系统字体。
本插件由宿主（Node）通过 PowerShell 读取 Windows 注册表
HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts（含 HKCU 用户级字体），
返回 100% 真实存在的字体族名清单；浏览器侧仅在宿主接口不可用时，才退回到
document.fonts.check() + Canvas 宽度对比的探测法（有假阳性，仅作兜底）。
截图
截图占位：安装后请补充以下截图。
- 设置 → 通用设置 → 背景壁纸（图片模式）
- 设置 → 通用设置 → 字体（下拉列表展示本机字体）
- 壁纸设计面板（Wallpaper Engine 壁纸库）
| 截图 1：背景壁纸设置 | 截图 2：字体选择 | 截图 3：壁纸设计 |
|---|---|---|
| docs/screenshot-1.png | docs/screenshot-2.png | docs/screenshot-3.png |
开发
打包（Windows）
build.bat
安装依赖（如需要）
pnpm install
许可证
MIT —— 只覆盖本仓库内的插件源码。扫码进群