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

快速上手

dsh-web-ui

— 源: plugin_wiki.wiki_content

安装与验证

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

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

— 源: plugins.install

关键要点

• Web 终端：xterm.js 远程终端，实时输出，窗口大小自适应；
• 文件传输：SFTP 上传 / 下载，有进度条，能浏览远程目录；
• 端口转发：本地隧道直连远程内网服务（数据库、API、管理后台），只监听 127.0.0.1；
• 集群执行：一条命令并发跑多台主机，按别名 / 环境 / 标签过滤；
• Agent 直连：Agent 和面板共用同一份主机配置，对话里说一句「连一下 xxx 看看状态」，智能体就去执行远程命令。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完为什么设置里看不到皮肤中心？

皮肤中心以 settings.section 一级页形式挂在「设置」里（src/client/index.ts:159-166），需要刷新页面并打开「设置」才能看到「皮肤中心」入口。卡片默认开启，没有总开关前可以正常列出皮肤。

切换皮肤需要重启 DSH 吗？

不需要。皮肤切换完全在浏览器侧完成（src/client/runtime/skin-controller.ts:7-15），不刷新页面、不重写 cordis.patch.yml、不重建启动图。首屏由 tapIndex 适配器预先盖好属性，刷新后直接以当前皮肤启动，没有官方原貌闪屏。

用户自己做的皮肤怎么放进去？

只要把符合 v2 契约（contracts/README.md）的目录丢进 $DSH_HOME/skins//（DSH_SKINS_HOME 环境变量可改根目录，src/skin-repo.ts:64-68），重开卡片或刷新页面就会出现在列表里。同 id 会遮蔽内置皮肤；skin.json 校验失败会被 fail-closed 排除，并在目录诊断里说明。

试穿和应用有什么区别？

两者走同一个原子切换引擎（src/client/runtime/skin-controller.ts），区别只在是否落盘：试穿不持久化，「退出试穿」回到上次应用的状态；应用会调用 POST /api/skin-center/v2/active 把选择写到 $DSH_HOME/skin-center-active.json。

macOS / Linux 上能用 Wallpaper Engine 吗？

Wallpaper Engine 自动发现只支持 Windows（src/we-library.ts:145 通过注册表读 SteamPath）；macOS 和 Linux 可在卡片「手动文件夹」行里添加任意 .mp4/.webm 文件夹、单项目目录或项目合集目录，~ 会展开为主目录。

自定义皮肤的 hooks.mjs 有什么风险？

hooks.mjs 是受信代码逃逸舱（contracts/README.md:38-39），与本仓库同审同发，仅同源 serve。它拥有页面 DOM 和样式能力，其导入或执行错误被 try/catch 隔离，但不会拖垮静态皮肤。

怎么临时关掉皮肤中心？

卡片自带总开关（src/index.ts:54-87 的 enabled 字段），关闭后会停用试穿、应用、背景控制，持久化在 skin-background 命名空间；壁纸部分另有独立的总开关在 skin-wallpaper 命名空间。

自定义皮肤会被上传或外发吗？

不会。皮肤目录只在本地被 skin-center 加载并通过 /api/skin-center/* 同源路由服务（README.md:38-39 安全模型节）。壁纸导入仅复制到本机 harness-home 目录，从不上传或再分发，创意工坊内容归原作者所有。

— 源: plugin_wiki.faq_json

兼容性

• DSH: ^0.1.0-rc.8（@deepseek-ai/dsh-* peerDependencies 声明，package.json 未声明 engines）
• Node: 未声明（package.json 无 engines；源文件使用 node:fs / node:os / node:child_process，根 AGENTS.md 要求 Node ^22.19 || >=24）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则