展开本页目录
开始前准备什么
- 下载本题完整练习包,区分待实现 starter 与作者完成 reference。
- 按README准备本题原生依赖;所有输入均为原创或明确标注的本地fixture。
- 本地练习不需要付费模型Key;真实模型调用未执行,MiniLM题另有明确实际推理说明。
- 锁定项目依赖
- 在线生成Lock
- 保存Wheel清单
- 建立全新环境
- 禁止网络安装
- 缺Wheel必失败
- 比较版本行为
原创输入、待完成starter、作者reference及实际运行产物,依README本地准备依赖。
环境要求、具体操作、产物核对与未运行范围。
1. 锁定项目依赖
练习依赖humanize和boltons两个纯Python包,项目声明固定版本。除了版本列表,还准备格式化与去重两个可核对行为。
2. 在线生成Lock
在独立项目用uv lock与uv sync建立环境,保留生成的uv.lock。锁文件描述解析结果,但离线机器仍需要对应的安装文件。
本地启动与复现
cd reference
python3 verify.py3. 保存Wheel清单
下载两份wheel到练习临时目录,并记录SHA256。准备阶段可以联网,安装阶段不能偷偷从索引补取缺失依赖。
4. 建立全新环境
另建全新虚拟环境,避免把在线环境里已有的包误认为离线安装成功。检查路径与包版本应来自新环境。
5. 禁止网络安装
使用--offline、--no-index、--no-cache和--find-links安装指定wheel。真实安装成功后运行相同行为脚本,与在线环境输出比较。
6. 缺Wheel必失败
移走必要的humanize wheel,再建立第三个空环境,重复离线安装必须失败。若仍成功,应检查是否不小心允许了索引或缓存。
7. 比较版本行为
比较两个成功环境的版本、格式化1234567和稳定去重结果。下载包保留lock与脚本,不分发venv、uv缓存或作者机器路径;跨平台wheel要单独准备。
怎样确认已经完成
- 新环境在offline/no-index/no-cache条件下用指定wheel安装成功。
- 移走必要wheel后的另一空环境明确失败,没有网络回退。
- 成功环境版本及行为相同,wheel哈希与锁定清单对应。
常见问题
AI写的Python脚本,换台机器为什么就装不起来?
需要一起固定Python范围、解析版本与适用平台的安装文件。lock本身不会凭空提供离线wheel。
没有网络还能按锁文件装出相同依赖版本吗?
可以,先准备校验过的wheel,再在新环境offline/no-index/no-cache安装。移走必要wheel必须失败,不能偷偷回网络。
哪些部分实际运行,哪些需要独立验证?
uv真实锁定安装并在全新环境offline/no-index/no-cache成功,移走必要wheel后失败,版本与行为一致。 目标AI助手账号生成、云平台部署和生产环境不在本次执行范围。




