feat: countdown anniversaries and birthdays like ticktick

docs/api.md

@@ -36,6 +36,16 @@ Base path: `/api/v1`. 除初始化、登录和健康检查外均需 `dodo_sessio
 
 批量请求字段：`task_ids`、`completed`、`list_id`、`due_at`、`soft_delete`。所有任务和目标清单在写入前完成归属校验；任一不存在则整批不修改。
 
+## Countdowns
+
+- `GET /countdowns?archived=false` — 查询倒数日；置顶项优先，其余按下一次发生日期排序
+- `POST /countdowns` — 创建倒数日、纪念日或生日；支持 `none/weekly/monthly/yearly` 重复
+- `PATCH /countdowns/{countdown_id}` — 编辑名称、日期、类型、重复与图标
+- `POST /countdowns/{countdown_id}/pin` — 单一置顶，自动取消其他置顶项
+- `DELETE /countdowns/{countdown_id}` — 归档
+- `POST /countdowns/{countdown_id}/restore` — 恢复归档项
+- `DELETE /countdowns/{countdown_id}/purge` — 永久删除已归档项
+
 ## Recycle bin
 
 - `GET /trash?limit=&cursor=` — 已删除顶层任务的游标分页