This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-web-mobile

— source: plugin_wiki.wiki_content

Install & verify

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

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

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

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Does this plugin only work on mobile?

Yes. The entire set of styles, MutationObserver, and drawer/overlay only installs and runs when viewport ≤1023px; when viewport ≥1024px, all mobile controls are hidden and side effects are unloaded, making it exactly the same as if it wasn't installed.

Does it need additional configuration after installation?

No. The plugin itself has no Schema/configuration options; the only switch is adding ?mobile-nav-debug=1 to the address bar, which displays a diagnostic overlay showing viewport, breakpoints, frame markers, overlay state, and the last 5 JS errors - used only for troubleshooting.

Where do I open File Browser and Session Log?

During an active session, two new circular icon buttons appear next to the session title: "File Browser" and "Open Directory"; on the home page/blank page without a session header, floating buttons appear in the top-left corner. When the drawer opens, two capsule buttons appear at the bottom: "File Browser" and "Export Session Log" - the session log button is automatically disabled when there is no current session.

How to fullscreen the preview overlay?

There is a new fullscreen button on the right side of the preview overlay title bar in dsh-web-ui (the icon toggles based on current state). Pressing it fills the overlay with the entire viewport (including safe area), and pressing again restores it.

Will the plugin affect desktop users?

No. The source code sets all [data-mobile-nav=...] controls to display:none !important in media queries for >=1024px, and registers all effects only under (max-width: 1023px). No DOM is written and no observers are created on desktop.

Does it conflict with plugins like dshmarket, dsh-usage-stats, dsh-genui?

README states they are "compatible plugins" rather than conflicting plugins: 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. The plugin reserves order:5 at the bottom of the drawer, placing these two capsule buttons between the dshmarket icon row and dsh-usage-stats quota badge to avoid visual overlap.

— source: plugin_wiki.faq_json

Compatibility

• 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）

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule