本地优先的多智能体任务账本工具,支持跨会话持久化、项目池路由与协作,适合复杂多步骤工作流管理
说明:
## 核心功能
HZL 是一款专为 AI Agent 设计的本地优先任务账本系统,通过 `hzl` CLI 提供多步骤工作规划、进度检查点和跨会话持久化能力。其核心定位是填补 OpenClaw 缺乏原生任务追踪的空白,支持单 Agent 项目管理和多 Agent 池路由两种模式。
### 主要特性
**任务层级与状态管理**:支持项目→父任务→子任务三级结构,内置 `backlog → ready → in_progress → done → blocked` 完整状态流转,支持依赖关系和最大一层嵌套。
**多 Agent 协调机制**:通过项目池(pool routing)实现角色级任务分配——省略 `–agent` 参数时任务进入公共池,任何监控该池的 Agent 均可认领;指定 `–agent` 则实现专属路由。结合 `–lease` 租约机制防止任务孤儿,支持 `task steal` 回收过期任务。
**会话恢复与检查点**:`checkpoint` 命令记录关键进度快照,配合 `workflow run start` 实现跨会话无缝恢复。推荐在工具调用前、子 Agent 派生前、暂停前等关键节点打点。
**工作流命令(v2+)**:`handoff` 实现原子化任务交接,`delegate` 支持带依赖关系的子任务委派并可暂停父任务,简化多 Agent 协作流程。
### 显著优点
– **本地优先架构**:数据自主可控,支持可选的 Turso/LibSQL 云同步
– **明确的协作契约**:租约、依赖、状态机提供清晰的 Agent 间协作语义
– **灵活的路由策略**:单共享项目或多项目池模式适配不同团队规模
– **丰富的可观测性**:`agent status`、`task stuck`、`events` NDJSON 流、内置 Web Dashboard
### 潜在局限
– **无自动编排**:不自动派生 Agent 或分解任务,需外部编排层驱动
– **简单调度策略**:仅支持优先级+FIFO,无智能负载均衡
– **钩子延迟**:`on_done` 通知通过 cron 轮询(2-5分钟),非实时推送
– **嵌套限制**:子任务仅支持单层,复杂层级需扁平化处理
### 适用场景
适合需要「精确断点续作」的多步骤项目、跨 Agent 工作交接、长期运行可能中断的任务编排。不适合即时单步任务、时间提醒或长文知识库管理。
### 风险提示
`hzl init –force` 和 `–yes` 组合会**无确认删除全部数据**;`task prune –yes` 永久清除历史记录,无回滚机制。建议生产环境配合定期备份。








