跳到主内容

dsh-skins 使用指南

一个 npm 包内置 9 款 DSH Web 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-skins

复制以上命令在 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 Web 界面里看到什么？

在「设置 → 插件配置 → Web UI 插件」组里多出一张「皮肤中心」卡片，列出「官方默认」加上当前安装的所有内置皮肤（同花顺 ths、Windows XP luna、蓝色幻想 blue-fantasy、龙的传人 dragon-heir、Minecraft minecraft、初音未来 miku、交易终端 trading、鲸吟 whale-song、极光 aurora），当前激活的皮肤带 Active 标记（packages/skins/skin-center/README.md:1-12）。

切换皮肤需要重启 dsh web 服务吗？

不需要。点击「Apply / 恢复默认」后皮肤中心会写 patch 文件，宿主配置监听器在数秒内热加载，浏览器刷新即可看到新皮肤，全程无需重启（packages/skins/skin-center/README.md:20-27、packages/skins/skin-center/src/routes.ts:254-280）。

能不能同时启用两款皮肤？

不能。皮肤启用是互斥的，皮肤中心通过 ~/.dsh/cordis.patch.yml 的 dsh-skin managed 区段强制只有一个激活（packages/dsh-skins/package.json:3、packages/skins/skin-center/src/skin-switch.ts:89-90）。

"在线试穿"（Try on）会不会修改我的当前设置？

不会。试穿只在当前页面临时挂载该皮肤的视觉，退出时按配方完整还原当前皮肤的 body 属性、背景内联样式、chrome 子节点、xp footer taskbar 等，不会写入任何文件（packages/skins/skin-center/README.md:127-134）。

装完之后皮肤列表是空的，或者少了几款怎么办？

检查聚合包是否已经跑过构建：packages/dsh-skins/skins/<id> 目录必须同时存在 skin.json、lib/client.js、lib/index.js、cordis.patch.yml，缺一会被 build.mjs 跳过；正常 npm 安装会自动完成构建（packages/dsh-skins/build.mjs:78-119）。

Windows 上切换时报"权限不足"怎么办？

切换逻辑在符号链接失败时会自动回退到目录联结（junction），不需要开发者模式；如果仍失败请以管理员身份运行 dsh，或手动把皮肤包放进 profile 的 node_modules（packages/skins/skin-center/src/skin-switch.ts:433、487-502）。

怎么加一款自己的皮肤？

在 packages/skins/<your-id>/ 下放 skin.json（含 id、name、tagline、bodyAttr、wiring.id、package 字段）+ 构建后的 lib/client.js / lib/index.js / cordis.patch.yml，然后跑 pnpm --filter @captain1275/dsh-skins build 重新打包，重装聚合包即可在皮肤中心看到（packages/dsh-skins/build.mjs:55-119、README.md:130-133）。

怎么卸掉某款皮肤换回官方默认？

皮肤中心卡片里有「官方默认」入口，点击即可一键应用；想完全卸载插件则用 dsh plugin --profile web remove @captain1275/dsh-skins（packages/skins/skin-center/src/routes.ts:262-280）。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: 未声明（仓库根与本包 package.json 均未声明 engines，皮肤中心 devDependencies 隐含 Node ≥18 即可）
  • Platforms: Web, macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则

dsh-skins 使用指南