destructive_command_guard 依赖升级实战:从 Cargo.lock 兼容更新到破坏性版本迁移的完整记录
destructive_command_guard 依赖升级实战:从 Cargo.lock 兼容更新到破坏性版本迁移的完整记录
依赖升级是 Rust 项目日常维护中最容易"翻车"、也最容易被忽视的环节:cargo update 与 cargo upgrade 只差一步,但破坏性(breaking)变更往往隐藏在看似无害的版本号背后——toom 的 Deserializer::new() 突然返回 Result、sha2 的 digest 类型从 GenericArray 换成 hybrid_array::Array、rand 0.10 连 trait 名都改了。本文以开源仓库 destructive_command_guard(下称 dcg)的依赖升级日志 docs/planning/UPGRADE_LOG.md 为骨架,完整还原三轮依赖升级的全过程:从 82 个传递依赖的语义化兼容更新,到 13 个破坏性版本迁移,再到对已弃用 crate 的处置决策,并结合当前仓库源码逐一印证每个改动点的真实落地情况。读完本文,你将掌握一套可复制的 Rust 依赖升级方法论:如何分层升级、如何处理 API 破坏、如何用 clippy 与测试守住质量底线。
一、项目背景:为什么一个安全钩子项目对依赖升级如此敏感
dcg 是一个用 Rust 编写的 AI 编码 Agent 钩子,核心职责是在危险命令真正执行前将其拦截(详见 README.md 与 src/lib.rs)。这个定位决定了它的依赖栈有两个鲜明特征:
- 启动延迟敏感:钩子进程是一次性运行的(one-shot process),每次被 Agent 调用都要冷启动并完成整条命令的评估,任何依赖升级带来的编译期或运行期性能回退都会被放大。
- 安全语义敏感:依赖中的
unsafe代码面、序列化行为(如toml的解析结果变化)都会直接影响命令解析的正确性,进而影响拦截决策的可靠性。
因此,dcg 的升级策略非常谨慎:先跑通语义化兼容更新,再把破坏性升级拆成一笔一笔单独做,每一笔都用完整测试集 + clippy + 格式化检查验证。这正是 docs/planning/UPGRADE_LOG.md 记录的核心方法论。
当前仓库的 rust-toolchain.toml 还揭示了一个关键前提:项目固定使用 nightly 工具链(nightly-2026-08-31,含 rustfmt 与 clippy 组件),并明确解释了固定原因——裸 nightly 曾因 rustix 1.1.4 的工具链回归导致 Windows 之外的从源码构建失败。这意味着升级日志中提到的 "MSRV"(最低支持 Rust 版本)约束与 nightly 特性门槛,都必须在这个工具链前提下理解。
二、升级总览:一次典型的"兼容先行、破坏分批"升级节奏
升级日志在开篇给出了一次完整升级的统计快照:
| 指标 | 数值 |
|---|---|
| 更新(Cargo.toml 版本提升) | 12 |
| Cargo.lock 语义化兼容更新 | 82 |
| 跳过(Skipped) | 3 |
| 失败(Failed) | 0 |
| 需要关注(Needs attention) | 1 |
| 测试通过数 | 1935 / 1935 |
这个结构本身就是一套方法论模板:先做不改变版本约束的 cargo update(82 个传递依赖),再做显式改 Cargo.toml 的破坏性升级(12 个),对无法升级或不应升级的(3 个)明确记录理由,对存在隐患的(1 个,serde_yaml 弃用)单独挂起跟踪。零失败的结果不是运气,而是每一步都伴随完整验证的结果。
三、Phase 1:cargo update 语义化兼容更新
第一阶段的策略最简单也最安全:在现有版本约束范围内拉取最新的兼容版本,仅更新 Cargo.lock,不改任何 Cargo.toml 依赖声明。
日志记录的关键更新包括:
- clap
4.5.54 → 4.5.60 - regex
1.12.2 → 1.12.3 - memchr
2.7.6 → 2.8.0 - rust-mcp-sdk
0.8.2 → 0.8.3 - tokio(传递依赖)
- tree-sitter
0.26.3 → 0.26.5
这 82 个传递依赖的更新完成后,全部 1935 个测试通过。从当前 Cargo.toml 可以看到这些更新的延续结果:clap 已到 4.5+、regex 为 1.10+、memchr 为 2.8,tokio 为 1.52——语义化兼容更新允许仓库在相当长时间内保持小步前进,而不必频繁触碰 API 面。
工程启示:cargo update 是零风险(或极低风险)的"安全区",适合作为升级周期的第一步,先把传递依赖水位整体抬高,为后续破坏性升级扫清潜在的版本冲突。
四、Phase 2:12 个破坏性版本升级逐个拆解
第二阶段是重头戏。日志逐 crate 记录了破坏性变更、代码改动与测试结果。本节按日志顺序展开,并结合源码印证。
4.1 rust-mcp-sdk:0.8.1 → 0.8.3(补丁级,无破坏)
这是一个 patch 版本升级,实际已在 cargo update 阶段解决,无破坏性变更,测试通过。rust-mcp-sdk 是 dcg 的 MCP(Model Context Protocol)服务器实现依赖,当前仓库已进一步演进到 1.0.1(见 Cargo.toml),并在 src/mcp.rs 中对外暴露 check_command、scan_file、explain_pattern 三个工具。
4.2 fancy-regex:0.14 → 0.17(新特性,无破坏)
破坏性变更:无。新特性包括 split()、splitn() 和 RegexBuilder 选项。当前 Cargo.toml 中 fancy-regex 已为 0.19,继续沿用同一兼容路线。
4.3 colored:2.1 → 3.1(MSRV 提升)
破坏性变更:MSRV 提升到 1.80+(项目使用 nightly,无影响);内部移除了 lazy_static。代码改动:无。测试通过。当前版本为 3.1(见 Cargo.toml),colored 承担终端彩色输出的职责。
4.4 dirs:5.0 → 6.0(维护性发布)
破坏性变更:无,完整 API 兼容。代码改动:无。测试通过。当前为 6.0(Cargo.toml),用于解析用户目录等路径,这与项目对 Windows 用户临时目录、HOME 重定向等场景的处理直接相关。
4.5 console:0.15 → 0.16(引入 std feature)
破坏性变更:引入了 std feature flag(默认启用)。代码改动:无。测试通过。console 与 indicatif、inquire 共同构成 dcg TUI/CLI 视觉层(Cargo.toml 注释将其标记为 "TUI/CLI visual polish dependencies")。当前为 0.16(具体到 0.16.3)。
4.6 indicatif:0.17 → 0.18(跟随 console)
破坏性变更:依赖 console 0.16;number_prefix 切换为 unit-prefix。代码改动:无。测试通过。当前为 0.18(Cargo.toml),用于进度条显示。
4.7 inquire:0.7 → 0.9(RenderConfig 变为 Copy)
破坏性变更:RenderConfig 现在实现 Copy;底层切换 bitflags v2;MSRV 1.82+。代码改动:无(项目未直接触碰 RenderConfig)。测试通过。当前为 0.9(Cargo.toml),用于交互式提示。
4.8 toml:0.8 → 1.0(1.0 里程碑)
破坏性变更:Deserializer::new() 现在返回 Result;Value 的 FromStr 行为改变。代码改动:无——项目所有使用点都是 toml::from_str 与 to_string_pretty 这类不变接口。测试通过。这条记录的价值在于:即使 crate 跨入 1.0 主版本,只要使用面恰好落在稳定 API 上,就能零改动迁移。当前 Cargo.toml 中 toml 为 1.0,且在 src/allowlist.rs 等位置持续使用 toml::from_str 解析配置。
4.9 toml_edit:0.22 → 0.25(内部类型变化)
破坏性变更:InternalString 被移除;Time 字段被 Option 包裹;table 位置信息变化。代码改动:无——项目使用面是 DocumentMut、Table、value()、ArrayOfTables 等编辑 API。测试通过。当前为 0.25(Cargo.toml),其保留格式编辑的能力对 dcg 修改 TOML 配置(如 allowlist)至关重要。
4.10 rusqlite:0.35 → 0.38(类型转换行为收紧)
破坏性变更:u64/usize 的 ToSql/FromSql 转换行为变化;statement 缓存变为可选;最低 SQLite 版本提升到 3.34.1。代码改动:无——项目使用 bundled SQLite 且不使用 u64/usize 转换。测试通过。rusqlite 服务于 dcg 的历史遥测(history telemetry),当前已进一步演进到 0.40.1(Cargo.toml,bundled 特性),对应 src/history/ 目录的实现。
4.11 rand:0.8 → 0.10(本次升级中改动量最大的一个)
rand 0.10 是一次 API 面较大的重构,日志逐条列出:
thread_rng()→rng()gen_range()→random_range()- trait
Rng→RngExt - features 重命名:
["std", "std_rng"]→["std", "thread_rng"]
对应的代码改动落在三处:
- src/interactive.rs:
use rand::Rng→use rand::RngExt - src/interactive.rs:
rand::thread_rng()→rand::rng() - src/interactive.rs:
.gen_range()→.random_range() - Cargo.toml:features 调整为
["std", "thread_rng"]
当前源码中的实际用法完全印证了日志记录:let mut rng = rand::rng(); 配合 rng.random_range(0..CODE_CHARSET.len()),用于生成随机的短代码(short-code)字符。这是一个教科书级的"破坏性升级必须改代码"案例——trait 名都变了,任何依赖旧 API 的代码都无法编译通过,而编译错误恰恰是升级最可靠的"变更清单"。
4.12 criterion 0.5 → 0.8 与 which 7.0 → 8.0(dev-dependency)
这两个属于开发期依赖:
-
criterion 0.5 → 0.8:
criterion::black_box被弃用,迁移到std::hint::black_box。代码改动涉及两个 bench 文件:- benches/heredoc_perf.rs:切换为
use std::hint::black_box,用于 heredoc 检测的性能基准 - benches/regex_automata_comparison.rs:同样切换,用于 regex 引擎对比基准
这个细节值得注意:
std::hint::black_box自 Rust 1.66 起稳定,是标准库对criterion::black_box的官方替代,bench 代码因此减少了一个对测试框架的耦合。当前 Cargo.toml 中 criterion 为0.8,且 Cargo.toml 注册了heredoc_perf、regex_automata_comparison、codex_deny、hook_latency四个基准。 - benches/heredoc_perf.rs:切换为
-
which 7.0 → 8.0:仅有次要 API 变化,代码改动为零。which 用于 E2E 测试中定位 dcg 二进制路径,当前为
8.0(Cargo.toml)。
五、Skipped:三个"刻意不升"的依赖及其决策逻辑
升级不只是"升",更包括"不升"。日志记录了三个跳过项,每一个都有明确的工程理由:
| Crate | 状态 | 跳过理由 |
|---|---|---|
| serde_yaml 0.9 | 已弃用 | crate 官方弃用,继任者是 serde_yml 或 serde_yaml_ng,迁移需要评估替代方案,记为未来工作 |
| vergen-gix 10.0.0-beta.5 | 预发布版 | 已是最新预发布版(稳定版最高 9.1.0),留在 beta 轨道 |
| rich_rust 0.2.0 | 稳定版最新 | 已是当前最新稳定版本 |
这三个跳过项展示了两类决策:"不该升"(deprecated 需要替换而非升级)与"没法升"(已到最新)。当前 Cargo.toml 中 serde_yaml 仍为 0.9,说明该迁移至今仍在待办队列;而 vergen-gix 已推进到 10.0.0-beta.8(Cargo.toml),rich_rust 推进到 0.2.2(Cargo.toml),印证了"留在 beta 轨道持续跟进"的策略。
六、Needs Attention:serde_yaml 弃用跟踪
日志单独标记了一条"需要关注"项:serde_yaml(0.9.x)已被官方弃用,建议在未来会话中迁移到 serde_yml 或 serde_yaml_ng。
这一条的价值在于建立了升级日志与后续工作之间的闭环:弃用不是立刻删代码,而是先记录、再评估、最后在合适时机迁移。从 Cargo.toml 的注释("External pack YAML parsing")可知,serde_yaml 承担的是外部 pack 的 YAML 解析职责,替换方案需要保证与现有 pack 生态(examples/packs/example.yaml)的兼容性,因此谨慎处理是合理的。
七、验证三件套:fmt + clippy + test
每一轮升级都以同样的三件套收尾,这是质量底线:
cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test --lib # 1935/1935 passed
三者的分工清晰:fmt 保证代码风格一致;clippy 以 -D warnings 强制零警告(防止新依赖版本暴露新的 lint 问题);测试验证行为没有回归。值得注意的是,Cargo.toml 中配置了大量 clippy lint 的 allow 例外,说明项目对 clippy 的使用是"精细校准"的——保留有意义的正确性检查,同时对风格类 lint 显式豁免。
八、Round 2:内部库盘点与一次 crate 重命名迁移
8.1 内部开发库清单盘点
第二轮升级从一个完整的内部库盘点表开始,这是"自研库"与"外部依赖"双轨管理的关键:
| Crate | Cargo.toml 当前 | /dp 最新 | crates.io 最新 | 动作 |
|---|---|---|---|---|
| fsqlite | 0.1.2 | 0.1.2 | 0.1.2 | 已最新 |
| fsqlite-types | 0.1.2 | 0.1.2 | 0.1.2 | 已最新 |
| fsqlite-error | 0.1.2 | 0.1.2 | 0.1.2 | 已最新 |
| rich_rust | 0.2.0 | 0.2.1 | 0.2.1 | 升级 → 0.2.1 |
| toon-rust | 0.1.3 | 重命名为 tru 0.2.2 | toon-rust 0.1.3(陈旧)、tru 0.2.2 | 迁移 → tru 0.2.2 |
这个表格揭示了一个重要实践:即使内部库版本号没有外部压力,也要主动对照本地开发目录与 crates.io 的状态,防止"仓库里的依赖悄悄落后于内部最新版"。
8.2 rich_rust:0.2.0 → 0.2.1(补丁级 bug 修复)
无破坏性变更,是一批 bug 修复:移除 nightly-only feature gate、保留 Tree label spans、修复窄列下的 wide-char 与 gutter 溢出、clamp 交互式 max_length、LiveWriter 中的 CRLF、Python fixtures 一致性、光标定位等。代码改动为零,测试通过。当前已推进到 0.2.2(Cargo.toml),作为 rich-output 特性(默认启用)下的可选依赖,只启用 markdown 渲染器。
8.3 toon-rust 0.1.3 → tru 0.2.2:一次完整的 crate 重命名迁移
这是第二轮中最具教学价值的一笔:不仅升级版本,还迁移了 crate 名称。破坏性变更包括:
- 包名变更:
toon-rust→tru(crate lib 名保持toon) - 编码 API 变为无错:
encode(&serde_json::Value, Option<EncodeOptions>) -> Result<String>→encode(impl Into<JsonValue>, Option<EncodeOptions>) -> String(infallible) - 解码 API 重命名:
decode(...) -> Result<serde_json::Value>→try_decode(...) -> Result<JsonValue>(返回 crate 自己的 JsonValue 类型) - 数字类型有损往返:数字在 decode 时以
f64往返,整数/浮点区分会丢失
对应的代码改动:
- Cargo.toml:
toon-rust = "0.1.3"→tru = "0.2.2" - src/cli.rs:测试输出编码器从
toon_rust::encode(&json, None).expect(...)改为toon::encode(json, None);roundtrip 测试改用toon::try_decode加.into::<serde_json::Value>(),并由于新库在整数/浮点区分上有损,改为规范化比较(将 Numbers 归一为 f64)
这一笔升级展示了迁移重命名 crate 的完整心态:不仅要改包名,还要重新审视每个 API 的语义变化(encode 从可能失败变成不可能失败、decode 返回类型变化),并针对有损行为调整测试断言策略。升级完成后测试规模从 1935 提升到 2210/2210。
8.4 兼容更新与 clippy 顺带修复
第二轮同时通过 cargo update 拉取了约 60 个传递/直接依赖的更新,包括 tokio 1.49.0 → 1.52.1、clap 4.5.60 → 4.6.1、clap_complete、toml 1.0.3 → 1.1.2、toml_edit、chrono、proptest、rayon、rand 0.10.0 → 0.10.1、semver、tempfile、console、once_cell、tracing-subscriber、vergen-gix beta、which、rustls 等(详见 Cargo.lock)。
此外,日志还记录了两处被新版 nightly clippy 暴露的存量代码问题(不严格属于依赖问题,但阻塞了 cargo clippy -D warnings):
- src/heredoc.rs(引号定界符解析器):把两个
if let Some(end)块用find()上的?运算符合并 - src/packs/mod.rs(复合命令切分器):把相同的
&&/||分支合并为单一 OR 条件
这提醒我们:工具链升级也会带来新的 lint 检查,-D warnings 策略会让这类问题第一时间暴露。
九、Round 3:五个延期的大版本升级,逐个击破
第三轮标题直接点明了方法论:"Deferred major bumps — done carefully one at a time"(延期的重大升级——一次一个,谨慎处理)。五个大版本升级被一笔一笔单独消化:
9.1 sha2:0.10 → 0.11(digest 返回类型变更)
破坏性变更:Digest::finalize() 现在返回 hybrid_array::Array<u8, U32> 而非 GenericArray<u8, U32>。新的 Array 类型没有实现 LowerHex,因此 format!("{:x}", hash) 无法直接作用于 digest 输出。
代码改动:在 tests/update_rollback.rs 中改为逐字节 hex 编码:
let digest = hasher.finalize();
digest.iter().fold(String::new(), |mut s, b| {
let _ = write!(s, "{:02x}", b);
s
})
用 write!(s, "{:02x}", b) 逐字节格式化替代 format!("{:x}", digest),绕开 Array 类型不实现 LowerHex 的限制。这是典型的"类型系统迁移引发格式化 API 连带修改"。验证:update_rollback 20/20 + pending_exceptions 32/32 通过。
9.2 hmac:0.12 → 0.13(trait 归属变化)
破坏性变更:Hmac<D>::new_from_slice 从由 Mac trait 提供改为由 KeyInit trait 提供,因此需要显式 use hmac::KeyInit;。
代码改动:一行 import 调整——src/pending_exceptions.rs 从 use hmac::{Hmac, Mac}; 改为 use hmac::{Hmac, KeyInit, Mac};。验证:pending_exceptions 32/32 通过。这条记录特别有价值:同一个方法在不同版本中归属不同 trait,是 Rust 生态中极易踩坑的"隐性破坏",只有编译错误才会暴露。
9.3 ast-grep-core / ast-grep-language:0.40 → 0.42(零改动)
破坏性变更:无(对项目使用面而言——AstGrep、Pattern、SupportLang、递归 Doc/Node 遍历)。代码改动:无。验证:heredoc 130/130 + ast_matcher 79/79 通过。ast-grep 是 dcg AST 模式匹配能力的基石(Cargo.toml 中已推进到 0.45,启用 bash/python/javascript/typescript/ruby/go/php 七种 tree-sitter 语言),对应 src/ast_matcher.rs。
9.4 self_update:0.42 → 0.44(feature 联动破坏)
这是第三轮中隐藏最深的一个破坏:启用 rustls feature 不再传递性地引入 HTTP client,必须显式启用 reqwest 或 ureq 之一,否则代码引用不存在的 http_client::get 直接编译失败。
代码改动:Cargo.toml 的 features 从 <a href="https://link.gitcode.com/i/10265529f51bbd5e0c416c2dbacf7fe5" target="_blank">"rustls", ...] 改为 ["reqwest", "rustls", ...](当前已是 ["reqwest", "rustls", "github"])。验证:update 46/46 + update_rollback 20/20 通过。self_update 服务于 dcg 的自更新能力([src/update.rs),feature 联动破坏是 Cargo 生态中"默认特性越少越安全"这一原则的典型例证。
9.5 rust-mcp-sdk:0.8.3 → 0.9.0(两处 API 变更)
破坏性变更:
ToolInputSchema::new(required, properties, ...)的properties参数类型从Option<HashMap<String, Map<String, Value>>>改为Option<BTreeMap<String, Map<String, Value>>>——目的是确定性的迭代顺序(这直接影响工具 schema 输出的可复现性,对测试快照和协议稳定性都很重要)。McpServerOptions<T>新增必填字段message_observer: Option<Arc<dyn McpObserver<...>>>。
代码改动全部集中在 src/mcp.rs:
- src/mcp.rs:
tool_input_schema中用std::collections::BTreeMap::new()替代HashMap::new() - src/mcp.rs:
McpServerOptions { ... }初始化中新增message_observer: None - 移除不再使用的
use std::collections::HashMap;
日志还记录了升级后的一次真实二进制冒烟测试(而不仅是单元测试):stdio MCP 服务器握手端到端验证成功——
initialize:服务器返回 capabilities,name 为dcgtools/list:返回三个工具check_command、scan_file、explain_pattern,JSON schema 正确
当前 src/mcp.rs 源码中可以看到这三个工具的完整定义(check_command 评估命令是否符合 dcg 策略、scan_file 扫描文件、explain_pattern 按 rule_id 解释规则),印证了冒烟测试的真实性。
9.6 Round 3 验证清单:五重门禁
第三轮的验证比前两轮更严格,加入了 release 构建与端到端二进制冒烟测试:
cargo check --all-targets # Passed
cargo clippy --all-targets -- -D warnings # Passed
cargo test --lib # 2210/2210 passed
cargo build --release # Passed
# 端到端二进制冒烟测试(hook deny、hook allow、dcg test、dcg mcp-server):全部通过
这展示了升级风险随规模增加时的应对:每多升一个破坏性版本,验证层就加深一层。第三轮一口气消化了五个延期大版本,所以把验证从"三件套"升级为"五重门禁",并专门对实际二进制做了端到端冒烟。
十、从日志中提炼的 Rust 依赖升级方法论
回顾三轮升级,可以提炼出一套可复用的方法论,这也是 docs/planning/UPGRADE_LOG.md 作为一个"活文档"最重要的价值:
- 分层执行,先易后难:先
cargo update清空兼容区(Phase 1 一次 82 个),再逐笔处理破坏性升级(Phase 2 拆成 12 笔),把难度最大的延期单独排期(Round 3 五个一笔一笔做)。 - 破坏性升级"一次一个":多个破坏性版本并发升级时,错误难以归因;单独提交可以让每个失败点都精确对应到某个 crate 的某个变更。
- 编译错误即变更清单:rand 的 trait 改名、hmac 的 trait 归属变化、toml 的返回类型变化,全部由编译器强制暴露,逐条修复即可。
- 区分"升级"与"替换":serde_yaml 已弃用,正确的动作不是升级而是评估迁移;vergen-gix 在 beta 轨道上,正确动作是跟进而非强求稳定版。
- 记录 skipped 与 needs-attention:升级日志不是一次性产物,而是后续会话的输入。跳过理由、待办迁移、版本追踪都应可回溯。
- 验证随风险升级:兼容更新只需 fmt + clippy + test;大版本批量升级要加 release 构建与真实二进制冒烟测试。
- 工具链升级与依赖升级联动:新版 nightly clippy 会暴露存量代码问题(heredoc.rs、packs/mod.rs 的 lint 修复),
-D warnings是把这类隐性债务显性化的有效机制。
十一、升级之后的现状:日志与仓库的对照
升级日志记录的时间线截至 2026-04-20(Round 3),而当前仓库的 Cargo.toml 呈现的是持续演进后的状态,两者对照可以清晰看到升级策略的长期效果:
| Crate | 日志记录版本 | 当前 Cargo.toml 版本 |
|---|---|---|
| rust-mcp-sdk | 0.9.0(Round 3) | 1.0.1 |
| rusqlite | 0.38(Phase 2) | 0.40.1 |
| ast-grep-core | 0.42(Round 3) | 0.45 |
| fancy-regex | 0.17(Phase 2) | 0.19 |
| vergen-gix | 10.0.0-beta.6 | 10.0.0-beta.8 |
| rich_rust | 0.2.1(Round 2) | 0.2.2 |
| tru | 0.2.2(Round 2 迁移) | 0.2.2 |
| self_update | 0.44(Round 3) | 1.1.0 |
这说明日志中确立的分层升级节奏(兼容区小步快跑、破坏区谨慎单发)被持续执行,测试规模也从 1935(Phase 1)→ 2210(Round 2/3)稳步增长,而 Cargo.toml 中针对 regex 家族的按包优化(opt-level = 3)与针对发布体积的 opt-level = "z" + LTO + strip 配置,则提示了升级决策背后的性能考量——正如升级日志所隐含的:依赖版本不仅是"能不能编译"的问题,还直接影响钩子进程的启动延迟与分发体积。
结语
一份好的依赖升级日志,本质上是一份工程决策记录:它不只回答"升到了什么版本",更回答"为什么升、为什么不升、升的时候踩了哪些坑、用什么验证兜底"。dcg 的三轮升级日志为 Rust 项目提供了一套可直接借鉴的模板——从 82 个兼容更新的快速推进,到 12 个破坏性升级的逐笔拆解,再到内部库重命名迁移与五个延期大版本的集中攻坚,每一步都有测试、有 clippy、有端到端冒烟作为证据链。对于任何维护 Rust CLI 工具、Agent 钩子或对启动延迟敏感的项目的开发者,这份日志与其对应的仓库源码(Cargo.toml、rust-toolchain.toml、src/interactive.rs、src/mcp.rs、src/pending_exceptions.rs)都是一份值得收藏的实战参考。