帮助与常见问题
上手 TermBuddy 所需的一切，以及我们最常被问到的问题。
快速上手
1. 添加服务器
打开 TermBuddy，点“添加服务器”，填入服务器地址、SSH 端口和用户名，选择密码或 SSH 密钥。只需这些，TermBuddy 会通过 SSH 连接并自动在服务器上安装它的小助手程序。
2. 创建 Buddy
Buddy 是服务器上的一个持久会话，以聊天形式呈现。可以创建终端 Buddy（像发消息一样执行命令），或 AI Buddy（在你指定的项目目录里运行 Claude Code / Codex / Gemini）。
3. 开始对话
发送命令或指令，输出会像回复一样流回来。随时可以关掉 App，长任务在服务器上继续运行，完成后你会收到推送通知。
常见问题
TermBuddy 到底是什么？
TermBuddy 把远程服务器变成 iPhone 和 Mac 上的聊天会话。终端和 AI 编程助手（Claude Code、Codex、Gemini CLI）都成为可以“发消息”的 Buddy。会话保存在服务器上，手机揣兜里工作也不中断。
安全吗？需要开放什么端口？
只需要 SSH（通常是 22 端口），也就是你本来就在用的端口。TermBuddy 安装在服务器上的助手只监听 127.0.0.1，绝不暴露到公网；所有流量都走你的 SSH 连接。凭据只保存在设备的系统钥匙串里，不经过任何第三方服务器。
服务器上需要准备什么？
一台能 SSH 登录的 Linux 或 macOS 服务器即可，无需手动配置：TermBuddy 会自动上传并配置助手程序。使用 AI Buddy 还需要在服务器上安装并登录对应的 AI CLI（如 Claude Code），服务器页面里也有引导式安装。
支持哪些 AI 助手？
Claude Code、OpenAI Codex CLI、Google Gemini CLI。AI 在你的服务器上、你指定的工作目录里运行，使用你自己的账号和计费。TermBuddy 是遥控器：计划、待办、提问和结果都以聊天消息呈现。
关掉 App 命令会停吗？
不会。会话在服务器上运行。关 App、断网、换设备都没关系，回来时完整历史都在。长任务完成或出错会推送通知。
记忆库（Experience）是什么？
一个个人知识库，包含偏好、项目笔记和踩坑经验，从 Mac 自动同步到所有服务器，供所有 AI Buddy 使用。可以一键导入已有的 Claude 记忆，还可以用“分类”功能让 AI 把所有记忆按主题整理成文件夹。
技能（Skills）是什么？
可复用的指令包（代码审查、系统化调试、TDD、数据分析、科研写作等），教 AI Buddy 把一类任务做好。在 Mac 端技能标签页开关即可，自动部署到所有服务器；当你的请求匹配时 AI 会自动采用。
Buddy 一直显示“处理中…”怎么办？
到服务器标签页查看健康状态，从那里重启 TermBuddy 助手能解决大多数问题；如果有小红点提示新版本，先更新助手。同时在服务器页面确认 AI CLI 已安装并登录。
连不上服务器怎么办？
先在其他终端用同样的地址、端口、用户名和凭据试一下普通 SSH。如果 SSH 通而 TermBuddy 不通，到服务器标签页检查健康状态，并查看服务器上的日志 ~/.termbuddy/termbuddy.log。
怎么更新？
App 本体通过 App Store 更新。服务器助手在 App 内更新：服务器标签页出现小红点表示有新版本，一键即可通过 SSH 完成更新。
你们收集什么数据？
设备直连你的服务器，中间没有任何中转。我们看不到你的凭据、命令、输出或文件。详见隐私政策。
在哪里获得支持？
发邮件到 atlai@atlai.co.uk，或使用 App 内的“发送反馈”。附上服务器日志（~/.termbuddy/termbuddy.log）的 Bug 报告尤其有帮助。