Skip to content

plugin-todo-list — 任务计划

包名: @aalis/plugin-todo-list
源码: packages/plugin-todo-list/src/index.ts

概述

会话级待办事项管理工具,AI 在执行复杂任务时可创建和跟踪任务列表。配合子任务使用时,工具描述要求父会话把「创建子任务」「等待子任务完成」「整合结果」列为计划步骤,避免遗漏等待或丢失结果。

待办经 memory 服务的 metadata 接口持久化(namespace todo-list,key 为会话 ID)。memory 未装时不报错,但待办只存活于本次装载的内存缓存:插件卸载或重装即清空。

插件声明

typescript
meta.name = '@aalis/plugin-todo-list'
meta.displayName = '任务计划'
meta.subsystem = 'scheduler'
meta.inject = {}

配置

字段类型默认值说明
enabledbooleantrue启用任务计划工具

注册工具

工具说明
manage_todo_list以完整数组整体替换当前会话的待办列表(最多 50 项,标题不超过 120 字符),属于工具分组 todo

待办项状态

状态说明
not-started尚未开始
in-progress进行中(工具描述要求模型同一时间只标一项,插件本身不强制)
completed已完成

事件

事件载荷说明
todo:updated(sessionId: string, items: TodoItem[])manage_todo_list 写入或 clearTodos 清空时触发(清空时 items[]

WebUI 前端通过 WebSocket 接收 todo_updated 推送,实时显示任务进度面板。