把这个插件装到你的 DSH 上

开始之前

三条自查，都不满足的话先补齐再装。

方案 A：直接从 GitHub 安装（推荐）

不需要发布到 npm，也不需要手动拷文件。已实测走通。

dsh plugin --profile web add github:68110923/dsh-plugin-mobile-ux

systemctl restart dsh-web   # 或用你自己托管 dsh web 的方式

方案 B：从 npm 安装（暂不可用）

本包尚未发布到 npm。下面是发布后会变成的样子，以及目前卡在哪里。

dsh plugin --profile web add @yourscope/dsh-plugin-mobile-ux
systemctl restart dsh-web

方案 C：本地目录 / 离线安装

不想依赖 GitHub，或者机器不能出网时用这个。

git clone https://github.com/68110923/dsh-plugin-mobile-ux /opt/dsh-plugin-mobile-ux
# 或从本地机器上传：
scp -r ./dsh-plugin-mobile-ux root@SERVER_IP:/opt/

dsh plugin --profile web add /opt/dsh-plugin-mobile-ux
systemctl restart dsh-web

装完怎么确认成功了

三层验证：装上了、服务认了、浏览器真的跑了。

1. 第一层：包在 profile 里
   服务器cat

   # 应该看到插件出现在 dependencies 与 bundles 里
   cat ~/.dsh/profiles/web/package.json

2. 第二层：服务能解析它（这一步最容易被忽略）
   服务器verify

   # 组装配置里应出现插件的行；出现 skipping profile bundle 就是没解析到
   dsh --profile web --dump-config | grep -A2 dsh-plugin-mobile-ux
   journalctl -u dsh-web --since "-5 min" | grep -c "skipping profile bundle"   # 期望 0

3. 第三层：浏览器控制台里摸得到它 在装了插件的页面里打开控制台（手机可用 Safari 的「检查」或地址栏 javascript: 前缀），执行：
   浏览器控制台console

   typeof window.__dshMobileUx   # object 表示插件已执行
   window.__dshMobileUx.metrics()   # 打印可视视口、外壳高度等实时数据
   # 加载前覆盖某一节（与上面的读数 API 是两个属性，互不覆盖）：
   window.__dshMobileUxOptions = { keyboard: false }

4. 肉眼验收（手机上最直观）
   • 侧边栏浮在对话之上并带遮罩，点空白处收起
   • 输入框底部按钮保持一行；设置面板全屏纵向
   • 点输入框页面不放大；打字与回撤时输入框不掉到键盘后面
   • 点一个未选中的会话：单击即切换，且抽屉自动收起

不想全要？按需开关

装完就能用；下面是常用的两个开关，完整清单见首页。

卸载与升级

完全可逆：插件只注入样式、挂监听器和几个内联样式，卸载时逐一还原。

dsh plugin --profile web remove dsh-plugin-mobile-ux
systemctl restart dsh-web

dsh plugin --profile web update dsh-plugin-mobile-ux
systemctl restart dsh-web

安装期排错

按报错原文找就行。