dsh-remote-plugin
DSH Remote 的官方 bundle 插件:在 DSH 侧边栏提供入口,打开快速状态面板和完整管理控制台,并内置随 DSH 自动启停的远程网关。
中文 · [English](README.en.md)
安装
dsh plugin --profile web add dsh-remote-plugin
# 也可以安装指定版本
dsh plugin --profile web add dsh-remote-plugin@0.6.8重启 DSH Web 后刷新浏览器,左侧边栏会出现 DSH Remote 入口。
插件提供什么
- 快速面板:网关状态、在线设备、Token 用量和快捷操作;
- 管理控制台:端口、上游、设备、请求、Token 统计、二维码和令牌轮换;
- 内置
gateway.cjs:默认监听0.0.0.0:8787,带 Bearer token 鉴权; - 网关自愈:DSH 重启或网关意外退出后自动拉起,可在面板中停止或启动;
/fs/*文件端点:列表、下载、分块上传、断点续传、暂停/继续/取消和 SHA-256 校验;- 手机端、桌面端和管理页 WebUI,以及随插件分发的 Android APK。
手机端能力
Android 应用 / 手机 WebUI 采用五个主要页面:会话、文件、主页、统计、设置。会话详情支持目标控制、子代理中断、模型切换、全屏输入、斜杠命令和图片附件。图片附件可从相机或相册选择,并以 session.prompt 图片内容发送到当前会话。
通知设置支持审批 / 提问通知、后台轮询、峰谷提醒、任务完成提醒和历史公告。当前保留四套主题:默认深空、落日、易北爱乐厅、草原孤塔。
网关配置
- 网关端口优先级:
DSH_REMOTE_GATEWAY_PORT环境变量 →~/.dsh-remote/gateway-port→8787; - 令牌:
~/.dsh-remote/token,首次运行自动生成; - 自愈开关:
~/.dsh-remote/gateway.enabled,或使用DSH_REMOTE_AUTOSTART=0禁用自动管理; - 文件根目录:
DSH_REMOTE_FS_ROOT,Linux/macOS 使用:,Windows 使用;; - 文件上限:
DSH_REMOTE_FS_MAX_UPLOAD,默认 2GB; - DSH 上游:默认
http://127.0.0.1:3080。
令牌等同于 DSH 远程操作凭证,请不要公开或提交到仓库。局域网访问建议配合防火墙;跨网络访问建议使用 Tailscale 或其他带认证的安全隧道。
相关地址
- 管理页:
http://<网关IP>:8787/admin - 桌面 WebUI:
http://<网关IP>:8787 - 主项目:dsh-Remote
- 正式版本:GitHub Releases
License
MIT