华为云 AI DevSpace 上手笔记：把云端 Agent 开发环境跑通的五个坑

最近在做华为云成长中心的积分任务，顺手把「AI DevSpace（AI 开发者空间）」完整走了一遍。它不是一个普通的在线 IDE，而是把 Agent 会话、终端和容器放在一起的云端开发环境。这篇记录完整的进入链路，以及我实际踩到的五个坑。

一、入口链路比想象的绕

成长中心任务卡「每日体验 AI DevSpace」→ AI 办公实践中心 →「前往 AI DevSpace 实践」→ devspace 落地页 →「立即进入」→ devstation，中间还要勾选两个协议。如果只停在 devspace 落地页，任务不会算完成——平台认的是 devstation 里那台容器真的被拉起来。换句话说，判断标准是「容器起来了」，不是「页面点开了」。

二、容器是临时的，三小时就回收

页面底部写得很清楚：体验版容器环境 3 小时后会释放，再次启动会创建全新容器。所以别把它当长租服务器：所有产物要立刻推到 GitCode 或下载下来。我第一次的教训是把虚拟环境装在 /root 下，容器重建后连 pip 缓存都没了。

三、只有 /root/workspace 是「正经地方」

资源管理器默认打开 /root/workspace。项目放这里，AI 会话的上下文和终端路径才对得上；放 /tmp 虽然能跑，但在会话里引用时容易被当成临时文件处理掉，还容易被清理策略带走。

四、AI Shell 是「会执行命令的对话」，不是终端

Auto 模式下它直接执行命令，Plan 模式下只给方案不执行。第一次用如果发现它「只说不做」，先检查模式，几乎都是这个原因。另外，写清楚触发条件和成功判据，比写「帮我装一下环境」有效得多，比如「装完执行 java -version，把版本号贴出来，低于 11 就重装」。

五、幂等脚本比一次性命令值钱

因为容器随时会重建，我把环境初始化写成了一段幂等 shell：先判断命令是否存在再安装，装完写一个 .ready 标记；第二次进去只跑三秒。这样即使每天开新容器，也能在一分钟内回到可用状态。

#!/usr/bin/env bash
set -e
marker=/root/workspace/.ready
[ -f "$marker" ] && exit 0
command -v node >/dev/null || sudo apt-get install -y nodejs npm
mkdir -p /root/workspace/app
echo ok > "$marker"

它能拿来干什么

• 跑 Python / Node 小服务，配合平台隧道临时对外，不占公网 IP、不开入站端口；
• 当作 Agent 的「手」：读写文件、跑测试、看日志，比纯对话可靠；
• 配合作品发布 Skill，把项目直接投递到开发者作品展览馆。

小结

DevSpace 的价值不是「一台免费机器」，而是「零配置、可抛弃、带 Agent 的实验台」。把它当宠物机养，一定会被三小时回收教做人；当牛机用，每次开新容器、跑完就扔，反而顺手。

下一篇文章会记录我用它部署一个静态小游戏、并通过隧道对外暴露的完整过程。