# 启动与 Python 安装引导模板

这些模板供技能生成最终 Python 项目时使用。根据实际版本、入口和日志策略调整后交付。

最终系统必须生成：

- Windows：`start_windows.bat`、`scripts/install_python_windows.ps1`
- macOS：`start_macos.command`、`start_macos.sh`、`scripts/install_python_macos.sh`
- 运行时配置：`config/python-runtime.json`
- 依赖助手：`scripts/dependency_plan.py`、`scripts/install_dependencies.py`
- 离线准备：`scripts/prepare_offline_dependencies.py`
- 启动自检：`scripts/preflight_check.py`

启动闭环：

1. 自动定位项目目录并检查 Python 3.10+；
2. 缺少 Python 时读取固定运行时配置；
3. 仅从 `https://www.python.org/` 获取固定版本安装包，验证 SHA-256 和 Python Software Foundation 数字签名；
4. Windows 优先当前用户安装，组织策略阻止且配置允许时显示 UAC；macOS 显示系统管理员授权窗口；
5. 用户拒绝授权或安装失败时停止，不修改数据库；
6. 创建项目内 `.venv`，按 requirements 指纹准备依赖；
7. 合格 `wheels/` 存在时优先离线安装，随后执行 `pip check`；
8. 执行只读启动前自检，再启动 Waitress 服务。

安全要求：

- 不绕过 UAC、Gatekeeper、系统完整性保护或执行策略；
- 不静默提权、不保存管理员密码、不使用 `sudo -S`；
- 安装配置中的 URL 和 SHA-256 必须在生成系统时替换为真实官方发布值，保留占位符不得交付；
- 无网络时只能使用已验证的对应平台官方安装包或预先准备的运行时；
- 支持中文、空格和非 ASCII 路径；
- 不写死用户名、IP 或第三方下载站；
- 失败显示稳定错误码、中文原因、日志位置和解决步骤。
