dsh-mobile-layout

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

0.9.1 起适配 dsh 0.1.5：文件浏览已由 0.1.5 内置能力（右侧边栏「文件」 标签 + 文档预览）接管，本插件不再自带文件浏览器。下载与上传能力保留， 以「下载到设备」/「上传」按钮挂接到内置文件面板上。0.9.7 起下载只保留 预览头一个入口（文件树行的下载按钮已移除）；0.9.8 修正下载路径来源 （改用预览根的 contentId，杜绝下载到错文件），目录行上传按钮改为只在 文件夹展开时出现并锚定到行元素；0.9.9 预览头新增「复制路径」按钮 （与下载同源）、下载请求的 sessionId 优先取 contentId 所属会话（跨会话 预览加固）。0.9.10 修正 Android 下载：0.9.9 曾让移动端走「导航式下载」， 被 Android 厂商下载管理器（XiaoMi/MIUI）接管后脱离页面上下文重发请求、 不带会话 Cookie → 401；现移动端与桌面统一走 XHR + blob（带会话 Cookie、有真实进度），文件名改从响应头 Content-Disposition 解析 （RFC5987 中文保真）。上传的工具栏入口不变：目录行上传到该目录、工具栏 上传到工作区 upload/。同时修复手机视口下内置面板在玻璃/半透明皮肤下的 透明问题。0.9.11 修正 Windows 路径：在此之前下载与 「上传到此目录」在 Windows 上一律 400（bad-path / bad-dir）—— 宿主与客户端都用 POSIX 判据 startsWith("/") 认定「绝对路径」，而 Windows 工作区根是 C:\...；同时拼路径恒用 / 会得到 C:\ws/sub/f.txt 这类混用分隔符的非法路径。现改用 node:path.isAbsolute()（POSIX / 盘符 / UNC 通吃）、按根的分隔符拼接，并在 win32 上按大小写折叠做包含性判定 （realpath 保留磁盘大小写，workspace 注册表里的路径大小写可能与磁盘 不一致）。macOS / Linux 行为不变。

功能一览

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

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

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

• 模式：无 / 玻璃 / 半透明，表面不透明度滑杆 0–100%
• 极光背景：四套预设——蓝紫 / 暖阳 / 青绿（浅色底）+ 单色·墨（深色底）， 彩色光斑缓慢漂移 + 电影颗粒质感
• 自定义背景：图片 URL 或手机相册选图
• 文字对比度自动适配：按背景明暗自动切换应用的深/浅文字主题，文字始终清晰
• 透明化：用户气泡、代码块、滚动条滑杆随表面同源半透明，文字保持不透明
• 0.1.5 右侧边栏覆盖：玻璃/半透明模式同样覆盖新右栏列（_rightbarCol）， 内置文件面板保持磨砂可读，不会透出底层内容

3. 内置文件面板「复制路径 / 下载到设备」挂接（预览头单入口）

• 0.1.5 内置的右侧边栏「文件」标签负责浏览，点击文件由内置文档预览打开； 本插件用 MutationObserver 给文档预览头（与自带 reload 工具并排，顺序 [wrap] [复制路径] [下载到设备] [reload]）注入两个工具按钮（data-dml-* 标记，样式与面板自带工具按钮一致）。0.9.7 起文件树行不再注入下载按钮， 下载只在预览头这一个出口。
• 复制路径（0.9.9 新增）：手机上长按选中路径文本很不方便，点这个按钮 即把当前预览文件的绝对路径写进剪贴板（navigator.clipboard.writeText， 非安全上下文/被拒绝时自动回退 textarea + execCommand('copy')），成功 短暂显示「已复制」。与下载按钮共用同一个路径解析结果，两者永不可能 指向不同文件；解析不出绝对路径时两个按钮都不显示。
• 下载走本插件保留的流式端点 GET /mobile-files/download，不受预览大小 上限影响，可下任意大小的二进制。0.9.10 起全端统一走 XHR + blob + <a download>（请求带会话 Cookie、按钮内有真实百分比进度、完成/失败 走状态机复位）。0.9.9 曾让移动端改走「导航式下载」，但 Android 厂商下载 管理器（XiaoMi/MIUI）会接管导航、脱离页面上下文重发请求且不带会话 Cookie → 服务端 401（nginx 日志实测）；故 0.9.10 移除该分支。文件名 取自响应头 Content-Disposition（RFC5987，非 ASCII 中文保真），经 getAllResponseHeaders() 大小写不敏感解析（规避厂商 WebView 对非标准 响应头的大小写敏感问题）。
• 路径来源（0.9.8 修正、0.9.9 加固）：优先取预览根元素的 data-textpreview-url（= 该预览 tab 的 contentId，形如 dsh-resource://file/session/<id>/<path> 或 file/absolute/<abs>，即 「预览正在读的那个文件」），经与内置 parseFileAddress 同款规则解出路径， 按工作区根化为绝对路径；其次才回退预览头 title 的绝对值（展示字符串， 异步推导，不可作首选）。0.9.8 起定不出绝对路径时直接移除按钮，绝不 留一个会下错文件的旧按钮。
• sessionId 归属（0.9.9 加固）：下载请求携带的 sessionId 优先取 contentId 里的所属会话（预览可能属于另一个会话，例如从聊天卡片打开）， 回退当前会话——Host 在服务端按该会话重新解析工作区根并拒绝越界路径， 会话失效只会得到可见报错，绝不会静默下错文件
• 上传能力保留：工具栏「上传」按钮维持原语义——进 <workspace>/upload （自动创建，不污染根目录）。0.9.8 起目录行上传按钮只在文件夹展开时 出现、并锚定到行元素（[class*='_row']，position:relative）而非整个 li——li 还包住展开的子树，旧写法让展开文件夹的按钮飘到子树中间 （已按几何坐标实测复现）。仍走本插件端点 POST /mobile-files/upload： 名字强制单段、dir 必须 realpath 落在工作区内、重名自动 (n) 不覆盖、 默认 500 MB 上限

4. 稳定性增强

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

安装

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

首次安装后重启一次 dsh web 进程（host 半的下载路由是冷路径；改 host 半 代码后同样需要重启）。client 半（布局/皮肤/下载按钮）随新页面热生效。

下载无需配置目录：根目录自动取当前会话所属的已注册工作区，无任何可选配置项。

Host 根据 sessionId 从服务端 Workspace 注册表解析 canonical path；浏览器传入的绝对路径只能位于该根内（含符号链接逃逸拒绝）。

作用范围

• 仅移动端（媒体查询门控）：阅读布局、输入框滚动收起、Session log 隐藏、 设置面板移动端布局
• 跨端功能（有意为之）：换肤、内置文件面板下载/上传挂接、abort 自愈
• 平台：POSIX 与 Windows 同等支持（0.9.11 起）。路径校验用 node:path.isAbsolute()，容器判定在 win32 上大小写折叠；C:\...、C:/... 与 UNC \\server\share 均可作为 path / dir 传入
• 皮肤关闭 / 卸载插件 = 完全还原 stock 外观

已知限制

• 会话轨迹（details）列在手机上无法打开（app shell 框架限制，CSS 无法干预）
• 下载/上传路由无内置认证——公网部署务必保持 nginx basic auth 等外部防护
• 0.8.x 的 /mobile-files/list|read 已从代码移除（/download 保留、 /upload 于 0.9.1 恢复）；已运行的 dsh web 进程在重启前仍会挂载旧版 四动作路由面（冷路径），属预期过渡态
• 老内核浏览器：无毛玻璃模糊（透明与背景仍生效，面板内有支持诊断）

开发与设计细节

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

License

MIT