设置分类与默认值

按 Cmd+,（Windows 上是 Ctrl+,），或点击侧边栏底部的设置。对话框打开时停在 Appearance。另有几个按钮会直接跳到其他分类：Token Meter 弹出面板里的设置链接打开 Token Meter，升级提示里的输入许可证密钥按钮打开 License & Activation，MXterm Hosts 标题栏里的齿轮，以及标题栏里的钥匙图标（访问密码开启时显示），打开 Remote Access & Devices。按 Esc、点 × 按钮或点对话框外面，都可以关闭。

大多数分类名在每种界面语言里都显示英文。General、Agents、Account、My Devices、Privacy 和 Feedback 有各自的译名：中文界面显示通用、Agent、账户、我的设备、隐私、反馈，越南语界面显示 Chung、Agents（不变）、Tài khoản、Máy của tôi、Quyền riêng tư 和 Góp ý。

只有一项：开机时启动，登录电脑时启动 MXterm Pro。这个开关反映的是操作系统当前登记的状态，所以在别处关掉它（比如 macOS 的系统设置），这里也会随之更新。

最低文本对比度会调整与背景太接近的终端颜色，主题的其余配色不变。聚焦分屏强调色是标出当前分屏的边框颜色，非活动分屏变暗决定其他分屏淡出多少；标签页里只有一个分屏时，它不会被变暗。MXterm Black 和 MXterm Slate 不会把非活动分屏淡成灰色：它们用黑色把分屏压暗，同一个滑块决定压暗多少。10 个主题全是深色。主题会应用到侧边栏、标签页和每个终端分屏，由你手动选择。

显示语言 / Display Language 是一个下拉菜单：它显示当前语言，展开后列出全部十一种。英语、印度尼西亚语、越南语和中文排在最前，然后是日语、韩语、西班牙语、法语、土耳其语、葡萄牙语（巴西）和德语。每一行显示该语言自己的名称，两者不同时，旁边用灰色附上英文名，当前语言用对勾标出。不用国旗。简体中文、日语、韩语、西班牙语、法语和土耳其语是 1.1.11 加入的，印度尼西亚语、葡萄牙语（巴西）和德语是之后加入的。选择后立即生效。

文本设置对已打开的终端立即生效，重置为默认值会恢复默认值。在 macOS 上，电脑里没有的字体在列表中标为未安装。在 Windows 上，应用读不到已安装字体列表，所以每个列出的字体都标为可用性未知。Shell 只影响修改之后新建的分屏，运行中的终端保持原来的 Shell。

最小列数防止程序被挤压。分屏窄于这个列数时，会改为缩小文字（以半个像素为步长），这样程序仍然能拿到这么多列。全屏程序被告知分屏有 13 列时，会按这个宽度换行输出，分屏再变宽，换行也不会恢复。分屏宽到够用后，文字会变回来，但不会超过大小（或该分屏自己的缩放）。如果要容纳这些列，文字得小于 8 px，分屏就不缩小，程序拿到真实的列数，和关闭该设置时一样。默认开启，为 80，对这台电脑上的分屏生效。以 10 为步长调低，一直调到关闭（0），即可关掉。重置为默认值会把它恢复为 80。

默认 SSH 工作目录决定从 SSH & SFTP Manager 打开的连接从哪个目录开始。主机本身保存了默认目录时，以主机的为准。Remember Last Session Directory 在 1.0.22 中已移除：它的行为一直和主目录 (~)相同，因为应用从来没有记录过上次的目录。参见 SSH 和 SFTP。

开启 Manage Claude Code's status line 后，应用会往 ~/.claude/settings.json 写入一条 statusLine，这样 Claude Code 分屏会显示 Claude Code 是否连上了 MXterm Pro 的 MCP 服务器，以及当前会话已用了多少上下文。如果你已经有自定义状态栏，它保持不动。

开启聊天视图（实验性）后，运行 Claude Code、Codex、omp 或 Grok 的分屏可以在终端和易读的对话聊天之间切换，聊天内容读自 Agent 自己的转录文件。可以在分屏标题栏里切换，也可以用 Cmd+Shift+J（Windows 上是 Ctrl+Shift+J）。新的 Agent 分屏会以你上次选的视图打开，在你选终端之前就是聊天，每个分屏也会记住它上次所在的视图。聊天是一层覆盖，所以切换从不会动正在运行的程序。

MXterm Pro 能启动 27 种编程 Agent，Agent 页为每一种列出一行，这些 Agent 见 Agent 页面。刷新会重新检查。每一行显示：

• 已安装或未安装。MXterm Pro 在与工作区创建页面相同的位置查找该 Agent 的可执行文件。它只看这些文件夹里的文件名，从不运行程序。Cursor Agent 对应的文件是 cursor-agent，不是 cursor，后者是编辑器的启动器。
• 该 Agent 是否已连到 Control Room：未在 Control Room 中、N panes in a room · M connected，或在房间中，但尚未调用 MXterm。分屏按其打开时选的 Agent 计数，所以你自己在普通 Shell 里敲 Agent 名字启动的，不计入。
• MXterm Pro 是否为该 Agent 配置它的 MCP 工具：要么是 MXterm 为此 Agent 配置工具（Claude Code、Codex、Gemini CLI、Grok 和 OMP），要么是 工具配置未验证（其他 Agent），后者可能需要手动配置，方法见 编程 Agent 和 Control Room。
• 有此参数的 Agent，会显示 Bypass Mode 所添加的跳过权限参数。对没有参数的 Goose，这一行改为显示环境变量 GOOSE_MODE=auto。
• 对于没安装的 Agent，如何安装会展开安装命令，附带复制命令和指向厂商页面的链接。MXterm Pro 从不替你执行安装。厂商没有给出安装命令的 Agent，如 Amp、Cursor Agent、Antigravity 和 Aider，会改为显示指向厂商页面的链接。

MXterm 创建的 worktree 是 Agent 页面上的一张卡片。它列出 .worktrees/ 下由 MXterm 为 Agent 或隔离标签页创建的文件夹，通过你最近用过的文件夹找到。点击显示列表才会加载：不会在后台扫描，也不会自动删除任何内容。每一行显示分支、路径、大小、文件夹多久前变动过，以及一个标签：可安全删除、有未提交的更改、未合并或使用中（有分屏正在其中打开，请先关闭该分屏）。删除会请你确认；如果未提交的更改或未合并的提交会丢失，还会再确认一次；分支始终保留。如果 git 仍列出某个文件夹已不存在的 worktree，会出现清理失效条目。

显示已登录账户默认关闭。开启后，MXterm Pro 会从各 Agent 自己的文件读取账户邮箱（~/.claude.json、~/.codex/auth.json、~/.gemini/google_accounts.json 和 ~/.grok/auth.json；设置了 CLAUDE_CONFIG_DIR 和 CODEX_HOME 时，Claude Code 和 Codex 分别按它们的路径读取），并显示在该 Agent 那一行，读不到则显示未找到账户。只读邮箱：不读 token，也不读 Keychain。关闭后，邮箱会立即从内存中清除。

逐个 Agent 的列表里只有 MXterm Pro 能读取状态的九个 Agent。普通 Shell 分屏不发通知。横幅写了什么、点击后跳到哪里，见 编程 Agent 和 Control Room。

置顶到顶部排在最前。它是一个菜单，用来选择 Token Meter 弹出面板最先列出哪个提供商：Claude Code、Codex、Gemini、其他 Agent、DeepSeek、Moonshot、Kimi、MiniMax、OpenRouter 或 Z.ai，也可以选无（固定顺序）。默认置顶 Claude Code。弹出面板仍会列出你配置过的所有提供商，标题栏里的数字也不跟随置顶：它仍然跟随最接近用完的那个限额。

套餐限额下有两个开关，默认都关闭。

• 显示 Claude 的真实限额百分比：应用通过系统的 security 工具，从 macOS Keychain 读取 Claude Code 的登录凭据，这样 macOS 不会每次都询问，然后调用 api.anthropic.com 读取你的套餐用量。token 只保存在内存中，你的对话记录不会被发送。关闭时，Token Meter 显示已用 token 数，而不是百分比。如果 macOS 拒绝读取，开关会保持关闭，直到你再次打开。如果这台 Mac 上的 Claude Code 没有登录，先在终端运行 claude 登录，再重试。用 MXTERM_DISABLE_KEYCHAIN=1 启动 MXterm Pro 会屏蔽这次读取，不管开关怎么设，适用于不允许访问其他应用 Keychain 条目的机器。此功能仅在 macOS 上有效。Windows 上开关仍会显示，但应用读不到那里的 Claude Code 登录凭据，所以不管有没有登录，都会报告 Claude Code 未登录。
• 实时 Codex 限额：应用读取 Codex 自己的 ChatGPT 登录凭据 ~/.codex/auth.json，并且只发送给 chatgpt.com。它从不修改或刷新这份凭据；Codex 存放在系统 Keychain 里的登录凭据不会被读取，所以如果面板提示没有，请运行 codex login。保持关闭时，Codex 的限额仍会显示，数据读自这台机器上的会话文件，因此只和你最近一次 Codex 对话一样新。

再往下，账户提供商可以填入 DeepSeek、Moonshot、Kimi、MiniMax、OpenRouter 和 Z.ai 的 API 密钥，这样 Token Meter 就能显示这些账户的剩余额度。粘贴密钥后点保存，这一行会显示 Key saved · …abcd（末尾四个字符），点移除即清除。Moonshot、MiniMax 和 Z.ai 还有区域菜单：Moonshot 是国际或 China，MiniMax 和 Z.ai 是 Global 或 China，默认是第一项。Z.ai 的密钥只在它所属的区域有效。如果这台电脑上的 Kimi Code CLI 已经登录，Kimi 这一行会从 ~/.kimi-code 读取该登录信息并标明；你粘贴的密钥优先。面板里写明了密钥的去向：密钥保存在 macOS Keychain 中，且仅发送给对应的提供商。 在 Windows 上，密钥通过系统凭据存储保存，而不是 macOS Keychain，不过面板文字仍然写的是 macOS Keychain。

Token Meter 自己显示什么内容，见 Token Meter 文档。

账户是你登录 MXterm 账户的地方。未登录时，卡片显示 MXterm 账户，下面一行是登录后即可查看并控制你的其他设备，无需每次都设置共享。，还有一个使用 MXterm 账户登录按钮。按钮会打开浏览器，在你完成之前显示正在等待浏览器…。如果失败，卡片会显示登录失败：加上原因。登录后，卡片显示已登录：和你的邮箱，另有一个退出登录按钮。

你登录期间，等待加入的设备卡片会列出请求加入该账户的设备。确认验证码与另一台设备显示的一致，输入它的末 4 位数字，然后点击批准。没有设备在等待时，该卡片会隐藏。

登录是免费的。它也是你在 License & Activation 里用团队的席位激活 Pro 的前提，我的设备也需要它。

Pro 按电脑生效，在这里用许可证密钥激活，或者在有人把许可证上的一个席位分给你的 MXterm 账户时，用该账户激活。

1. 打开设置，选择 License & Activation。
2. 把购买邮件里的密钥（格式类似 MXTERM-XXXX-XXXX-XXXX-XXXX）粘贴到激活许可证密钥下面的输入框。
3. 点击 Activate。

团队给你分配了席位？在密钥输入框下面，点击登录 MXterm，会通过浏览器让你登录，然后点击以 你的邮箱 激活，就能用账户激活这台电脑，无需密钥。如果你的账户在多个许可证上有席位，面板会让你选一个。这样激活的电脑不会向你显示密钥。

激活时会联系 mxterm.net。它发送密钥、这台电脑硬件 ID 的哈希、电脑名称、应用版本和操作系统。服务器把这台电脑计入你许可证的设备上限，并返回一个已签名的许可证 token，由应用保存。之后每次启动时应用会在线再检查一次许可证（每小时最多一次），运行期间每 24 小时再检查一次。如果连不上 mxterm.net，什么都不会变，Pro 离线时仍然可用。只有服务器连续两次给出同样明确的拒绝，才会去掉 Pro。粘贴错误或输错的密钥，不会让这台电脑上已有的有效许可证失效：表单会显示错误，许可证保持原样。许可证被去掉时，无论是在线检查、停用设备还是仍然从此设备移除，应用里所有地方都会立即同步去掉，无需重启。

激活后，面板会把许可证显示为 Active，并给出激活日期，以及在设备限制下，你的设备已用了多少、上限是多少。服务器没有返回上限时，面板显示 —，不会编造一个数字。还没有密钥？点面板里的获取 MXterm Pro，或查看价格。

如果某次在线检查把这台电脑上的 Pro 取走，面板会说明原因：已退款、许可证被吊销、密钥不再有效，或这台电脑因其席位转给了另一台而被移出许可证。重新输入密钥即可拿回一个席位。

停用设备会腾出这台电脑的席位，让你能在别处使用。它会先询问（停用此设备？ / 这将释放你许可证上该设备的名额，以便在另一台电脑上激活。此设备上的 Pro 功能将停止。），确认后，在通知 mxterm.net 期间显示正在释放名额…，完成后显示此设备的名额已释放。你可以在另一台电脑上激活许可证。

这个分类是 另一台 MXterm 上的分屏 的主机端：让其他设备查看你选定的分屏，你允许的话还能在里面输入。它会作为独立的一屏占满整个设置对话框，标题是远程访问与已配对设备，带有返回箭头和三个标签页：连接、设备和高级。点侧边栏 MXterm Hosts 标题旁的齿轮可以直接打开。服务器默认不运行，要点 Start Server 才会启动，除非开启了打开 MXterm 时启动主机服务。在高级里，删除从其他设备收到的图片，保留天数默认在 7 天后删除手机、iPad 或其他电脑发到这台 Mac 的图片（可选关闭，或 1、3、7、14、30 天）。立即清理会马上执行，设置为关闭时会先询问。Control Room 历史记录和你自己的附件不会被触碰，手机粘贴到分屏的图片则始终在 24 小时后删除。

• 角标会显示服务器将使用的网络：Tailscale Mesh VPN (全球访问)、本地 Wi-Fi 网络 (仅限局域网) 或仅限此 Mac (离线)。电脑上有 Tailscale 地址时，MXterm Pro 用这个地址。只有开启了允许局域网中的设备（未加密）时，才会使用私有局域网地址（10.x、172.16 到 172.31.x 或 192.168.x），并且是在 Tailscale 之外额外使用。局域网地址和 Tailscale 地址都能连通时，局域网地址排在前面，配对二维码里也先放它。这个开关默认关闭。否则服务器停留在 127.0.0.1，只有这台电脑能访问。如果唯一可达的地址是局域网地址而开关是关的，Start Server 会拒绝启动并说明原因。服务器从不在公网地址上提供服务。
• Start Server 和 Stop Server 用来开关监听，卡片标题会写出所用网络：Host server · Tailscale、Host server · Local network 或 Host server · Local。运行时，面板显示 Bound to 加地址。端口是 6868。MXterm Pro 先尝试上次绑定的端口，再依次尝试 6868 到 6877，所以保存的地址一直有效，除非别的程序占用了该端口。这十个端口都被占用时，面板会提示。
• 在服务器控制项下面，允许局域网中的设备（未加密）默认关闭。关闭时，服务器只在 Tailscale 上监听，而 Tailscale 是加密的。开启时，服务器会在你的 Tailscale 地址上监听，也会以明文在这台电脑的每个私有局域网地址上监听，所以同一 Wi-Fi 里能看到流量的人，都能复制已配对设备的 token，并打开你共享的分屏。开启它会先让你确认，并且不会启动服务器。关闭它会停止原先在局域网上监听的服务器。早期版本会自己用局域网；现在它保持关闭，直到你允许为止。
• 旁边的允许远程绕过默认关闭。关闭时，想打开新会话的设备，即使被允许创建会话，也永远无法跳过 Agent 的权限检查。开启时，要求绕过的请求会得到绕过，这台 Mac 会显示是哪个会话以这种方式打开的。
• 配对卡片是居中的单列。最上面是 6 个字符的配对码，和倒计时放在同一个框里（5 分钟后过期）。框的末尾有两个图标按钮：复制，把配对码放进剪贴板；新代码，一个刷新图标，生成另一个。没有有效配对码时，应用会为你生成一个。主机关闭时，开关下面有一行短提示，说明可以怎样连接：开关打开后可通过局域网，并给出这台 Mac 的地址（或提醒你打开允许局域网中的设备（未加密））；也可以用 Tailscale，提示会说明是否已找到它，或如何获取。配对码下面有一行提示，说明按新代码显示二维码：二维码包含地址和配对码，供手机上的 MXterm 应用扫描，按下该按钮后才会出现。再往下是在另一台设备上要打开的每个地址，每行有路径名称，行末有一个复制按钮。登录同一个 MXterm 账号的设备也可以不用配对码直接请求配对：Mac 上会弹出 允许 / 拒绝 提示，上面的数字要和设备上显示的数字对照，点允许即完成配对。请求 90 秒后过期，其他账号的设备会被拒绝。
• 在局域网中，连接未加密，面板会警告：同一 Wi-Fi 下任何拿到 token 的人都能打开你共享的分屏。请使用你信任的网络，或者用会加密的 Tailscale。没有安装 Tailscale 时，面板提供安装 Tailscale；已安装但未连接时，面板会提示你登录。无论哪种提示，下面的链接 How to use Tailscale with MXterm Pro 都会打开 mxterm.net 上的 主机绑定哪个地址的说明。主机开着局域网访问时，MXterm Pro 的设计是用 Bonjour 公告自己，让附近的手机能找到它；这条公告不带 token，也不授予任何访问权限。
• 当前已连接列出此刻连在共享分屏上的每台设备，包括分屏、连接时间和断开连接按钮。断开连接只结束该设备在这个分屏上的会话，在你重新共享这个分屏之前不让它再进入，配对本身保留。
• 已授权的远程设备列出每台已配对的设备，包括类型（浏览器或 MXterm 应用）、配对时间和上次出现的时间。撤销会移除设备。每台设备有一个可创建新会话开关，对每台新配对的设备都是关闭的。开启后，该设备可以从自己的屏幕在这台电脑上打开新分屏。每台设备还有可管理 Control Room，默认关闭：开启后，该手机或电脑上的 MXterm 应用可以从自己的屏幕创建 Control Room、选择它的协调者、添加或移除成员，也可以删除房间（标签页的主房间不能删除）。这里同样适用 Free 套餐对房间和成员数量的限制。打开之前，手机上的 MXterm 应用会显示这台电脑上装了哪些 Agent，检测方式与设置 → Agent 相同；扫描无法确认的 Agent 仍会列出。每台设备还有隐藏所有窗格：开启后，该设备看不到这台电脑的任何分屏，也无法打开或键入任何分屏。清理超过 30 天未使用的设备可以一键移除这些过期设备。两种设备只要连续 30 天没用就会自动失效，每次使用都会重新计 30 天。你配对的 MXterm 应用在主机重启后仍保持配对：主机保存的是它的 token 的哈希，不是 token 本身。

标题栏里的地球图标无需进入设置，就能打开同样的配对码、二维码和地址。每个地址排在最前面，旁边列出它的路径（局域网或 Tailscale，两者都可达时局域网在前），行末有一个复制按钮。地址下面，配对码居中放在一个框里，带有倒计时、一个复制图标和一个新代码图标按钮。二维码一开始不显示：框下面有一行提示，说明按新代码，按下后二维码就出现在框的下面。没有配对码时应用会为你生成一个。用键盘打开菜单后按 Enter 不会切换总开关；请先用方向键或 Tab 移动。点菜单外的任何位置都会关闭菜单。还没有可用路径时，菜单会给出 Tailscale 的下一步：未安装时是下载 Tailscale，已安装但没开时是打开 Tailscale，另有一个工作原理链接。Tailscale 连上后，菜单会这样说明；如果还没有其他设备，会请你在手机上用同一个账户登录 Tailscale。Cloudflare WARP 卡片只在 WARP 真的拦住 Tailscale 时才出现在菜单里。

设置与主机里还可能出现一张卡片。Cloudflare WARP 卡片只在安装了 WARP 时显示（或在另一个 VPN 接管所有流量时发出警告）。WARP 可能会拦住 Tailscale，而 Tailscale 仍显示已连接；卡片上的开关会把它们需要的地址加进 WARP 的排除列表，关闭开关时只移除它加的那些。

默认不共享任何内容。你从分屏标题栏的地球图标开始共享。选择控制（已配对设备可以查看和输入，同一时间只有一台设备）或仅查看（不能输入），再选时长：30 分钟、1 小时、8 小时，或直到你停止共享。若要改为共享主窗口的所有分屏，请在标题栏的地球图标里开启共享所有窗格，它在主机服务运行时才会显示。先在这一行的双段开关里选好控制或查看，并从它的下拉菜单里选好时长（1 小时、4 小时、8 小时或直到关闭）；这两个选择都会被记住。首次使用时是查看 1 小时，选择控制只需点一下，不用确认。开启期间新打开的分屏也会一并共享，到截止时间共享会自动结束，关闭开关只会取消由它共享的那些分屏。开启期间，这一行会显示此刻共享了多少个分屏，也计入你手动共享的分屏。Free 套餐对同时共享分屏数的限制仍然适用，菜单会说明有多少个分屏未能共享。

在 Free 套餐上，默认可以有 1 台其他电脑配对来控制这台电脑，并且最多同时共享 5 个分屏。手机上的 MXterm App（iPhone、iPad）和浏览器都不计入“1 台其他电脑可控制这台 Mac”的上限，只有运行 MXterm 的其他电脑才会计入。配对码下方有一行提示，例如Free 版：控制这台电脑的其他电脑 1/1 台。手机和平板不受限制。，达到限制后会出现升级按钮。超出限制的新电脑在配对时会被拒绝，从配对请求里允许一台新电脑会打开升级提示。共享第六个分屏也会打开升级提示。两项限制都不会移除已经存在的配对或共享。mxterm.net 可以调整这些数字。Pro 对两项都没有限制。参见定价。

主机在截止时间结束共享，在两种模式之间切换时剩余时间不变。分屏处于共享状态时，标题栏按钮（仅查看时是一只眼睛）会显示剩余时间（共享有截止时间的话）和已连接的设备数。MXterm Pro 的设计是在重启后，待每个分屏重新运行时恢复共享。参见 另一台 MXterm 上的分屏。

• 手机通知目前尚未推出。这里描述的是它的设计行为，上线时只会更改状态。
• Mac 端有一个开关，当代理需要我或完成时通知我的手机，在设置 → 远程访问与设备 → 高级里。它默认关闭，并且需要你登录 MXterm 账户。关闭时，Mac 不会发送任何内容。iPhone 应用尚未注册这些通知，所以目前没有手机会收到任何内容。
• 有 Agent 需要你时，以及 Agent 完成时，你都会收到通知。
• 你在这台 Mac 前时，Mac 不会发送任何内容。连续 2 分钟没有键盘或鼠标输入，就算离开。第一个开关下面还有第二个开关，我在这台电脑前时也通知我的其他设备，默认关闭；开启后即使你在 Mac 前也会收到通知，比如用来测试。它只在第一个开关开启时才起作用。
• 通知里只有 Agent、文件夹、分屏和它所在标签页的名称，Agent 完成时还有它工作了多久，绝不包含终端文本、提示词、命令或路径。分屏名称是你给它起的名称，没起名则用 Agent 的名称；程序在终端里设置的标题从不发送。它还可以带上一行简短的话，内容是某个 Agent 提出的问题（仅限普通问题，权限请求绝不带；最多 120 个字符；链接、文件路径、电子邮件地址和密钥会在你的 Mac 上被删除，提到密码、token 或密钥的行不会发送）。开启手机通知后，这一行默认开启；可在“设置 → 远程访问与设备 → 高级”中关闭，开关就在手机通知开关旁边。这些名称和这一行会经过 MXterm 的服务器和 Apple 到达你的锁屏，MXterm 不会保存它们。如果是普通问题（权限提示除外），还可以带上该问题的 ID，这样手机就能回答它。
• 遇到权限请求时，横幅可以提供批准和拒绝，且手机不能处于锁定状态。iOS 会限制应用关闭时能运行的操作，所以操作可能要等到你打开应用才执行。
• 你可以选择哪些事件、哪些电脑，以及哪些安静时段。
• 所有套餐都免费。先从 iPhone 开始，Apple Watch 会同步显示横幅。
• 通知通过 Apple 的推送服务发送。关于 mxterm.net 保存哪些数据，见隐私政策。

无人值守访问是远程访问与设备里的一张卡片，用于没人坐在电脑前时访问这台电脑。它有两个开关，每个开关下面都会说明当前的状态。

• 打开 MXterm 时启动主机服务默认关闭。开启后，MXterm Pro 每次启动都会启动主机服务。再配合通用里的开机时启动，电脑重启后就能再次被访问。每个分屏回来后，共享会恢复，所以重启本身不会结束共享。
• 在分屏共享时保持此 Mac 唤醒默认开启（Windows 上是在分屏共享时保持此电脑唤醒）。主机服务运行且至少有一个分屏处于共享状态时，它会阻止空闲休眠。屏幕仍然可以关闭。

MXterm 打开时如果网络还没起来，会在 5 秒后重试启动，然后 10 秒后，之后每 15 秒一次。如果 5 分钟后仍然没有网络，或启动一直失败，就会放弃，卡片会说明原因。点击 Start Server 或 Stop Server，或者关掉开关，都会结束重试。

如果上次是在 Tailscale 上启动的，这 5 分钟里它会等待 Tailscale，而不是用局域网地址启动。当允许局域网中的设备关闭时，它绝不会在局域网上启动：5 分钟内 Tailscale 仍未连上，卡片会显示未启动服务器：5 分钟内 Tailscale 仍未连接，且局域网访问已关闭。开关打开时，才会在时间到了之后改用局域网地址。

只有同时满足三个条件，电脑才会被保持唤醒：服务器在运行、至少有一个分屏处于共享状态、开关是开的。MXterm Pro 每 15 秒检查一次，共享、服务器或开关变化时也会检查，所以共享中的分屏被关闭后，电脑约 15 秒内就能再次休眠。

这只能阻止空闲休眠，阻止不了你自己造成的休眠，比如合上笔记本盖子（使用电池的 Mac 合盖后仍会休眠）。如果系统拒绝，卡片会显示系统拒绝保持机器唤醒：加上原因。

访问密码卡片让新设备可以用密码配对，不必再照着这块屏幕输入配对码。用这种方式配对的设备有自己的 token，可以在已授权的远程设备下撤销，和用配对码时完全一样。密码的权限不会超过配对码。它默认关闭。

密码在 Tailscale 上可用；在你允许时，在局域网上也可用，此时它是未加密的。它从不会在这台 Mac 自己的本机回环地址上被接受。服务器停止，或只在 127.0.0.1 上监听时，卡片会说明为什么现在密码无法配对任何设备。

输入至少 6 个字符的密码，点输入框右侧的保存，或点旁边的骰子按钮（生成）得到随机口令短语。密码开启期间，卡片上会显示绿色的已开启标识，点更改密码会打开同样的输入框和这两个按钮。生成的密码只显示一次，之后无法再显示。它以 Argon2id 哈希存放在系统凭据存储中（macOS 上是 Keychain），不会写进文件。修改密码不会让已配对的设备退出登录。

密码开启期间，标题栏会显示一个钥匙图标：临时模式是绿色，悬停时显示剩余时间；长期模式和即将到期的临时模式是琥珀色。点击它会打开远程访问与设备。密码关闭时不显示。

主机会限制猜密码。同一地址猜错 3 次后，之后每次猜错都会把该地址锁定更久，从 5 秒开始，每次翻倍，最长 15 分钟。此外，所有地址合计每 10 分钟最多允许 20 次猜错。

下面三个操作在危险区域里，它是卡片中居中的标题，点击展开。关闭（保留设备）是绿色的：它让密码不再配对新设备，已用它配对的设备保持配对。让所有设备退出登录会撤销每个已配对的浏览器和 MXterm 应用，并断开它们在所有分屏上的连接，密码保持不变。关闭并让所有设备退出登录两件事都做。关闭类操作只在密码开启时显示。每一项都会要求你确认。

要用这个密码配对另一台 MXterm，请打开它的 MXterm Hosts 部分。添加主机的表单和重新配对对话框都提供配对码和密码两种方式。选密码，用这台电脑的 Tailscale 地址（100.x.y.z）配对才是加密的，并让两台机器都保持 Tailscale 运行；局域网地址也行，但不加密。错误提示不会说明是密码错了，还是主机没有开启密码。

我的设备连接到登录同一个 MXterm 账户的另一台 Mac，无需配对码和密码。它需要已登录的账户和 Pro。未登录时，它会先请你登录，并提供一个账户按钮。在 Free 上，它显示“我的设备”是 Pro 功能和升级到 Pro。

否则它会列出你账户上受信任的其他设备，带一个刷新按钮。每一行显示设备名称，连接后带一个已链接角标，另有可创建新会话开关、一个地址输入框和一个连接按钮，链接后还有一个打开按钮。输入另一台 Mac 的主机地址，例如 http://192.168.1.50:6868，然后点击连接。没有其他设备时，面板显示暂无其他受信任设备：在另一台 Mac 上登录同一个账户，等它把这台反向链接后，就会出现。

1.0.22 起，使用情况上报从更新与关于移到了单独的隐私分类，同时新增了生成支持文件的功能。

分享匿名使用数据默认开启，仅适用于正式发布版。每次启动时，它会向 Google Analytics 发送一次 app_open 事件，内容是应用版本和你的操作系统，这次运行的其余时间不再向 Google Analytics 发送任何内容：没有重复发送的心跳。每天一次，发送版本、Free 或 Pro、操作系统版本、CPU 类型、启动次数、上次运行是否崩溃，以及升级提示显示和被点击的次数。出现故障时，发送它属于一份固定的已知故障列表中的哪一种，并附上原因代码。所有这些都带有一个与你无关联的随机 ID。它从不发送终端输出、文件路径、SSH 主机或用户名，也不发送许可证密钥。关掉开关即可停止上报。完整的发送内容见 Telemetry。

同一个开关还控制使用次数统计：每天一次，随每日上报一起，应用会发送你使用了哪些功能的计数和范围，从不发送你输入或打开的内容。完整列表见 Telemetry。关闭开关会停止新的使用情况上报，使用次数统计会保留 400 天。

你也可以在应用之外关闭它，这对为别人配置的机器很有用。启动 MXterm Pro 时，把 DO_NOT_TRACK 或 MXTERM_TELEMETRY_DISABLED 设为任意非空值，但不能是 0、false 或 no。环境变量优先于开关：此时开关会变灰，并标注已被 … 关闭，后面写出变量名。

技术支持诊断文件卡片会生成一个随支持请求一起发送的文件：应用信息和最近的错误，已去除敏感信息。在你发送之前不会上传任何内容：先在此查看。从 MXterm Pro 1.1.74 起，发送给 MXterm 会把反馈打开为一份缺陷报告，并已勾选此文件；在那里点发送之前不会发出任何内容。点预览会在面板里显示文件的文本，带有复制和发送邮件给支持团队按钮，所以在保存或发送任何内容之前你都能先读一遍。保存文件…会打开保存对话框，默认提供桌面上的 mxterm-diagnostics-YYYY-MM-DD.json，随后提供在 Finder 中显示（Windows 上是在文件资源管理器中显示）和发送邮件给支持团队。

• 它包含应用版本、是正式版还是开发版、运行时间、你的套餐和语言、你的操作系统及其版本和处理器、遥测是否开启、上次运行是否崩溃、已保存的 SSH 主机、标签页和分屏的数量、你用了哪些 Agent、配置了哪些 Token Meter 提供商，以及来自本地 14 天列表的近期故障。
• 你的主目录写成 ~，每条故障只保留形如标识符的值。
• 它从不包含终端输出、命令、文件路径、主机名、许可证密钥或邮箱地址。
• 写入前会先检查生成的文件。如果其中有任何内容没通过隐私检查，就不会保存，面板会告诉你是哪条规则拦下了它。

反馈是你给 MXterm 团队发消息的方式。先选类型：建议（一个想法或意见）、改进功能（功能能用，但可以更好）或报告缺陷。然后写下你的消息并点发送（更早的版本显示的是撰写邮件，见下文）。

从 MXterm Pro 1.1.57 起（Mac；Windows 和 Linux 为 1.1.58），点发送会把消息发送到 mxterm.net：你的姓名、邮箱和消息，类型，应用版本、你的操作系统和应用语言；只有你勾选时才会附上诊断文件（保留 90 天）。内容由我们的邮件服务提供商处理，每小时最多发送 3 次。如果发送失败，应用会提示改用你的邮件应用。

在更早的版本中，你的邮件应用会打开一封写给 support@mxterm.net 的邮件。主题注明类型，比如 [MXterm 1.1.31] Bug report；另外两种是 Suggestion 和 Feature improvement。正文是空的，下方有一小段页脚，包含 MXterm Pro 版本、你的操作系统和应用语言。

在这些版本中，MXterm Pro 自己不会发送任何内容：只有你在邮件应用里点发送，邮件才会发出。改用联系页面会打开 mxterm.net 上的联系页面。报告缺陷时，面板建议附上诊断文件，打开隐私设置会带你到技术支持诊断文件。

应用在启动 5 秒后检查 mxterm.net 上是否有新版本，之后每 4 小时检查一次。

有更新时，侧边栏底部、设置下方会出现 Update to vX.Y.Z 按钮。点它开始下载。下载时显示 Downloading… 和百分比，然后变成 Restart to update。下载失败时变成 Retry update，错误信息在它的提示里。窗口左下角还有一张小卡片，在更新就绪时提示，并用一句话说明更新后你的标签页和对话会重新打开。如果还有分屏在运行，会有一行说明有多少个，并建议等它们完成后再更新；重启确实会结束正在运行的命令。点 × 可以关闭它（下载时不行）；有更新的版本时它会再次出现。更新与关于里的预览会用一个示例版本显示这张卡片：按钮只是模拟，不会下载任何内容，应用也不会重启。

想自己检查，可以点更新与关于里的检查更新，或者在菜单栏（Windows 上是系统托盘）里 MXterm Pro 图标的菜单中选检查更新…。面板会显示你的版本和构建号，例如 v1.1.31 · build 2573，以及是否已是最新。检查失败时会显示检查更新失败：加上原因，下载失败时会显示下载失败：加上原因，而不是显示成已是最新。有新版本时，会显示发行说明和下载并安装，下载完成后显示重启以应用。查看更新日志会显示更新程序做了什么。

只有一个发布渠道，无法更改。这个分类还包含开源许可证，即 MXterm Pro 所用库的列表。