安装与认证

Tripo Web Tools 的所有子包发布在 GitHub Packages(https://npm.pkg.github.com),安装前需配置认证。

1. 配置 npmrc

在项目根目录创建或更新 .npmrc:

@tripo3d:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

GITHUB_TOKEN 需要具备 read:packages 权限,可在 GitHub → Settings → Developer settings → Personal access tokens 生成。

团队协作

建议将 token 放入 .env 或 CI 的密钥仓库中,避免直接写入 .npmrc。

2. 安装子包

按需安装:

pnpm add @tripo3d/design @tripo3d/engine @tripo3d/auth @tripo3d/utils

3. Peer 依赖

各子包对公共运行时的要求:

包	Peer 依赖
@tripo3d/design	vue ^3.5,unocss ^66(宿主工程)
@tripo3d/engine	three ^0.183,pinia ^3,可选 vue ^3.5
@tripo3d/auth	—(通过 @tripo3d/utils 传递 dayjs)
@tripo3d/utils	—

4. 版本管理

所有子包遵循 semver。因为 auth / design / engine 都依赖 utils,升级 utils 时请同步校验。