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

快速上手

dsh-web-mobile

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-web-mobile

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

— 源: plugins.install

关键要点

• 状态栏适配:保留系统状态栏,viewport-fit=cover + env(safe-area-inset-top) 避让刘海,theme-color 跟随深/浅主题,禁用双击缩放;
• 会话全宽 + 抽屉导航:网格改 1fr 0 0,侧栏变 overlay 抽屉;点会话行切换并收起抽屉,行内按钮(三点菜单)不收起;
• 会话头部重排:目录按钮 / 会话名称 / 模式徽标按移动端排列,Session log 移到抽屉底部;
• 设置界面适配:官方双栏弹窗改近全宽 sheet——分类标签单行横向滚动,顶部工具栏并入标签行,手机上隐藏「打开配置文件」;
• 文件树 / 预览浮层:Explorer 与 Preview 变圆角底部浮层(滑入动画),文件行一步打开预览,浮层可一键全屏并自动还原;

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件只在手机上生效吗？

是的。整套样式、MutationObserver 和抽屉/浮层只在视口 ≤1023px 时安装并运行；视口 ≥1024px 时所有移动控件被隐藏、副作用被卸载，与未安装时完全一致。

安装之后还需要额外配置吗？

不需要。插件本身没有任何 Schema / 配置项；唯一的开关是地址栏加 ?mobile-nav-debug=1，会显示视口、断点、帧标记、浮层状态和最近 5 条 JS 错误的诊断浮条，仅用于排查。

文件浏览和会话日志在哪儿打开？

会话进行时，会话标题旁新增「文件浏览」「打开目录」两个圆形图标按钮；首页/空白页没有会话头，浮动按钮出现在左上角。抽屉打开后底部会多出「文件浏览」「导出会话日志」两个胶囊按钮，会话日志按钮在没有当前会话时自动禁用。

预览浮层怎么全屏？

在 dsh-web-ui 的预览浮层标题栏右侧有一个新增的全屏按钮（图标会跟随当前状态切换），按下后浮层填满整个视口（含安全区），再次按下恢复。

桌面端会不会被这个插件影响？

不会。源码在 >=1024px 的媒体查询里把全部 [data-mobile-nav=...] 控件设为 display:none !important，并把所有 effect 限定在 (max-width: 1023px) 下注册，桌面端不写任何 DOM、不创建观察者。

和 dshmarket、dsh-usage-stats、dsh-genui 这些插件有冲突吗？

README 声明它们是「兼容插件」而非冲突插件：dshmarket 1.2.2、dsh-usage-stats 0.1.2、@omdsh-dev/dsh-genui 0.8.3、@linxin666/dsh-web-ui-all 0.1.14。该插件会在抽屉底部留出 order:5，把这两个胶囊按钮放在 dshmarket 图标行与 dsh-usage-stats 配额徽章之间，避免视觉穿插。

— 源: plugin_wiki.faq_json

兼容性

• DSH: @deepseek-ai/dsh-client-* 系列 ^0.1.0-rc.6（peerDependencies）；@deepseek-ai/cordis ^4.0.1；cordis.patch.yml 注册的 plugin id 为 dsh-mobile-nav
• Node: 未声明（package.json 未设置 engines）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则