KyoMio/dsh-zen-remote 预览 preview

KyoMio/dsh-zen-remote

将 DeepSeek Harness 转变为一款可通过任何地方安全访问的手机应用:极简移动端界面重构 + 配对码网关 + PWA + Web 推送。让 DSH 变成可公网安全访问的手机应用。

Project Overview项目介绍

dsh-zen-remote is a native plugin built exclusively for DeepSeek Harness (DSH) that lets users access their local DSH instance remotely from a mobile device over the public internet. To install the plugin, run the command dsh plugin add dsh-zen-remote and restart dsh web afterward, and no manual configuration is required. It is verified to work with both DSH 0.1.1-rc.2 and 0.1.2-rc.1 web profile, and internally handles the API changes introduced in the newer DSH version to maintain compatibility. Users can also manually install the plugin by editing their DSH profile’s package.json if they prefer.

After installation, the mobile UI is available locally at 127.0.0.1:3080 right away. To access the instance from outside your local network, you can set up a reverse proxy with Nginx or Caddy, or use Cloudflare Tunnel if your home network does not have a public static IP address. Pairing a new mobile device uses a simple pairing code, no accounts or passwords are ever collected or stored. Each device gets a unique random identity token stored in an HttpOnly cookie, issued by the plugin itself. This plugin is ideal for users who need to check and manage their DSH sessions on the go from a mobile device.

This plugin is released under the open source MIT license. It does not send any user data to third parties, and all push notifications are end-to-end encrypted with AES-128-GCM so even the browser vendor cannot read the content. Uploaded attachments are only saved to the .dsh-uploads/ folder in the current working directory, and pairing state and configuration are stored in the ~/.dsh/ directory on your local machine. There are a few known limitations: settings pages cannot be opened from a remote browser due to DSH upstream design, and the input box position may be slightly off when the mobile keyboard pops up. Runtime logs for troubleshooting are prefixed [dsh-zen-remote-*] and stored in ~/.dsh/logs/web.log.

dsh-zen-remote 是专为 DeepSeek Harness (DSH) 开发的原生插件,用于将 DSH 转换为可从公网安全访问的手机应用。它提供了适配移动端的交互界面,支持添加到手机主屏幕、锁屏推送通知和配对码网关功能。用户可通过 dsh plugin add dsh-zen-remote 命令一键安装,安装后只需重启 dsh web 即可启用,无需手动编写配置文件。该插件同时兼容 DSH 0.1.1-rc.2 和 0.1.2-rc.1 版本,内部适配了两个版本的 API 变更。

安装完成后,本地即可通过 127.0.0.1:3080 访问移动端界面。如果需要从公网远程访问,用户可自行配置 Nginx 或 Caddy 反向代理,也可选择 Cloudflare Tunnel 解决家庭网络无公网 IP 的问题。设备配对通过配对码完成,全程无需注册账号或设置密码,设备身份由插件生成的随机令牌保存在 HttpOnly Cookie 中。它适合需要在外随时访问本地 DSH 实例、在手机上管理 DSH 会话的用户。

该插件采用 MIT 许可证开源,不会向任何第三方上报数据,推送内容通过 AES-128-GCM 端到端加密,浏览器厂商无法读取内容。附件上传仅保存在当前会话工作目录的 .dsh-uploads/ 文件夹下,配对信息和配置存放在 ~/.dsh/ 目录中。已知限制包括:远程浏览器无法打开设置页面,这是 DSH 上游设计限制,需在本地修改设置;移动端键盘弹出时输入框位置可能有偏差。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 10 stars - an early-stage project星标 10,属于早期项目
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-zen-remote

把 KyoMio/dsh-zen-remote 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-zen-remote

One DeepSeek Harness plugin, two roles. The host turns DSH into a phone-reachable PWA (mobile UI, pairing gateway, lock-screen push) and shares chosen sessions to paired desktops. The client runs inside another DSH desktop app and puts the host's shared sessions right into its own sidebar — full history, live progress, messages, approvals, terminal, everything executes on the host.

npm version npm downloads publish workflow MIT
DeepSeek Harness 0.1.7 – 0.2.x Node npm provenance PWA + Web Push TypeScript strict

中文文档

Session list home Session page Session info card
Session list home Session page Session info card
Composer permission sheet Pairing page a public visitor sees
Composer permission sheet Pairing page

Screenshots are a 390×844 phone viewport in the light theme; both themes are supported. The pairing page is drawn by the gateway in DSH's official style, following the system light / dark appearance.


One plugin, two roles

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-ui-font 下一个 Next dsh-host-rsi →