dsh-Remote

DSH Remote

把电脑上的 DSH，带到你的掌心。

在手机或另一台电脑查看会话、处理审批与提问、传输文件，并掌握主机运行状态。

中文 · English

DSH Remote 由 DSH 插件、单文件网关和多端客户端组成。插件提供 DSH 内入口并管理网关；网关负责鉴权、HTTP/实时代理和文件传输；客户端包括 Android、手机/桌面 WebUI 与 HarmonyOS 源码工程。

文档首页 · 安装指南 · 故障排查 · 下载 · 反馈

你可以做什么

能力 · 内容 会话控制 · 历史与实时消息、模型/思考档位、审批、提问、目标、队列与子代理 文件与图片 · 主机目录、预览、下载、分块续传、图片附件 主机状态 · 网关、DSH、双事件流、设备、Token 与费用估算 插件管理 · 当前主机已安装/发现插件、详情、配置启停与操作记录 会话洞察 · 可选 dsh-context 上下文与 dsh-cost-meter 费用/额度摘要 弱网与恢复 · 独立长轮询、WS 退避重连、历史缓存、gzip/ETag、受限异常恢复 多网络与主题 · 多地址配对、服务器分组、局域网/Tailscale、六套 Web 主题

手机底部导航为 会话、文件、主页、插件、设置；统计由主页简要用量与会话入口查看。桌面 WebUI 使用宽屏工作台、文件页和按需抽屉。详细操作与跨端差异见使用指南。

图片理解由 DSH 与模型能力决定；Remote 的费用估算不是供应商账单。会话洞察需安装对应主机插件，缺失时显示不可用。DSH UI 支持安全只读子集。

快速开始：DSH Web 插件

先确认 DSH Web 能正常打开，在运行 DSH 的同一用户下执行：

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

1. 完整重启 DSH Web，浏览器 Ctrl+F5，从侧栏打开 DSH Remote。
2. 确认网关运行，在主机打开 http://127.0.0.1:8787/health。
3. 在管理控制台生成二维码，用客户端「设置 → 服务器」扫码。
4. 手动连接时填写 http://电脑局域网IP:8787 和令牌。手机上的 localhost 指向手机自己。

示例使用 web profile，自定义 profile 请用实际名称。DSH Desktop 从桌面版自带插件管理入口安装，完整退出并重开；不要把 Web profile 的安装当作 Desktop 已安装。RC 包使用 @next，标签实际指向需查询 npm。

首次连接、多网卡、独立网关、固定版本和 Git 源安装见安装指南。

配对二维码包含凭证。使用可信局域网或 Tailscale；不要公开二维码/令牌或直接把网关端口暴露到公网。

截图

2026-10-12 更新：手机图片来自 Android 16 模拟器中实际运行的 0.7.4 APK；桌面、插件面板和管理页来自浏览器。会话、用量、设备和地址均为仿真示例，未使用真实 profile 或凭证；没有进行实体手机或 HarmonyOS 截图。查看全部 19 张截图与说明。

App 主页 App 设置

下载与平台状态

GitHub Releases 提供版本与资产；Latest 是正式版入口，RC 单独用于验收。

平台 · 资产与范围 Android · dsh-remote.apk，Capacitor 壳；相机、通知、后台及安装权限需真机确认 Windows x64 · dsh-remote-win-x64.exe，免 Node 网关 Linux x64 · dsh-remote-linux-x64，免 Node 网关，需执行权限 浏览器 · 连接网关，使用手机/桌面 WebUI HarmonyOS · ArkTS/ArkUI 源码，需自行构建与签名，当前发布流程不提供 HAP macOS · 不在当前主发布工作流目标内；历史预览不保证每版同步

本轮文档源码基线为 0.7.4（2026-10-12）；HarmonyOS manifest 仍为 0.6.26。这不是对 GitHub/npm/Gitee 当前分发状态的独立核验，也不代表本轮完成 Android/HarmonyOS 真机验收。

Windows Desktop 启动/重启属实验能力，需要经过验证的实例与启动配置；网关必须在线。管理页可选择「登录后自动运行网关」（默认关闭，仅 Windows），使未打开 DSH 时仍能连接已配置的中转；不注册系统服务，需完成 Windows 登录。后台、恢复与文件授权边界见配置参考。

文档与开发

内容 · 入口 用户文档 · 安装、使用、配置、排障 功能专题 · 插件中心、会话洞察、DSH UI 开发与接口 · 开发指南、模块索引、兼容性 构建与发布 · 发布指南、鸿蒙自构建 历史与设计 · 历史索引、文档核对记录

网关零运行时依赖，WebUI 零构建纯 JS；整个仓库保留已有 Capacitor/AndroidX 与本地 vendored 资源。开发不新增依赖，遵守 AGENTS.md，改根 public/ 或网关后同步插件副本。

npm ci
npm run sync-plugin
npm run check
git diff --check

Android 构建为 npm run build-app，本地 APK/更新元数据准备为 npm run publish。正式 npm run release 会提交全部非忽略改动、推送并更新 tag，需按发布流程明确授权；--dry-run 仍修改本地文件。

贡献者与致谢

感谢代码、修复、文档与反馈贡献者。以下名单与客户端离线致谢保持一致，完整历史见 GitHub Contributors：

• Blank-not-black
• wikkd
• anupamme
• liuchang-t

客户端设置中的关于页提供贡献者入口；历史名单不是本轮重新查询的贡献排名。

☕ 支持项目

如果 DSH Remote 对你的工作流有帮助，欢迎给项目点一个 Star，或请作者喝杯咖啡。每一份反馈、Issue、PR 和赞赏，都会帮助这个小工具继续变得更可靠。

License