dsh-remote-plugin

DSH Remote 的官方 bundle 插件：在 DSH 侧边栏提供入口，打开快速状态面板和完整管理控制台，并内置随 DSH 自动启停的远程网关。

中文 · English

安装

dsh plugin --profile web add dsh-remote-plugin
dsh plugin --profile web list --depth 0

# 也可以安装指定版本
dsh plugin --profile web add dsh-remote-plugin@0.6.8

第二条命令用于确认插件安装在正确的 web profile。然后完整重启 DSH Web 进程并 Ctrl+F5 强刷浏览器，左侧边栏会出现 DSH Remote 入口。如果 DSH Web 由 systemd 用户服务管理，可执行 systemctl --user restart dsh-web；手动运行时则需停止旧的 dsh web 进程后重新启动。

安装后先在 DSH 主机访问 http://127.0.0.1:8787/health。看到 JSON 后再用手机连接 http://电脑局域网IP:8787；手机上的 127.0.0.1 和 localhost 指向手机自己，不是 DSH 主机。

插件提供什么

• 快速面板：网关状态、在线设备、Token 用量和快捷操作；
• 管理控制台：端口、上游、设备、请求、Token 统计、二维码和令牌轮换；
• 内置 gateway.cjs：默认监听 0.0.0.0:8787，带 Bearer token 鉴权；
• 网关自愈：DSH 重启或网关意外退出后自动拉起，可在面板中停止或启动；
• /fs/* 文件端点：列表、下载、分块上传、断点续传、暂停/继续/取消和 SHA-256 校验；
• 手机端、桌面端和管理页 WebUI，以及随插件分发的 Android APK。

手机端能力

Android 应用 / 手机 WebUI 采用五个主要页面：会话、文件、主页、统计、设置。会话详情支持目标控制、子代理中断、模型切换、全屏输入、斜杠命令和图片附件。图片附件可从相机或相册选择，并以 session.prompt 图片内容发送到当前会话。

通知设置支持审批 / 提问通知、后台轮询、峰谷提醒、任务完成提醒和历史公告。公告通过中央 HTTPS 源更新，App 前台每 30 秒检查，中央源不可达时回退网关缓存或安装包内公告。当前保留四套主题：默认深空、落日、易北爱乐厅、草原孤塔。

网关配置

• 网关端口优先级：DSH_REMOTE_GATEWAY_PORT 环境变量 → ~/.dsh-remote/gateway-port → 8787；
• 令牌：~/.dsh-remote/token，首次运行自动生成；
• 自愈开关：~/.dsh-remote/gateway.enabled，或使用 DSH_REMOTE_AUTOSTART=0 禁用自动管理；
• 文件根目录：DSH 已登记工作区会自动放行；其他目录用 DSH_REMOTE_FS_ROOT 配置，Linux/macOS 使用 :，Windows 使用 ;；
• 文件上限：DSH_REMOTE_FS_MAX_UPLOAD，默认 2GB；
• 中央公告：DSH_REMOTE_ANNOUNCEMENTS_URL 可覆盖默认 HTTPS 地址，设为空字符串可禁用中央源；
• DSH 上游：默认 http://127.0.0.1:3080。

令牌等同于 DSH 远程操作凭证，请不要公开或提交到仓库。局域网访问建议配合防火墙；跨网络访问建议使用 Tailscale 或其他带认证的安全隧道。

网关打不开

curl -i http://127.0.0.1:8787/health
ss -ltnp | grep ':8787'
curl -i http://127.0.0.1:3080/

• 8787 本机也拒绝连接：检查插件是否装在 web profile、插件面板的网关开关、DSH Web 是否真正重启，以及 8787 是否被占用。
• /health 能打开但 upstreamOk: false：网关已运行，应检查 DSH Web 的 3080 端口。
• 本机能打开但手机不能：使用电脑局域网/Tailscale IP，并允许防火墙 TCP 8787 入站；不需要对公网放行 3080。
• 出现 401：重新扫码或复制 ~/.dsh-remote/token。
• 页面黑屏/功能未更新：Ctrl+F5 强刷，手机端完全退出后重开。

插件网关可能以 transient 进程运行，不要依赖 systemctl --user restart dsh-remote-gateway.service。优先在插件面板启动网关，或重启 DSH Web 触发自愈。

相关地址

• 管理页：http://<网关IP>:8787/admin
• 桌面 WebUI：http://<网关IP>:8787
• 主项目：dsh-Remote
• 正式版本：GitHub Releases

License

MIT