使用 DSH Dream Skin 自定义主题、壁纸和透明效果

<!-- BEGIN REVIEWED GUIDE SUPPLEMENT -->

2026-10-02 更新到 Dream Skin 9.29.0，适配 DSH 0.2.0-rc.2

本页安装目标更新为 [email protected]，命令固定使用 DSH 0.2.0-rc.2。新版本声明兼容 0.2.0-rc.2；本站只做了固定版本的源码与发布包静态复核，没有安装或运行。

• 版本号从 0.4.10 跳到 9.29.0，是作者从 8.28.0 起改用"月.日.当日序号"的日期版本，发布者与仓库都没有变化。
• 分享链接会自动导入：打开带主题 hash 的 DSH 地址即导入并登记主题包，无二次确认（client.js tryImportFromHash）；主题值经过 CSS 过滤，但仍应只打开可信来源的分享链接。
• 第三方图床请求：图片 URL 壁纸及可选定时刷新由浏览器直接请求外部主机（出厂预填 uapis.cn bing-daily），会暴露 IP 与 UA；默认壁纸为内联 SVG，定时刷新默认关闭。
• 宿主 DOM 依赖与残留：插件通过 MutationObserver 给宿主 DOM 打标记并注入材质样式，宿主改版会导致部分透明度失效（作者记录 6 个锚点中 4 个漂移）；卸载后 $DSH_HOME/dream-skin.json 与 localStorage 会保留。

仍在使用 DSH 0.1.x： 仍在使用 DSH 0.1.x 的用户：之前收录的 0.4.10（提交 96fe8c5494d6）peer 为 ^0.1.0-rc.6，只适用于 0.1.x，在 DSH 0.2.0-rc.1 及以上会被宿主整包跳过（外观设置全部消失，不报错）。9.29.0 的 peer 范围同时覆盖 0.1.0-rc.6 起的 0.1.x 与 0.2.x，0.1.x 用户也可以直接安装 [email protected]；如需保留旧版，可继续使用 github:RevolutionLA/dsh-dream-skin#96fe8c5494d6。两个版本共用同一个 $DSH_HOME/dream-skin.json 与 localStorage 键。

依据：固定证据 1 ↗（外部链接，在新标签页打开）。

<!-- END REVIEWED GUIDE SUPPLEMENT -->

dsh-dream-skin 9.29.0 基于 DSH 官方 Theme Token 提供八套原生主题、壁纸（本地图/URL/渐变，新增裁剪填满、完整显示、模糊填充三种填充方式）、玻璃材质与各区域透明度、强调色、主题包导入导出与分享链接。

如果你的目标是为 DSH Web 设置主题、壁纸、模糊、透明度和强调色，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-dream-skin。本文锁定作者仓库提交 4e63b25e187f；已复核固定提交的原始资料，未进行运行实测。

对应插件：查看 dsh-dream-skin 的功能、权限与兼容性说明。先确认它适合你的工作流，再执行安装。

先确认是否适合你

• 分类：界面交互
• 风险等级：medium
• 核验证据：source_reviewed
• 兼容性边界：9.29.0 的 6 条 @deepseek-ai/dsh-client-* peer 为 >=0.1.0-rc.6 <0.3.0-0，按 semver 7 includePrerelease 计算满足 0.2.0-rc.2，也覆盖 0.1.x；0.3.x 被明确排除。@deepseek-ai/cordis ^4.0.1 与 react ^18.2.0 不在宿主预检范围。以上为声明层面兼容，52DSH 未在 0.2.0-rc.2 上运行验证；作者自述在 0.2.0-rc.1 上复核，未覆盖从 npm 全新安装路径。要求 Node.js >=18。
• 主要权限关注：浏览器端注册主题、注入一个材质 <style> 并用 MutationObserver/定时器给宿主 DOM 打标记以调整透明度；读写 dsh-dream-skin:* localStorage 键与诊断全局量 window.DSH_DREAM_SKIN_STATUS；Host 端注册 /dream-skin/api（Host/Origin 信任围栏，非认证）并原子写入 $DSH_HOME/dream-skin.json（0600）。不读取模型凭据、不注册 Agent 工具、不启动子进程。

如果你准备在重要工作区使用，先阅读插件详情页的权限和数据流说明；“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

本页 DSH 命令版本： 0.2.0-rc.2。9.29.0 声明的 DSH 版本范围包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2。仅静态复核，未在本站运行验证。

• DSH 0.2.0-rc.2：通过 npx 运行 @deepseek-ai/[email protected]，并使用独立的 web Profile 测试。
• Node.js 18+：插件 engines 声明 Node.js >=18。
• 可信壁纸来源：使用图片 URL 壁纸时只填写可信的 HTTPS 图床地址。

1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 pnpm 可用。
2. 使用独立的 web Profile 和可丢弃测试工作区，不直接连接生产目录。
3. 备份当前 Profile 配置，并记录安装前的 --dump-config 输出。
4. 核对固定来源中的外部服务、账号、运行时和平台限制。
5. 作者资料未显示明确的插件专属环境变量；如果运行时要求凭据，不要根据同类插件猜测变量名。

安装 dsh-dream-skin

52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项，不要全局放行未知依赖。

插件专属配置

配置目标

• 设置 → 外观（Theme）：切换皮肤、强调色、壁纸与填充方式、玻璃材质透明度，导入或导出主题包。
• $DSH_HOME/dream-skin.json：Host 端保存的外观偏好，跨端口和重启保持；由插件自动读写，不需要手改。

主题包文件（*.dsh-theme.json）

证据：固定来源 ↗（外部链接，在新标签页打开）。将路径、账号和凭据占位符替换为测试值。

{
  "format": "dsh-dream-skin/pack",
  "version": 1,
  "manifest": {
    "id": "aurora-test",
    "name": "Aurora Test",
    "nameZh": "极光测试",
    "author": "RevolutionLA",
    "version": "1.0.0",
    "colorScheme": "dark",
    "accent": "#34d399",
    "tokens": {
      "--dsw-alias-bg-base": "#04120f",
      "--dsw-alias-bg-layer-1": "#0a1d18",
      "--dsw-alias-brand-primary": "#34d399",
      "--dsw-alias-label-primary": "#eafaf2",
      "--dsw-alias-label-secondary": "#92d5b8",
      "--dsw-alias-border-l1": "#0f2a22",
      "--dsw-alias-border-l2": "#1a3a30"
    }
  }
}

安装后设置

1. 重启 DSH Web 后打开 设置 → 外观（Theme），确认出现皮肤、强调色、壁纸与主题包等设置行。
2. 先使用内置皮肤和本地图片或渐变壁纸；需要图片 URL 时只填可信 HTTPS 地址，定时刷新按需手动开启。

配置验证与成功结果

先导出配置，再启动同一版本的 DSH Web：

npx --yes @deepseek-ai/[email protected] --profile web --dump-config
npx --yes @deepseek-ai/[email protected] web

1. 导出 web Profile 组合配置，确认 dream-skin 加载条目存在。

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config
   

   期望结果：输出中出现 id 为 dream-skin、name 为 dsh-dream-skin 的条目。

2. 启动 DSH Web，在 设置 → 外观（Theme）切换一套内置皮肤。

   npx --yes @deepseek-ai/[email protected] web
   

   期望结果：界面配色立即切换；刷新页面后仍保持所选皮肤。

3. 在浏览器开发者工具控制台读取 window.DSH_DREAM_SKIN_STATUS。

   期望结果：build 为 9.29.0，status 为 ready。

第一次使用

• 在 设置 → 外观（Theme）选择 nebula 皮肤，把壁纸切到本地图片并选择“模糊填充”。
• 导入示例主题包 sample-theme-pack.json，应用“极光测试”后再导出一份作为备份。

数据、权限与凭据

**数据流：**内置 Token、导入的主题包 JSON 或 URL hash 分享链接 → 客户端格式与 CSS 值校验 → Theme Runtime、localStorage 与 /dream-skin/api → $DSH_HOME/dream-skin.json；选择图片 URL 壁纸时浏览器直接请求该图片主机（出厂预填 uapis.cn bing-daily 链接，但默认壁纸为内联 SVG、定时刷新默认关闭）；开启定时刷新后按间隔带时间戳重新拉取；插件自身未发现遥测或其他外部请求。

**权限关注：*浏览器端注册主题、注入一个材质 <style> 并用 MutationObserver/定时器给宿主 DOM 打标记以调整透明度；读写 dsh-dream-skin: localStorage 键与诊断全局量 window.DSH_DREAM_SKIN_STATUS；Host 端注册 /dream-skin/api（Host/Origin 信任围栏，非认证）并原子写入 $DSH_HOME/dream-skin.json（0600）。不读取模型凭据、不注册 Agent 工具、不启动子进程。

**数据存储：*浏览器 localStorage 的 dsh-dream-skin: 键，以及 $DSH_HOME/dream-skin.json（经 /dream-skin/api 读写，文件权限 0600）。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后，从同一个 Profile 移除包：

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-dream-skin

1. 运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-dream-skin，并重启 DSH Web。
2. 如不再需要外观偏好，删除 $DSH_HOME/dream-skin.json，并在浏览器中清除该 DSH 地址下的 dsh-dream-skin:* localStorage 键。

常见问题

升级后外观设置整体消失

DSH 0.2.x 会跳过 peer 不满足的插件；确认已安装 9.29.0 而不是 0.4.10，并查看 DSH 启动日志中的插件跳过记录。

图片 URL 壁纸不显示

只支持 http、https 与 data:image 链接；检查图床可访问性，或改用本地图片和渐变。

安装时提示新版本被拒绝

可能是 pnpm 最小发布年龄策略拦截新版本；按作者 README 的更新说明处理，或稍后重试。

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile，再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务，检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文，并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时，应先停止 DSH、保留日志并回退插件。

固定来源证据

以下资料是本文配置结论的依据：

• README.md ↗（外部链接，在新标签页打开）
• SECURITY.md ↗（外部链接，在新标签页打开）

继续查看：返回 dsh-dream-skin 插件详情页，重新核对兼容性、权限、同类插件和来源状态。