皮肤不是主题包,是一层被限定的 CSS 契约
主题包通常拿走整页样式,作者想改哪里就改哪里,官方升级一次,界面就撕开一道口子。DSH 的皮肤中心是另一条路:把「换肤」拆成三层可以被逐层验证的契约,皮肤只能在契约划定的范围里说话。 包名 @linxin666/dsh-client-ui-skin-center (cordis 插件 id ui-skin-center ),版本 v0.4.15,站内快
主题包通常拿走整页样式,作者想改哪里就改哪里,官方升级一次,界面就撕开一道口子。DSH 的皮肤中心是另一条路:把「换肤」拆成三层可以被逐层验证的契约,皮肤只能在契约划定的范围里说话。
包名 @linxin666/dsh-client-ui-skin-center(cordis 插件 id ui-skin-center),版本 v0.4.15,站内快照 33 星(数据截至 2026/11/4)。它是 dsh Web GUI 里所有皮肤唯一的加载器与渲染器:皮肤是纯资产目录,没有 package.json、不发 npm、不接 cordis 接线,只与 contracts/ 耦合。对官方 DSH 的耦合,被吸收在契约之后。
dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center
L1:重映射官方设计 token
L1 是最窄也最稳的一层。皮肤在 skin.css 里重映射官方 --dsw- 设计 token,不改结构、不碰选择器优先级。换肤最终落地为一批 CSS 自定义属性换了值,官方壳层照自己的规则渲染。
好处是几乎不可能画错:官方还用同一套 token,皮肤不会因为多一个 div 就错位。代价是形状与层级动不了,只覆盖被 token 化的颜色、圆角、阴影——不输出语义属性的插件只享受 L1,部分面板会保持原色。
L2:三个语义属性
结构级覆盖靠 data-dsh-surface、data-dsh-part、data-dsh-plugin,枚举写在 contracts/semantic-attrs-v1.md。兼容适配器从 data-slot 出口、data-chat-flow-kind 这类稳定锚点出发,为官方壳层 DOM 打标。
价值是皮肤不必猜选择器:写 data-dsh-surface="sidebar" 比写 div:nth-child(3) 抗改版得多。主动输出语义属性的插件拿满 L2,不输出的只剩 L1。
公共壳层适配器则在激活期间统一处理列表末端 fade、composer 占位符颜色与滚动口间距。
L3:任意选择器补丁,以及它的代价
patches.css 是高敏感项。理由很直接:插件运行时写进 DOM 的行内样式,除了 !important 补丁没有别的覆盖办法。
所以 L3 本质是一份免责声明——它拥有完整页面样式能力,不构成安全边界,脆弱性由皮肤作者自负。排查顺序也因此确定:先看 L1/L2,只剩行内样式时才动 L3。
一次切换 = 一个 activation
试穿与应用共用同一个原子引擎:一次切换生成新的 activation identity,取回已限定作用域的样式表,装样式、背景媒体与可选 hooks,翻转 html[data-dsh-skin="<id>"],再销毁上一个 activation。效果账本 append-only,清理幂等,重复触发不留残影。
三个决定值得单独记:最新请求永远胜出,连点几套只有最后一次留在页面上;失败或被淘汰时旧皮肤完整保留,页面上永远只有一套皮肤;试穿走同一引擎但不落盘,「退出试穿」恢复已提交的皮肤,应用才写 POST /api/skin-center/v2/active。全程不刷新页面、不改 cordis.patch.yml、不重建启动图。
首屏:先盖属性,再谈样式
刷新时官方原貌已经画出来、皮肤样式还没到,这就是 FOUC。解法是在文档送达阶段动手:host 半区注册一个 webServer.tapIndex 转换,给每份送达的 index.html 盖上 html[data-dsh-skin] 并插入样式表链接。先有属性、后有样式,首帧就在皮肤作用域里。
失败策略同样关键:tap 出任何问题都 fail-closed 回官方原貌,宁可这一屏是官方样子,也不留属性对了、样式没到的中间态。首屏还会同步读壁纸插件的持久化选择,确认这一屏要画壁纸,就完全不注入皮肤。
CSS 安全管线:每请求 fork 一个 worker
皮肤终究是别人写的 CSS。最省事的做法是在宿主进程里挂个解析器,但那等于把原生 addon 映射进长驻进程。这里的处理是宿主从不加载 CSS 解析器:每次转换都在短生命周期 worker 里跑,每个请求单独 fork 一个,并在样式表响应写回之前确认 worker 已退出。
规则也偏保守:每个选择器强制限定在 html[data-dsh-skin] 之下;@import、远程或协议相对 URL、越界路径直接报错,资产读取限定在各皮肤目录之内。
并发最多持 8 个请求(含执行中与等待中),超出立即 503 css-transform-overloaded;白名单违规 422,其它转换失败 500;每请求 10 秒预算,也覆盖「已应答但拒绝退出」的 worker,起不来的 worker 立即失败而不是耗完预算。
契约放弃了什么
- 只在 dsh Web GUI 生效,不是通用主题引擎。
- 覆盖深度取决于插件配合:没有语义属性只剩 L1,写死行内样式只能靠 L3 硬顶。
- L3 的脆弱性被转移而不是消除,「装了就永远好看」的预期不成立。
- 自定义主题只生成 token 白名单 CSS,不接收选择器、任意 CSS 或资源 URL;目录皮肤激活时它自动停用。
口径与档位
最近提交在 3 天前。npm 周下载 45,467 是 npm 全网含 CI 与镜像的下载量,不是本站安装数,不能换算成用户数。
信任档位是「仅索引」:静态安装检查通过、未做真实安装(数据截至 2026/10/29)。安全扫描标注「含敏感能力」,本站尚未做风险分级(截至 2026/11/06),未覆盖不等于无风险。遥测是每个 UTC 日一次匿名心跳,只含一个 localStorage 随机 ID 与本包名,服务端只存该 ID 的加盐哈希、不存 IP。
总结
它把换肤收敛成三层可逐层验证的契约,稳定性与自由度都写在明面上,代价是覆盖深度受插件配合限制;想对照同类插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:长期开着 dsh Web GUI、希望深色护眼又不想每次升级重调样式的人;要给团队做统一配色、且接受只走 token 白名单的团队;插件作者想验证自己的面板有没有吃到 L2 覆盖;装了壁纸插件、需要「壁纸与皮肤轮流上场」共存规则的人。
不适合:主要在 DSH Desktop 桌面端使用、又不打算先装 dsh 引擎的人;想把这套皮肤挪到 VS Code 或终端里的;指望装一款皮肤就修好所有第三方面板配色的人——写死行内样式的部分只能靠 L3,脆且自负;把「仅索引」当成逐项验过的成品、需要生产级背书才敢上的人。
标签:皮肤中心、DeepSeek Harness、Web GUI 主题、CSS 契约
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。