HZL 概述
HZL 是一个本地优先（local-first）的任务账本系统，专为 AI 代理和自动化工作流设计。它通过 hzl CLI 提供完整的任务生命周期管理，核心定位是填补 OpenClaw 等环境缺乏原生任务跟踪的空白——与 Claude Code 的 TodoWrite 或 Codex 的 update_plan 不同，HZL 提供持久化、可跨会话恢复的任务状态。
核心用法
HZL 围绕四个核心概念构建：Project（项目容器）、Task（顶层工作项）、Checkpoint（进度快照）和 Lease（限时认领机制）。支持单代理简单场景（单一共享项目）和多代理池路由场景（按角色分项目）。
关键工作流包括：
- 任务创建与认领：
hzl task add创建任务，hzl task claim --next认领下一个可用任务 - 进度检查点：
hzl task checkpoint在关键里程碑记录状态，支持会话恢复 - 多代理协调：通过
--lease参数防止任务 orphaned，支持hzl task steal恢复过期任务 - 委托与交接：
hzl workflow run handoff/delegate实现原子化的任务交接（v2+） - 依赖管理：支持任务间依赖关系，
hzl dep list查询阻塞项
显著优点
1. 会话边界韧性：任务状态持久化到本地数据库，代理重启或会话中断后可精确恢复
2. 多代理安全：Lease 机制防止任务被重复认领，支持 stuck 检测和自动恢复
3. 池路由灵活：通过 project 而非 agent 分配任务，支持角色级别的水平扩展
4. 本地优先隐私：数据默认本地存储，可选同步到 Turso/libSQL
5. Web 仪表板：内置 hzl serve 提供可视化界面
潜在局限
1. 无原生编排：不自动分解任务或调度代理，需外部编排层
2. 生命周期钩子有限：仅 on_done 触发 webhook，其他事件需轮询
3. 嵌套限制：子任务仅支持一级嵌套
4. 版本依赖：workflow 命令需 HZL v2+，旧版需 fallback 模式
适合人群
- 使用 OpenClaw 等缺乏内置任务跟踪的代理框架的开发者
- 需要跨会话恢复复杂多步骤任务的 AI 工作流设计者
- 运行多代理系统的团队，需要协调 handoff 和依赖管理
- 追求本地数据主权、避免云端任务管理 SaaS 的用户
常规风险
数据破坏性操作：hzl init --force 会删除全部数据且无undo；hzl task prune --yes 永久清除已完成任务历史。必须用户显式授权方可执行。
Lease 管理：Lease 过期后任务可被其他代理 steal，需在关键操作前更新 checkpoint 和 lease。
并发冲突：多代理共享数据库时，必须使用 distinct --agent ID 并依赖 lease 避免碰撞。
Hook 延迟：on_done webhook 非即时交付，依赖 hzl hook drain 的定时轮询（2-5分钟周期）。