远程控制台 Blank-not-black/dsh-Remote

DSH Remote

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

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

English · 简体中文

dshbase listed
dsh.so risk
dsh.so install
Awesome DSH Plugin
dsh-remote-plugin on dsh.fish
dshplugin.dev listed
dshfind

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

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

需要操作说明或把问题交给自己的 AI？从操作与排障知识库开始；AI 阅读索引按症状、错误码和验证依据导航，插件包附带离线副本。

当前源码为 0.8.0-rc.9（2026-10-22），仍处于正式版前验证阶段。版本与验证范围见 rc.9 说明；本地候选版本不代表 npm 标签或 Release 已更新。

你可以做什么

| 能力 | 内容 |
| 会话控制 | 历史与实时消息、模型/思考档位、审批、提问、目标、队列、子代理与回合分支 |
| 新手引导与排查 | 手机端八步练习、AI 只读排查、操作日志与反馈 |
| 文件与图片 | 主机目录、预览、下载、分块续传、图片附件 |
| 主机状态 | 网关、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. 在插件连接向导或管理控制台生成连接二维码，用客户端「更多 → 主机与连接 → 扫码连接」扫码。APK 下载码只用于安装。
4. 手动连接时填写 http://电脑局域网IP:8787 和令牌。手机上的 localhost 指向手机自己。

示例使用 web profile，自定义 profile 请用实际名称。DSH Desktop 从桌面版自带插件管理入口安装，完整退出并重开；不要把 Web profile 的安装当作 Desktop 已安装。测试已发布的候选版时使用 @<确切版本>；@next、@latest 的实际指向需查询 npm。

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

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

截图

下图为 2026-10-22 的 rc.9 手机 WebUI，使用隔离测试主机与示例数据，展示默认鱼皮肤和调整后的“更多”页。它们不是 Android 真机截图。旧版 Android 模拟器、桌面与管理页截图及来源保留在截图库。

会话首页更多与新手引导

下载与平台状态

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 Apple Silicon | CI 已配置 dsh-remote-macos-arm64 构建、ad-hoc 签名与隔离启动冒烟；未做 Apple 公证。Intel 使用插件或源码，见安装指南 |

文档源码基线为 0.8.0-rc.9（2026-10-22）；HarmonyOS manifest 仍为 0.6.26。构建配置与实际 Release 附件应分别核对；本页不宣称公开分发或所有平台真机验收已完成。

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

文档与开发

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

网关零运行时依赖，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 <version> 会提交全部非忽略改动、推送并更新 tag，需按发布流程明确授权；--dry-run 仍修改本地文件。

贡献者与致谢

日常开发与普通 PR 以 dev 为目标，main 作为发布主线并保留为 GitHub 默认分支。参与前请阅读贡献指南、社区行为准则、安全政策与支持指南。

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

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

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

☕ 支持项目

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

License

MIT