目录

• 怎么 从空白服务器到 agent 运行 skill
• • 一、先把「沙箱」到底指什么讲清楚（3 层，不要混）
  • • 本项目的沙箱契约（硬约束）
  • 二、空白服务器：从 0 到 agent 能稳定跑，5 步
  • • 步骤 1：打好底座（OS + Python + 系统依赖）
    • 步骤 2：装 Python 环境沙箱（venv）
    • 步骤 3：填 `.env`（环境变量沙箱边界）
    • 步骤 4：把 3 步流水线跑一次（冒烟测试）
    • 步骤 5：把 skill 挂到 Agent
    • • 路 A：VOC 后端 cron / sandbox 触发（本项目主用）
      • 路 B：LangChain Agent 直接调用
  • 三、「怎么保证运行」——8 条工程实践
  • • 1. 用 systemd 常驻（不要 `nohup &`）
    • 2. 用 Docker 打死依赖（推荐）
    • 3. 每次运行都在**全新 sandbox**里
    • 4. 用 Python 环境沙箱 + 锁版本
    • 5. 健康检查 + 冒烟脚本
    • 6. 结构化日志 + 告警
    • 7. 密钥不进代码，`.env` 不进 git
    • 8. LLM / 数据接口的重试和退避
  • 四、一张图：空白服务器 → agent 稳定运行的完整拓扑
  • 五、常见踩坑速查
  • 六、一句话总结