待办任务 liuyuguo99/dsh-task-todo

dsh-task-todo · 待办任务

在 DSH 里管理你的任务：四种视图、子任务与备注、每日/每周/每月重复，并且同一份数据对 agent 开放为工具与斜杠命令。

它做什么

侧边栏在「新建会话」和「工作区」之间多出一个「待办任务」入口，点开即用主面板里的完整任务页；再点一次同一个入口就收起、回到会话。同一份数据也是 agent 可读写的工具集。任务是全局的（不是按会话分库），所以你早上加的任务，下午在另一个会话里依然在。

| 能力 | 说明 |
| 浮窗 | 一个可拖到页面任意位置、可拉伸大小的独立小窗口，专门用来一边看会话一边盯任务清单；它只放"我该看哪些任务"的控件，视图切换与清单管理仍留在面板里。详见下一节 |
| 四种视图 | 列表（按 逾期/今天/明天/本周/以后/未安排 分组）、看板（列 = 清单，可拖拽换清单）、日历（月网格，重复任务出现在每个发生日）、甘特图（start → due 区间，可前后翻页）。切换器在左侧栏的「视图」分组里，窄宽度下自动搬到顶栏 |
| 任务详情 | 点任意任务/子任务从屏幕正中弹出卡片（Esc、点遮罩、点 ✕ 都能关），面板和全屏用的是同一个弹窗 |
| 子任务 | 任意层级，可折叠；每个子任务有自己的备注、优先级、截止时间 |
| 备注 | 任务与子任务都能写多行备注（列表里以图标标记，鼠标悬停看内容） |
| 重复 | 每天 / 每周（可指定周几）/ 每月，支持间隔（每 2 周）、结束条件（到某天 / 共 N 次）；完成一次会滚动到下一次并重置子任务 |
| 快速添加 | 一句话搞定：明天 15:00 交周报 !高 #工作 @紧要；输入框下方实时显示这次回车会创建什么（标题、截止、重复、优先级、标签、清单，清单不存在时会说明将自动创建）——识别结果来自宿主自己的解析器，所见即所得 |
| 标签 | 左栏「标签」分组列出所有用过的标签与未完成计数，点一下只看该标签；搜索框输入 #工作 是同一件事。标签可整体改名（改一次，所有任务跟着变）或清空 |
| 智能清单 | 今天 / 最近 7 天 / 已逾期 / 未安排 / 全部 / 已完成，带实时计数 |
| 清单管理 | 左栏每行一个清单：点齿轮（或选中该行后点）打开居中弹窗，可改名 / 换颜色 / 上移下移 / 删除；也能直接拖拽换位置。颜色是 8 个预设色，点一下即生效 |
| 新建清单 | 左栏「清单」分组里直接输入名字回车即建，输入框前的圆点就是它将要得到的颜色（宿主决定的，不是猜的） |
| 数据与备份 | 左侧栏「数据」分组写明数据文件叫什么、在哪儿，并给出一键 导出备份 / 导入恢复 / 复制路径 |
| 全屏 | 覆盖整个框架的全屏模式（Esc 退出，再点入口也可收起），切换不丢当前视图与筛选 |
| 侧边栏徽标 | 入口图标右上角显示待办数（口径可在设置里切换：今天 / 逾期 / 未完成） |
| 与 agent 协作 | 6 个工具 + /todo 斜杠命令 + 随包分发的技能，天然可对话操作 |

浮窗

一个可拖、可拉伸的独立小窗口，用来一边干别的、一边把任务清单摆在眼前。

- 怎么打开：面板（或全屏）头部点「⇱ 浮动」；浮动后同一位置变成「⇤ 停靠」和「✕ 关闭」，停靠就是把界面交回侧边栏面板，关闭则是收起窗口。Ctrl+K 命令面板里也有「浮动窗口 / 停靠回面板」。
它挂在框架级覆盖层上，所以不会被侧边栏或面板裁切。
- 摆放：拖头部挪位置，右下角的小三角拉伸尺寸（最小宽度 260px）。
位置与尺寸记在浏览器本地（dsh-task-todo:float:v1），下次打开还在原处——不用每次都重新摆。
- 窗口里只放三件事：顶部常驻的捕获条（和面板同一个输入框、同一份草稿与预览）、一条「浮窗栏」（智能清单页签：今天 / 最近 7 天 / 已逾期 / 未安排 / 全部 / 已完成，带计数，窄了可横向滚）、以及清单选择器（每个清单带自己的未完成数）。视图切换、搜索、清单管理、标签与数据块都留在面板里，所以这个窗口就是一份清单，不是第二个面板。
- 行在这里是紧凑形态：只有复选框 + 标题（悬停看完整标题），没有元信息胶囊、没有行尾 ＋ / ×、不展开子任务树，行高也更小。窗口只有几百像素宽时，卡片和一堆元信息会把标题挤成一个字一行。
- 它有自己的皮肤：窗口内单独重指了一层令牌——奶白表面 + 蓝色强调，连复选框的勾都是蓝的（不是面板里那个绿色）；蓝色只承担"状态"（当前页签、复选框、你所在的那一行），任务标题是窗口里唯一的重色文本，其余都退成发丝线级别的底噪。深色主题下同样成立。
- 同一份数据：浮窗、侧边栏面板、全屏、agent 的 6 个工具共用同一个数据文件与同一份界面状态，在窗口里勾完、回面板看不丢，换个座位也不丢。

界面

列表视图

| 看板 | 日历 |
| 看板 | 日历 |

| 甘特图 | 任务详情 |
| 甘特图 | 任务详情 |

| 深色列表 | 深色看板 | 深色任务详情 |
| 深色列表 | 深色看板 | 深色任务详情 |

安装

前置：已安装 DeepSeek Harness（dsh，且 dsh web 能跑起来），Node ≥ 22。

从 npm 安装（包发布后可用；当前请先 git clone 再指本地目录）
dsh plugin --profile web add dsh-task-todo

或者指到本地目录（开发形态）
dsh plugin --profile web add ""

然后重启 dsh web：bundle 层只在启动时读取。带 UI 的插件还要 Ctrl+F5 强刷一次浏览器（客户端 bundle 按包路径缓存）。

卸载：

dsh plugin --profile web remove dsh-task-todo

配置

设置 → 插件 → 待办任务：

| 项 | 默认 | 说明 |
| 启用 | 开 | 关闭后工具与界面都不工作 |
| 数据文件 | /todo/tasks.json | 留空用默认；改动会重新加载 |
| 默认清单 | 收集箱 | 新增任务未指定清单时的归属 |
| 每周起始日 | 周一 | 只影响日历视图的列顺序 |
| 侧边栏徽标 | 今天 | 今天（今天到期 + 逾期）/ 逾期 / 未完成 |

Skills

| Skill | 用途 |
| todo | 教模型如何用这 6 个工具、日期与重复约定、快速添加语法、以及哪些事不要承诺（例如提醒） |

MCP servers

无。本插件不依赖外部进程。

Tools

| 工具 | 参数 | 返回 |
| task_list | filter list query includeDone includeSubtasks today | 任务列表 + 计数 + 全部清单（含 id/颜色/顺序/任务数）+ 文本摘要 |
| task_add | title due start priority list tags note repeat repeatInterval repeatWeekdays repeatUntil repeatCount parent | 新任务 |
| task_update | id(或唯一标题) + 任意可改字段 | 更新后的任务 |
| task_done | id undone | 任务（重复任务会滚动到下一次） |
| task_delete | id | 被删除的 id（含子任务） |
| list_manage | action(list/create/update/move/delete) id(或唯一清单名) name newName color index delta | 清单（或清单列表）+ 文本摘要 |

id 也接受唯一标题；标题不唯一时会拒绝并返回候选，不会替你猜。清单同理：list_manage 接受唯一的清单名，删除只删分组、任务移到「收集箱」，系统清单「收集箱」删不掉。

斜杠命令

| 命令 | 行为 |
| /todo | 今天的概览 |
| /todo add | 快速添加 |
| /todo ls [今天\|本周\|逾期\|未安排\|全部\|已完成] | 列出任务 |
| /todo done | 完成 |
| /todo help | 语法速查 |