跳到主内容

miku 使用指南

为 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-client-ui-skin-miku

复制以上命令在 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-skin use official,config watcher 会在几秒内热重载,刷新页面即可恢复原貌。

我想换一张自己喜欢的初音图作为背景,怎么做?

把图片放到本仓库根目录(如 bg.png),用 node scripts/embed-bg.mjs 转成 WebP 后会自动写入 src/client/art.ts 的 MIKU_ART 常量;之后重新 pnpm build 并刷新页面生效。

这个皮肤会和别的皮肤同时生效吗?

不会。皮肤之间是互斥的,由仓库内的 scripts/dsh-skin 统一管理,同时只会有一个皮肤处于激活状态。

卸载后页面元素会留下残留吗?

不会。apply() 通过 Cordis effect disposer 完整回收自己写入的内容,包括 body 上的 data-dsh-miku 属性、注入的标题栏、状态栏、favicon 以及文档标题。

安装路径里有空格(Windows)会出问题吗?

会。dsh plugin add 在路径含空格时会拆断参数,建议改用 cd ~/.dsh/profiles/web && pnpm add "link:<仓库绝对路径>",再把包名追加到 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组中。

安装后页面没看到变化怎么办?

重启 dsh web 服务并对页面做一次硬刷新(Ctrl+Shift+R),如果仍未生效,检查 ~/.dsh/cordis.patch.yml 的 managed 区段确认本皮肤已启用。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明
  • Node: >=20.0.0
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源:通用规则