时间规划(4个指令)
时间规划指令(4个指令)
用于时间管理、任务规划和目标跟踪的四个指令。
倒计时(deadline)
翻牌式倒计时器,适合项目截止、活动开始等场景。
新年倒计时
距离2027年还有
00
00
00
00
00
00
00
00
00
00
00
00
00
00
00
00
已经过了截止时间,会显示 expiredText:
早鸟报名
名额有限
00
00
00
00
00
00
00
00
00
00
00
00
:::deadline{date="2026-12-31T23:59:59" title="新年倒计时" description="距离2027年还有"}
:::
:::deadline{date="2025-01-01" title="早鸟报名" description="名额有限" expiredText="报名已结束" showSeconds="false"}
:::date— 目标日期时间,格式YYYY-MM-DDTHH:MM:SStitle— 倒计时标题description— 倒计时说明文字showSeconds— 是否显示秒,默认trueexpiredText— 倒计时结束后的文字,默认「已截止」
日历(calendar)
macOS 风格日历,自动显示农历、二十四节气、法定节假日和调休,也可以写入自己的日程。支持前后切换月份和回到今天。
2026年5月
日
一
二
三
四
五
六
初十
26日
十一
27日
十二
28日
十三
29日
十四
30日
十五
5月1日
劳动节(休)
劳动节
五一出游
劳动节(休)
劳动节
五一出游
十六
2日
劳动节(休)
十七
3日
劳动节(休)
十八
4日
劳动节(休)
十九
5日
立夏
劳动节(休)
立夏
二十
6日
廿一
7日
廿二
8日
廿三
9日
劳动节(班)
劳动节(班)
廿四
10日
廿五
11日
廿六
12日
项目评审
项目评审
廿七
13日
廿八
14日
廿九
15日
三十
16日
四月初一
17日
初二
18日
初三
19日
初四
20日
朋友聚会
朋友聚会
初五
21日
小满
小满
初六
22日
初七
23日
初八
24日
初十
26日
十一
27日
十二
28日
十三
29日
十四
30日
十五
31日
十六
6月1日
十七
2日
十八
3日
十九
4日
二十
5日
芒种
芒种
廿一
6日
:::calendar{month="2026-05"}
| date | type | content | color | link |
| ---- | ---- | ------- | ----- | ---- |
| 05-01 | 假期 | 五一出游 | red | |
| 05-12 | 工作 | 项目评审 | | |
| 05-20 | 生活 | 朋友聚会 | blue | |
| 05-25 | 项目 | Vergil v1.0 发布 | green | https://github.com/wsjz/vergil-astro-theme |
:::month:打开时显示的月份,格式YYYY-MM,不写就是当前月份- 日程写成表格,表头必须是英文列名,每列都可以省略:
date:日期,写MM-DD、YYYY-MM-DD,或只写日D表示当月type:类型,同一类型自动用同一种颜色content:日程内容color:指定颜色,可选blue、green、red、purple、yellow、cyan、orange、pinklink:链接,带链接的日程显示小箭头,点击跳转
- 农历、节气、节假日、调休补班(橙色「班」)都是自动的,不用写
OKR 目标管理(okr)
Objectives and Key Results 目标管理,带进度条追踪。
Q2 产品目标
2026年第二季度
整体完成度
76%
O1
O1: 提升用户体验
优化核心流程,降低用户流失率。
KR1
页面加载时间
首屏加载优化
KR2
用户留存率
7日留存
KR3
NPS 评分
用户推荐度
O2
O2: 拓展市场份额
进入两个新行业领域。
KR1
新客户数
签约企业客户
KR2
行业覆盖率
覆盖行业数量
:::okr{title="Q2 产品目标" period="2026年第二季度"}
## O1: 提升用户体验
优化核心流程,降低用户流失率。
| Key Result | Target | Current | Description | Status |
|------------|--------|---------|-------------|--------|
| 页面加载时间 | 2s | 1.5s | 首屏加载优化 | 正常 |
| 用户留存率 | 80% | 75% | 7日留存 | 预警 |
| NPS 评分 | 50 | 45 | 用户推荐度 | 正常 |
## O2: 拓展市场份额
进入两个新行业领域。
| Key Result | Target | Current | Description | Status |
|------------|--------|---------|-------------|--------|
| 新客户数 | 100 | 60 | 签约企业客户 | 正常 |
| 行业覆盖率 | 5 | 3 | 覆盖行业数量 | 滞后 |
:::title— OKR 总标题period— 周期,如「2026年第二季度」## O1:、## O2:— 定义 Objective(目标)- KR 表格列:
Key Result、Target、Current、Description、Status、Link - 自动计算进度:每个 KR 的进度 = Current / Target × 100%
任务规划(plan)
多视图任务管理看板,支持 7 种展示模式。数据写成 Markdown 表格,表头用 列名:类型 声明列类型,同一份数据可以在不同视图间切换。
项目开发计划(多视图组合)
项目开发计划
待办 (1)
测试验收
2024-03-10
Dave
0%
进行中 (1)
前端开发
2024-02-01
Carol
65%
已完成 (2)
需求分析
2024-01-01
Alice
100%
技术选型
2024-01-10
Bob
100%
需求分析2024-01-01
技术选型2024-01-10
前端开发2024-02-01
测试验收2024-03-10
| 状态 | 任务 | 优先级 | 截止日期 | 负责人 | 完成度 |
|---|---|---|---|---|---|
| ● | 需求分析 | ● P0 | 2024-01-01 | Alice | 100% |
| ● | 技术选型 | ● P1 | 2024-01-10 | Bob | 100% |
| ◉ | 前端开发 | ● P0 | 2024-02-01 | Carol | 65% |
| ○ | 测试验收 | ● P0 | 2024-03-10 | Dave | 0% |
1月
2月
3月
01-01
01-10
02-01
03-10
需求分析
●
技术选型
●
前端开发
◉
测试验收
○
整体完成度
4 个任务 · 2 已完成 · 1 进行中 · 1 待办
需求分析
技术选型
前端开发
测试验收
状态分布
● 已完成250%
◉ 进行中125%
○ 待办125%
:::plan{title="项目开发计划" views="board,list,table,timeline,progress"
default="board" dateCol="截止日期" progressCol="完成度"
statusCol="状态" titleCol="任务" ownerCol="负责人"
filters="状态,优先级"}
| 状态:status | 任务:text | 优先级:priority | 截止日期:date | 负责人:text | 完成度:progress |
|-------------|-----------|-----------------|---------------|-------------|-----------------|
| done | 需求分析 | P0 | 2024-01-01 | Alice | 100% |
| done | 技术选型 | P1 | 2024-01-10 | Bob | 100% |
| doing | 前端开发 | P0 | 2024-02-01 | Carol | 65% |
| todo | 测试验收 | P0 | 2024-03-10 | Dave | 0% |
:::英语学习计划(艾宾浩斯复习)
基于艾宾浩斯遗忘曲线自动生成复习计划,鼠标悬停节点查看复习详情。
英语学习计划
单词 List 1
●
第 1 次复习
05-21
已完成
复习重点熟词僻义 + 例句
预计时长30分钟
状态done
●
第 2 次复习
05-22
已完成
复习重点熟词僻义 + 例句
预计时长30分钟
状态done
●
第 3 次复习
05-24
已完成
复习重点熟词僻义 + 例句
预计时长30分钟
状态done
●
第 4 次复习
05-27
已完成
复习重点熟词僻义 + 例句
预计时长30分钟
状态done
●
第 5 次复习
06-04
已完成
复习重点熟词僻义 + 例句
预计时长30分钟
状态done
●
第 6 次复习
06-19
已完成
复习重点熟词僻义 + 例句
预计时长30分钟
状态done
100%
单词 List 2
●
第 1 次复习
05-26
已完成
复习重点词根词缀整理
预计时长25分钟
状态doing
●
第 2 次复习
05-27
已完成
复习重点词根词缀整理
预计时长25分钟
状态doing
●
第 3 次复习
05-29
已完成
复习重点词根词缀整理
预计时长25分钟
状态doing
●
第 4 次复习
06-01
已完成
复习重点词根词缀整理
预计时长25分钟
状态doing
●
第 5 次复习
06-09
已完成
复习重点词根词缀整理
预计时长25分钟
状态doing
●
第 6 次复习
06-24
已完成
复习重点词根词缀整理
预计时长25分钟
状态doing
100%
高数导数
●
第 1 次复习
05-28
已完成
复习重点复合函数求导
预计时长45分钟
状态todo
●
第 2 次复习
05-29
已完成
复习重点复合函数求导
预计时长45分钟
状态todo
●
第 3 次复习
05-31
已完成
复习重点复合函数求导
预计时长45分钟
状态todo
●
第 4 次复习
06-03
已完成
复习重点复合函数求导
预计时长45分钟
状态todo
●
第 5 次复习
06-11
已完成
复习重点复合函数求导
预计时长45分钟
状态todo
●
第 6 次复习
06-26
已完成
复习重点复合函数求导
预计时长45分钟
状态todo
100%
| 内容 | 学习日期 | 复习重点 | 预计时长 | 状态 |
|---|---|---|---|---|
| 单词 List 1 | 2026-05-20 | 熟词僻义 + 例句 | 30 | ● |
| 单词 List 2 | 2026-05-25 | 词根词缀整理 | 25 | ◉ |
| 高数导数 | 2026-05-27 | 复合函数求导 | 45 | ○ |
待办 (1)
高数导数
2026-05-27
进行中 (1)
单词 List 2
2026-05-25
已完成 (1)
单词 List 1
2026-05-20
:::plan{title="英语学习计划" views="ebbinghaus,table,board"
default="ebbinghaus" dateCol="学习日期" titleCol="内容"
groupBy="状态" statusCol="状态"}
| 内容:text | 学习日期:date | 复习重点:text | 预计时长:number | 状态:status |
|-----------|---------------|---------------|-----------------|-------------|
| 单词 List 1 | 2026-05-20 | 熟词僻义 + 例句 | 30分钟 | done |
| 单词 List 2 | 2026-05-25 | 词根词缀整理 | 25分钟 | doing |
| 高数导数 | 2026-05-27 | 复合函数求导 | 45分钟 | todo |
:::用到的特性:
views="ebbinghaus,table,board"艾宾浩斯 + 表格 + 看板dateCol="学习日期"指定学习日期,自动计算 6 个复习节点(+1天、+2天、+4天、+7天、+15天、+30天)steps="1,3,7,14,30,60,90"可自定义复习间隔(默认不指定即可)- 节点状态:实心 = 已完成,呼吸动画 + 下箭头 = 今天该复习,空心 = 待复习
- 鼠标悬停节点自动显示表格中其他列的内容(如”复习重点”、“预计时长”)
- 右侧百分比表示已完成复习节点占比
习惯打卡(纯表格 + checkbox)
用 checkbox 类型做每日习惯打卡表。
每日习惯
| 习惯 | 周一 | 周二 | 周三 | 周四 | 周五 | 周六 | 周日 |
|---|---|---|---|---|---|---|---|
| 早起 | ● | ● | ○ | ● | ● | ○ | ○ |
| 阅读 | ● | ● | ● | ● | ○ | ● | ● |
| 运动 | ● | ○ | ● | ○ | ● | ● | ○ |
| 冥想 | ○ | ● | ● | ● | ● | ○ | ● |
:::plan{title="每日习惯" views="table"}
| 习惯:text | 周一:checkbox | 周二:checkbox | 周三:checkbox | 周四:checkbox | 周五:checkbox | 周六:checkbox | 周日:checkbox |
|-----------|---------------|---------------|---------------|---------------|---------------|---------------|---------------|
| 早起 | true | true | false | true | true | false | false |
| 阅读 | true | true | true | true | false | true | true |
| 运动 | true | false | true | false | true | true | false |
| 冥想 | false | true | true | true | true | false | true |
:::用到的特性:
:checkbox类型显示为实心/空心圆点(true=完成, false=未完成)- 纯表格视图,类似打卡表
软件迭代(里程碑 + 时间轴范围模式)
里程碑视图展示版本发布,时间轴范围模式展示开发周期。
产品迭代
●
2024-01-01
v1.0
首个正式版本
●
2024-03-15
v1.5
支持暗黑模式
●
2024-06-01
v2.0
全新架构上线
11月
12月
1月
3月
5月
11-01
12-31
03-10
05-28
v1.0
v1.5
v2.0
:::plan{title="产品迭代" views="milestone,timeline" default="milestone"
dateCol="发布日期" titleCol="版本" descCol="更新内容"
startDate="开始" endDate="结束"}
| 版本:text | 发布日期:date | 更新内容:text | 开始:date | 结束:date |
|-----------|---------------|---------------|-----------|-----------|
| v1.0 | 2024-01-01 | 首个正式版本 | 2023-11-01| 2023-12-31|
| v1.5 | 2024-03-15 | 支持暗黑模式 | 2024-01-15| 2024-03-10|
| v2.0 | 2024-06-01 | 全新架构上线 | 2024-03-20| 2024-05-28|
:::用到的特性:
milestone视图:按发布日期排列的里程碑卡片,显示descCol的内容timeline范围模式:startDate="开始"+endDate="结束"渲染为甘特条- 同时有
dateCol(发布日期)和startDate/endDate(开发周期),timeline 优先使用范围模式
自定义看板分组与顺序
用 groupOrder 属性覆盖默认的字母序排列。比如按”阶段”分组时,不指定 groupOrder 会按字母序变成 测试 → 上线 → 设计 → 开发,但业务上合理的顺序是 设计 → 开发 → 测试 → 上线。
设计 (1)
首页原型
开发 (1)
API 接口
测试 (1)
用例编写
上线 (1)
生产部署
:::plan{views="board" groupBy="阶段" groupOrder="设计,开发,测试,上线" titleCol="任务"}
| 阶段:select | 任务:text | 负责人:text |
|-------------|-----------|-------------|
| 设计 | 首页原型 | Alice |
| 开发 | API 接口 | Bob |
| 测试 | 用例编写 | Carol |
| 上线 | 生产部署 | Dave |
:::用到的特性:
groupOrder="设计,开发,测试,上线"同时定义看板分组和列顺序(从左到右),最多8个:select是列类型(控制单元格显示为 pill 标签),groupOrder是看板属性(定义分组和顺序),两者独立- 不指定
groupOrder时,:select列默认按字母序排列,这里用groupOrder覆盖了默认顺序 - 8 种颜色按位置自动分配,均基于主题色派生
视图
| 视图 | 说明 |
|---|---|
board | 看板视图,按状态分栏 |
list | 列表视图,带筛选 |
table | 表格视图 |
timeline | 时间线视图 |
milestone | 里程碑视图 |
progress | 进度总览 |
ebbinghaus | 艾宾浩斯遗忘曲线 |
列类型
| 类型 | 说明 | 示例 |
|---|---|---|
text | 默认纯文本 | 任意文字 |
status | 状态圆点(todo/doing/done) | done |
priority | 优先级标签(P0/P1/P2) | P0 |
date | 日期,表格中带月份色条 | 2024-01-01 |
progress | 进度条 | 65% |
number | 数字,自动千分位格式化,Notion 风格标签 | 4200 |
checkbox | 勾选框(true/false) | true |
select | 单选标签 | 任意文字 |
link | 可点击链接 | https://... |
状态列
状态列使用 status 类型,支持三个值:
todo— 待办,空心圆doing— 进行中,半实心圆 + 呼吸动画done— 已完成,实心圆
属性
| 属性 | 说明 | 示例 |
|---|---|---|
title | 组件标题 | title="项目计划" |
views | 启用的视图 | views="board,table" |
default | 默认视图 | default="table" |
groupBy | board 分组列 | groupBy="状态" |
groupOrder | board 自定义分组和列顺序(从左到右) | groupOrder="待办,进行中,已完成" |
filters | table 筛选列 | filters="状态,优先级" |
dateCol | 日期列映射 | dateCol="截止日期" |
startDate | 范围起始列 | startDate="开始" |
endDate | 范围结束列 | endDate="结束" |
progressCol | 进度列映射 | progressCol="完成度" |
statusCol | 状态列映射 | statusCol="状态" |
titleCol | 标题列映射 | titleCol="任务" |
ownerCol | 负责人列映射 | ownerCol="负责人" |
priorityCol | 优先级列映射 | priorityCol="优先级" |
descCol | 描述列映射 | descCol="描述" |
steps | ebbinghaus 复习间隔(逗号分隔天数) | steps="1,3,7,14,30" |
视图所需列
| 视图 | 所需列 | 说明 |
|---|---|---|
| table | 无 | 永远可渲染 |
| list | 无 | 永远可渲染 |
| board | 无 | 永远可渲染 |
| timeline | dateCol 或 startDate 或 endDate | 单点或范围模式 |
| milestone | dateCol | 只支持单点模式 |
| progress | progressCol | 必须指定进度列 |
| ebbinghaus | dateCol | 艾宾浩斯复习计划,自动计算复习节点 |
关于列类型: 视图所需列只要求列存在即可,不强制要求特定类型。例如 timeline 的
dateCol用text类型也能工作(只要值能被new Date()解析)。但建议声明对应类型(如:date、:progress)以获得更好的显示效果(月份色条、进度条等)。