SuperAPI AI 工具集

env-config

部署与运维

查看项目

更新于 10-15 17:21

技能介绍

用途:为 Python 项目提供环境配置、密钥与密钥管理的完整指引,基于 UV(现代 Python 包与项目管理器),实现配置与代码分离、跨环境密钥安全管理和防止凭据泄露。

主要能力:用 .env 文件与环境变量管理配置;区分开发/预发/生产多环境(如 .env.development、.env.production);用模板文件共享结构而不暴露密钥;可选 cryptography 加密与 JSON 密钥加载;可选 pydantic 做类型安全校验;提供 env_helper.py 辅助脚本,可校验 .env、加解密 secrets、比较不同环境、生成 .env 模板;附带测试配置与安全审计建议。

使用方式:安装 UV 用 curl -LsSf https://astral.sh/uv/install.sh | sh,或 pip install uv;用 uv init my-project、uv venv、source .venv/bin/activate 建项目与虚拟环境;用 uv add python-dotenv cryptography pydantic 及 uv add --dev pytest pytest-env black ruff 装依赖;创建 .env.template 提交、.env 填入真实值并加入 .gitignore;编写 config.py 在启动时校验必需变量;用 uv run python main.py 运行。辅助脚本用法如 python scripts/env_helper.py validate .env、encrypt secrets.json secrets.encrypted、compare .env.development .env.production。

适用场景:新 Python 项目的配置初始化、从硬编码迁移到环境变量、多环境标准化、密钥安全审计与团队协作规范。

限制:具体依赖版本、收费、支持平台及性能表现暂未提供;加密、轮换与审计的完整实现需参考技能内的 advanced-topics.md 与 api-reference.md,本文未展开代码细节。