前言¶
在 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 倉庫 或 社區目錄。
