用途：预览、创建或诊断由 uv 管理的本地 Python .venv，命令为 databricks environments setup-local。使用前须先用 databricks-core 处理 CLI、认证与 profile 选择，不得使用默认 profile；已有环境则用 databricks-execution-compute。
主要能力：先校验 CLI 版本不低于 v1.16.0（该版本引入 --no-dbconnect 与 E_PROVISION_CONFLICT），版本比较须确定性进行，不可目测。通过后用所选 profile 认证：databricks auth describe --profile <PROFILE>。确认包含 pyproject.toml、.venv、uv.lock 的项目根目录，须为全新或 uv 管理。
目标选择：只能选一个分支——集群用 --cluster-id 或 --cluster-name；无服务器用 --serverless-version；作业任务用 --job-task <JOB_ID>.<TASK_KEY>；bundle 项目用 databricks-dabs 检查，可加 --target。不得混用计算标志。
用法：先干跑预览 databricks environments setup-local --profile <PROFILE> <TARGET_ARGS> --dry-run --output json，默认普通模式，仅在用户明确不需要管理 databricks-connect 时用 --no-dbconnect。应用前确认目录可写并运行 uv --version，安装 uv 须先询问，不得静默设置 DATABRICKS_LOCALENV_AUTO_INSTALL_UV=1 或运行远程安装器。展示目标、版本、警告、plan.diff 与目录并获批准后再应用；apply 可能备份重写 pyproject.toml、安装 Python 与依赖、更新 .venv 与 uv.lock。若预览后目录、profile、目标、模式或项目文件变化，须重新干跑并再次获批。
结果处理：ok 为 true 时，bundle 的 --serverless-version 需同步更新作业 YAML 中 environments[].spec.environment_version 并校验 bundle；集群与作业任务目标跳过。ok 为 false 时按故障排查处理，诊断性改动或提交外部 issue 前须询问。无 JSON 时检查 stderr 中的 CLI、认证、目录或缓存错误。
限制：CLI 低于 v1.16.0、缺失或版本不可读时停止；dev 构建无法校验版本下限，须用户确认。无服务器版本无列表命令，未指定时询问。不得未经批准更换包管理器或手动重建 setup-local。