Prhub

#2564 release: bump miles version to 0.1.0

原始 PR 作者 yueming-yuan 合并时间 2026-08-15 11:39 文件变更 1 提交数 1 评论 0 代码增减 +1 / -1

执行摘要

miles 版本号重置为 0.1.0,启动首次发布流程

PR body 说明:0.2.x 编号继承自 slime,miles 名下从未发布过任何版本,因此没有顺序冲突,v0.1.0 是 miles 版本线的正式起点。release-tag.yml 的 tag gate 会校验 setup.py 中的版本号是否为 0.1.0,本 PR 正是为通过该门禁提供前置条件,是首次发布的 Release step ①。

不值得精读,但适合快速浏览以了解发布流水线设计:版本号被 release-tag.yml 的 tag gate 直接校验,体现了 CI 门禁驱动的发布策略。管理人员可借此确认首次发布链路完整性,工程师无需关注代码细节。

讨论亮点

无实质代码评审讨论:Zhichenzzz 与 nblintao 直接批准,claude[bot] 仅发送"手动 review 模式"的自动提示。版本号重置没有引发争议或设计权衡。

实现拆解

整个变更只涉及一步:

  1. 版本号重置:修改 setup.py 中 setup() 调用的 version 字段,由 0.2.1 改为 0.1.0。文件其余部分(bdist_wheel 自定义 wheel 类、platform tag 推导、依赖与 extras 声明)保持不变。
  2. 无配套改动:没有对应的测试、配置或部署变更;版本号由 CI 工作流直接消费,无需额外配套。
  3. 发布链路衔接:本 PR 合并后,后续 release-branch-cut.yml 创建 release/v0.1.0 分支并冻结锁文件,release-tag.yml 在 release-ci 状态通过后打标签并产出镜像,tag gate 校验的正是本次写入的 0.1.0。
文件 模块 状态 重要度
setup.py 打包配置 modified 4.03

关键源码片段

setup.py configuration

唯一变更文件,version 字段由 0.2.1 重置为 0.1.0,是首次发布流水线的门禁输入。

# setup.py —— 项目打包配置入口
# miles 的首次正式发布版本线从 0.1.0 开始;
# 此前的 0.2.1 是继承自 slime 的历史编号,miles 名下从未发布过setup(
    author="miles Team",
    name="miles",
    # 版本号是发布流水线的门禁输入:
    # release-tag.yml 在打 v0.1.0 标签前会校验 setup.py 中的版本号
    version="0.1.0",
    packages=find_packages(include=["miles*", "miles_plugins*"]),
    include_package_data=True,
    package_data={"miles.dashboard": ["static/*"]},
    install_requires=_fetch_requirements("requirements.txt"),
    extras_require={
        "fsdp": ["torch>=2.0"],
        "mlflow": ["mlflow>=2.0"],
        # dashboard 依赖用于独立离线 serving,训练镜像已自带 sglang
        "dashboard": ["fastapi>=0.135", "uvicorn>=0.41", "prometheus_client>=0.24"],
    },
    python_requires=">=3.10",
    cmdclass={"bdist_wheel": bdist_wheel},
)

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险极低:

1) 若仓库内脚本或依赖解析硬编码 0.2.x 区间,版本号重置可能带来混淆,仓库内未发现此类引用;
2) 发布链路存在顺序依赖,本 PR 是 release-branch-cut.yml 与 release-tag.yml 的前提,合并后需及时跟进后续动作;
3) PR body 确认 0.2.x 从未作为 miles 发布,不存在 PyPI 或镜像仓库的版本冲突。

用户侧:后续通过 pip 或 radixark/miles 镜像获取的 miles 将以 0.1.0 为第一个版本;系统侧:解锁 release-branch-cut.yml 分支裁剪与 release-tag.yml 打标签流程,产出 v0.1.0 与 v0.1.0-cu12 镜像;团队侧:miles 结束对 slime 版本号的继承,建立独立版本线。

发布门禁前置

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论