企业官网建设流程全解析

• 开发工具
• 构建工具
• CLI
• 包管理器

WinPython 3.11.3.1 是面向 Windows 平台的便携式 Python 发行版，随附 Python 3.11.3 运行时、Node.js 等独立工具以及约 600 个预编译 Python 包，覆盖科学计算、机器学习、Web 开发、Jupyter 生态等主流领域。本篇以官方 changelog 文档为骨架，逐层拆解该版本的工具与包构成，并深入仓库源码揭示这份包索引的自动生成、版本比对与归档机制，帮助读者既会用、也能读懂 WinPython 发行版的"体检报告"。

版本总览：3.11.3.1 是什么

WinPython-64bit-3.11.3.1是一个 64 位 WinPython 发行版的包索引文档，位于 changelogs/WinPython-64bit-3.11.3.1.md。它回答了一个核心问题：这个发行版里到底装了哪些东西、各是什么版本。

文档正文以两个 Markdown 表格清单构成：

• Tools（独立工具）：3 项，均为非 Python 的外部工具；
• Python packages（Python 包）：以 Python 3.11.3 本体为首，共约 630 个预编译包，每条记录含包名、版本号、一行描述。

与之配套的 changelogs/WinPython-64bit-3.11.3.1_History.md 则记录了该版本相对上一版 3.11.3.0 的变更：toolz由 0.11.2 升级到 0.12.0，winpython（发行版自带工具集，含 WPPM）由 6.1.20230518 升级到 6.1.20230527。也就是说，3.11.3.1 是一次以"随发行版工具链更新"为主的维护性发布。

说明：WinPython 是一个面向 Windows 的便携式 Python 发行版（详见 README.rst），本仓库托管的是其工具链与构建体系（含 WPPM 包管理器），changelog 目录则是每个构建产出的"发行版包索引"档案。

随附工具（Tools）：Node.js、npm 与 Pandoc

这三项工具并非 Python 包，而是随发行版一起打包的独立可执行程序。它们的实战价值在于：

• Node.js + npm：支撑 JupyterLab、ipywidgets 等前端组件生态，以及前端构建类工作流；
• Pandoc：与pypandoc、nbconvert配合，可在 Markdown / reStructuredText / HTML / PDF 等格式之间转换文档，是科学写作与 notebook 导出链路上的关键一环。

从源码看，工具清单与 Python 包清单在生成时被分门别类地收集。在 wppm/wppm.py 的get_package_index_data中，返回的数据结构显式分为tools、packages、wheelhouse三组记录；wppm/diff.py 也定义了### Tools、### Python packages、### WheelHouse packages三类分区头。这解释了为什么 changelog 文档严格按"工具 / Python 包"分区排版。

Python 运行时与核心科学计算栈

Python 3.11.3 本体

winpython包本身也随发行版分发——这正是 README.rst 提到的 WinPython Package Manager（WPPM），用于浏览已安装包、从随附 Wheelhouse 安装包或注册 WinPython。

数值计算与数据处理

数据存储与格式

机器学习与深度学习栈

经典机器学习

深度学习与 AI 框架

自然语言处理

数据可视化与交互应用

地理空间（GIS）与地球科学

Web 开发、数据库与异步生态

Web 框架与 HTTP

数据库与 ORM

异步与并发

Jupyter 交互计算生态

开发工程与质量工具

GUI 与桌面科学计算

安全、认证与常用工具库

changelog 文档的格式规范：它是"机器可读"的

这份包索引不只是给人看的，其结构经过精心设计，可以被仓库的 diff 工具直接解析。从 wppm/wppm.py 的generate_package_index_markdown可以看到标准模板：

## WinPython 3.11.3.1 The following packages are included in WinPython-64bit v3.11.3.1 . ### Tools Name | Version | Description -----|---------|------------ [Nodejs](https://nodejs.org) | v18.16.0 | ... ### Python packages Name | Version | Description -----|---------|------------ [Python](http://www.python.org/) | 3.11.3 | ...

解析端在 wppm/diff.py：Package类用正则\[([\w\-\:\/\.\_]+)\]\(([^)]+)\) \| ([^\|]*) \| ([^\|]*)匹配每一行"名称链接 | 版本 | 描述"；PackageIndex类识别### Tools、### Python packages、### WheelHouse packages三个分区头，并跳过表头、分隔行与<details>等装饰行。文件名WinPython-64bit-3.11.3.1.md的命名规则在 winpython/build_winpython.py 中由WinPython{flavor}-{arch}bit-{version}.md拼出，其中版本号可携带b1、rc1等 release level（PEP 440 版本），保证 beta 与正式版的索引不会互相覆盖。

这份 changelog 是怎么生成的：构建管线 Step 7

在 winpython/build_winpython.py 的构建流程中，第 7 步专门负责生成 changelog，实际调用链为：

1. 调用wppm.Distribution().generate_package_index_markdown()，枚举发行版内安装的工具与 Python 包（含 wheelhouse），渲染成上文的标准 Markdown 包索引；
2. 将生成的WinPython{flavor}-{arch}bit-{version}.md复制到changelogs/目录归档；
3. 调用wppm.diff.compare_package_indexes(version, searchdir=changelogs_dir, flavor, arch)生成_History.md——它从changelogs/中定位上一个版本（wppm/diff.py 的find_previous_version依据文件名解析 PEP 440 版本并取"最近的更早版本"），逐分区比对两版包索引，输出新增/升级/移除三类变更。

这也是 changelogs/WinPython-64bit-3.11.3.1_History.md 中toolz 0.11.2 → 0.12.0、winpython 6.1.20230518 → 6.1.20230527这两条"Upgraded packages"的来源——compare_packages会按-/_归一化包名并对比版本号（wppm/diff.py）。

值得注意的细节：对于 2026 周期起的新构建，仓库策略已调整为不再把_History.md归档进changelogs/——相关注释与 tests/test_changelog_files.py 明确说明，历史文件对比的是"相邻上一版"，但发行版 flavor 时常增减、用户大约每年才升级一次，这种固定链式对比价值有限；需要对比时，读者应自己用wppm -diff挑选两个索引。这也解释了为何历史较新的 changelog 目录里只有.md索引文件。

如何自己读取与对比包索引

随发行版分发的winpython包（即 WPPM）提供了两条直接可用的命令（见 wppm/wppm.py 的参数定义）：

# 以 Markdown 形式输出当前安装的包索引（相当于在本地重新生成一份 changelog） wppm -md # 对比两个包索引文件，输出新增/升级/移除 wppm -diff WinPython-64bit-3.11.3.0.md WinPython-64bit-3.11.3.1.md

wppm -md走的就是与构建管线相同的generate_package_index_markdown；-diff支持full（全分区）、section（指定分区）与pairs（分区配对）三种模式（wppm/diff.py）。此外wppm -ls pand可按表达式列出已安装包，wppm -lsa pandas -l1可查看包依赖细节。

若只想按 WinPython 发行版等同的 wheel 集合安装包，README.rst 提供了基于 hash 校验的安装方式：pip install --require-hashes配合随版本发布的requir.*.txt文件即可。

小结

• 3.11.3.1 的内容构成：Python 3.11.3 + Node.js v18.16.0/npm 9.5.1/Pandoc 2.3 三项工具 + 约 600 个预编译 Python 包，覆盖 numpy/scipy/pandas 科学计算栈、PyTorch 2.0.1 深度学习栈、Jupyter 生态、Web/数据库/异步库与地理科学工具。
• 相对 3.11.3.0 的变更：toolz与winpython（发行版工具集）两个包升级，是一次维护性发布。
• 格式与机制：changelog 是"结构化、可解析"的包索引，由构建管线 Step 7 自动生成并归档，版本命名遵循 PEP 440 语义，历史差异由wppm/diff按"最近的更早版本"自动比对产生。

读者可基于 changelogs/WinPython-64bit-3.11.3.1.md 直接核对任何包是否包含及具体版本；深入 wppm/wppm.py、wppm/diff.py 与 winpython/build_winpython.py 则可完全掌握索引生成与比对的实现原理。

• 开发工具
• 构建工具
• CLI
• 包管理器