跳到主内容

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

踩坑提醒

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

— 来源:通用规则