dsh-web-skin

dsh-web-skin 🖼️

给 DSH Web 界面（浏览器里的 DSH）铺壁纸的插件：设置 → 背景图 输入本地图片路径即时换图，
侧栏、对话框变成半透明玻璃感，壁纸从界面下面透出来。挂进 profile 后重启不丢、无需任何 agent 操作。

✨ 功能

• 🖼️ 任意本地路径换图：输入 C:/Users/you/wallpaper.png 这类路径 → 应用，即时生效（≤ 8MB）
• 🌗 玻璃半透明：主题底色 token 覆盖为半透明，浅色/深色主题自适应，壁纸从 UI 下透出
• 💾 路径持久化：存在 localStorage，重启自动恢复上次的图
• ↩️ 一键恢复默认：随时切回默认图
• 🔒 隐私安全：图片只在本机传输，不上传、不联网

安装（给使用者，三选一）

方式 A：让 DSH 的 AI 帮你装（最简单）

把这句话发给你的 DSH：

帮我安装 dsh-web-skin 插件，代码在 github:SnoWinKK/dsh-web-skin

方式 B：命令安装（需要 dsh 和 pnpm）

# 直接从 GitHub 安装：
dsh plugin --profile <profile> add github:SnoWinKK/dsh-web-skin

# 或者：clone 下来后用本地文件夹安装：
git clone https://github.com/SnoWinKK/dsh-web-skin
cd dsh-web-skin
dsh plugin --profile <profile> add .

然后重启 DSH。dsh plugin 会自动把插件加进 profile 的 bundles，无需手改配置。

💡 <profile> 填什么？

• 用 Deepseek-Harness-Desktop 桌面版 → 填 desktop
• 用官方 dsh web 网页版 → 填 web
• 不确定的话：打开 C:\Users\你的用户名\.dsh\profiles 文件夹，里面的文件夹名就是可用的 profile 名
• 填错不会弄坏东西：只是装进另一套配置。重启后没生效，就换一个名字再跑一次命令

方式 C：手动编辑 profile（不装 dsh CLI）

1. 拿到本仓库（Download ZIP 解压即可）；

2. 编辑 ~/.dsh/profiles/<profile>/package.json：

   {
     "dependencies": { "dsh-web-skin": "link:<解压后的路径>" },
     "dsh": { "profile": { "bundles": [/* ... */, "dsh-web-skin"] } }
   }
   

3. 在 profile 目录跑 pnpm install，重启 DSH。

使用

• 换图：设置 → 背景图 → 输入本地图片路径 → 应用；恢复默认 → 输入留空点「恢复默认」
• 默认图：默认没有内置图——「恢复默认」会尝试工作区根目录的 wallpaper.jpg；想自定义默认图就把 lib/index.js 顶部的 DEFAULT_IMG 改成你的图片路径
• 可选插件行配置：config: { "path": "C:/..." } 预设初始路径

工作原理

┌─ Host（Node 进程）──────────────────────────────────┐
│  webServer.register('/dsh-web-skin/bg')             │
│  fs.resolve + fs.readBytes 读取本地图片（沙箱化）    │
└───────────────┬──────────────────────────────────────┘
                │ 同源 HTTP：GET /dsh-web-skin/bg?path=…
┌───────────────▼──────────────────────────────────────┐
│ Client（浏览器）                                      │
│  fetch → blob → data URL → <html> 背景图 !important   │
│  theme.overrideTokens：底色 token → 半透明（玻璃感） │
│  settings.section：注册「背景图」设置面板             │
│  localStorage 持久化路径，重启自动恢复                │
└──────────────────────────────────────────────────────┘

结构

• lib/index.js — Node 半：注册 /dsh-web-skin HTTP 路由，沙箱化读图
• lib/client.js — Client 半（__ModuleLoader__ 格式）：注入壁纸 + 主题半透明 + 设置面板
• cordis.patch.yml — 宿主合成补丁

许可

MIT。