dsh-mobile-layout

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

功能一览

1. 移动端阅读布局（/upload`；目录须在

roots 白名单内（服务端校验）

• 绝不覆盖：文件名强制单段（无路径穿越），同名自动追加 (1) 序号， 单个文件默认上限 500 MB（可配 uploadMaxBytes），失败自动清理半截文件
• 上传成功后文件页签自动刷新；成功显示落盘完整路径，8 秒自动收起

5. 稳定性增强

• 历史加载 abort 错误自动重试愈合（全端生效）

安装

dsh plugin --profile  add github:crwsr124/dsh-mobile-layout
# 或本地源码: dsh plugin --profile  add file:

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

文件浏览 / 上传默认关闭。在自己的 cordis.patch.yml 里覆盖 row config 开放 （不配 config 仅文件页签与上传按钮不可用，其余功能正常）：

- id: dsh-mobile-layout
  config:
    roots:
      - /你的/项目目录
      - /另一个/目录
    defaultPath: /你的/项目目录
    uploadDir: /你的/项目目录/workspace # 可选；无目录参数时的回退上传目录
    uploadMaxBytes: 524288000            # 可选；缺省 500 MB

上传目录固定由服务端决定：uploadDir 优先，未配置则自动创建 /upload（不会写进根目录），realpath 校验必须在 roots 白名单内。 反代部署注意：若经 nginx 等网关访问，上传大文件需在网关侧放开 client_max_body_size（nginx 默认仅 1 MB，超限返回 HTML 413 页）。

作用范围

• 仅移动端（媒体查询门控）：阅读布局、输入框滚动收起、Session log 隐藏、 设置面板移动端布局
• 跨端功能（有意为之）：换肤、文件页签、上传文件、abort 自愈
• 皮肤关闭 / 卸载插件 = 完全还原 stock 外观

已知限制

• 会话轨迹（details）列在手机上无法打开（app shell 框架限制，CSS 无法干预）
• 文件浏览按 defaultPath 静态配置，不感知当前会话 cwd
• 上传路由无内置认证——公网部署务必保持 nginx basic auth 等外部防护（与 文件浏览路由同一威胁模型）
• 老内核浏览器：无毛玻璃模糊（透明与背景仍生效，面板内有支持诊断）

开发与设计细节

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

License

MIT