#年度计划与站点数据

ModernDuang 的首页可以展示年度计划进度和站点数据统计两个板块，让访客直观了解你的目标和站点的成长历程。

#年度计划

通过 plans 数组配置你的年度目标/计划列表，每个计划包含文字描述、完成状态和进度数据：

plans:
  - text: 完成自定义博客主题的开发
    done: true
    current: 1
    final: 1
  - text: 阅读 12 本技术书籍
    done: false
    current: 7
    final: 12
  - text: 至少撰写 20 篇博客
    done: false
    current: 14
    final: 20

#进度计算与显示

每个计划的显示方式取决于 final 和 done 的值：

#当 final = 1 时

表示为二元目标（完成/未完成）。done 字段决定显示状态：

• done: true — 显示绿色勾选标记，表示已完成
• done: false — 显示灰色圆圈，表示待完成

plans:
  - text: 完成博客迁移
    done: true
  - text: 拿到驾照
    done: false

#当 final > 1 时

表示为进度目标，显示进度条和数值标签：

• 进度标签格式：当前值/目标值（如 7/12）
• 进度百分比：current / final * 100%
• 进度条颜色随完成度线性渐变

plans:
  - text: 阅读 12 本技术书籍
    done: false
    current: 7
    final: 12

#总体进度条

首页计划板块顶部会展示一个总体进度条：

• 进度计算：所有计划中 done: true 的计划占比 + 各进度计划的加权平均
• 进度条：圆角粘土风格，内凹设计，填充色随进度变化
• 百分比标签：显示精确到整数百分比的完成度

#计划卡片样式

每个计划渲染为一张紧凑的卡片：

┌──────────────────────────────────────┐
│  [✅] 完成自定义博客主题的开发          │
│       进度: 1/1                      │
├──────────────────────────────────────┤
│  [🔄] 阅读 12 本技术书籍     7/12     │
│       ████████░░░░░░░░  58%          │
├──────────────────────────────────────┤
│  [🔄] 至少撰写 20 篇博客     14/20    │
│       ███████████░░░░░  70%          │
└──────────────────────────────────────┘

#站点数据统计

通过 siteStats 字段配置站点数据展示板块：

siteStats:
  enable: false
  startDate: '2024-01-01'

#站点运行时间

首页自动计算并展示从 startDate 到现在的时间跨度：

• 精确计算：年数 + 天数
• 显示格式：已运行 X 年 Y 天
• 实时更新：每日刷新（基于页面加载时的日期计算）
• 视觉呈现：展示在粘土风格卡片中，配合柔和动画

例如，若 startDate 为 2024-01-01，当前日期为 2026-07-05：

已运行 2 年 186 天

#十年之约倒计时

"十年之约"是一个常见的博客社区约定——博客承诺运行十年，以此表达长期写作的决心。ModernDuang 提供十年之约倒计时显示：

• 计算方式：主题自动计算结束日期为 startDate + 10 年，显示当前所处位置的进度
• 显示格式：进度百分比和进度条
• 视觉呈现：圆环进度指示器或横向进度条

十年之约
█ █ █ █ █ █ █ ░ ░ ░  25%
还剩 7 年 180 天

当 10 年期限已到，显示"十年之约已完成"。

#站点统计卡片

首页的站点统计区域通常放置在个人信息卡片下方或年度计划下方，显示为一个单独的功能卡片：

┌──────────────────────────┐
│ 📊 站点数据               │
│                          │
│ 已运行 2 年 186 天        │
│                          │
│ 十年之约                  │
│ ████░░░░░░░░  25%       │
│ 还剩 7 年 180 天          │
└──────────────────────────┘

#完整配置示例

# 年度计划
plans:
  - text: 完成自定义博客主题的开发
    done: true
    current: 1
    final: 1
  - text: 阅读 12 本技术书籍
    done: false
    current: 7
    final: 12
  - text: 至少撰写 20 篇博客
    done: false
    current: 14
    final: 20
  - text: 每月跑步 50 公里
    done: false
    current: 320
    final: 600
  - text: 学习一门新编程语言
    done: true
    current: 1
    final: 1

# 站点数据
siteStats:
  enable: false
  startDate: '2024-01-01'

注意： 站点数据板块默认不展示（siteStats.enable 默认为 false）。如需开启，请将 siteStats.enable 设置为 true。当 siteStats.enable 为 false 时，整个站点数据板块（运行时长、十年之约倒计时）都不会在首页渲染。

#相关页面

• Hero 区域 — 配置首页 Hero 区域
• 个人信息卡片 — 配置首页个人信息卡片
• 配置参考 — 查看所有配置选项