# PR #2564 完整报告

- 仓库：`radixark/miles`
- 标题：release: bump miles version to 0.1.0
- 合并时间：2026-08-15 11:39
- 原文链接：http://prhub.com.cn/radixark/miles/pull/2564

---

# 执行摘要

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

# 功能与动机

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

# 实现拆解

整个变更只涉及一步：

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`（模块 打包配置；类别 config；类型 configuration）: 唯一变更文件，version 字段由 0.2.1 重置为 0.1.0，是首次发布流水线的门禁输入。

关键符号：未识别

## 关键源码片段

### `setup.py`

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

```python
# 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},
)

```

# 评论区精华

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

- 暂无高价值评论线程

# 风险与影响

- 风险：风险极低：
 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 版本号的继承，建立独立版本线。
 - 风险标记：发布门禁前置

# 关联脉络

- 暂无明显关联 PR