ambleloft在 SSH 远程项目中开发
连接服务器上的项目目录，在 Ambleloft 中浏览远端文件、执行 Agent 任务，并使用集成终端检查结果。现有代码和工具链可以继续留在服务器上。
完成后：连接 SSH 项目，核对文件、Agent 命令与终端使用同一远端目录。
前置条件：可访问的 Linux SSH 服务器、账号和项目目录；服务器模式需要 Bash 与 SFTP。
本页内容
01连接前准备
准备能从本机访问的 Linux SSH 服务器、账号及项目目录。当前服务器模式要求 Bash 与 SFTP。认证支持密码、私钥和本机 SSH Agent。根据需要在服务器安装项目自身的运行与构建工具；无需安装远端 Ambleloft Agent。模型配置和任务协调仍在桌面应用中进行。
02创建 SSH 远端项目
打开「创建项目」，选择「SSH 远端项目」。填写主机 / IP、端口和 SSH 用户名，再选择认证方式并填写对应信息。点击「保存连接并测试」，首次连接时与管理员提供的信息核对服务器指纹。凭据默认仅在本次应用运行期间保留；需要时勾选「使用系统安全存储记住凭据」。
03选择服务器工作目录
连接成功后，在「工作环境」选择「服务器」，点击「浏览远端目录」。进入项目文件夹，点击「使用此目录」，填写项目名称并保存；也可以填写远端绝对路径。项目会保存连接和目录，后续文件、Agent 命令与终端使用这一目标。
04用只读任务核对连接
在这个项目中新建任务，先让 Agent 读取项目说明和目录结构。打开文件面板查看同一份 README，再打开终端执行 pwd，核对输出是已保存的远端目录。确认目标正确后再让 Agent 修改文件、运行测试，并按当前权限模式处理审批。
请先只读检查这个远端项目：读取 README 和构建配置，
列出启动与测试命令，并报告当前工作目录。
暂时不要修改文件、安装依赖或启动服务。05在文件、任务和终端间协作
文件面板支持远端浏览、预览和下载。Agent 使用远端读写、搜索和命令工具；终端直接进入项目目录。每个 Agent 命令是独立会话，终端中的 cd 或 export 不会自动传给下一次 Agent 命令。需要固定工作目录或环境变量时，在命令中明确设置。项目根目录约束文件工具访问范围，不构成 Shell 命令的隔离沙箱。
06数据与权限在哪里处理
服务器保存项目文件并执行远端命令。Agent 读取的文件和命令输出可能发送给所选模型服务；SSH 模式不意味着模型推理也在服务器上运行。SSH 凭据通过应用连接设置处理，不发送给模型。默认权限下远端写入和命令执行需要批准；选择完全访问模式前确认任务范围。本地附件目前需要自行上传到服务器。
07掉线或停止后先核实结果
应用重新启动后连接初始为未连接，可在项目连接区重新连接。意外掉线会按连接策略尝试恢复，但正在执行的命令不会自动重跑。重连后检查文件或服务实际状态，再决定是否继续；已退出的终端需要新建。手动断开会影响共用该连接的任务和终端。停止后不要仅凭客户端状态判断远端进程或业务写入一定未执行。
08认证、指纹与路径问题
认证失败时打开「连接设置」更新凭据并测试。服务器指纹变化会阻止连接，先向管理员核实变化原因。目录访问失败时检查路径、用户权限和 SFTP。若提示 SSH 功能未加载，请完全退出并重启桌面应用；源码开发重新运行 npm run dev，仅刷新窗口不足以加载桌面接口。
09与技能大师的安装流程配合
远端项目可进行需求设计和代码生成。当前创建安装入口处理本地项目内的产物，SSH 任务也不开放普通本地扩展操作。需要安装远端生成的 Skill 或扩展时，先把完整产物取回本地项目，再在本地继续检查和安装。不要把服务器路径当作本机文件路径使用。
回到本地项目完成引导创建与安装10源码预览：进入 Docker 容器
Docker 模式已完成代码和模拟测试，真实 SSH + Docker 环境验收仍待完成。使用包含该功能的源码版本并重启宿主后，在已连接项目的「工作环境」选择「Docker 容器」。搜索并双击运行中的容器，或选中后点击「进入容器」，再选择容器内目录并保存。停止的容器需要勾选显示，并明确点击「启动并进入」。
11容器依赖和恢复边界
SSH 服务器需要 Docker CLI，以及访问其本机 Docker Unix socket 的权限。容器需要 Python 3 和 /bin/bash 或 /bin/sh；应用不会自动安装依赖。高级设置可选 socket、容器用户和 Shell。项目绑定完整容器 ID；同名重建后需重新选择容器与目录并新建任务。修改目标前先结束活跃任务和终端。当前不包含镜像构建、Dev Containers、端口转发、Podman 或 Kubernetes。
12判断工作是否完成
从远端文件或 Git 差异确认改动，运行项目测试并核对输出。连接成功只证明连接建立；模拟容器测试也不能证明真实环境可用。现有 SSH 路线面向 Linux Bash / SFTP 服务器，暂不包含跳板机、多因素认证或断线后的终端进程恢复。需要这些能力时，先确认部署条件再安排任务。
检查结果与排错
连接 SSH 项目，核对文件、Agent 命令与终端使用同一远端目录。
按本页的验证步骤核对实际结果。涉及业务服务时，分别检查界面提交、工具回执与服务端记录。
打开错误代码与排错 →