远程工作空间（SSH）

远程工作空间（Remote Workspace）是你在 Mac 上打开的另一台电脑上的文件夹，比如服务器、实验室的机器、家里的另一台电脑。文件留在那台电脑上，在 Resomark 里照样能浏览、编辑、搜索和看改动，和本机的工作空间一样。AI 在服务器上干活时，你在自己的 Mac 上看它改了什么。远程工作空间是 Plus 功能，试用期内能用。

Resomark 是 Mac App，装在你的 Mac 上。你连过去的那台电脑（主机）可以是：

• Mac：Apple 芯片，macOS 15 或更新，在「系统设置」→「通用」→「共享」里打开「远程登录」。
• Linux：ARM64 或 x86_64，哪个发行版都行。要有 curl 或 wget、gzip，以及 sha256sum、shasum、openssl 中的一个，大多数系统都自带；要看 Git 仓库的改动还需要 git。
• Windows：Windows 11，ARM64 或 x64，打开系统自带的 OpenSSH 服务器。追踪更改只在本机的 NTFS 磁盘上可用，网络驱动器上不行。

Resomark 用你 Mac 上的 SSH 来连，~/.ssh/config 里的别名、端口、跳板机和密钥都照用。所以先在「终端」里试一下 ssh 主机：能登录上去，Resomark 就能连。VPN、内网穿透这些网络问题要你先自己打通。

1. 选「文件」→「添加远程工作空间…」（Add Remote Workspace…）。首次启动页上的「连接远程服务器（SSH）…」也是它。
2. 弹窗顶部的菜单已经选在「新的远程主机」。输入 用户名@主机 或 SSH 别名，端口可以空着（照 SSH 配置），点「连接」。~/.ssh/config 里已有的主机，直接在这个菜单的「远程主机」下面选。
3. 要输密码、密钥口令、验证码，或要确认主机身份时，Resomark 在窗口里问你。密码只在这次运行里记着，退出 App 就忘，不存下来。
4. 连上以后列出主机上的文件夹，从你的主目录开始：单击选中，双击进入，↑ 回上一级；也可以在路径框里输入路径后回车。⌘⇧. 显示隐藏的文件夹。
5. 点「添加工作空间」（Add Workspace）。这个文件夹不是 Git 仓库、也没在哪台 Mac 上当过工作空间时，先问要不要打开「追踪更改」；当过的，就沿用主机上的设置。

连接失败时，弹窗里有一句原因和 SSH 的原文，改好后点「重试」。

第一次连上一台主机时，Resomark 会在上面装一个小程序，叫远程助手，由它在那台电脑上读写文件、记改动。不用你动手：主机自己下载，下载不了就由你的 Mac 下载后传过去。它装在主目录下的 ~/.resomark/remote-helper/（Windows 是 %LOCALAPPDATA%\.resomark\remote-helper\），不需要 sudo，不装系统服务，也不开端口。没有 Mac 连着它时，它 10 分钟后自己退出。

文件夹页的大标题后面有一个圆点，首页上远程工作空间的电脑图标上也有一个。指针移上去，能看到现在走到哪一步，比如「等待认证…」。

颜色	意思	在文件夹页点一下
灰	没连着，用到时才连	现在就连
蓝（闪）	正在连接或加载	重新开始这一次连接
绿	连着，内容是新的	检查一次连接
黄	连着，但有内容没更新成功	重试
红	断开了	重新连接

首页上的灯只显示，不能点。

打开 Resomark 时不连任何远程工作空间。进入它、打开里面的文件、在里面搜索时才连；没有窗口再用它，60 秒后自动断开，灯变回灰色。断开后不在后台重试，下次用到它时自动重连。没连着的远程工作空间不出现在搜索结果里。

• 不用手动保存：你停下来以后，改动自动同步到主机。标签上的圆点表示还没同步完。
• 你和主机上的程序同时改了同一个文件，会自动合并；改到同一处时，两边的内容都留着，中间加上标记，你挑好以后删掉标记就行。
• 断线时，打开着的文件和你的编辑都留着，文件暂时只读；还没同步的内容先存在这台 Mac 上。连上以后先核对这些编辑有没有送到，再合入主机上的新内容，不会拿旧的盖掉别人刚改的。
• 退出 App 时还没同步的内容也存着，下次打开会恢复；连不上时，也可以「另存为…」存到本机。

• 复制到本机：右键文件选「复制」，或按 ⌘C，再到访达里粘贴；也可以直接把文件从侧栏拖到桌面、访达或别的 App。拿到的是主机上当前的内容，整个传完才落盘。只限文件，文件夹不行。
• 传到主机：把本机的文件或文件夹拖到侧栏里远程的文件夹上。同名时问你「两者都保留」还是「停止」，不会覆盖。窗口里有进度，可以取消；超过 1,000 个文件或 500 MB 会先问你，单个文件超过 64 MiB 不传。
• 用默认 App 打开：右键选「使用默认 App 打开」。HTML 在默认浏览器里打开，旁边的图片和样式照常加载；别的文件打开的是一份只读副本。
• 新建、改名、移到废纸篓和标签都照常，但要连着。「在“访达”中显示」和「打开方式」在远程文件上用不了。

• 不在 Git 里的文件夹：「追踪更改」照常用，看改动、保留与还原都和本机一样。改动和历史记在主机上，几台 Mac 打开同一个远程文件夹，看到的是同一份。
• Git 仓库：Git 在主机上运行。能看未提交的改动和提交历史，也能切换主机上的 worktree 和分支；提交、拉取、推送不在 Resomark 里做，交给你的 AI 或终端。
• 远程文件没有 Mac 版本，也不能从 Git 提交里恢复。
• 收藏和置顶照常用，记在主机上那个文件夹里。远程工作空间的收藏不进首页，进入它以后在文件夹页里看。

「添加远程工作空间…」旁边带 PLUS 标记。已经加过的远程工作空间留在侧栏里，连接和配置都保留，点开会弹出订阅窗口。见 Free、Plus 与 14 天试用。

1. 在「终端」里用同样的地址 ssh 一下，看能不能登录。
2. 把指针移到状态灯上，看卡在哪一步。
3. 还是不行，选「帮助」→「导出远程诊断…」（Export Remote Diagnostics…），在「报告 Bug…」或邮件里附给我们。见遇到问题怎么办。

• 几种工作空间
• 追踪更改
• Git 仓库里的未提交改动