# 本机引擎与远程主机

DSH 可以直接运行在这台手机上（本机引擎），也可以运行在你的电脑或服务器上，由手机远程连接。对话、工作区和插件都属于各自的主机。

## 本机还是远程

第一次打开 App 时选择 DSH 在哪里运行：

- **本机**：在手机上安装运行环境，全程在本机完成。选项里会写明需要的存储空间和内存。
- **远程主机**：连接电脑或服务器上的 DSH，不在手机上安装。手机内存或存储不够时会推荐这一项。

之后随时可以补装本机环境：在引擎页点**安装运行环境**，或在切换主机时点**本机**。装好后自动启动。

## 本机引擎

<!-- nav: commonSettings,hubSettingsEngine -->
`设置 › 本机引擎` · [打开](dshgo://open/engine)

- **启动**、**停止**、**重启**：停止前会确认；停止和重启都会中断进行中的对话。
- 启动失败时，页面显示失败原因和对应的修复按钮，如重试、**以安全模式启动**、查看日志。
- **打开 App 时自动启动**：默认开启。只要装了本机环境，即使在用远程主机，打开 App 时也会启动本机引擎；不需要时关闭。
- **自动进入安全模式**：默认开启。连续两次启动失败后，自动不加载插件启动。
- **以安全模式启动**：手动进入安全模式；修好后点**恢复正常模式**。进入和退出都会重启引擎。
- **日志**：引擎的实时输出。
- **后台运行**、**诊断**：见 [常见问题](11-faq.md)。

## 重置运行环境

<!-- nav: commonSettings,hubSettingsEngine,phoneEngineReset -->
`设置 › 本机引擎 › 重置运行环境`

删除本机数据后重新安装运行环境，用于修复无法启动的环境。确认框里可选：

- **保留界面配置和技能**：默认勾选。
- **保留已装插件和设置**：默认不勾选。

按默认确认，会删除对话、工作区、插件和设置，自定义模型渠道也在其中；App 里保存的 DeepSeek Key 会自动补回。确认框会写明这次删除的范围，点**删除并重置**后 App 自动重新安装。重置无法撤销，需要的对话先用 `/export` 或「全部功能」里的**导出对话日志**导出。

## 卸载运行环境

<!-- nav: commonSettings,hubSettingsEngine,localEnvUninstall -->
`设置 › 本机引擎 › 卸载运行环境`

释放存储空间。本机的对话、工作区、插件、设置、界面配置和技能都会删除，且不会自动重装。之后想再用本机引擎，在同一页点**安装运行环境**。只是暂时不用时，停止引擎，并关闭**打开 App 时自动启动**。

## 切换主机

打开对话列表，点底部的当前主机名，打开**切换主机**，选择**本机**或一台远程主机。还没有远程主机时点**连接电脑或服务器**，已有时点**管理远程主机**。

<!-- nav: remoteSwitchHost,remoteManageHosts -->
`切换主机 › 管理远程主机` · [打开](dshgo://open/remote)

设置里也能进：

<!-- nav: commonSettings,commonRemoteHost -->
`设置 › 远程主机`

打开 App 时会连回上次使用的主机。想每次先用本机，在远程主机页关闭**连接上次使用的主机**；已保存的主机不受影响，随时可以手动连接。

## 添加 SSH 主机

那台主机需要开着 SSH，并装好 DSH（`npm i -g @deepseek-ai/dsh`）。

1. 在远程主机页点**添加 SSH 主机**。
2. 填写**主机**、**用户名**，**端口**默认 22。名称可以留空。
3. 选择**密码**或**私钥**登录。私钥可以**从文件导入**，有口令时填**私钥密码（可选）**。密码和私钥只保存在这台手机上。
4. **启动命令**默认 `dsh web`；用 nvm 安装的 DSH 可以填完整路径。**工作目录（可选）**是新对话的默认目录。
5. 点**测试连接**。首次连接会弹出**信任这台主机？**：在那台主机上核对指纹，一致再点**信任并连接**。
6. 点**保存**，再在主机列表里选中它。

测试连接会启动远端的 DSH，测试结束后它继续运行。修改或删除：点主机右侧的**编辑**按钮，进入**编辑主机**，底部是**删除这台主机**。删除只移除手机上保存的设置、密码和私钥，远端的 DSH 和对话不受影响。

## DSH Remote

无需配置网络，连接端到端加密，适合不在同一网络的电脑。

1. 在那台主机的 DSH 里装好远程插件并登录。
2. 在远程主机页选择你在那台主机上使用的登录方式，例如「使用 GitHub 登录」，再用同一账号登录。如果页面没有列出登录方式，只显示**在浏览器中登录**，点它继续。
3. 在列表里选中在线的主机。首次连接时核对身份指纹，与主机上远程插件显示的一致再点**信任并连接**。

连接默认自动尝试局域网 / P2P、TURN，最后回落 Relay，无需打开直连开关；相应路径需服务端与主机支持。点击连接卡或主机旁的网络标签，查看实际路径、连接耗时、可测的往返延迟和回落原因；未测量的项目不会显示为零。

DSH Remote 一次只连一台主机，切换会断开上一台。经 DSH Remote 连接时：只能发送图片；App 内打不开网页版；插件只能开关；DS Bot 和导出对话日志不可用。