Pueue v4.0.0 发布：任务队列管理工具的重大革新

Pueue 是一个现代化的任务队列管理工具，它允许用户将命令行任务排队并按顺序执行。与传统的任务队列不同，Pueue 提供了丰富的功能，如任务并行执行、任务状态监控、任务编辑等，特别适合需要管理大量后台任务的开发者使用。

近日，Pueue 发布了具有里程碑意义的 4.0.0 版本。这个版本对核心架构进行了重大重构，解决了长期存在的设计问题，并引入了多项新特性，虽然这些改进带来了向后兼容性的破坏，但显著提升了工具的可靠性和用户体验。

核心架构重构

任务状态管理的革命性改进

在之前的版本中，Pueue 通过专门的线程和通道(mpsc)来管理子进程状态。这种设计导致客户端命令(如启动任务)与实际执行之间存在延迟，即使使用--immediate标志，任务也需要几百毫秒才能开始执行。

v4.0.0 彻底重构了这一机制，现在客户端可以直接操作子进程状态，消除了所有不必要的延迟。这意味着像pueue add --immediate install_something && pueue send 0 'y\n'这样的命令组合现在可以可靠地工作，因为任务会立即开始执行。

强类型化的任务状态

新版本利用 Rust 的结构体枚举(struct enum)特性重构了任务状态表示。这种类型系统级别的改进确保了各种状态不变量的强制执行，消除了手动维护状态一致性可能导致的错误。虽然代码量增加了约25%，但彻底解决了一整类潜在问题。

值得注意的是，这一改变完全破坏了向后兼容性。升级到 v4.0.0 后，需要重启 Pueue 守护进程，原有任务状态将被清空。

用户体验提升

革命性的任务编辑体验

旧版本的任务编辑流程相当繁琐，每次只能编辑一个任务，且需要为每个属性单独打开编辑器。v4.0.0 引入了两种全新的编辑模式：

1. 文件模式：为每个任务创建临时目录，每个属性保存为单独文件，适合使用支持文件树浏览的编辑器(如helix)的用户。

2. TOML模式：将所有待编辑任务序列化为单个TOML文件，适合简单任务的快速编辑。这是默认模式，但需要注意特殊字符的转义问题。

用户可以通过client.edit_mode配置项选择偏好的编辑模式。

命令输出标准化

新版本将大部分信息和日志输出重定向到标准错误(stderr)，仅保留JSON和任务日志等有用信息输出到标准输出(stdout)。这一改变使得脚本处理Pueue输出更加可靠。

新增功能

跨平台服务支持

v4.0.0 为Windows平台添加了真正的服务支持，实现了与Unix系统一致的后台守护进程体验。同时修复了Windows上的-d守护模式问题。

环境变量管理

新增了设置和取消设置任务环境变量的子命令，为任务执行环境提供了更精细的控制。

状态压缩

引入可选的gzip状态压缩功能，可将状态文件大小缩减至原来的1/15(测试中2MB→120KB)，虽然保存时间略有增加(8ms→20ms)，但显著降低了I/O负载，特别适合嵌入式和大规模任务环境。

其他改进

• 新增NetBSD支持
• 为log、enqueue和stash命令添加--all和--group选项
• 支持按enqueue_at时间排序任务
• 回调模板新增queued_count和stashed_count变量
• 改进CLI帮助文本
• 提升错误日志的可读性

总结

Pueue v4.0.0 是一次彻底的重构和革新，虽然牺牲了向后兼容性，但带来了更可靠的任务管理、更直观的用户体验和更丰富的功能集。对于需要高效管理命令行任务的开发者来说，这次升级值得认真考虑。新用户可以直接享受这些改进，而现有用户在升级前应确保已完成所有重要任务。