# 管理应用环境

> 检查并修复 Astravia 内置 Node.js、Python 与包镜像配置。

Canonical page: /product/application-environment



入口：**设置 → 应用环境**。管理 Astravia 随应用提供的运行时，供 Agent 与相关命令进程使用。它们 **不会** 改写系统终端、Shell 配置或本机全局 Node/Python 安装。

## 运行时 [#运行时]

页面 **运行时** 区域显示内置：

| 运行时     | 用途（界面说明）                             |
| ------- | ------------------------------------ |
| Node.js | 运行 JavaScript / TypeScript 工具与 npm 包 |
| Python  | 运行 Python 脚本与 pip 包                  |

状态可能为已就绪 / 未就绪 / 获取中。首次使用代码类工具，或升级后运行时不可用时，使用 **获取** / **重新获取** / **重装** 修复当前应用配套版本。

验证时，在 **Astravia 会话** 中让 Agent 执行：

```bash
node --version
python --version
```

应返回版本号。系统终端里的版本可以不同，这不代表 Astravia 内置环境失败。

## 开发工具 [#开发工具]

**开发工具** 显示本机 Git 的版本和来源。Git 面板，以及 Agent 执行的 git 命令，都依赖它。

已经安装的系统 Git 优先使用。Astravia 不会用自带的 Git 盖过你的配置和凭据。没检测到时：

| 系统      | 页面上怎么做                                                                    |
| ------- | ------------------------------------------------------------------------- |
| macOS   | 点 **安装**，打开系统的「命令行开发者工具」窗口。装完后点 **重新检测**                                  |
| Windows | 点 **为 Astravia 安装**。它只在 Astravia 内生效，不改系统环境。要在终端或其他软件里也使用 Git，用旁边的链接下载安装包 |
| Linux   | 复制页上对应发行版的命令，在终端执行，然后点 **重新检测**                                           |

没装 Git 时，Git 面板不会提示去初始化仓库，而是给出同样的安装引导。

## 镜像源 [#镜像源]

| 项      | 说明                  |
| ------ | ------------------- |
| npm 仓库 | 安装 npm 包时自动注入的镜像    |
| pip 索引 | 安装 Python 包时自动注入的镜像 |

需要其它源时，在具体项目或命令中显式配置，并遵守组织网络策略。

## 限制 [#限制]

* 内置环境不包含完整本机编译工具链。需要 C/C++ 或平台 SDK 编译的原生依赖可能失败；此类项目应使用已准备好的系统开发环境或预编译包。
* **重新获取** 只修复当前 Astravia 版本配套的运行时，不会升级到应用尚未支持的新版本。
* 部分平台可能提示 **当前平台不支持** 某一运行时。