beyond-local-file v0.2.2：上架 PyPI 与体验打磨

发布于 2026年5月1日

大家好！beyond-local-file 又更新了！这次 v0.2.2 版本主要做了两件事：让工具更好用和让文档更完善。

背景：PyPI 发布了，终于是个正规军了

好消息！beyond-local-file 已经正式发布到 PyPI 了，以后安装更新更方便，一行命令搞定：

uv tool install beyond-local-file

如果你更习惯于 pip 的话：

pip install beyond-local-file

顺便说一句，之前发了几个版本之后，我自己都不知道当前机器上装的是哪个版本，这次也把这个小问题解决了。

blf --version

没什么高大上的，朴实无华。

之前有个奇怪的 bug：运行 blf link check 的时候，明明符号链接指向了错误的地方，检查却显示 ✅ 一切正常。直到真正同步的时候才弹出提示，有点让人摸不着头脑。

现在这个问题修复了。检查命令会真正验证符号链接的目标路径，链接错了就是错了，一眼就能看出来。

这次把 README 重新梳理了一遍，增加了不少实用内容：

具体的使用示例：展示真实的工作流，比如同步 HTTP 客户端文件、AI agent hooks、开发环境配置等
作者本人的用法：增加了"How the author uses it"章节，看看这个工具在我日常工作中是怎么用的
对比其他工具：新增了"Why not just use X?"章节，解释清楚 beyond-local-file 和 GNU Stow、chezmoi 等工具的区别

如果你之前看过文档觉得信息不够，这次值得再看一眼。

这次还做了一次底层重构，把整个同步和检查的逻辑统一了。虽然你看不到什么新功能，但代码更清晰了，以后加新功能也会更快更稳。

最后提醒一下，之前隐藏的 symlink 子命令别名已经移除了。如果你还在用 blf symlink sync 这种写法，需要改成 blf link sync。这个变化在 v0.2.0 就通知过了，现在正式取消。

这次更新没有新增什么大功能，主要是把之前不太顺手的地方打磨了一下。版本查询、检查准确性、文档完善——都是小改进，但用起来会更顺心。

项目已经发布到 PyPI，欢迎试试！