Mindcraft项目环境变量配置指南

环境变量配置的基本概念

在Mindcraft项目中，配置API密钥是使用各种AI服务的前提条件。传统方式是通过设置环境变量来实现，这是一种安全且灵活的配置方法。环境变量是操作系统级别的键值对，应用程序可以在运行时读取这些值而无需硬编码在代码中。

Windows系统下的配置方法

对于Windows用户，推荐使用PowerShell来设置环境变量。具体命令格式如下：

$env:变量名="你的密钥值"

例如，要设置OpenAI的API密钥，可以使用：

$env:OPENAI_API_KEY="your-actual-key-here"

这种设置方式只在当前PowerShell会话中有效，关闭后需要重新设置。如需永久设置，可以通过系统属性中的环境变量设置界面进行配置。

密钥文件配置方案

最新版本的Mindcraft项目已增加了更便捷的keys.json文件支持方案。这种方法相比环境变量有以下优势：

1. 配置更直观：所有密钥集中在一个JSON文件中
2. 管理更方便：无需记忆复杂的命令行操作
3. 持久化存储：配置一次即可长期使用

keys.json文件的使用方法

在项目根目录下创建keys.json文件，格式如下：

{
  "OPENAI_API_KEY": "your-openai-key",
  "GEMINI_API_KEY": "your-gemini-key",
  "OTHER_SERVICE_KEY": "other-key-value"
}

Mindcraft项目启动时会自动读取这个文件中的配置，优先于环境变量。这种方式特别适合开发环境和本地测试使用。

安全注意事项

无论使用哪种配置方式，都应注意以下安全准则：

1. 不要将包含真实密钥的文件提交到版本控制系统
2. 在团队协作时，通过安全渠道分享密钥
3. 定期轮换密钥以提高安全性
4. 对keys.json文件设置适当的访问权限

常见问题解决

如果在配置过程中遇到问题，可以检查以下几点：

1. 确保变量名拼写正确，大小写敏感
2. 确认密钥是否有效且未过期
3. 检查文件路径是否正确
4. 重启应用以使配置生效

通过以上方法，用户可以灵活选择适合自己使用习惯的配置方式，确保Mindcraft项目能够顺利访问所需的AI服务。