企业官网建设流程全解析

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

导读

本文以 changelogs/WinPython-3.4.4.5.md 为骨架，系统梳理 WinPython 3.4.4.5（Python 3.4.4 时代面向 Windows 的便携式科学计算发行版）内置的全部工具与 Python 包清单，对照 changelogs/WinPython-3.4.4.5_History.md 还原自 3.4.4.3 以来的新增与升级明细，并结合当前仓库源码（winpython/build_winpython.py、wppm/wppm.py、wppm/diff.py）解释这类包清单与变更历史文档是如何被自动生成的。读者读完后，既能按图索骥掌握 3.4.4.5 发行版的完整生态构成，也能理解 WinPython 发行版"包索引 → 变更对比 → 发布文档"的自动化流水线。

发行版概览：3.4.4.5 在 WinPython 版本体系中的位置

WinPython 是面向 Windows 平台的便携式 Python 发行版，其核心价值在于预编译：所有第三方包均已针对 Windows 架构编译为 wheel，开箱即用，无需本机编译工具链。3.4.4.5 是 3.4.x 系列后期的一个维护型快照，版本号3.4.4.5可拆解为：

• 3.4.4：内置 Python 版本为 3.4.4；
• .5：WinPython 发行序号（build number），表示这是基于 Python 3.4.4 的第 5 次发行快照。

整个发行包含两部分：Tools（独立于 Python 的辅助工具，本版仅 Pandoc 一项）与Python packages（约 210 个预编译包，覆盖科学计算、机器学习、可视化、Jupyter 交互、数据库、Web 开发等方向）。该清单由仓库中 wppm/wppm.py 的generate_package_index_markdown()方法按固定模板生成（详见下文"包清单文档的生成机制"一节）。

内置工具（Tools）：Pandoc 1.17.2

3.4.4.5 发行包仅捆绑一个独立工具：

该工具由t目录（tools 目录）随发行版一起打包。现代构建流程中，工具的存放目录通过 winpython_builds.toml 中每个 flavor 的toolsdirs配置指定（例如bdTools\Tools.dot、bdTools\tools64_pandoc_alone），构建时由 winpython/make.py 的copy_items()统一拷贝到发行目录的t子目录。与之配套，发行版还包含纯 Python 的pypandoc1.3.2（Pandoc 的薄封装），二者共同构成文档转换能力。

Python 包全景：按功能域划分的完整清单

下表完整继承自原文档，包名、版本、描述均以原清单为准（原文档中每个包名附带的 PyPI 等外部链接已省略，可回查 changelogs/WinPython-3.4.4.5.md 原文）。为便于检索，按功能域分组排列。

解释器、打包与发行基础设施

科学计算核心栈

机器学习、深度学习与统计建模

可视化

交互环境与 Jupyter 生态

IDE 与 GUI 工具

数据库与数据访问

Web 开发与网络

符号计算、数学与其他科学工具

文档工具链

系统、互操作与开发辅助

说明：numdifftools、pygments、mistune等少数包因功能交叉在不同分组中重复出现以方便检索，实际发行清单以 changelogs/WinPython-3.4.4.5.md 的原始顺序为准。

从 3.4.4.3 到 3.4.4.5：一次典型的小版本迭代

配套文档 changelogs/WinPython-3.4.4.5_History.md 记录了自 3.4.4.3 以来的全部变更，从中可以观察 WinPython 的维护节奏。

新增的 15 个包

新增方向清晰：强化文档转换（pypandoc、pdfrw、nbconvert-reportlab）、可视化（altair、vega）、优化与微分（scikit-optimize、numdifftools、algopy）以及交互体验（tqdm、clrmagic、heapdict、zict）。

工具升级

• Pandoc 1.13.1 → 1.17.2：通用文档转换器，跨 4 个小版本升级。

关键包升级（节选）

此外还有 bokeh 0.11.1→0.12.3、holoviews 1.6.0→1.6.2、bqplot 0.7.1→0.8.4、dask 0.10.1→0.12.0、distributed 1.11.2→1.14.0、tables 3.2.3→3.3.0、cython 0.24.1→0.25.1、xarray 0.7.2→0.8.2、zarr 1.0.0→2.1.3、requests 2.10.0→2.11.1、psutil 4.3.0→4.4.2、pyzmq 15.3.0→15.4.0、lxml 3.6.0→3.6.4、bottleneck 1.1.0→1.2.0、emcee 2.1.0→2.2.1、seaborn 0.7.1→0.8.dev0、pymongo 3.2.2→3.3.0、tornado 4.4→4.4.2、pillow 3.3.0→3.4.2、pylint 1.6.1→1.6.4 等约 70 项升级，详见 changelogs/WinPython-3.4.4.5_History.md 全文。

包清单与变更历史文档的生成机制：源码级剖析

这份 changelog 并非手工维护，而是 WinPython 构建流水线的自动产物。理解其生成机制，有助于读者自行解读任何历史版本的清单。

包索引 Markdown 的生成

winpython/build_winpython.py 的 Step 7（generate changelog逻辑，约 L312-L347）在执行时调用：

from wppm import wppm result = wppm.Distribution().generate_package_index_markdown() open(r'<build-dir>/WinPython<flavor>-<arch>bit-<version>.md', 'w', encoding='utf-8').write(result)

在 wppm/wppm.py 中，generate_package_index_markdown()（L116-L132）组装出与本文开头完全一致的结构：

return f"""## {d["name"]} {d["version"]} The following packages are included in {d["name"]}-{d["architecture_bits"]}bit v{d["version"]} {d["release_level"]}. {self.render_markdown_for_list("Tools", as_tuples(data["tools"]))} {self.render_markdown_for_list("Python packages", as_tuples(data["packages"]))} {self.render_markdown_for_list("WheelHouse packages", as_tuples(data["wheelhouse"]))} """

其中每个表格由render_markdown_for_list()（wppm/wppm.py）渲染，格式固定为Name | Version | Description三列，并按包名排序；数据来源为get_package_index_data()（wppm/wppm.py），它调用pip list --format=full枚举发行目录site-packages中实际安装的包，并附带 wheelhouse（发行附带 wheel 库）信息。因此清单内容始终与发行目录的真实安装状态一致，这是"事实准确"的结构性保证。

变更历史的自动对比

changelogs/WinPython-3.4.4.5_History.md 由 wppm/diff.py 生成。构建脚本调用：

from wppm import diff result = diff.compare_package_indexes('3.4.4.5', searchdir=r'<changelogs>', flavor='', architecture=64)

其核心流程（wppm/diff.py）：

1. find_previous_version()（L153-L160）在 changelogs 目录中按 PEP 440 版本解析，找出当前版本之前最近的同 flavor/同架构索引（3.4.4.5 的上一个版本是 3.4.4.3）；
2. compare_packages()（L61-L74）对两份索引的包名做规范化（-→_、小写）后逐项比较，划分出New / Upgraded / Removed三类，并生成old → new形式的升级行；
3. 表头写入History of changes for ... since version ...，文末追加* * *分隔符（L175-L182）。

由于文件名是版本的唯一来源，changelog_versions()（L129-L151）用正则WinPython<flavor>-<arch>bit-(.+)\.(txt|md)$匹配并交给packaging.version.parse解析，因此带b1之类 release level 的版本也能正确参与排序比较。diff.py同时支持命令行直接使用，例如wppm -diff <a>.md <b>.md或python -m wppm.diff --write-changelog <version2> <version1>手工对比任意两份索引（wppm/diff.py）。

如何构建一个类似 3.4.4.5 的发行版：现代构建流水线

虽然 3.4.4.5 是 2016 年的历史版本，但其构建模式在当前仓库中仍然延续，只是参数化程度更高。现代流程以 winpython_builds.toml 为单一事实来源：一个构建由(python_target, flavor)二元组描述，其余路径全部派生（winpython_builds.toml）：

[defaults] root_dir_for_builds = "C:\\Winp" find_links = "C:\\Winp\\packages.srcreq" arch = "64" create_installer = "None" [flavors.dot] requirements = "dot_requirements.txt" source_dirs = "packages.win-amd64" toolsdirs = "bdTools\\Tools.dot" [pythons."313"] python_target_release = "31315" release = "1" my_release_level = "b1" builds = ["dot", "slim"]

对应到 3.4.4.5 时代的构建，则是 winpython/make.py 中的WinPythonDistributionBuilder：从python-*.zip解压出基础 Python 环境（_extract_python_archive()，L94-L101）、拷贝启动器与工具目录（_copy_essential_files()，L103-L110）、写入scripts/env.ini环境配置（_create_env_config()，L112-L126）。随后 winpython/build_winpython.py 的 8 个 Step 依次执行：清理旧构建 → make.py 建基座 →pip install安装 mandatory/requirements（L281-L291）→ 打补丁使启动器可移动 → 可选并行字节编译 → 安装 wheelhouse 依赖 → 生成 pylock/requir 锁文件 → 生成 changelog → 可选创建 7-Zip 安装包。

其中--bytecode参数（winpython/build_winpython.py）控制字节码编译策略：pip（默认，pip 内联编译）、none（不生成 .pyc，用于一次性构建）、parallel/parallel-N（先--no-compile再用compileall -j多核编译）；--only-binary yes（默认）则强制只从 wheel 安装，缺失 wheel 立即失败而非在构建机上现场编译第三方代码（L233-L237）——这正是"预编译发行"承诺的落地保障。

现代视角：如何按 3.4.4.5 的思路复现包组合

如今要复现某个 WinPython 发行版的精确包组合，不再依赖手工清单，而是使用仓库提供的哈希锁文件。winpython/portable/下按构建周期（cycle_2025_04、cycle_2025_05、cycle_2026_01等）存放两类产物：

• pylock.64-3_13_7_0dot.toml：pip 锁文件（含哈希）；
• requir.64-3_13_7_0dot.txt：带 hash256 的 requirements 文本（供尚不支持 pylock 的 pip 使用）。

按 README.rst 的说明，仅安装某发行版所组装的 wheel 集合可执行：

python -m pip install --no-deps --require-hashes <requir.64-3_13_7_0dot.txt 的 URL>

若包管理器支持 pylock，则直接使用对应.toml。锁文件由构建 Step 6 自动生成：先pip freeze出实际安装清单，再用pip lock --no-deps锁定到 web 与 local 两个源并校验一致性（winpython/build_winpython.py），保证"本地 wheelhouse 能装的组合"与"公网可下载的组合"完全一致——这与 3.4.4.5 的包清单所承诺的"开箱即用、版本确定"一脉相承。

结语

WinPython 3.4.4.5 的包清单文档，看似只是一张 200+ 行的表格，实则是整个发行工程体系的可视化截面：清单由构建流水线从真实安装环境自动生成，变更历史由版本化对比自动推导，包组合由锁文件可精确复现。读者既可以把它当作 2016 年科学计算 Python 生态的"快照地图"，也可以顺着 wppm/wppm.py、wppm/diff.py 与 winpython/build_winpython.py 的源码，把"包清单 → 变更文档"这条自动化链路迁移到任何需要发布版本清单的软件项目中。

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