安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 简单
- 适合新手
- 可以尝试
- 兼容状态
- 声明兼容,尚未实测
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
为 DSH Web 提供面向手机和平板的响应式交互层,包括抽屉式导航、全屏对话框、可拖动悬浮入口、历史消息加载和窄屏操作优化。
需要DSH 界面、主题、侧边栏能力的用户。
安装前准备
- 已有访问入口(必需):手机先能通过受控网络访问原版 DSH Web;插件只解决布局。
如何安装 dsh-mobile-hanui
本页命令固定使用 DSH 0.1.1-rc.2,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
webProfile- DSH 基线
0.1.1-rc.2- 安装来源
- GitHub 源码(锁定提交)
- 固定目标
github:Z-6354/dsh-mobile-hanui#27f11e7b7925
既有插件教程与安装命令的固定 CLI 基线,独立于 npm 默认分发;不代表每个插件已在该版本或新版本运行验证。更新前须逐项审核配置证据。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到 Web Profile
这条命令会把插件加入
webProfile,并在插件声明 DSH Bundle 时自动加入配置层。GitHub 源码(锁定提交)npx --yes @deepseek-ai/[email protected] plugin --profile web add github:Z-6354/dsh-mobile-hanui#27f11e7b7925 - 03如遇构建脚本拦截
GitHub 源码插件可能通过
prepare构建。pnpm 10 及以上会先阻止未授权构建;只把终端明确提示的包名加入该 Profile 的pnpm-workspace.yaml中allowBuilds,审阅脚本后再重复上一步,不要使用全局放行。 - 04确认 Bundle 已进入配置
安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 dsh-mobile-hanui或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/[email protected] --profile web --dump-config - 05启动并完成最小验证
启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Webnpx --yes @deepseek-ai/[email protected] web
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-mobile-hanui插件专属配置
web Profile- 仅安装一款移动布局插件,避免重复注入。
恢复自动适配 · javascript。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
localStorage.removeItem("dsh-mobile-shell");
location.reload();- 安装固定版本后重启 DSH Web,在手机刷新已有访问地址。
- 保持页面查询中没有 mobileShell=0,再检查浏览器本地开关。
配置检查与成功结果
- 01在手机或窄窗口中打开原版会话,按下方回归表检查抽屉、输入和权限确认。
期望结果:界面可操作;记录环境,不把桌面窄窗口通过当作真机通过。
- 02用 mobileShell=0 刷新当前页面并比较。
期望结果:恢复原版界面;网络访问和 DSH 权限没有因此消失。
第一次使用建议这样验证
- 只打开一个可丢弃会话,展开导航与设置,核对返回聊天区的路径。
它可能接触哪些数据和能力
仅在浏览器页面中调整 DOM、样式和交互状态,使用 localStorage 保存插件开关与悬浮按钮位置;Host 入口为空,不注册模型工具、网络接口、文件写入或命令执行能力
数据存储:同一 DSH 网页 origin 的 localStorage 保存 dsh-mobile-shell 开关与 dsh-mobile-fab-pos 悬浮位置;Host 入口为空。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- 停用后还是没有自动恢复布局
- 检查地址中的 mobileShell=0 和本地 dsh-mobile-shell=0,两者任一存在都会关闭适配。
- 手机无法连接电脑
- 先检查 DSH 进程和已有网络入口;HanUI 不提供代理或隧道。
- 用 mobileShell=0 临时关闭并刷新;这只关闭布局,不关闭远程访问。
- 停止 DSH,从同一 web Profile 运行上方 remove 命令,再重启和硬刷新,核对 Bundle 消失。
- 如需清理偏好,仅移除该 origin 下的 dsh-mobile-shell 与 dsh-mobile-fab-pos,不清空整个 localStorage;查询参数也应移除。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
插件版本 0.2.5、MIT,未声明 Node.js 或 DSH peer 版本,通过 Cordis Patch 注入 DSH Web 客户端运行时与布局服务;本站完成固定提交静态审阅,未在当前 0.1.1-rc.2、iOS Safari、Android Chrome、横屏、软键盘或辅助功能下做真实设备回归
数据流
当前 DSH Web 页面结构与用户点击/拖动 → 浏览器内响应式布局和交互处理 → localStorage 中的少量界面偏好;没有发现提示词、会话、凭据或文件向外部服务发送。
源码审阅结论
已审阅固定提交的 Cordis Patch、Host 空入口和完整客户端实现。插件不使用 fetch、不注入远程脚本,也不读取模型内容或 Host 数据;主要风险是它依赖 DSH 当前 DOM 结构和 CSS 类名,升级后可能出现按钮重复、抽屉错位或触摸冲突。上线前在常见手机宽度、横竖屏、深浅色、软键盘和滚动历史场景做视觉回归,并在 DSH 大版本更新后重新验证选择器。 2026-09-07 定向复核窄屏阈值、开关、浏览器存储与卸载恢复;固定版本保持 0.2.5,手机 UI 适配不提供网络连通或额外认证。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
08f3df46cca1- 固定提交
27f11e7b7925- 许可证
- MIT
- 主要语言
- JavaScript
- 中文资料
- 有完整中文配置资料