在 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 中构建具备任务管理能力的智能体应用的开发者。