用途：帮助新手安装、检查、验证或按授权更新 Python 与 pip，适用于「安装 Python」「更新 Python」「python 命令不存在」「pip 不能用」等场景。
主要能力：先只读检查 OS、架构、python3/python/py 版本、pip 模块及解释器来源，再读取 pyproject.toml、requirements.txt 或 .python-version 的项目约束；据此选择 Python 官方安装器或系统认可的包管理器。默认以 python -m pip 和项目级虚拟环境操作，不覆盖已有环境，不自动使用管理员权限。
更新策略：发现新版本只汇报；模糊的「更新 Python」仅做版本比较并等待确认；客户明确要求最新版后才沿原来源（官方安装器、Homebrew 或 pyenv）执行。pip 更新是独立动作，需单独明确授权。
使用方式：说明目标项目、操作系统和版本要求；缺失时选官方当前维护的稳定版本。安装或授权更新时按检查、计划、执行、验证与终态记录进度并展示状态表。
限制：不执行全局 pip install 到系统环境，不修改项目依赖文件，不删除旧 Python，不把第三方一键脚本作为默认方案；网络超时优先交由 soia-env-network-diagnose 处理。具体平台差异与维护版本见 official-sources.md。