PyInfra 团队正式发布了 3.8.0 版本，这是一次重大的功能更新，包含了大量针对核心 API、操作模块、事实收集、连接器以及文档的修复与改进。同时，该项目宣布从本版本开始全面转向语义化版本管理（semver），为后续的稳定迭代奠定基础。

本次更新最值得关注的变化之一是安全性的显著提升。在 operations 模块中，开发团队扩展了对用户输入的引用机制，有效防止了命令注入攻击（#1576）。对于需要远程执行大量命令的运维场景，这一改进至关重要，能够帮助用户避免因不当输入导致的潜在风险。此外，facts.selinux.FileContext 现在能够优雅地处理缺失 SELinux 上下文的情况（#1581），而 facts.systemd 也确保在用户管理器不可用时不会报错（#1604），这些细节优化让 PyInfra 在复杂环境下的鲁棒性更强。

在功能扩展方面，PyInfra 3.8.0 引入了多项新能力。例如，facts.server 新增了 Ports 事实，可以返回所有监听端口（#1637）；operations.git.repo 增加了 depth 参数支持（#1656），方便进行浅克隆操作；operations.files 新增了 limit_rate 参数（#1681），允许限制下载带宽，以及 files.unarchive 操作（#1631），支持解压归档文件。这些新功能使得 PyInfra 在文件管理、版本控制、网络操作等场景中更加灵活。

Docker 相关操作也得到了强化：operations.docker 新增了额外参数支持（#1593）以及自定义命令功能（#1625），让容器管理更加细致。对于包管理器，facts.apt.AptSources 现在支持 deb822 格式（#1465），facts.{yum,dnf,zypper} 则为每个仓库条目添加了 filename 字段（#1684），便于识别来源。此外，operations.server.reboot 修复了在 askpass 清理过程中 SSH 会话意外死亡的问题（#1665），并优化了 BSD rc.d 服务的调度优先级（#1685）。

连接器层面，PyInfra 3.8.0 修复了 SSH 配置文件注释解析错误（#1574），并利用 gevent.subprocess 实现了对 macOS 和 Python 3.13 的兼容（#1653）。同时，askpass 生成错误现在会明确显示（#1628），而 ProxyJump 场景下的 ConnectTimeout 也能被正确遵守（#1679），这些改进让远程连接更加稳定可靠。

文档方面，团队不仅修复了多个文档生成脚本的问题，还更新了 Python 版本要求说明，并将文档构建集成到 CI 流程中（#1614）。对于 Openwrt 用户，文档特别注明了从 opkg 向 apk 的迁移注意事项（#1595）。

PyInfra 3.8.0 的发布，标志着该项目在成熟度和功能完备性上迈出了重要一步。无论是对于系统管理员、DevOps 工程师，还是对自动化运维感兴趣的开发者，这个版本都值得升级体验。完整的更新日志和下载链接可在 GitHub 发布页找到。