ma-task
记录别人交代的事情，并帮助你不要忘记。
开会时、IM 里、走廊上被交代一件事，三秒记下来，然后继续手上的活 —— 不用担心转头就忘。
快速上手
| 快捷键 |
作用 |
Alt+K |
随手记一条（不离开当前编辑器） |
Alt+Shift+K |
打开任务面板 |
记一条只需要：按 Alt+K → 输入 → 回车。
功能
随手记
在输入框里把标题、标签、优先级、日期一次性写完，回车即存。
把登录页的错误提示改掉 #前端 !p1 明天18:00
| 写法 |
含义 |
示例 |
#标签 |
打标签，可多个 |
#前端 #重构 |
!p0 ~ !p3 |
优先级，默认 P2 |
!p0 |
明天 后天 今天 |
相对日期 |
后天 |
周五 下周三 |
星期 |
下周三 |
9月5日 2026-09-05 9/5 |
具体日期 |
9月5日 |
18:00 18点 18点半 |
具体时间 |
18点 |
- 写日期 + 时间（如
明天18:00）→ 设为截止时间，到点算逾期
- 只写日期（如
周五）→ 设为计划日期，当天出现在「今日」，不会一早就标红逾期
存完后会提示解析结果，可立刻「编辑详情」补充信息，或「撤销」这一条。
任务面板
Alt+Shift+K 打开，左侧列表、右侧详情。
分组
默认按时间分四组：
| 分组 |
内容 |
| 逾期 |
已过截止时间 |
| 今日 |
今天到期，或计划日期已到 |
| 以后 |
更远的任务 |
| 已完成 · 近 7 天 |
最近完成的，方便写周报时回看 |
可切换为按标签或按工作区分组。
列表
每条显示优先级色点、标题、截止时间（逾期标红）、标签、备注里任务项的完成进度。
超过 14 天没动过的待办会标上「陈旧」，提醒你处理或关掉。
顶部有过滤框，可按标题、备注、标签关键字筛选。分组标题可点击折叠。
任务详情
点列表里任意一条，右侧显示详情，所有字段都能直接改：
| 字段 |
说明 |
| 状态 |
待办 / 进行中 / 已完成 / 已取消 |
| 优先级 |
P0 紧急 ~ P3 有空做 |
| 截止时间 |
精确到分钟 |
| 计划日期 |
打算哪天做 |
| 标签 |
任意个，随时增删 |
| 备注 |
Markdown，见下 |
详情顶部显示创建时间、最后更新时间、完成时间。
备注
备注区支持 Markdown，用来放对方原话、背景、以及拆好的步骤：
| 语法 |
用途 |
- [ ] / - [x] |
任务项，点方框即可勾选 |
# 标题 |
分段 |
**粗体** *斜体* |
强调 |
`代码` |
标识符、命令、路径 |
> 引用 |
贴对方原话 |
[文字](https://github.com/majj/ma-task/blob/HEAD/链接) |
链接到 IM 记录、邮件、文档 |
任务项的完成情况会汇总显示在列表行上（如 2/5），点一下就能切换。
提醒
- 逾期高亮：到期的任务移到「逾期」分组并标红
- 稍后提醒：把任务推迟 15 分钟 / 1 小时 / 明天 / 3 天后再提醒，推迟期间列表上会标「已推迟」
- 状态栏：常驻显示今日待办数，有逾期时变红并显示逾期数，点击打开任务面板
删除与恢复
删除是可恢复的：删除后会提示「撤销」，点了就回来。
左栏底部常驻显示当前待办、进行中的任务数。
设置
点面板右上角的齿轮图标，右侧打开设置页：
- 查看数据文件位置
- 复制数据文件路径
- 打开数据文件所在目录
- 跳转到 VS Code 设置项
数据全部保存在本地，不上传任何服务器，不需要注册账号。
命令
在命令面板（Ctrl+Shift+P）输入 ma-task 可见：
| 命令 |
作用 |
| ma-task: 快速添加任务 |
同 Alt+K |
| ma-task: 打开任务面板 |
同 Alt+Shift+K |
| ma-task: 今日任务 |
打开面板查看今日 |
| ma-task: 数据保存在哪里？ |
显示数据文件位置 |
| ma-task: 刷新 |
重新加载任务列表 |
暂未提供
以下功能尚未实现，后续会补上：
- 每日综述（打开 VS Code 时弹出今日 / 逾期 / 待清理概览）
- 到期主动通知（当前只在面板和状态栏里体现逾期）
- 周报 / 复盘导出
- 任务导入导出
- 日历视图
许可
Apache License 2.0
