@aipt/idp-setup

IDP 工程体系准入工具：解决新机器环境初始化与新项目接入。

路径请使用 $HOME 或绝对路径；不要把全角波浪号 ～ 当作 Shell 的半角 ~。

核心使用场景

1. 新电脑机器准入（每台电脑执行 1 次）

解决全局 pnpm 缓存配置、环境变量持久化与 CLI 工具链安装问题：

# 初始化全局 pnpm Store、受管配置目录，并安装全局 CLI 套件
corepack pnpm dlx @aipt/idp-setup init --root <Sources根>

# 当前打开的终端生效环境变量（后续新开终端由 Shell 自动加载）
source <Sources根>/config/idp/generated/sources.env

2. 新项目准入（进入新项目时执行 1 次）

解决项目纳管、工程规范接入、应用外部配置目录初始化与开发就绪检查：

# 进入项目目录直接运行（自动识别当前目录）
cd <项目>
idp-setup bootstrap

# 或显式指定项目路径
idp-setup bootstrap --project <项目>

3. 工具链升级

解决全局 CLI 套件版本滞后问题，一键升级到最新发布版本：

idp-setup update --root <Sources根>

4. 机器与环境诊断

排查机器配置目录是否健全、全局工具入口是否正常：

idp-setup doctor --root <Sources根>

常用命令速查

| 命令 | 解决的问题 / 使用场景 | |---|---| | idp-setup init --root <Sources根> | 机器首次准入，固化环境与工具链 | | idp-setup bootstrap [--project <项目>] | 项目准入，初始化配置与开发就绪检查 | | idp-setup update [--root <Sources根>] | 升级全局 CLI（dyyto、idp、idpctl、idp-setup）到最新版本 | | idp-setup doctor [--root <Sources根>] | 诊断机器配置根、Store 与工具链健康状态 | | idp-setup print-env [--root <Sources根>] | 打印当前受管环境变量配置内容 |