应为测试与正式环境分别创建独立项目空间并生成专属API密钥，通过环境变量和方舟CLI按项目绑定密钥实现完全隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在火山引擎方舟平台中，让测试环境和正式环境使用完全隔离的API密钥，避免测试调用误刷正式配额、密钥泄露波及生产系统、或权限混用导致越权访问。
创建独立项目空间
登录火山引擎控制台 → 进入「项目管理」→ 点击「新建项目」。
为测试环境单独命名，例如 【ark-test-dev】；为正式环境单独命名，例如 【ark-prod-live】。两个项目名称必须语义清晰、不可重叠，这是后续所有隔离的前提。
项目创建后，立即在左下角切换至该新项目空间——后续所有密钥操作都必须在此项目上下文中进行，否则密钥将绑定到默认项目，失去隔离意义。
分项目生成专属API Key
方法一：控制台手动创建（推荐用于初期验证）
在 ark-test-dev 项目空间内 → 左侧导航进入「API Key 管理」→ 点击「创建API Key」→ 名称填写为 test-ci-bot-v1 → 创建完成，立即复制并安全保存 Access Key ID 和 Secret Key。
切换至 ark-prod-live 项目空间 → 同样路径创建新 Key → 名称必须区别于测试环境，例如 prod-app-gateway-2026q4 → 创建后同样复制保存。
注意：两个Key的Secret Key绝不可复用，且不能在控制台页面长期停留——Secret Key仅显示一次，关闭页面即无法再次查看，务必在弹出后立刻复制。
配置环境变量实现运行时隔离
第一步：在本地开发机或CI/CD节点上，为不同环境设置专用环境变量前缀
测试环境执行：export VOLC_ARK_TEST_ACCESS_KEY_ID=AKLTxxx && export VOLC_ARK_TEST_SECRET_KEY=SKLTxxx
正式环境执行：export VOLC_ARK_PROD_ACCESS_KEY_ID=AKLTyyy && export VOLC_ARK_PROD_SECRET_KEY=SKLTyyy
第二步：在应用代码中按需加载对应变量，例如 Python 中：
if os.getenv("ENV") == "prod":
ak = os.getenv("VOLC_ARK_PROD_ACCESS_KEY_ID")
sk = os.getenv("VOLC_ARK_PROD_SECRET_KEY")
else:
ak = os.getenv("VOLC_ARK_TEST_ACCESS_KEY_ID")
sk = os.getenv("VOLC_ARK_TEST_SECRET_KEY")
这一步不做硬编码，不写死字符串，全部走环境变量注入——哪怕只部署一次，也必须通过变量名区分环境，否则上线即失效。
用方舟CLI绑定指定项目密钥
方舟CLI 默认读取全局 ~/.volc/credentials 文件，但支持按项目覆盖：
① 在测试环境目录下执行：ark-cli login --access-key-id AKLTxxx --secret-key SKLTxxx --project ark-test-dev
② 在正式环境目录下执行：ark-cli login --access-key-id AKLTyyy --secret-key SKLTyyy --project ark-prod-live
执行后，CLI 会在当前目录生成 .ark/config.json，其中明确记录 project 字段值。后续所有 ark-cli deploy 或 ark-cli invoke 命令，都会强制使用该目录下配置的项目与密钥，不会跨目录污染。
这个机制比全局配置更可靠，特别适合多团队协作场景——开发者无需担心自己本地的全局密钥被他人误用。
