前言¶
在 DeepSeek Harness (DSH) 的生态中，插件承担着扩展模型能力的作用。对于需要执行多步骤任务或处理复杂流程的 AI 代理而言，保持上下文记忆是关键。xby-todolist 插件为大型语言模型和 AI 代理提供外部工作记忆和任务管理功能，解决代理在处理长对话或复杂任务时容易遗忘上下文或步骤的问题。
插件简介¶
xby-todolist 是由 xby-skill 维护的一个 DSH 插件，分类为“记忆”类。它为智能体提供结构化的任务管理服务，帮助代理追踪进度、管理优先级并保持工作记忆，支持复杂多步骤任务的可靠执行。
核心功能¶
插件提供以下核心能力：
- set_xby_apikey：在聊天中设置 API 密钥，该操作会自动持久化，重启进程后依然有效。
- todo_read：读取当前待办事项列表，返回任务的状态、优先级和内容。
- todo_write：创建和管理结构化任务列表，支持任务状态的实时追踪。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add github:xby_skill/xby-todolist
安装完成后，重启 dsh 进程即可生效。
典型用法¶
根据使用场景，按以下方式调用工具：
- 在对话开始时，使用
todo_read查看待办事项，确认当前进度。 - 在开始新任务前，使用
todo_read优先处理现有工作。 - 当用户提供多个任务时，使用
todo_write创建列表。 - 在完成复杂多步骤任务时，使用
todo_write追踪进度。 - 在开始工作前，将任务状态标记为
in_progress。
适用场景与注意¶
- 适用场景：主要适用于需要执行复杂多步骤任务的场景，或用户提供了多个任务指令的情况。插件能帮助代理保持上下文一致性。
- 使用注意：
todo_read不接受任何参数，输入必须为空。- 当只有一个简单任务时，不建议使用
todo_write。 - 同一时间只能有一个任务处于
in_progress状态。 - 只有完全完成任务后才将状态标记为
completed。
总结¶
通过引入外部记忆层，xby-todolist 提升了 AI 代理处理复杂任务的可信度与可靠性。插件使用 MIT 许可证，可放心在项目中集成。更多信息请查看 GitHub 仓库 或 社区目录。
