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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则