---
## 🎯 项目介绍
AutoDL Remote 的目标很直接：**Claude Code 或 Codex 在本地写代码，远端 GPU 机器负责运行代码；需要什么文件，就显式上传或下载什么文件。**
做 LLM、深度学习、论文复现实验时，模型权重、数据集、checkpoint 往往都在 AutoDL 这类远端 GPU 环境里。本地电脑不适合下载大模型，直接在远端安装和登录 Claude Code 或 Codex 又容易遇到代理、浏览器登录、环境配置等问题。
这个插件选择更简单的路线：远端不需要安装 daemon，不需要运行服务，只要能 SSH 登录即可。Claude Code 或 Codex 仍然在本地工作，本地保留代码修改痕迹和 Git diff；远端负责执行训练、推理和查看日志。
> **一句话理解：** AutoDL Remote 不是同步框架，而是给 Claude Code 和 Codex 用的一组 SSH 原语。
## ✨ What You Get
| 能力 | 说明 |
| --- | --- |
| 🔐 SSH 账号管理 | 支持保存多个远端账号，项目里只引用账号名，不写密码 |
| 📁 项目绑定 | 当前本地目录绑定到一个具体远端目录，例如 `/root/autodl-tmp/my-project` |
| 🖥️ 远端命令 | 用 `exec` 在远端运行训练、推理、环境检查等命令 |
| ⬆️ 显式上传 | 用 `put` 或 `sync-up` 把本地改过的文件送到远端 |
| ⬇️ 显式下载 | 用 `get` 或 `sync-down` 只拉回需要查看或提交的结果 |
| 📜 日志查看 | 用 `tail` 查看远端训练日志，不必下载大文件 |
| 🧾 Job 生命周期 | 用 `job status`、`job tail`、`job stop` 跟踪并停止 `exec --detach --name` 创建的长任务 |
| 🧵 tmux 后端 | 可选用 `exec --tmux` 让长任务保留远端终端 pane，方便 dashboard 展示现场输出 |
| 📊 Dashboard | 用只读页面查看多台远端设备、run 状态、最近日志或 tmux pane 输出 |
| 🧠 脚本执行 | 用 `exec --script` 或 `exec --stdin` 避免复杂 quoting |
| ⏻ 远端关机 | 用 `shutdown` 处理 AutoDL 关机和 SSH 断开返回码 |
| 📝 项目约定 | 首次使用自动生成 `.autodl-remote/CONVENTIONS.md` 记录远端约定 |
| 🧩 Agent 友好 | 插件不替你判断同步策略，把决策权留给用户和 coding agent |
## 🆕 0.9.0：标准 MCP 工具
- 插件现在同时提供现有 `autodl-remote` CLI 和 13 个聚合 MCP 工具；MCP 只是安全、结构化的入口，底层 SSH 行为仍由同一套 CLI 实现。
- 常用账号、项目、文件、传输、执行、job/run、fleet、tmux、dashboard 和 shutdown 操作都可由模型直接调用。
- 命令参数以 argv 数组传递，不经过本地 shell；输出统一包含退出码、stdout/stderr、截断标记和耗时。
- 上传镜像删除、停止任务、杀 tmux、安装 tmux、危险命令放行和关机都要求明确确认；密码录入、交互 shell、持续 follow/watch 仍只保留在 CLI。
## 0.8.1 修复
- 新增 `job stop` / `run stop`，停止 detach 作业的整个进程组，并保留已完成作业的原始退出状态。
- 防止活跃同名 job 覆盖；需要替换时使用显式 `--replace`。
- 修复 detach 命令参数引用、尾随 `job tail --lines` 解析，以及死 runner 的 `lost` 状态归一化。
## 🆕 0.8.0 更新
这版重点补上了多机训练时最需要的“现场感”：
- 新增可选 `tmux` 后端：长任务可以用 `exec --tmux --name 
