Plan 数据视图指令详解

:::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%              |
:::

用到的特性：

• views="board,list,table,timeline,progress" 启用五个视图
• default="board" 默认显示看板视图
• filters="状态,优先级" 表格视图启用筛选下拉
• ownerCol="负责人" 看板卡片和列表条目显示负责人
• :status 列在列表视图显示彩色竖条，在时间轴视图显示不同颜色的节点
• :priority 列显示 P0/P1/P2 优先级标签
• :date 列在时间轴中定位圆点，表格中带月份色条
• :progress 列在进度视图中显示环形完成度和进度条
• titleCol="任务" 指定卡片/列表/里程碑标题列

:::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" 可自定义复习间隔（默认不指定即可）
• 节点状态：实心 = 已完成，呼吸动画 + 下箭头 = 今天该复习，空心 = 待复习
• 鼠标悬停节点自动显示表格中其他列的内容（如”复习重点”、“预计时长”）
• 右侧百分比表示已完成复习节点占比

:::plan{title="2024 阅读计划" views="board,table,milestone"
        default="board" groupBy="类别" dateCol="读完日期" titleCol="书名"}
| 类别:select | 书名:text | 作者:text | 读完日期:date | 评分:number | 链接:link |
|-------------|-----------|-----------|---------------|-------------|-----------|
| 科幻        | 三体      | 刘慈欣    | 2024-02-15    | 9           | [豆瓣](https://book.douban.com/subject/2567698) |
| 文学        | 活着      | 余华      | 2024-03-10    | 9           | [豆瓣](https://book.douban.com/subject/4913064) |
| 科幻        | 沙丘      | 赫伯特    | 2024-05-20    | 8           | [豆瓣](https://book.douban.com/subject/26715448) |
| 历史        | 万历十五年 | 黄仁宇   |               |             | |
| 文学        | 百年孤独  | 马尔克斯  |               |             | |
:::

用到的特性：

• groupBy="类别" 按类别列分组，看板每列一个颜色
• :select 类型显示为 pill 标签（适合有限选项如”科幻/文学/历史”）
• :number 类型显示为千分位格式化的 Notion 风格标签
• :link 类型支持两种格式：直接 URL（https://...）或 Markdown 链接（[名称](url)），带外部链接图标，悬停高亮
• titleCol="书名" 指定看板卡片和里程碑标题

:::plan{title="云南之行" views="timeline,milestone"
        default="timeline" dateCol="日期" statusCol="状态" titleCol="事件"}
| 事件:text | 日期:date | 状态:status | 备注:text |
|-----------|-----------|-------------|-----------|
| 抵达昆明  | 2024-07-01| done        | 入住翠湖附近 |
| 大理古城  | 2024-07-03| done        | 骑行洱海西线 |
| 丽江古城  | 2024-07-06| doing       | 玉龙雪山一日游 |
| 香格里拉  | 2024-07-09| todo        | 普达措国家公园 |
| 返程      | 2024-07-12| todo        | 昆明飞回     |
:::

用到的特性：

• timeline 单点模式：每个事件显示为一个圆点
• milestone 视图：按时间顺序排列的卡片，显示备注内容
• :status 列控制时间轴节点颜色（todo=灰, doing=呼吸, done=实心）

:::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=未完成）
• 纯表格视图，类似打卡表

:::plan{title="2024 年度计划" views="board,progress" default="board"
        groupBy="状态" titleCol="关键结果" progressCol="完成度"
        statusCol="状态" priorityCol="优先级"}
| 状态:status | 目标:text | 关键结果:text | 完成度:progress | 优先级:priority |
|-------------|-----------|---------------|-----------------|-----------------|
| doing       | 技术成长  | 掌握 TypeScript | 60%             | P0              |
| doing       | 技术成长  | 阅读 12 本技术书 | 25%             | P1              |
| todo        | 身体健康  | 减重 5kg        | 0%              | P0              |
| done        | 身体健康  | 每周运动 3 次   | 100%            | P0              |
| todo        | 财务规划  | 建立应急基金    | 0%              | P1              |
:::

用到的特性：

• board + progress 组合，看板分组 + 环形进度图
• groupBy="状态" 按状态分组
• priorityCol="优先级" 在看板卡片和进度统计中显示优先级分布

:::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 优先使用范围模式

:::plan{views="board" groupBy="阶段" groupOrder="设计,开发,测试,上线" titleCol="任务"}
| 阶段:select | 任务:text | 负责人:text |
|-------------|-----------|-------------|
| 设计        | 首页原型  | Alice       |
| 开发        | API 接口  | Bob         |
| 测试        | 用例编写  | Carol       |
| 上线        | 生产部署  | Dave        |
:::

用到的特性：

• groupOrder="设计,开发,测试,上线" 同时定义看板分组和列顺序（从左到右），最多8个
• :select 是列类型（控制单元格显示为 pill 标签），groupOrder 是看板属性（定义分组和顺序），两者独立
• 不指定 groupOrder 时，:select 列默认按字母序排列，这里用 groupOrder 覆盖了默认顺序
• 8 种颜色按位置自动分配，均基于主题色派生