在 DeepSeek Harness (DSH) 的開發流程中,任務管理與智能體協作往往需要切換上下文。dsh-task-todo 插件將任務管理功能集成在 DSH 界面中,並提供了一套工具與斜槓命令,讓 agent 可以直接讀寫任務數據。
核心功能¶
- 多視圖支持:提供列表(按日期分組)、看板(可拖拽)、日曆(月網格)和甘特圖(時間線)四種視圖。視圖切換在側邊欄的「視圖」分組中。
- 任務管理:支持任務詳情、子任務(可摺疊、含備註)、多行備註。支持重複(每日/每週/每月),完成一次任務會自動滾動到下一次。
- 快速添加:通過特定語法快速創建任務,例如
明天 15:00 交週報 !高 #工作 @緊要。輸入框下方會實時預覽識別結果。 - 浮窗模式:支持將任務列表以可拖拽、可調整大小的浮窗形式展示在頁面任意位置,方便在瀏覽會話時同步查看任務。
- Agent 協作:提供 6 個工具(
task_list,task_add,task_update,task_done,task_delete,list_manage)以及/todo斜槓命令,Agent 可通過對話操作任務。
安裝與配置¶
安裝前請確保已安裝 DeepSeek Harness,且 Node 版本 >= 22。
# 從 npm 安裝
dsh plugin --profile web add dsh-task-todo
# 或指向本地目錄
dsh plugin --profile web add "<插件目錄的絕對路徑>"
安裝後需重啓 dsh web 使配置生效。
插件配置位於「設置 → 插件 → 待辦任務」:
* 啓用:開關插件功能。
* 數據文件:默認爲 <DSH_HOME>/todo/tasks。
* 默認清單:未指定清單時新任務的歸屬。
* 側邊欄徽標:顯示今天/逾期/未完成的計數。
工具與命令¶
插件爲 Agent 提供了以下工具:
| 工具 | 參數 | 說明 |
|---|---|---|
task_list |
filter, list, query 等 |
獲取任務列表、計數及清單信息 |
task_add |
title, due, priority 等 |
創建新任務 |
task_update |
id, 任意可改字段 |
更新任務 |
task_done |
id, undone |
標記完成/未完成,重複任務會滾動 |
task_delete |
id |
刪除任務 |
list_manage |
action, id 等 |
管理清單(增刪改查) |
常用斜槓命令:
| 命令 | 行爲 |
|---|---|
/todo |
查看今天的概覽 |
/todo add <文本> |
快速添加任務 |
/todo ls [分組] |
列出任務(分組可選:今天/本週/逾期/未安排/全部/已完成) |
/todo done <id\|標題> |
標記完成 |
/todo help |
查看語法 |
注意事項¶
- 全局數據:任務數據是全局的,不按會話分庫,不同會話間數據互通。
- 環境依賴:需要 Node >= 22 以及
@deepseek-ai/dsh-toolspeer dependency。 - 數據存儲:數據文件位於
<DSH_HOME>/todo/tasks。 - 生效時機:修改配置後需重啓
dsh web。
該插件遵循 MIT 許可證,適合需要在 DSH 中構建具備任務管理能力的智能體應用的開發者。