Agent 工作区场景 · 克隆 Git 仓库并翻译 README.md

场景目标

让 AI 把一个公开仓库的 README.md 翻译成中文。这个场景涵盖了工作区最典型的能力组合：

自动安装依赖（git）
克隆远程仓库
读取文件内容
翻译并写回新文件
导出结果

前置条件

创建好一个 Agent 工作区（英文名称，如 coding）
工作区已安装 Rootfs、处于就绪状态
一个已绑定该工作区的助手
助手使用的模型足够强（能处理翻译 + Linux 操作）

对话过程示例

第一步：下达任务

你在聊天中发送：

克隆 https://github.com/user/repo 这个仓库，然后把 README.md 翻译成中文，保存为 README.zh-CN.md。翻译要保留原始的 Markdown 格式和代码块。

第二步：AI 自动工作

AI 在后台会执行类似这样的操作：

# 1. 检查 git 是否存在，没有就安装
apt update && apt install -y git

# 2. 克隆仓库
git clone https://github.com/user/repo repo
cd repo

# 3. 确认 README 存在
ls README.md

# 4. 读取 README 内容
cat README.md

# 5. 翻译（这部分不是工作区操作，而是 AI 在对话里完成的）
# AI 读取内容 → 在对话中翻译成中文 → 写回新文件
echo "翻译后的内容..." > README.zh-CN.md

# 6. 确认文件已创建
ls -lh README.zh-CN.md

整个过程中你不需要手动操作。AI 会自己判断需要什么依赖、自己安装、自己执行。

第三步：确认结果

AI 会在对话里告诉你操作完成了。你可以：

进入工作区 → 文件管理页
找到 repo/README.zh-CN.md
导出到手机存储，或直接分享到微信 / 邮件
或者在对话里让 AI 打开文件看看翻译结果

常见问题

AI 说它克隆不了（网络问题）

Agent 工作区的网络走的是 Android 设备的网络。如果：

设备没有网络连接 → 先连上网
设备能上网但 git clone 超时 → 可能是 GitHub 在你当前网络下速度慢，可以让 AI 重试
需要走代理 → 工作区里也可以设置 HTTP_PROXY / HTTPS_PROXY

AI 翻译质量不好

这不是工作区的问题，是模型能力的问题。换一个更强的模型，或者在助手的系统提示词里加上翻译规范。

想保留原始 README 不动，同时创建新文件

在提示词里说清楚："保留原始 README.md，创建新文件 README.zh-CN.md"。AI 会遵守。

想自己手动看看工作区里发生了什么

打开终端，手动跑一遍 git clone 看看有没有问题。或者进入文件管理页直接查看文件。

进阶：让 AI 在仓库里修改多个文件

你可以下达更复杂的任务：

克隆 repo，把所有 .md 文件翻译成中文，放在 docs/zh/ 目录下。保留原始文件不动。

或：

克隆 repo，找到 README.md，给它加上一个「快速开始」章节，内容是...

AI 可以处理单文件、多文件、批量操作。能力边界取决于模型的理解能力 + 工作区的 Linux 能力组合。

把结果推回远程仓库

如果你想让 AI 把修改 push 回 GitHub：

让 AI 在工作区里配置 git user.name 和 git user.email
让 AI git add / commit / push
push 可能需要 GitHub token——可以让 AI 在 git remote set-url 里配好带 token 的 URL

push 操作有风险（覆盖远程仓库）。建议：

在一个测试仓库里先试
在提示词里说清楚你想 push 到哪个分支
如果怕误操作，可以先在工作区里完成修改后自己手动 push