本地密钥设置

1. 用 Finder 在自己的用户目录新建文件夹，例如 xkapi-test，用代码编辑器打开它。
2. 在编辑器里新建文件，命名为 .env，粘贴下面的内容，再替换 Key 和模型占位符。文件名不要变成 .env.txt。
3. .env 是放在本人电脑的配置文件；不要上传，也不要截图展示真实内容。

# .env：替换占位符；真实密钥只放在本地文件里。
XKAPI_API_KEY='替换成你的完整Key'
XKAPI_BASE_URL='https://cdn.api.inxk.com/v1'
XKAPI_MODEL='YOUR_MODEL_ID'

同一文件夹新建 .gitignore，填入下面的规则。如果已有这个文件，就追加规则，不要覆盖原内容：

# 不提交本地密钥、虚拟环境和依赖。
.env
.env.*
.venv/
node_modules/
__pycache__/
# 可以提交只含假值的配置模板。
!.env.example

Mac 在终端输入 cd （后面有空格），把 Finder 中的 xkapi-test 文件夹拖到终端，再按回车。然后运行：

# 只加载你本人创建、信任的 .env；source 会执行文件内容。
set -a
source .env
set +a
# 只检查是否有值，绝不打印 Key。
if [ -n "$XKAPI_API_KEY" ]; then echo "密钥已载入"; else echo "请检查 .env"; fi

✅ 本节完成检查点

• [ ] 已完成本页操作，真实 Key 没有写进代码或提交到 GitHub。