环境准备

在使用 OSDK CLI 或集成 SDK 之前，请确保你的开发环境满足以下要求。

基础环境

• Node.js: >= 18
• 包管理器: pnpm >= 8 (或 npm)
• 网络访问: 可访问 Loambase Foundry 后端（例如 https://tenant-1.loambase.com）

创建 Personal Access Token (PAT)

调用 API 和使用 CLI 需要个人访问令牌进行认证：

1. 打开你的租户控制台（例如 https://tenant-1.loambase.com），使用你的账号（如 GitHub）登录。
2. 点击左下角用户头像 → 基本设置 → 个人访问令牌 → 新建令牌。
3. 复制生成的 token。该 token 将用于 CLI 初始化或 SDK 的 authToken 配置中。

配置优先级说明

在整个 OSDK 工具链中，认证信息按以下优先级生效（从高到低）：

1. 命令行参数：--base-url、--token、--workspace-id
2. 环境变量：VITE_DEV_API_TOKEN、VITE_DEV_API_BASE_URL、VITE_DEV_WORKSPACE_ID (或加载自当前目录的 .env.development)
3. 全局 profile 配置文件：
   • ~/.loambase/config.json：base-url、workspace 等常规配置
   • ~/.loambase/credentials.json：token 等敏感凭据