dsh-dream-skin

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

快速判断

安装前先看这几项

配置资料
配置资料完整
配置难度
简单
适合新手
可以尝试
兼容状态
声明兼容,尚未实测
验证状态
源码已审阅,未标记运行实测
本页目录(9)
中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 dsh-dream-skin 安装与配置教程 →
功能

这个插件能做什么

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

适合谁

需要DSH 界面、主题、侧边栏能力的用户。

准备

安装前准备

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

如何安装 dsh-dream-skin

本页命令固定使用 DSH 0.2.0-rc.2,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。

安装到
web Profile
DSH 基线
0.2.0-rc.2
安装来源
npm 预构建包(锁定版本)
固定目标
[email protected]

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

  1. 01
    检查 Node.js 与 pnpm

    DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且 pnpm 必须已在 PATH 中。先运行:

    环境检查
    node --version && pnpm --version
  2. 02
    安装到 Web Profile

    这条命令会把插件加入 web Profile,并在插件声明 DSH Bundle 时自动加入配置层。

    npm 预构建包(锁定版本)
    npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]
  3. 03
    确认 Bundle 已进入配置

    安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 dsh-dream-skin或对应 Bundle 层。

    检查配置
    npx --yes @deepseek-ai/[email protected] --profile web --dump-config
  4. 04
    启动并完成最小验证

    启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。

    启动 DSH Web
    npx --yes @deepseek-ai/[email protected] web
卸载与回退

测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除
npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-dream-skin
配置

插件专属配置

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

主题包文件(*.dsh-theme.json) · json。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 主题包文件(*.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 地址,定时刷新按需手动开启。
验证

配置检查与成功结果

  1. 01
    导出 web Profile 组合配置,确认 dream-skin 加载条目存在。
    复制验证命令
    npx --yes @deepseek-ai/[email protected] --profile web --dump-config

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

  2. 02
    启动 DSH Web,在 设置 → 外观(Theme)切换一套内置皮肤。
    复制验证命令
    npx --yes @deepseek-ai/[email protected] web

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

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

    期望结果:build 为 9.29.0,status 为 ready。

使用

第一次使用建议这样验证

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

它可能接触哪些数据和能力

执行本机命令控制浏览器使用服务凭据

浏览器端注册主题、注入一个材质 <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)。

请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

升级后外观设置整体消失
DSH 0.2.x 会跳过 peer 不满足的插件;确认已安装 9.29.0 而不是 0.4.10,并查看 DSH 启动日志中的插件跳过记录。
图片 URL 壁纸不显示
只支持 http、https 与 data:image 链接;检查图床可访问性,或改用本地图片和渐变。
安装时提示新版本被拒绝
可能是 pnpm 最小发布年龄策略拦截新版本;按作者 README 的更新说明处理,或稍后重试。
卸载后的清理步骤
  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 键。
深入审计:兼容性、数据流与来源
证据

兼容性与审阅记录

兼容性说明

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。

数据流

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

源码审阅结论

已静态复核 npm 包与 v9.29.0 tag 的绑定(SHA-512 与 dist.integrity 一致,tarball 与锁定提交去除行尾差异后逐字相同,lib/ 为直接提交的 JS)、0.4.10→9.29.0 的 Host API(lib/index.js 未变)、客户端 fetch/网络调用、出厂默认值、分享链接导入与 CSS 值过滤。打开带主题 hash 的链接会直接导入主题包(无二次确认);图片 URL 壁纸和定时刷新会让浏览器向第三方图床暴露 IP 与 UA;卸载不会删除 $DSH_HOME/dream-skin.json 与 localStorage。版本号自 8.28.0 起为日期式 M.D.X,非接管。未执行插件,未在 DSH 0.2.0-rc.2 上做运行时验证。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。

来源快照
08f3df46cca1
固定提交
4e63b25e187f
许可证
MIT
主要语言
JavaScript
中文资料
有完整中文配置资料