dsh-mobile 使用指南
为 DSH WebUI 提供手机端适配:窄屏下三栏框架重排为左右两页的翻页器,侧边栏常驻露出半边聊天卡片。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-mobile
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add github:lehhair/dsh-mobile
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- PiUI 翻页器:≤768px 时三栏框架重排为两页横向 snap 轨道——侧边栏页半开宽(约半个视口),聊天页全宽;滑到侧边栏页时聊天卡片在右半露出(半边信息流),PiUI 同款结构
- 宽度自适应:560-768px 宽屏(横屏手机、大折叠屏、小平板)下侧边栏页从 360px 随视口涨到约半个视口(上限 420px),侧边栏壳冻结的桌面 280px 内容同步拉伸铺满页列——屏幕变宽,侧边栏内容跟着变大,不再留白
- 侧边栏始终完整渲染:窄屏下控制器自动展开 AppFrame 折叠的侧边栏并保持(滑动翻页不同步状态)——侧边栏列的内容在聊天全屏时也完整留在 DOM 里,滑回来立即可见,绝不"滑动才跟着渲染"
- 同色区分:侧边栏与信息流同色(平页,无圆角阴影);只有信息流是卡片(16px 圆角 + 阴影 + 细边框),PiUI 同款视觉
- PiUI 3D 翻页:滚动时聊天卡片
rotateY/scale跟随(transform-origin偏向滑动侧),prefers-reduced-motion关闭
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
这个插件会改动 DSH 的核心代码吗?
不会。所有改动都是纯客户端样式与 DOM 控制器,注入 <style data-plugin> 与受控的滚动/属性变更;卸载插件后界面逐字节还原。
安装后需要在网页上做什么配置吗?
不需要。插件没有配置项,安装即生效;视口宽度变化与虚拟键盘弹出由内置控制器自动处理。
在桌面浏览器上访问会改变原有布局吗?
不会。翻页器仅在 max-width: 768px 时启用,桌面三栏布局保持原样。
用 iPhone 自带的 Safari 还是微信内置浏览器打开都能用吗?
可以。只要浏览器支持 visualViewport(现代浏览器与 PWA 均支持)就能正确避开虚拟键盘;否则键盘内边距退化为 0。
横屏手机、大折叠屏、小平板会怎样?
560-768px 区间会启用宽屏模式,侧边栏页宽度随视口涨到约半个屏幕(上限 420px),内容会拉伸铺满整页。
卸载插件后界面会立刻恢复原样吗?
是的。样式以 <style data-plugin> 形式注入,卸载时被移除;控制器在 dispose 时还原 viewport meta、属性、CSS 变量,桌面端逐字节等同原生。
— 源: plugin_wiki.faq_json
兼容性
- DSH: >=0.0.1
- Node: 未声明
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则