Vim0x3c/dsh-skin-appearance 预览 preview

Vim0x3c/dsh-skin-appearance

Plugin插件 Native原生 ⭐ 4 UI & Themes界面与主题

DeepSeek Harness 外观定制插件:八套内置主题 + 自定义壁纸(透明度/模糊),Host 设置持久化 | dsh web 的外观插件

Project Overview项目介绍

This is an appearance plugin built exclusively for DeepSeek Harness (DSH). It retains all of DSH’s native interface controls and only adds a dedicated “Appearance Customization” section to the DSH settings menu. It ships with 8 pre-built themes: DeepSeek-chan, QQ2008 Crystal Blue, Cloud Lab, Ink Algorithm, Abyss Starport, Deep Sea Whale Song, and two versions of the Intelligence Orbit theme. It also supports uploading custom local background images, automatically compresses uploaded files to fit a 1600-pixel maximum long edge size limit, and extracts complementary color palettes for both light and dark modes.

After installation, the plugin works seamlessly with DSH’s native theme toggles for light mode, dark mode, and system matching, so you don’t have to switch themes manually outside DSH’s native controls. Each theme comes with custom-styled sidebars, new conversation buttons, plugin entry points, and input boxes that match the theme’s unique visual language. Users can independently adjust background transparency and blur strength, and all custom settings are persisted across DSH restarts via the host settings system. If you ever want to go back to the default DSH look, one click on the reset option restores the original native appearance.

The plugin is packaged as a standard DSH bundle, so you can install it to your DSH web profile via the DSH CLI. If the plugin is published to the official DSH package registry, you can install it directly by its name without downloading a local copy. For local development, it follows the standard DSH client plugin build structure, uses pnpm for dependency management and builds. To test local changes, you first need to build the main DSH source, then install the local plugin directory to your web profile before running DSH web. The plugin is released under the open source MIT license.

这是专为 DeepSeek Harness (DSH) 打造的原生外观插件,它保留了 DSH 全部原生控件,仅在设置页新增「外观定制」入口。插件内置八套主题,分别是 DeepSeek 娘、QQ2008 水晶蓝、云海实验室、山海算境、深海星港、深海鲸歌,以及两套智能星图主题,同时支持用户上传自定义本地背景图,自动压缩图片并提取配色生成深浅两套方案。

用户安装后,可通过 DSH 原生的浅色/深色/跟随系统开关切换当前主题的配色模式,每套主题都自带适配视觉风格的侧栏、新会话按钮、插件入口和输入框样式,还支持独立调整背景透明度和模糊效果。所有设置都会跟随 DSH 主机设置跨重启持久保存,不需要重复配置,点击一键还原就能恢复 DSH 原生外观。

插件是标准 DSH bundle 格式,可以通过 DSH CLI 安装到 web profile,若已发布到包仓库,直接使用包名即可完成安装。开发遵循 DSH 独立客户端插件构建规范,使用 pnpm 做依赖管理和构建,需要和 DSH 本体联调时要先构建 DSH 本体再安装插件,许可证为 MIT。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-skin-appearance

把 Vim0x3c/dsh-skin-appearance 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-skin-appearance

语言:中文 | English

这是一个面向 DeepSeek Harness 的外观插件。 它保留 Harness 原生控件,只在设置中增加「外观定制」页面,提供:

  • DeepSeek 娘、QQ2008 水晶蓝、云海实验室、山海算境、深海星港、深海鲸歌和两套智能星图,共八套内置主题;
  • 本地背景图片选择,并在写入设置前自动缩小压缩;
  • 从上传图片自动提取主色、辅色、面板色和文字色,同时生成浅色/深色两套配色;
  • 八套内置主题和上传图片都跟随 Harness 原生的「浅色/深色/跟随系统」开关;
  • 每套主题都有贴合自身视觉语言的侧栏、新会话按钮、插件入口和输入框;
  • 独立的背景透明度和模糊控制,默认透明度 100%、模糊 0 px;
  • 由 Host 设置文档支持的跨重启持久化;
  • 一键还原原生 Harness 外观。

主题预览

DeepSeek娘·深海回响 QQ2008·水晶蓝
DeepSeek娘主题 QQ2008主题
云海实验室 山海算境
云海实验室主题 山海算境主题
深海星港 深海鲸歌
深海星港主题 深海鲸歌主题
智能星图·墨 智能星图·曦
智能星图墨主题 智能星图曦主题

安装

插件是一个 dsh bundle,可以用 Harness CLI 安装到 web profile:

dsh plugin --profile web add /path/to/dsh-skin-appearance
dsh web

包中的 dsh.bundle.patch 会把插件加入 profile 的配置层。下次启动 Web 时,dsh.client 声明会让 Harness 发现浏览器 bundle,设置页面中就会出现「外观定制」。

如果插件已经发布到包仓库,可以把本地路径换成包名:

dsh plugin --profile web add dsh-skin-appearance

实现说明

Node 半边通过 Harness settings 服务注册 appearance 设置命名空间。浏览器半边通过 ctx.theme.overrideTokens 提供浅色和深色双模式 token,通过 settings.section slot 注册设置页,并维护一个覆盖整个应用根节点的背景图片层。八套主题分别提供侧栏、会话列表、新会话按钮、插件入口和输入框的表面样式;QQ2008 额外使用独立的经典蓝色窗口框架。自定义壁纸使用自适应的浅色/深色毛玻璃方案。

上传图片会先解码,再按长边 1600 像素上限压缩成 JPEG data URL;独立的 48 像素采样画布会提取主色、色相分离的辅色,并分别生成浅色和深色的可读面板色、文字色。切换 Harness 原生的浅色、深色或跟随系统设置时,当前皮肤保持不变,只切换对应的表面和 token;选择「默认」会移除插件自己的覆盖并交还原生界面。

背景层本身不使用 backdrop-filter;模糊只应用在有明确边界的界面表面,避免流式输出和滚动时触发整页重复合成。

开发

这个目录采用 Harness 独立 client 插件的构建结构:

pnpm install
pnpm build

要在 Harness 源码 checkout 中联调,先构建 Harness,再把本目录安装到 web profile:

cd /path/to/deepseek-harness
pnpm install
pnpm build
dsh plugin --profile web add /path/to/dsh-skin-appearance
dsh web

Harness 服务被声明为 peer dependency,确保插件和宿主共用同一个 Cordis、settings、theme、React 实例,避免浏览器 bundle 内联出重复的服务身份。

许可证

MIT。

← 上一个 Prev dsh-undo 下一个 Next dsh-tailscale-sync →