miku 使用指南

为 DSH Web GUI 提供初音未来主题皮肤：蓝紫洋红渐变 + 毛玻璃面板 + 可换背景图 + 亮暗双主题，纯呈现层可热插拔。

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

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

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add --allow-build=@linxin666/dsh-client-ui-skin-miku github:ningbainb/deepseek-harness-desktop#path:packages/skins/miku

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

— 源: plugins.install

可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个皮肤安装了之后会自动启用吗？

安装后不会自动激活，需要通过 dsh-skin use miku 切换；皮肤之间是互斥的，可随时 dsh-skin use official 回到官方默认。

切到这个皮肤后能撤回吗？会留下多余的 DOM 元素吗？

不会。apply() 通过 ctx.effect 注册 disposer，body 属性、注入的标题栏/状态栏、favicon、document.title 都会在 dispose 时精确还原。

能不能换成自己的初音图片当背景？

可以。把图片放到仓库下（例如 bg.png），执行 node scripts/embed-bg.mjs 转成 WebP 并写入 src/client/art.ts 的 MIKU_ART 常量，重新构建后刷新页面即可。

这个皮肤会影响模型调用、数据存储或事件流程吗？

不影响。它是纯表现层：不注入 cordis 服务、不发事件、不触模型请求，只改 DOM 与 CSS。

暗色模式下背景图会被压暗吗？

不会被压暗。皮肤通过 MutationObserver 监听 data-ds-dark-theme 属性，切换暗色时只换一层很薄的蓝色薄纱，让画面保持鲜艳的同时保证文字可读。

是否需要修改 DSH 源码？

不需要。皮肤通过 cordis bundle patch 以独立插件包形式挂载，DSH 源码不做任何修改。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则