从社区版迁移到企业版

MinT 社区版与企业版共享同一套 SDK 与 API，代码可以零成本迁移。迁移本质上只是切换端点与 Key，训练脚本无需改动。

迁移的三个差别

列出社区版与企业版的差别，从迁移视角看有三条与代码相关：

1. 接入端点：社区版是公共 mint.macaron.xin；企业版是专属集群（公有云 / 私有化）。
2. API Key：企业版 Key 通过对接会议获取，与社区版自助申请的 Key 不通用。
3. 可用底座：企业版额外可用 GLM / Kimi / DeepSeek 等商业模型（详见支持的模型）。

其它一切（SDK 包名、模块路径、方法签名、数据结构、训练循环范式）保持一致。

迁移步骤

1. 确认 SDK 版本

企业版与社区版共用 mindlab-toolkit：

pip install --upgrade git+https://github.com/MindLab-Research/mindlab-toolkit.git
python -c "import mint; print(mint.__version__)"

2. 切换端点与 Key

把客户端的环境变量指向企业版的地址（大陆区仍用 mint-cn；私有化部署使用 Mind Lab 交付时给的域名）：

# 社区版（旧）
# export MINT_BASE_URL=https://mint.macaron.xin/
# export MINT_API_KEY=sk-community-...

# 企业版（新）
export MINT_BASE_URL=https://<your-enterprise-endpoint>/
export MINT_API_KEY=sk-enterprise-...
export TINKER_BASE_URL=$MINT_BASE_URL
export TINKER_API_KEY=$MINT_API_KEY

更详细的凭证管理见配置与管理 API Key。

3.（可选）切换到企业版专属底座

社区版脚本里如果硬编码了 Qwen/Qwen3-...，企业版上直接可用。想升级到企业版独有的商业模型，改一个字符串即可：

training_client = service.create_lora_training_client(
    base_model="GLM-5.1",        # 企业版专属
    rank=16,
)

迁移完成自检清单

• python -c "import mint; print(mint.__version__)" 输出非空。
• MINT_BASE_URL 指向企业租户端点，可通过curl -v验证 TCP 通路。
• MINT_API_KEY 是企业版 Key（sk- 开头）。
• 原 SFT 脚本在企业版上首跑能拿到 ServiceClient 无异常、forward_backward 返回 future 正常。