【求助】请问如何添加 python 包？

[hu-qi]

[FenjuFu]

你好，根据报错截图中的 ModuleNotFoundError: No module named 'json5'，这是因为代码节点所在的运行环境（Docker 容器）中缺少 json5 依赖包

由于 Astron Agent 是基于 Docker 容器化部署的，你需要将包安装到对应的容器中。建议通过以下两种方式解决：

方法一：临时安装（立即生效，推荐测试使用）

你可以直接进入正在运行的工作流容器安装依赖。此方法无需重启服务，安装后即可重试运行，但如果删除容器（如 docker compose down），依赖会丢失。

1. 找到工作流服务的容器名称：
   在部署服务器上执行：

   docker ps | grep workflow

   通常容器名称类似于 astron-agent-core-workflow。

2. 进入容器并安装 json5：

   # 假设容器名为 astron-agent-core-workflow
   docker exec -it astron-agent-core-workflow bash

3. 激活当前 .venv 并安装依赖

   # 激活项目内置虚拟环境
   source .venv/bin/activate
   # 使用 uv 快速安装依赖
   uv pip install json5 -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 重试运行：
   回到前端页面重新点击“运行”即可，无需重启服务。

方法二：标准工程化配置（推荐，持久化生效）

为了保证生产环境的一致性，应当通过项目标准的包管理工具 uv 将依赖写入配置文件。这是最规范的做法。

1. 更新项目声明： 进入宿主机的源码目录，通过 uv 自动处理 pyproject.toml 和 uv.lock：

   cd core/workflow
   uv add json5

2. 重新构建并启动：

   docker compose up -d --build

方法三：Dockerfile 强制构建（不推荐，仅作备选）

若不希望通过 uv add 管理（例如临时引入特定版本），可直接修改 Dockerfile。

1. 编辑 core/workflow/Dockerfile，在 uv sync 执行后添加：

   RUN uv pip install json5 -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 重新构建并启动容器。