DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-web-mobile-pmsfh

d

dsh-web-mobile-pmsfh

Manifest valid

A standalone mobile page for DeepSeek Harness with conversations, attachments, approvals and workspace file browsing. Desktop UI untouched. It is served from the Host's web server under its own route

UI (client)hasBundlePatch

dsh-web-mobile-pmsfh

简体中文 | English

DeepSeek Harness 的移动端页面插件:移动设备打开主站自动进入,会话、对话、 附件、审批都在这个为窄屏设计的独立界面里完成;不动桌面端界面,也不改主仓库代码。

它在 /dsh-web-mobile-pmsfh/ 路径下挂一套独立的移动页,直接调 DSH 自己的接口,不加载官方前端,也不改官方代码。

License topic npm dsh

功能概览

  • 会话:按工作区分组折叠,另有「未分组」;新建、重命名、删除工作区(删除只从列表移除,目录与会话记录保留,会话转入「未分组」);长按归档会话;新建会话时经内联目录浏览器选工作区,并选权限档位(仅可查看 / 工作区内修改 / 完全权限,完全权限启用前需确认风险)
  • 对话:流式输出、思考过程折叠、上下文压缩提示;markdown 与代码块渲染,生成中可停止,后续消息排队可见,上翻按页加载更早消息,贴底跟随与一键回到底部
  • 附件:移动设备上选文件,先上传拿到凭证再随下一条消息发送,走官方对话附件通道;单文件上限 8 MB,发送前可移除,不落工作区
  • 审批:越界操作弹出审批卡,可选允许一次、拒绝、稍后,也可自行输入后提交
  • 模型:会话内切换模型与推理等级
  • 文件:工作区文件列表与下载,只读
  • 界面:中英双语跟随浏览器,深浅色跟随系统;软键盘弹出时输入框骑在键盘上方;列表底部「进入桌面版」只对本次浏览生效,切换后右下角出现「📱」浮标可返回移动版;沿用 DSH 登录状态,过期有引导,可退出登录

快速开始

环境要求:DSH 0.2.2-rc.1(见「兼容性」)、Node.js ≥ 24;dsh plugin 需要 pnpm,经 corepack 启用或全局安装:

corepack enable

或

npm i -g pnpm

装好后,两种方式选一种安装;安装完成后重启 DSH 服务,重启命令按实际部署方式调整。

方式一:从 npm 安装

适合直接使用,能收到新版本的更新提示:

dsh plugin --profile web add dsh-web-mobile-pmsfh

方式二:从源码安装

适合自行修改;克隆目录需保留,更新时在目录内拉取:

git clone https://github.com/renlang119/dsh-web-mobile-pmsfh.git
dsh plugin --profile web add ./dsh-web-mobile-pmsfh

dsh plugin 命令安装到 dsh web 启动的服务端;DSH 桌面客户端自行管理插件,要在桌面端使用,在客户端的设置 → 插件页里安装。

如果本机 npm 指向国内镜像,无法安装这个包,在命令后面加 --registry=https://registry.npmjs.org。

重启命令示例:

sudo systemctl restart dsh-web

首次访问:用移动设备打开主站会自动跳转,也可以直接开 https://<域名>/dsh-web-mobile-pmsfh/;如果没跳转,检查这次浏览是否点过「进入桌面版」——那是会话级偏好(sessionStorage),关闭页面重新打开即恢复默认。

兼容性

DSH状态
0.2.2-rc.1已适配
其他 0.2.x未验证,端点签名可能不同

技术栈

Node.js 24 · DeepSeek Harness 0.2.2-rc.1 · Cordis 插件 · 原生 JavaScript (无构建)· markdown-it

移动页是单页原生 JS 应用,不加载官方前端、不走打包器;运行时没有额外依赖, 克隆后即可运行。

项目结构

dsh-web-mobile-pmsfh/
├─ lib/index.js       host 侧:静态路由与 connection.admit 校验
├─ client/client.js   桌面端:窄屏设备跳转到移动页
├─ mobile/            移动页
│  ├─ index.html
│  ├─ app.js / app.css
│  └─ vendor/         markdown-it 与 CJK 标点兼容补丁
├─ cordis.patch.yml   插件挂载配置
├─ types.d.ts         协议与数据形状定义
└─ tsconfig.json      仅类型检查,不产出构建物

架构

插件分三个部分,全部落在插件目录内,主仓库零改动;cordis.patch.yml 把插件插入 profile 层栈完成挂载:

组件职责
lib/index.jshost 侧:注册 /dsh-web-mobile-pmsfh/ 下的静态路由,全部置于 DSH 登录门之后
client/client.js桌面端注入:把触屏窄屏(coarse pointer 且视口 ≤ 768px)从官方界面跳转过来
mobile/独立移动页:原生 JS 单页应用,不加载官方前端、不走打包器

移动页与 DSH 的通信全部走 DSH 自身的 wire 协议(Typert Gateway),没有插件私有端点:

  • POST /api/<method>:一元 RPC(会话、工作区、模型、文件等操作)
  • WS /api/remote.mux:帧复用长连接(会话日志流、工作区基线、事件总线)
  • POST /api/$events/result:审批与问答应答

5 条资源路由,另加 1 条裸路径 302 跳转:

路径内容
/dsh-web-mobile-pmsfh/移动页
/dsh-web-mobile-pmsfh/app.js页面脚本
/dsh-web-mobile-pmsfh/app.css页面样式
/dsh-web-mobile-pmsfh/vendor/markdown-it.min.jsmarkdown 渲染
/dsh-web-mobile-pmsfh/vendor/markdown-it-cjk-friendly.min.jsCJK 标点下的 ** 处理

页面文件每次请求从磁盘读取(no-cache,内容不变时 304),插件更新并重启 dsh-web 后立即生效;vendor 文件按内容哈希缓存 30 天(immutable)。

DSH 接口依赖

移动页直接调用下列 DSH 内部接口(session/follow、workspace/follow 与 $events 走 mux 长连接,其余走一元 RPC):

接口用途
session/list/session/create/session/prompt/session/cancel列表、创建、发消息、停止
session/selectModel / session/modelCatalog模型与推理等级选择
session/page / session/follow历史分页与实时日志流
workspace/create / workspace/rename / workspace/delete工作区管理
workspace/archiveSession / workspace/follow会话归档与工作区基线流
directoryPicker/list / directoryPicker/createDirectory新建工作区的内联目录浏览器
commands/execute权限档位设置(/permission 命令)
fileUploads/upload附件上传,返回凭证随下一条消息发送
workspaceFiles/list / workspaceFiles/readBytes工作区文件列表与下载
$events/result审批与问答应答

这些是 DSH 内部接口,没有稳定承诺:校验服务不可用时返回 503,不放行; 端点签名变动会导致相应功能不可用,需要等插件适配(见「兼容性」)。

质量

  • 类型:types.d.ts 定义协议与数据形状,源码带 @ts-check, tsc --noEmit 全绿
  • 语法:node --check 覆盖 host 侧与移动页
  • 静态资源:按内容哈希发 ETag,重复访问返回 304,升级后立即生效
  • 无构建链:仓库即运行物,没有安装与构建步骤

安全

  • 不自带账号体系:未登录访问插件页被 DSH 登录校验拦下(401);校验服务不可用时返回 503,不放行
  • 经反向代理对外暴露时,在代理层加认证(Basic Auth / OIDC / mTLS),不要把 DSH 端口直接暴露公网
  • 模型输出经 markdown-it 渲染(html: false),链接限定 http/https/mailto;HTML 响应带 CSP、nosniff、no-referrer 与 X-Frame-Options: DENY

自检与排查

  • 打不开插件页、被带回 DSH 登录页:未登录或会话过期,先在主站登录
  • 插件页返回 503:DSH 登录校验服务不可用,插件拒绝放行,先恢复 DSH 本体
  • 手机打开主站没有进移动页:本次浏览点过「进入桌面版」(会话级偏好, sessionStorage),关闭页面重新打开即恢复默认;切到桌面版的手机右下角有「📱」浮标,点它回移动版
  • 会话列表能开但模型列表不可用:DSH 后端模型服务异常,看 DSH 自身日志
  • 升级 DSH 后插件页打不开或行为异常:内部接口签名可能变动,对照「兼容性」确认适配版本,等插件适配新版

已知限制

  • 本插件不提供网络连接能力:不做端口转发、内网穿透,也不代转流量。移动页挂在 DSH 同一地址下,不单独监听端口,能否打开与 DSH 主站一致。DSH 在公网可访问的, 移动设备接任意网络打开同一地址即可;只在内网部署的,移动设备需接入同一内网; 只在本机运行的,只能在本机访问。在本机部署 DSH 或使用桌面版时,桌面浏览器 默认不会进入移动页,要测试移动页面需自行开启设备模拟或安装移动模拟器。
  • 不列子代理会话(与桌面端一致:子代理不占顶层行)
  • 附件走官方对话附件通道,不写入工作区;工作区文件只读
  • 依赖 DSH 内部接口,没有稳定承诺:端点签名变动会使相应功能不可用, 需等插件适配
  • 建议单用户使用:DSH 本身没有多账号区分,多用户共用要自己在外面做隔离

更新

从 npm 安装的,更新到新版本后重启:

dsh plugin --profile web add dsh-web-mobile-pmsfh@latest
sudo systemctl restart dsh-web

从源码安装的,在克隆目录拉取最新代码后重启:

git pull
sudo systemctl restart dsh-web

卸载

从 web profile 移除插件后重启:

dsh plugin --profile web remove dsh-web-mobile-pmsfh
sudo systemctl restart dsh-web

开发

本地调试建议使用独立的 DSH_HOME 与端口,避免影响生产数据:

DSH_HOME=~/.dsh-test dsh --profile web --no-open --port 3080
  • 无构建链:仓库即运行产物,改动落盘后重启 dsh-web 即生效(页面文件每次请求都从磁盘读)
  • 语法检查 node --check,类型检查 tsc --noEmit(@ts-check 逐文件生效)
  • 调试钩子:页面暴露 __dshwm.dispatch(),可向 mux 注入合成帧,用于演练审批与问答弹窗;__frames 记录收到的帧类型序列
  • 软键盘适配:#app 以 visualViewport 高度为准钉高,配合 interactive-widget=resizes-content meta,保证输入框骑在键盘上方
  • 词典集中在 mobile/app.js 顶部的 T 对象,中英两套键值对照,改界面文案时两套都要动

实现要点:静态资源按内容哈希发 ETag,重复访问返回 304;内置依赖缓存 30 天。

许可证

MIT © 2026 renlang119

Comments

Loading…

Similar plugins

dsh-mobile

by zyfgood

Mobile web UI for DeepSeek Harness: a token-protected LAN server that lists all sessions, streams replies over SSE, and lets a phone continue any conversation; the desktop GUI shows a QR entry and, wi

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add @zyfgood/dsh-mobile

by kaijia323

DSH Web 的移动端外壳插件:抽屉式导航、触控尺寸控件、安全区适配、对话区占满整屏,桌面端行为不变。

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Nov 4, 2026

dsh plugin --profile web add dsh-mobile-ui

by loeissu

Mobile-first UI for the DeepSeek Harness web client — an official slot client plugin. 让 DSH 在手机上好用:抽屉导航、命中区、键盘适配、横屏。不改宿主源码,不 fork tether,不接管 sidebar。

Manifest valid

★ 0

MIT

JavaScript

Sep 14, 2026

dsh plugin --profile web add dsh-plugin-mobile-ui

by lan450

Mobile layout adaptation for the DeepSeek Harness Web UI — no overflow on phones: overlay sidebar, bottom-sheet pickers, two-row question/plan-review cards, safe-area handling. 手机端 UI 适配插件.

Manifest valid

★ 0

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add dsh-mobile-ui

A PIN-protected, chat-only mobile web client for DeepSeek Harness, served on an isolated port over LAN or a self-provided tunnel.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

dsh plugin --profile web add dsh-mobile-access

by slicenferqin

A task-first mobile workspace for DeepSeek Harness, with session overviews, compact input, and full-record access.

Development & InfrastructureManifest valid

★ 1

MIT

JavaScript

Oct 26, 2026

dsh plugin --profile web add dsh-mobile