deepseekplugins

DeepSeek Harness plugin

dsh-mobile-adaptive

dsh web 移动端适配插件：侧边栏抽屉 + 设置页单列布局（P1）；宿主目录浏览移动端化 + 本地上传到工作区 ./上传/（P2）。

UI Enhancements
Jump to install

Source facts

Repository
zzh799/dsh-mobile-adaptive
Latest update
Aug 16, 2026
Category
UI Enhancements
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/zzh799/dsh-mobile-adaptive
Plugin: dsh-mobile-adaptive
Author: zzh799

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-mobile-adaptive

dsh web 的移动端适配插件。以 dsh 客户端插件形式挂载，纯 CSS/JS 注入，不改 dsh 业务逻辑；桌面（>=1024px）零改动。

  • P1 侧边栏折叠 · 设置页单列
  • P2 目录浏览移动端化 · 本地上传 · 顶部工具条

功能一览

功能说明
侧边栏折叠<1024px 侧栏隐藏为覆盖式抽屉；注入汉堡按钮 + 点遮罩/菜单项/Escape 关闭
设置页单列<1024px 设置面板全屏化 + 两层导航（分区列表 → 具体设置项，带返回）；控件拉满宽度、触控 ≥44px
目录浏览移动端化仅对 dsh 已有的目录树（browse）对话框做样式适配：窄屏全屏 + Miller 双栏收敛为单栏 + 行高 ≥44px。是否开启 browse 由 profile 配置决定，插件不改业务
本地上传输入框附件按钮 + 进度面板；批量上传、逐文件进度、落盘 <当前会话工作区>/上传/、重名自动改名、失败可重试
顶部工具条≤1023px：权限/模型选择从输入栏上移到会话头部，原头部条目收进 + 号弹出面板；桌面端全部还原

目录结构

src/client.tsx     浏览器半边：抽屉交互、上传按钮 + 进度面板、store
src/mobile.css     全部移动端结构样式（锚定 data-slot / 属性选择器）
src/index.ts       宿主半边：挂载 /dsh-mobile-adaptive 上传通道
src/upload-host.ts 上传后端：分片落盘、改名、护栏、清扫
build.mjs          esbuild 构建（closure-factory 工件），--watch 热更

挂载

本包同时声明 组合包（dsh.bundle，见根目录 cordis.patch.yml）与 客户端插件（dsh.client）。用标准流程安装并自动激活宿主 + 浏览器两半边，无需手改 profile：

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

本地开发链接本机仓库（改动即生效）：

dsh plugin --profile web add link:<本机仓库绝对路径>

安装后重启 dsh web 使新插件生效（先停止已在运行的 dsh web，再重新启动）：

dsh web

> 从 git 安装（dsh plugin --profile web add github:zzh799/dsh-mobile-adaptive）时，prepare 脚本会在安装后构建 lib/；pnpm ≥10 默认拦截构建，需把 pnpm 提示的包键加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 再重试。

日常使用

cd <本机仓库路径>
node build.mjs          # 一次性构建
node build.mjs --watch  # 开发：浏览器半边热更

注意：浏览器半边（lib/client.js）热更；宿主半边（lib/index.js，上传通道）改动需重启 dsh web。

目录选择固定为 browse（应用内目录树）

原因：dsh 由 launchd 托管、绑定 127.0.0.1，远程访问走组网 + NGINX 转发。directory-picker-auto boot 采样只见「回环 + darwin」，误判成桌面场景而挂载 native（Finder 选择器）。手机上点"打开工作区/目录选择"会在无人值守的 Mac 上弹 Finder，浏览器侧无 UI、功能不可用。故显式固定为 browse（应用内目录树）。

方法（配置在 ~/.dsh/profiles/web/cordis.patch.yml，profile 补丁层，非插件代码）：

# 关掉 auto 判定（否则仍动态挂载 native），静态装配 browse 那一对。
- id: directory-picker
  disabled: true

- insert:
    - id: directory-picker-browse
      name: '@deepseek-ai/dsh-host-directory-picker-browse'
    - id: directory-picker-browse-surface
      name: '@deepseek-ai/dsh-client-ui-directory-picker-browse'

要点：

  • 两个 browse 包（host 后端 + client 界面）在 web-app bundle 已声明依赖，插到补丁列表即可。
  • 生效需重启 dsh web。
  • 回退默认行为（重新启用 auto）只需删掉这段并重启——会回到"远程弹 Finder、手机无 UI"的原问题。

上传传输设计

  • 客户端按 1 MiB 切片 base64 走通用 RPC 通道 /dsh-mobile-adaptive（upload/begin|append|commit|abort），复用宿主连接传输层的信任围栏，不新增 HTTP 面。
  • 宿主只写 <cwd>/上传/：cwd 必须是已存在的绝对路径目录；文件名清洗为单路径段（剥分隔符/控制字符、240 字节截断），无法逃逸暂存目录。
  • 重名改名用 no-clobber link()（EEXIST 换 (1) (2) … 至 999），无 TOCTOU 窗口，并发同名不互相覆盖。
  • commit 校验 received === expected，不完整会话拒绝落盘；.part 临时文件 1 小时清扫、卸载时清除。

已确认的边界

  • 目录浏览当前固定为 browse（见上节）。
  • <1024px 详情列轨道归零；≤767px 隐藏 ContextMeter（给输入工具行让位）。
  • 100dvh 需 iOS 15.4+；旧版回退 100vh。
  • 上传面板文案为中文；文件上限 2 GiB；空文件拒绝。

验收对照

  • 手机/平板：主界面、侧边栏、设置页、目录选择、上传均可用 ✓；无横向滚动、触控 ≥44px ✓
  • 目录浏览可经目录树选定宿主机路径（browse + 手机单栏化）✓
  • 上传：入口、批量、进度、落盘 ./上传/、重名自动改名 ✓
  • 桌面（>=1024px）：除附件按钮移至 + 命令按钮右侧外，与改动前一致，无回归 ✓
Back to searchOpen GitHub repository

More related plugins

View category