One-Line Positioning

Dress up DeepSeek Harness with 8 sets of iOS/Linear-style translucent cool-toned skins, wallpapers, and accent colors, and turn "skin changing" into a shareable, importable, and rollback-capable standard theme pack ecosystem.

Core Features

• Provides 8 built-in skins (Calm Blue, Aurora Cyan, Nebula Purple, Ember Orange, Midnight Black, iOS Flat, Liquid Glass, Material Pink), covering light and dark modes
• Supports three wallpaper sources: local image, image URL, and CSS gradient, with independent adjustment for opacity, blur, sidebar transparency, and auto-dimming
• Provides per-user Accent colors, allowing any brand color to overlay on the current skin without disrupting the skin itself
• Implements import, export, sharing links, and local theme library via *.dsh-theme.json theme packs, with format validation and rollback
• Registers a dedicated section under "Settings → Appearance / Theme", containing five functional rows: Skin, Wallpaper, Advanced Wallpaper, Accent, and Theme Pack
• Persists across DSH restarts: dual-write to localStorage and host ~/.dsh/dream-skin.json, with recovery from browser side if state file is lost

Technical Implementation

• Language: JavaScript (Node-side ESM + browser-side CJS via __ModuleLoader__)
• Key Dependencies: @deepseek-ai/cordis (plugin host framework), @deepseek-ai/dsh-client-runtime / dsh-client-locale / dsh-client-ui-theme (DSH official client packages), react ^18.2
• Architecture Pattern: Standard DSH dual-sided plugin — Host side inserts dream-skin loader entry via cordis.patch.yml, mounts /dream-skin/api trusted JSON persistence endpoint; Browser side declares itself via dsh.client to be pulled by dsh-client-modules, registers themes, slots, and locale dictionaries
• Entry Files: lib/index.js (Host apply), lib/client.js (Browser apply, containing 8 skin tokens and 8 language dictionaries)

Use Cases

Ordinary users who want to tune DeepSeek Harness to a translucent cool-toned visual style that matches their aesthetic, without installing desktop client injection-type skin tools. Ideal for those who spend long hours daily writing/coding in DSH Web, needing softer contrast, more restrained accent colors, and better-looking light/dark combinations, while being able to switch or share a custom color scheme with colleagues at any time.

Prerequisites & Compatibility

Installation

dsh plugin --profile web add github:RevolutionLA/dsh-dream-skin

Configuration Options

This plugin requires no additional configuration. All adjustable options are presented graphically in Settings → Appearance (Theme) panel. Common options include:

All persistence keys carry the dsh-dream-skin: prefix, stored in browser localStorage; after each change, they are debounced for 200ms and pushed to host file ~/.dsh/dream-skin.json. Both official Web with fixed origin and DSH Desktop with random ports can persist across restarts.

FAQ

Q: After installation, I can't see the "Appearance / Theme" section in DSH. What should I do?

A: You must restart DSH Web (run dsh web) for the new plugin to be discovered and loaded by the plugin manager. After restart, go to Settings → Appearance (Theme) to see the five functional rows: Skin, Wallpaper, Accent, and Theme Pack.

Q: After restarting DSH, why does the skin/wallpaper I applied seem to revert to default?

A: Since version 0.4.0, the plugin uses three-layer persistence by default: memory cache → localStorage → host file ~/.dsh/dream-skin.json. On restart, the browser side pulls the saved skin/wallpaper/accent/theme pack from the host file and reapplies them. If it still gets lost, verify whether DSH_HOME points to the expected directory, or if the Web process was actually restarted.

Q: Is this plugin the same as Codex-Dream-Skin?

A: It's a tribute but with a different implementation path. Codex-Dream-Skin injects CSS into the desktop client via CDP, while this plugin uses DSH's official ctx.theme.register / ctx.slots.inject extension points—no injection, no binary modification—so it won't break due to DSH updates.

Q: How do I share my custom color scheme with colleagues?

A: Click "Theme Pack → Import" in settings to load a *.dsh-theme.json, or write your own (refer to docs/examples/sample-theme-pack.json), then click "Copy Share Link" to encode the entire pack into a URL hash and send it out; you can also export the file and distribute it through any channel. Import validates format and required fields, failing safely without disrupting existing settings.

Q: Will there be residual files after uninstallation?

A: Uninstalling only stops loading. Keys prefixed with dsh-dream-skin:* in localStorage and ~/.dsh/dream-skin.json remain; reinstalling automatically takes over, or you can manually delete them for complete cleanup.

Q: Why doesn't the background change when I switch skins?

A: The default logic is "if skin has no built-in background, automatically apply iOS diffuse light gradient for that skin." Once you manually select an image/URL/gradient, the plugin marks it as "custom wallpaper"—subsequent skin switches won't override it. To revert to "follow skin", you need to clear the custom wallpaper.

Q: Can I completely remove the wallpaper to restore the official appearance?

A: Click "Clear Wallpaper / Remove Image" in "Advanced Wallpaper" or the main wallpaper row. The main canvas and sidebar will revert to that skin's opaque colors.

Difficulty Level

Beginner — After installation, just click a few times in the settings panel, no commands, no config files, no extra restart steps required; to write your own theme pack, dive into docs/themes-spec.md.

Known Issues & Limitations

• Flash of Unstyled Content (FOUC): Before the plugin first mounts, the theme hasn't been applied yet, showing the default appearance. Current approach is "render with same-origin localStorage as fallback first, then overlay." Completely eliminating FOUC remains a Roadmap item (README.md:321).
• Request Body Limit 32 MB: /dream-skin/api returns 413 when a single set exceeds 32 MB. Wallpapers are stored as base64 data URLs in localStorage and auto-compressed to ≤2 MB, so it rarely hits the limit, but be mindful when batch-importing large theme packs.
• Host channel only meaningful under random port deployment: Official Web has fixed origin, so localStorage is theoretically sufficient; $DSH_HOME/dream-skin.json primarily serves DSH Desktop where "port changes every launch," so behavior differs slightly between the two.
• No user-level config schema exposed: All settings are in the UI, with no injectable config items in the form of ctx.config.*; to change tokens, you need to add new built-in skins or write theme packs.

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

⚡ 一句话安装

复制下面这句话给你的 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 工作区。

---

📸 实机截图

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

  

---

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

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

✨ 功能一览

🚀 进阶能力（P0）

吸取了同类先行项目之短，融入 Codex 换肤的 UX，做了一套差异化能力：

🧩 它是什么形式的插件

它是 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 plugin --profile web add dsh-dream-skin
• 调用的是官方扩展点：ctx.theme（注册主题）、ctx.theme.overrideTokens（叠加层）、 ctx.slots（把 UI 挂进独立的 设置 → 外观 / Theme 分节）。
• manifest 契约与官方一致：dsh.bundle + dsh.client + exports["./client"]。

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

🖼️ 预览 — Mirage 幻梦系列

以下色卡由各皮肤的真实 token 生成，所见即所得。点开可放大。

预设一览

⚡ 快速开始（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   # 重启后恢复官方外观

🧩 兼容性

升级 DSH 到新版本时，请同步更新 package.json 里的 peerDependencies。

⚙️ 工作原理

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')

• Host 半边（lib/index.js）：dsh.bundle patch 层，插入 dream-skin loader 入口；apply 为空操作， 与官方 ui-* 包同构。
• 浏览器半边（lib/client.js）：
  1. ctx.theme.register(...) 注册 8 套皮肤；
  2. 恢复上次保存的皮肤并 ctx.theme.setTheme(...) 应用；
  3. 壁纸渲染为 z-index:-1 固定背景层，叠加 ctx.theme.overrideTokens(...) 让主画布 （--dsw-alias-bg-base）与侧边栏（--dsw-specific-sidebar-fill）半透明；
  4. 监听 theme/change，切皮肤 / 深浅色时自动重新着色壁纸洗色层；
  5. 注册独立的 设置 → 外观 / Theme 分节（settings.section），5 个功能行挂在 settings.dreamSkin.item 插槽下。

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

💼 持久化说明

• 皮肤与壁纸存于 localStorage（键前缀 dsh-dream-skin:），只在当前浏览器生效。
• 为何不用 Host settings？DSH 的 Host settings 线路只向浏览器暴露一份白名单命名空间 （dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES），第三方命名空间会返回 settings-not-exposed； 产品本身也把远程浏览器偏好进程化。localStorage 恰好匹配这一边界，且跨刷新存活。

🛠️ 开发 / 扩展主题

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

• 新增一套内置皮肤：在 lib/client.js 的 SKINS 数组加一个对象（id + colorScheme + tokens）， 它即自动出现在设置里；记得在全部 8 种语言词典（zh/en/ja/ko/es/fr/de/ru）补 skin.<id> 文案。
• 做一个主题包（推荐分发方式）：参考 docs/examples/sample-theme-pack.json， 一个 *.dsh-theme.json 即可在设置里导入或通过分享链接分发给别人，无需改代码。
• 放你自己的壁纸：把图片丢进 wallpapers/（注意只在你有权限的前提下分发），再在 DSH 的「背景图片」里导入即可。
• 跑校验：npm test（VM 冒烟测试，覆盖 factory 求值、apply 挂载、主题包导入/持久化）。
• 换配色：参考 --dsw-alias-* 令牌（完整契约见 docs/themes-spec.md）。

📌 Roadmap

• 首版：8 套主题 + 自定义壁纸（透明度 / 模糊）+ 本地持久化
• 主题包格式 + 导入 / 导出 / 分享链接（JSON + manifest + 校验）
• 每用户强调色 Accent + 随机
• 壁纸 2.0（URL / 渐变 / 每皮肤建议 / 自动弱化）
• 本地主题包库 + 一键应用 / 收藏 /「换一个试试」
• 多语言文案与文档（中 / 英 / 日 / 韩 / 西 / 法 / 德 / 俄）
• 在线色板 / 主题预览 Studio（纯前端，浏览器内校验 + 对比度检查）
• 社区主题库（把主题包投稿到仓库 / 在线 Gallery）
• 首帧无闪烁（FOUC）改进

🤝 贡献

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

⭐ 支持这个项目

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

🔒 安全

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

📄 开源协议

MIT

🙏 致谢

• 架构与 API 参考：DeepSeek Harness 官方 ui-theme 客户端包。
• 概念致敬：Codex-Dream-Skin。