跳到主内容

skin-center 使用指南

DSH 网页端的皮肤中心：在 GUI 设置页里即时试穿、一键应用皮肤，热载入无需重启。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-ui-web

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @captain1275/dsh-client-ui-skin-center

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 毛玻璃输入框：高斯模糊（backdrop-filter 30px）+ 半透明玻璃底 + 细边框 + 内高光
  • 自定义背景：URL / 本地图片 / 动图（GIF/WebP）/ 视频（mp4/webm） / 透明度 / 模糊调节，
  • 仿Claude Code推理等级滑块：点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、
  • 用户消息气泡毛玻璃：与输入框统一的玻璃质感
  • 图片资源（社区同人资源，codex-pet-DeepSeek-girl）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

一键应用皮肤后需要重启 DSH 吗？

不需要。点击"应用"或"恢复默认"后，host 端把目标皮肤写入 ~/.dsh/cordis.patch.yml 的 managed 段，DSH 自带的配置 watcher 在数秒内热载入新补丁，浏览器自动刷新页面即生效（src/routes.ts:263-279 / README.md:20-22）。

试穿会改动当前激活的皮肤吗？

不会。试穿仅在浏览器侧临时收回当前皮肤的 body 属性、背景内联样式和 chrome 子节点，"退出试穿"会原样还原；激活皮肤自身的 cordis 纤维全程不被触碰，状态完全保留（src/client/try-on.ts:300-363）。

皮肤还没构建 lib/client.js 时试穿会怎样？

试穿会报错并自动还原激活皮肤。host 路由 /api/skin-center/bundle/ 在目标 lib/client.js 不存在时返回 404，前端 catch 后调用 controller 的还原分支，绝不会留下半套皮肤（src/routes.ts:236-240 / src/client/try-on.ts:217-221）。

Windows 上能用吗？

可以。皮肤切换在 Windows 下用目录 junction（绝对路径）创建 profile node_modules 链接，不需要开发者模式或管理员权限；DSH 主目录优先读 $DSH_HOME，缺省 ~/.dsh，仓库路径由脚本自身位置推导，不依赖 $HOME 或固定路径（src/skin-switch.ts:453-464 / README.md:24-27）。

跨站请求会被拒绝吗？

会。host 路由对 Sec-Fetch-Site=cross-site 直接返回 403，Origin 与 Host 不匹配同样拒绝，仅同源 fetch 可调用 /api/skin-center/apply 与 /state，防止恶意网页通过 localhost CSRF 改写用户的皮肤配置（src/routes.ts:51-72）。

怎么添加一款新皮肤到列表里？

在 packages/skins// 放一份 skin.json（id 匹配 [a-z0-9-]+，package 与 wiring.id 必填），再为该皮肤构建 lib/client.js。registry 由脚本扫描 skin.json 自动生成，无需修改 skin-center 代码；刷新 host 或重建 generated/skins.ts 即可在卡片看到新条目（src/skin-switch.ts:146-189 / src/client/generated/skins.ts:39-58）。

背景遮挡滑块有什么用？

它控制主页背景的遮罩强度（0–100，默认 0），把数值写到 document.body 的 --dsw-skin-scrim CSS 变量上。仅对会画背景插画的皮肤（蓝色幻想 / 鲸吟）即时生效，官方默认无背景图时该滑块不产生视觉变化，但值仍会被持久化到下一次切到画背景的皮肤（src/client/background.ts:88-91 / src/client/SkinCenter.tsx:244-264）。

官方默认也能"试穿"吗？

可以。点击官方默认卡片上的"试穿"会触发同一套收回配方，临时撤掉当前皮肤的视觉写面，但不挂载任何皮肤，页面立即回到 DSH 官方原貌；点击"退出试穿"则恢复激活皮肤（src/client/try-on.ts:238-244 / src/client/SkinCenter.tsx:77-88）。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: ^0.1.0-rc.6（peerDependencies 全部声明 ^0.1.0-rc.6，package.json 无 engines）
  • Node: 未声明（package.json 无 engines；host 侧使用 node:fs / node:os / node:path，依赖仓库根 AGENTS.md 要求 Node ^22.19 || >=24）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

skin-center 使用指南