FAQ
Redock 常见问题
关于设置、数据存储、语音转写、tmux 和移动端 agent 工作流的常见问题。
Codex、Claude Code 或 OpenCode 是跑在手机上吗?
Claude Code、Codex、OpenCode、Git、tmux、包管理器和项目工具运行在你的开发环境里。Redock 通过 SSH 或 Mosh 连接,并在手机上提供启动、控制和恢复这些工作的入口。
Redock 会存储哪些数据?
Redock 会保存 Host、Project、Action、终端 snippets、偏好设置和相关元数据等产品配置。它也会保留本地运行历史,例如 Run 记录和最近连接上下文,用于在 Activity 中展示最近工作。
SSH 密码、私钥和语音 API Key 存在哪里?
这些敏感信息通过 Apple Keychain 相关存储保存。SSH 密码、SSH 私钥材料和语音 API Key 不会写入普通应用数据快照。本地模式下它们保存在本机 Keychain;Pro 且开启 iCloud 同步后,可以使用同一 Apple 账号下可同步的 iCloud Keychain 项。
iCloud 同步会同步哪些内容?
开启后,Host、Project、Action、snippets、偏好设置和相关元数据等支持同步的配置可以保存到你的私有 CloudKit 数据库。最近连接和 Run 这类本地运行历史保持在当前设备,不通过 CloudKit 同步。
语音转写是怎么工作的?
语音输入是可选功能。Redock 会录音并发送给你选择的语音服务商,然后把转写结果放入可编辑的待输入区,等你确认后再发送到终端或 agent TUI。
使用 OpenAI 语音需要自己的 API Key 吗?
需要。在 My / Speech 中填写 OpenAI API Key。Redock 会把它存入 Keychain,并使用 gpt-4o-mini-transcribe、gpt-4o-transcribe 或 gpt-4o-transcribe-diarize 等转写模型。语音输入不需要配置 Assistant、Realtime、TTS 或 fine-tuning。
豆包或火山引擎语音应该填什么?
选择豆包语音提供方后,填写语音识别服务的 Resource ID,并填写火山控制台中的 APP Key。常见默认 Resource ID 是 volc.bigasr.auc_turbo。ep-... 这类 Endpoint ID 不是这里要填写的内容。
为什么 Redock 需要 Local Network 权限?
Local Network 权限用于发现同一局域网里的 SSH 设备,并在添加 Mac 或服务器时自动预填 Host 和 Port。如果不授权,也可以手动填写主机地址。
可以使用 Mosh 吗?
可以。Host 可以选择 SSH 或 Mosh。Mosh 仍然会通过 SSH 做预检查并启动 mosh-server,然后在可用时使用 UDP 承载交互式 Shell。如果 Mosh 启动路径失败且可以恢复,Redock 可以回退到标准 SSH Shell。
为什么 tmux 很重要?
手机会切换网络,App 也会进入后台。tmux 让会话和长任务留在远程主机上继续运行。Redock 提供创建、进入和恢复 tmux session 的入口,不需要每次手动输入 tmux 命令。
Action 和 Run 有什么区别?
Action 是可复用命令或 agent 入口。Quick Task 或 Background Task 会产生 Run,用来记录命令状态、输出、耗时和后台任务元数据。Run 会出现在 Activity 中,不会自动变成普通终端连接;只有你打开 live tmux session 时才会进入交互式会话。
第一次应该怎么设置?
先在同一 Wi-Fi 下通过 macOS Remote Login 或可访问的 SSH Server 跑通。基础连接成功后,推荐用 Tailscale 做更安全的日常远程访问。