dsh-mobile-layout

DeepSeek Harness Web UI 移动端体验套件：让 dsh web 在手机上好看、好用。 零依赖，装上即用；关闭皮肤即完全还原 stock 外观。

功能一览

1. 移动端阅读布局（<1024px 自动生效）

![banner](docs/banner-layout.gif?v=1)

侧栏抽屉化：无常驻窄栏，会话区占满全宽；顶栏左上角鲸鱼按钮开合会话抽屉
字体密度：正文 / 标题 / 代码适度收缩，一屏容纳更多内容
表格：自然宽度 + 横向触摸滚动；长词、链接自动换行不再溢出
输入框：上滑阅读、切换已有会话或刷新恢复已有会话时默认收起（不会唤起手机输入法），点击消息文字即可显示并聚焦；空白新会话保持可见，桌面端不受影响
设置面板：导航横排适配手机宽度；模型编辑等长表单在内容区独立触摸滚动，底部操作不会被截断

2. 换肤（侧边栏「主题与背景」按钮）

![banner](docs/banner-skin.gif?v=1)

模式：无 / 玻璃 / 半透明，表面不透明度滑杆 0–100%
极光背景：四套预设——蓝紫 / 暖阳 / 青绿（浅色底）+ 单色·墨（深色底），

彩色光斑缓慢漂移 + 电影颗粒质感

自定义背景：图片 URL 或手机相册选图
文字对比度自动适配：按背景明暗自动切换应用的深/浅文字主题，文字始终清晰
透明化：用户气泡、代码块、滚动条滑杆随表面同源半透明，文字保持不透明

3. 文件浏览器（「文件」页签，与对话/轨迹并列）

![banner](docs/banner-files.gif?v=1)

文件根目录自动跟随当前会话所属工作区；同一工作区切换会话会保留当前目录、列表缓存和滚动位置（不刷新），只有切换到不同工作区才取消旧请求并从新根加载
在工作区内浏览：面包屑导航、手动刷新、md / 代码 / 图片 / PDF 预览、「新标签页打开」和「下载到设备」
下载走独立流式端点，不受 2 MB / 40 MB 预览大小上限影响
客户端只传 sessionId；Host 从服务端 Workspace 注册表解析可信根目录，跨工作区路径与符号链接逃逸均拒绝
对话页保持原生滚动；文件页签使用独立列表滚动，切换页签不会锁死或复用对话滚动位置

4. 上传文件（侧边栏「上传文件」按钮）

侧边栏底部动作区新增「上传文件」按钮（回形针图标，与主题按钮同款式），

点击选文件（支持多选），逐个上传，状态卡实时显示进度与结果

上传到当前工作区专用目录：Host 根据发起时的 sessionId 解析工作区，自动创建并写入 <workspace>/upload，不污染工作区根目录
绝不覆盖：文件名强制单段（无路径穿越），同名自动追加 (1) 序号，

单个文件默认上限 500 MB（可配 uploadMaxBytes），失败自动清理半截文件

上传成功后文件页签自动刷新；成功显示落盘完整路径，8 秒自动收起

5. 稳定性增强

历史加载 abort 错误自动重试愈合（全端生效）
移动端从阅读态新建空白会话时强制恢复输入区，避免 body 级收起状态跨会话残留而只剩背景

安装

dsh plugin --profile <name> add github:crwsr124/dsh-mobile-layout
# 或本地源码: dsh plugin --profile <name> add file:<本目录绝对路径>

首次安装后重启一次 dsh web 进程（host 半的文件路由是冷路径；改 host 半代码后同样需要重启）。

文件浏览和上传无需配置目录：根目录自动取当前会话所属的已注册工作区。只有上传大小上限是可选配置：

- id: dsh-mobile-layout
  config:
    uploadMaxBytes: 524288000 # 可选；缺省 500 MB

> Host 根据 sessionId 从服务端 Workspace 注册表解析 canonical path；浏览器传入的绝对路径只能位于该根内。上传固定进入 <workspace>/upload。 > 反代部署注意：若经 nginx 等网关访问，上传大文件需在网关侧放开 > client_max_body_size（nginx 默认仅 1 MB，超限返回 HTML 413 页）。

作用范围

仅移动端（媒体查询门控）：阅读布局、输入框滚动收起、Session log 隐藏、

设置面板移动端布局

跨端功能（有意为之）：换肤、文件页签、上传文件、abort 自愈
皮肤关闭 / 卸载插件 = 完全还原 stock 外观

已知限制

会话轨迹（details）列在手机上无法打开（app shell 框架限制，CSS 无法干预）
上传路由无内置认证——公网部署务必保持 nginx basic auth 等外部防护（与

文件浏览路由同一威胁模型）

老内核浏览器：无毛玻璃模糊（透明与背景仍生效，面板内有支持诊断）

开发与设计细节

实现原理、兼容性处理、选择器约定与版本历史见 [docs/DESIGN.md](docs/DESIGN.md)。

License

MIT

来源信息

安装

检查来源文件