dsh-skin

August 14, 2026 · View on GitHub

一个给 DSH Web 界面加本地图片背景 + 收藏夹 + 主题系统的插件。 本包为自包含版本：dsh-skin/ 目录即全部代码，无外部依赖（仅 Windows 自带 PowerShell 用于缩略图）。

安装（目标机器）

前提

  • Windows + 已安装 DSH（推荐与发布时相同的版本 0.1.0-rc.6，见下方"版本兼容性"）
  • 图片目录：准备一个存放背景图的文件夹（任意位置）

官方方式（推荐）

插件按 DSH 官方 bundle 规范打包（包内自带 cordis.patch.yml 注册行 + dsh.bundle 声明），使用官方 CLI 安装：

# 从 GitHub 仓库安装（发布到 npm 后把地址换成包名）
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:HuggingFries/dsh-skin

dsh plugin 会 pnpm 安装包、把 dsh.bundle 声明自动并入 profile 的 bundles 层并启用插件。完成后重启 dsh web。

一次性前置（dsh rc.6）：当前官方 dsh 版本（0.1.0-rc.6）的 dsh plugin 只是 pnpm 转发器，而 profile 是 pnpm workspace 根，直接 add 会被 pnpm 拒绝。在 profile 目录放一个 .npmrc（一行）即可：

ignore-workspace-root-check=true

之后所有 dsh plugin add/remove 都正常。未来版本若修复了转发行为，此步可省略。

快速安装（脚本方式）

在仓库根目录（与 install.ps1 同目录）运行：

.\install.ps1

脚本优先调用官方 dsh plugin add；若 dsh/pnpm 不可用则自动回退到手动复制 + 幂等写入注册行（重复运行安全）。完成后重启 dsh web。

卸载：

.\uninstall.ps1

（脚本优先调用官方 dsh plugin remove，失败自动回退手动清理。）

常用参数：-DshHome <目录>（非默认安装位置时）、-Force（免确认覆盖）。

手动安装

  1. 复制包：把 dsh-skin 整个文件夹复制到：

    %USERPROFILE%\.dsh\profiles\web\node_modules\dsh-skin

    （即 C:\Users\<你的用户名>\.dsh\profiles\web\node_modules\dsh-skin；若 node_modules 目录不存在则新建）

  2. 注册插件：打开文件 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml，把内容替换为：

    # Your patch layer for this dsh profile, applied after every bundle layer:
# a top-level YAML array of loader patch entries (id-targeted config
# overrides, disables, and insert lists; `!!js` expressions allowed).

# dsh-skin — 外观定制插件
- insert:
    - id: dsh-skin
      name: 'dsh-skin'
      inject: [webServer, fs]

    （如果该文件已有其他内容，把最后的 - insert: 段追加进去即可，不要覆盖原有条目）

  3. 重启：停止并重新启动 dsh web（从任何目录启动均可）

  4. 选择图片文件夹：打开 设置 → 皮肤 (◕‿◕) → 点"选择文件夹…"选你的图片目录。首次打开会自动选第一张宽幅图。

验证

  • 背景应自动出现；设置页有：收藏夹 / 播放 / 位置缩放 / 主题（自动识别、预设、自定义、三个透明度滑块）

可选：迁移个人数据

把旧机器的 C:\Users\zxy\.dsh-skin-state.json（收藏夹、主题、每图设置）复制到新机器启动 dsh 的目录下（状态文件按 dsh 进程启动目录解析；不确定的话，先启动一次 dsh、在设置里随便改个值，再看新机器上生成了哪个 .dsh-skin-state.json，用同目录覆盖即可）。

版本兼容性

  • 插件的背景、主题、收藏夹等功能基于主题令牌实现，跨小版本基本稳定；
  • 部分 UI 样式（工具卡片文字、布局预览测量、统计条等）使用了当前前端构建的哈希类名（如 .o3BgMG_*、.pI_x6G_*）。若新机器 dsh 版本与 0.1.0-rc.6 不同，这些样式可能静默失效（不影响背景/主题主功能），失效时把对应类名按新版本前端更新即可。

卸载

官方方式（与安装对称，一条命令）：

dsh plugin --profile web remove dsh-skin

该命令移除依赖、把插件从 bundles 层摘除、清理 node_modules——dsh plugin 的调和逻辑对增删都生效。完成后重启 dsh。

或者运行仓库里的 .\uninstall.ps1（优先调用官方命令，失败自动回退手动清理：删除包目录、cordis.patch.yml 注册块、package.json 的依赖与 bundles 条目）。