dsh-dream-skin README

The project's README from github.com/RevolutionLA/dsh-dream-skin. As one markdown file: README.md.

中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Русский

dsh-dream-skin 🔮

为 DeepSeek Harness 换上一张克制、清透、有质感的「脸」。

原生换肤 · 背景壁纸 · 强调色 · 主题包 —— 一条 --dsw-* token 生态内的优雅实现。装一次，用很久。

写代码的地方，可以很安静。

🎨 8 套原创主题 🖼️ 壁纸 + 弥散光 🎯 克制的强调色 📦 主题包可分享

1 行安装 · 纯原生（无注入/不改安装包）· 不因 DSH 更新失效

🎮 两种玩法，一条插件都给你

🪄 玩法一：开箱即用的优雅

🧱 玩法二：随你掌控的 DIY
内置 8 套设计师调校的预设皮肤（Mirage 幻梦系列），浅色 / 深色兼顾，每套自带专属弥散光背景。
戴上即高级，不用任何调参。		 在预设之上，你还能 换壁纸（本地图 / URL / 渐变）、叠加强调色 Accent、拖入或分享一个主题包，内部每个 token 都能摸到。
想要的样子，自己捏。

两种玩法分层独立、互不干扰：预设皮肤决定「材质与底色」，DIY 一层是纯叠加（overrideTokens），随开随关、一键还原。

📸 实机截图

真机效果，非概念图。左：应用皮肤后的 DSH 界面；右：设置里的「外观 / Theme」分节。

DSH 皮肤实机预览    设置中的外观分节

🎨 预览 — Mirage 幻梦系列

玩法一 · 开箱即用的优雅。 8 套皮肤，由各皮肤的真实 token + 专属弥散光背景生成——所见即所得。点开可放大查看精致材质。

abyss
abyss · 沉静蓝		 aurora
aurora · 极光青		 nebula
nebula · 星云紫		 ember
ember · 余烬橙
midnight
midnight · 午夜黑		 ivory
ivory · iOS 扁平		 mist
mist · 液态玻璃		 rose
rose · 蔷薇粉

📋 预设一览

id 风格 特质
abyss 🕶️ 沉静蓝 冷静深沉的靛蓝，克制不喧哗
aurora 🌌 极光青 清冽通透的冷青，自然冷调
nebula 🪐 星云紫 深邃漫射的紫青，朦胧神秘
ember 🔥 余烬橙 温暖克制的琥珀橙
midnight 🌚 午夜黑 极简纯黑，OLED 沉浸
ivory 📐 iOS 扁平 极简平白，iOS 系统灰 + 克制的蓝
mist 🧊 液态玻璃 清透毛玻璃，半透明 + 模糊
rose 🌸 Material 粉 明快彩粉，谷歌 Material 扁平彩色

🧱 强大 DIY 空间（玩法二）

预设皮肤之外，dsh-dream-skin 还给你一套完整的自定义体系——想捏出独一无二的工作区，从这里开始。

能力 玩法二 · 你能做什么
🖼️ 自定义壁纸 2.0 本地图 / 图片 URL / 渐变预设；附带透明度 / 模糊，每套皮肤还自动建议一张渐变，可自动弱化（聚焦任务时降低干扰）
🌈 每用户强调色 Accent 为当前皮肤叠加自定义品牌强调色（overrideTokens 层，不动皮肤本身），12 个典型色块一键选色 + 选色盘 + 随机 + 恢复主题色
📦 主题包导入 / 导出 / 分享 一个 *.dsh-theme.json = manifest + 全套 tokens，可导入文件、一键应用、复制分享链接（编码进 URL hash）
🪟 弹窗不透明度 滑块控制下拉菜单 / 浮层 / 弹窗的底填充透明度，跟随持久化保存
🧩 本地主题包库 导入的主题包集中展示，应用 / 收藏 / 移除 一键完成
🎲 换一个试试（surprise me） 随机换一个和你当前不同的主题；收藏喜欢的皮肤快速切换
✅ 校验 + 回滚 导入时校验格式 / 必填 token / 颜色合法性；失败或移除时安全回退，不做破坏性更改

一切都叠加在预设之上，随开随关、一键还原到 DSH 内置外观——大胆去试，不会弄坏什么。

⚡ 一句话安装

复制下面这句话给你的 DSH，它自己会装好一切：

请帮我安装 dsh-dream-skin 换肤插件（https://github.com/RevolutionLA/dsh-dream-skin 或 npm 的 dsh-dream-skin），装完告诉我如何重启 DSH Web。

不想麻烦 Agent？命令行一条：

dsh plugin --profile web add dsh-dream-skin && dsh web

🚀 现已发布到 npm！ 装好 DSH 后，一条命令即可安装，无需 clone。

致敬 Codex-Dream-Skin。 但实现路径不同：Codex 是往桌面客户端渲染进程 注入 CSS（CDP），而 DSH 本身是 token 驱动的 Web GUI，官方就提供了「第三方插件注册主题」的能力——所以本插件是 纯原生接入，无注入、不改二进制、不因客户端更新失效。

不是官方产品。 仅供美化你的 DeepSeek Harness 工作区。

🏆 为什么值得用（vs 同类）

换个赛道看：全家桶把换肤做成一堆二次元题材的「贴图墙」；我们把换肤做成材质与配色的精细化工艺—— 追求的不是「更花」，而是「更准、更克制、更耐看」，像一块反复推敲的玻璃。审美是我们的护城河。

能力 本插件 全家桶换肤方案 Codex-Dream-Skin (桌面)
原生 token 主题，不注入、不改安装包 ✅ ✅ ❌ (CDP 注入)
iOS/Linear 式清透冷调材质与配色 ✅ ❌ (偏二次元题材) ❌
每皮肤克制的高级感弥散光背景 ✅ 部分 ❌
自定义壁纸 + 透明度/模糊 ✅ 部分 ✅
主题包导入/导出 + 分享链接 ✅ ❌ ✅ (zip 主题)
每用户强调色 Accent ✅ ❌ 部分
壁纸 2.0（URL / 渐变 / 每皮肤建议 / 自动弱化） ✅ ❌ ✅
本地主题包库 + 收藏 + 随机 ✅ ❌ 部分
校验 + 回滚 ✅ 部分 ✅
浏览器 Web GUI，天然跨平台 ✅ ✅ ❌ (需桌面 App)

✨ 功能一览

能力 说明
🎨 8 套主题预设（Mirage 幻梦） 在 设置 → 外观（Theme） 一键切换，浅色 / 深色兼顾
🖼️ 自定义壁纸 上传本地图（自动压缩 ≤2MB），调节透明度 / 模糊
🔤 内层不透明 卡片、输入框、消息气泡不被壁纸盖住，可读性优先
↩️ 默认还原 一键回到 DSH 内置外观（跟随系统）
💾 本地持久化 皮肤与壁纸存 localStorage，刷新 / 重开浏览器不丢

🧩 它是什么形式的插件

它是 DeepSeek Harness 的标准「双面插件」（dsh-plugin）——加载和用法与官方 ui-theme 完全一致。

DeepSeek Harness 的口号是「一切皆插件」：模型、工具、沙箱、会话、UI，乃至 Agent Loop 本身都是插件。 dsh-dream-skin 的本质就是把「换肤」做成一个和官方 UI 包同构的 npm 包：

            ┌────────────── dsh-dream-skin（标准 dsh-plugin / 双面插件）──────────────┐
            │  dsh.bundle   → cordis.patch.yml 插入 dream-skin 入口   (host 半边)     │
            │  dsh.client   → lib/client.js（浏览器 bundle）          (浏览器半边)     │
            └─────────────────────────────────────────────────────────────────────────┘

也就是说：你装的不是一个旁门左道的脚本，而是 DSH 官方插件体系里的标准皮肤插件。

⚡ 快速开始（3 步）

# 1. 安装
dsh plugin --profile web add dsh-dream-skin
# 2. 重启
dsh web
# 3. 打开 设置 → 外观（Theme）→ 皮肤，挑一套 → 完。

装的是 npm 已完成发布的正式包，无需 clone。若 dsh plugin add 报 workspace 相关错误，补一个 -w 即可。

📦 安装

四种方式任选其一，装完重启 DSH Web 即生效（当前会话会中断，但 DSH 会话有磁盘持久化，重启后可以恢复）。

方式一：npm 正式包（推荐，最简单）

dsh plugin --profile web add dsh-dream-skin

方式二：从 GitHub 安装（固定到已验证的提交）

dsh plugin --profile web add 'github:RevolutionLA/dsh-dream-skin#<40位commit>'

固定到 release 对应的 commit，之后 main 的新改动不会静默改变已安装代码。

方式三：从 Release tarball 安装（离线 / 不便走 git 的环境）

从本仓库 Releases 下载 dsh-dream-skin-<版本>.tgz（内含构建好的 lib/client.js，安装时无需执行任何 prepare 脚本），然后：

dsh plugin --profile web add ./dsh-dream-skin-<版本>.tgz

方式四：克隆后从本地路径安装（开发迭代）

git clone https://github.com/RevolutionLA/dsh-dream-skin.git
cd dsh-dream-skin
dsh plugin --profile web add .

dsh plugin 会把相对路径锚定到你运行命令的目录，装的是指向克隆目录的 link 依赖：改完源码保存，重启 DSH 即生效，无需重新安装。

重启并验证：

dsh web
dsh --profile web --dump-config | grep -A2 dream-skin   # 应出现 dream-skin loader 条目

打开 设置 → 外观（Theme），即可看到「皮肤」「强调色」「壁纸 / 高级壁纸」与「主题包」等行。

-w 标志在裸 add 时必需：每个 profile 自带 pnpm-workspace.yaml，pnpm 会把它当作 workspace 根，裸加报错 ERR_PNPM_ADDING_TO_ROOT。若已加过 -w，后续用现有 workspace 即无需重复。

🔄 更新 / 卸载

更新到最新版（装的是 npm 正式包时）：

dsh plugin --profile web update dsh-dream-skin
dsh web   # 重启生效

若更新后仍显示旧版本，可能是 pnpm 的最小发布年龄（supply-chain）策略挡住了刚发布的新版本： 在 profile 目录执行 pnpm add dsh-dream-skin@latest --config.minimumReleaseAge=0 即可绕过。

卸载：

dsh plugin --profile web remove dsh-dream-skin
dsh web   # 重启后恢复官方外观

🧩 兼容性

项 值
DeepSeek Harness (dsh) 同一构建兼容两代宿主：稳定版 0.1.0-rc.6 / 0.1.1-rc.x（peer 以 ^0.1.0-rc.6 对齐）与 DSH master（dsh-client-runtime 拆分后的新模块表）
Node.js >=18
浏览器 现代 Chromium / WebKit（依赖原生 CSS 变量与 matchMedia）

兼容机制：客户端 bundle 对设置 store 的宿主模块做运行时双目标解析——先试 master 的 @deepseek-ai/dsh-client-store，查表落空（missed the module table）才回落稳定版的 @deepseek-ai/dsh-client-runtime/client，其余错误原样抛出。所有 peer 平台包均声明为 optional（由宿主运行时供给，npm 上无需安装）。

⚙️ 工作原理

DSH 的主题系统是 token 化的：web 外壳内置 --dsw-* 设计令牌，ThemeRuntime 允许第三方插件注册主题去 覆盖别名层（--dsw-alias-*）。本插件是标准的「双面」插件：

                ┌─────────────────────────────────────────────┐
                │            dsh-dream-skin (双面插件)          │
                ├────────────────────────────┬────────────────┤
    Host 半边   │  lib/index.js              │  浏览器半边      │
                │  cordis.patch.yml 插入      │  lib/client.js │
                │  dream-skin loader 入口     │  __ModuleLoader__│
                └────────────────────────────┴────────────────┘
                             │                         │
                        profile 树加载              /plugins/dsh-dream-skin/client.js
                                                         │
        ┌────────────────────────────────┬────────────────┐
        │                                │                │
   ctx.theme.register(8套皮肤)      ctx.theme.overrideTokens(壁纸半透明)   ctx.slots.inject('settings.section' + 'settings.dreamSkin.item')

每套皮肤携带自己的 colorScheme（light/dark），驱动 body[data-ds-dark-theme]；别名 token 覆盖作为 <body> 内联自定义属性由 ui-layout 的 ThemePresenter 应用。

💼 持久化说明

🛠️ 开发 / 扩展主题

客户端 bundle 直接以 __ModuleLoader__ 格式编写（即 tsdown 为官方 ui-* 包输出的形态），免构建。 lib/client.js 只能 require 模块表实体：平台种子词（react、react/jsx-runtime、…）与已注册客户端 bundle（@deepseek-ai/dsh-client-runtime/client、…）。

📌 Roadmap

🤝 贡献

欢迎提交 Issue 与 PR！请先阅读 贡献指南，并遵循 Code of Conduct。

⭐ 支持这个项目

喜欢的话，给仓库点个 Star ⭐、在 npm 上点个 👍，或把它转发给你的 DSH 朋友——这会让更多人发现它， 也能激励持续维护。想一起做主题库 / 在线 Studio / 更多主题？欢迎来贡献。

🔒 安全

发现安全问题？请勿直接开公开 Issue——参见 安全策略。

📄 开源协议

MIT

🙏 致谢

📈 成长曲线

每天自动更新（GitHub Actions）。左轴：累计下载量（青色）；右轴：Star 数（紫色）——两个量级不同，因此使用独立的双纵轴。

dsh-dream-skin 每日 Star × 累计下载量成长曲线

*数据每 24 小时自动采集一次：下载量来自 [npm 官方 API](https://api.npmjs.org/downloads/

dsh-dream-skin (RevolutionLA/dsh-dream-skin)

Searching Database…

254 ·GitHub
Dsh-dream-skin
Что это?Плагин скинов и тем для DeepSeek Harness (DSH), который добавляет в веб-GUI DSH 8 готовых тем, пользовательские обои, акцентные цвета для каждого пользователя и наборы тем, которыми можно делиться.
Это отдельное приложение или плагин для DSH?Это стандартный dsh-plugin (двусторонний плагин с хостовой и клиентской половинами), который загружается и ведёт себя в точности как официальный пакет ui-theme — он регистрирует нативные темы через собственный API DSH вместо внедрения кода.
Что уже должно работать перед установкой?Рабочая установка DeepSeek Harness, Node.js 18 или новее и современный браузер на Chromium или WebKit, так как плагин опирается на нативные CSS-переменные и matchMedia.
Скин применится сразу или нужно что-то перезапустить?Чтобы новый скин вступил в силу, DSH Web придётся перезапустить; текущая сессия при этом приостанавливается, но потом возобновляется, потому что DSH сохраняет сессии на диск.
Как называются 8 встроенных тем?Abyss (глубокий синий), Aurora (холодный циан), Nebula (дымчатый фиолетовый), Ember (тёплый янтарный), Midnight (чистый чёрный для OLED), Ivory (плоский серый в стиле iOS), Mist (матовое стекло) и Rose (розовый в духе Material) — каждая идёт со своим атмосферным градиентным фоном.
Можно ли поделиться своим оформлением с кем-то ещё?Да, можно экспортировать своё оформление в один файл '.dsh-theme.json' (манифест плюс все токены), который другие смогут импортировать напрямую, или поделиться ссылкой, кодирующей тему в хэше URL.
Зачем было делать это заново вместо переиспользования подхода Codex-Dream-Skin?Codex-Dream-Skin внедряет CSS в процесс рендеринга десктоп-клиента через CDP, но веб-GUI DSH изначально управляется токенами, поэтому dsh-dream-skin регистрирует темы через собственный плагин-API DSH — а значит, переживает обновления DSH без всяких инъекций и бинарных патчей.
Что будет, если импортировать битый набор тем?Импорты проверяются на корректный формат, обязательные токены и валидные цвета; если проверка не проходит или вы позже удаляете набор, плагин безопасно откатывается, не ломая текущее оформление.
What are similar projects?DSH-Transparent-UI-Plugin, open-sea-skin, gal-view, dsh-liang-skin, dsh-wallpaper-engine, dsh-deep-whale, dsh-dafeiyu, WhaleIsle
Which topics is it in?wallpaper, theme, dsh, plugin-system, dsh-plugin, deepseek-harness, design, customization, browser, plugin, ui, gui
Creator
RevolutionLA
Size
31.9 MB
Stars
254
Updated
CommitOct 18Releasev10.16.0Oct 16
Age
2mo
Commits · 90 Days