安装
通过 BRAT 安装
安装并启用社区插件 BRAT
执行命令 BRAT: Add a beta plugin for testing
填写仓库地址：https://github.com/sustcsugar/obsidian-gantt-calendar
手动安装
下载最新的 Release
解压后将文件夹复制到 /.obsidian/plugins/
重启 Obsidian 并在设置中启用插件
快速开始
打开视图
点击侧边栏图标按钮打开主日历视图
使用工具栏中的视图切换按钮在视图间切换
创建任务
使用工具栏右侧的添加任务按钮，或在任意 Markdown 文件中手动编写：
md
- [ ] 🎯 完成项目文档 📅 2025-12-20
刷新插件即可在日历和任务列表中看到该任务。
功能特性
界面布局
插件采用顶部工具栏 + 内容区的布局结构：
工具栏左侧 — 视图切换（6 个视图）
工具栏中间 — 当前日期范围 / 标题
工具栏右侧 — 功能按钮（导航、排序、筛选、添加任务等）
任务格式
Tasks 插件格式（Emoji）
md
- [ ] 🎯 完成项目文档 ⏫ ➕ 2025-01-10 📅 2025-01-15
Emoji 含义 Emoji 含义
🎯 全局筛选标记 🔺 最高优先级
⏫ 高优先级 🔼 中优先级
🔽 低优先级 ⏬ 最低优先级
➕ 创建日期 🛫 开始日期
⏳ 计划日期 📅 截止日期
✅ 完成日期 ❌ 取消日期
🔁 重复任务 - -
Dataview 插件格式（字段）
md
- [ ] 🎯 完成项目文档 [priority:: high] [created:: 2025-01-10] [due:: 2025-01-15]
字段 含义 字段 含义
priority:: 优先级 created:: 创建日期
start:: 开始日期 scheduled:: 计划日期
due:: 截止日期 completion:: 完成日期
cancelled:: 取消日期 repeat:: 重复规则
时间精度
日期格式：YYYY-MM-DD（如 2026-04-27）
时间格式：YYYY-MM-DD HH:mm（如 2026-04-27 14:00）
包含时间的任务会自动在日视图和周视图中显示为时间轴布局
重复任务语法
md
🔁 every day # 每天
🔁 every 3 days # 每3天
🔁 every week on Monday # 每周一
🔁 every month on 15 # 每月15日
🔁 every year on 01-01 # 每年1月1日
🔁 every weekday # 每个工作日
🔁 when done # 完成后重新开始
年视图
全年概览 — 12 个月卡片展示全年任务分布
任务热力图 — 5 级颜色梯度，直观显示任务密度
8 种配色方案：蓝 / 绿 / 红 / 紫 / 橙 / 青 / 粉 / 黄
3D 热力图效果（关闭 / 轻微凸起 / 明显凸起）
响应式布局 — 根据窗口宽度自动切换 4×3 / 3×4 / 2×6 / 1×12 布局
任务数量统计 — 可选显示每日任务总数
农历显示 — 月卡片内显示农历日期
点击导航 — 点击日期切换到日视图
月视图
月度日历 — 标准月历布局，清晰显示每日任务
周数显示 — ISO 周数显示在每周第一列
任务数量限制 — 可配置每天显示任务数量（1–10），超出显示"+N 更多"
任务弹窗 — 点击日期显示当天完整任务列表
节日显示 — 阳历/农历/节气节日三色标记
拖拽排序 — 拖拽任务卡片在日期间移动
周期任务 — 自动显示重复任务的虚拟实例
周起始配置 — 支持周一/周日开始
周视图
双模式布局
列表模式 — 当周内无定时任务时，显示 7 列卡片布局
时间轴模式 — 检测到定时任务时自动切换，显示 24 小时纵向时间轴，7 天并排对齐
今日高亮 — 当天日期特殊标记
灵活导航 — 上一周 / 本周 / 下一周快速切换
拖拽交互 — 拖拽任务到任意天或小时格
快速创建 — 空时间格悬停显示"+"按钮，点击快速创建任务
当前时间线 — 红色指示线标记当前时刻
农历信息 — 日期栏显示农历文本和节日
日视图
详细任务列表 — 显示当天所有任务详情
时间轴布局 — 当任务包含时间精度时，渲染 0:00–23:00 时间轴，任务定位到对应小时格
拖拽交互 — 拖拽任务到任意时间格调整时间
快速创建 — 空时间格悬停显示"+"按钮
当前时间线 — 红色指示线标记当前时刻
Daily Note 集成
嵌入式完整编辑器（WorkspaceSplit 模式）
编辑 / 预览模式切换
自动加载对应日期的 daily note
支持 Obsidian 核心日记插件、Periodic Notes 插件和自定义路径
可调整分栏 — 任务区与笔记区之间可拖拽调整大小（水平或垂直布局）
农历信息栏 — 显示农历日期、节日、节气
任务视图
任务列表 — 集中展示所有任务
日期范围筛选 — 全部 / 今天 / 本周 / 本月 / 自定义范围
时间字段选择 — 按任意 6 种日期字段过滤
多维筛选 — 状态、优先级、标签（AND/OR/NOT 运算符）
排序 — 7 种排序字段，支持升序/降序切换
状态持久化 — 筛选和排序设置刷新后保留
甘特视图
交互式甘特条 — 自定义 SVG 渲染引擎
拖动整体任务条调整时间
拖动左右端点调整开始/结束时间
拖动调整任务进度百分比
点击打开任务编辑弹窗
导航按钮 — 跳转到今天 / 向左 / 向右滚动
增量刷新 — 智能更新策略，避免全量重绘
标签/状态筛选 — 按标签和任务状态过滤甘特条
可配置字段 — 选择映射到甘特图起止时间的日期字段
侧边栏视图
两个标签页，方便随时查看和管理任务：
任务列表标签页
关键词搜索（防抖处理）
多维筛选：状态、优先级、标签（OR/AND）、日期范围
排序：优先级 / 截止日期 / 开始日期
点击任务卡片跳转到源文件
每日时间线标签页
24 小时时间格展示今日定时任务
全天任务区域
当前时间指示线（实时标记）
拖拽任务调整时间
空时间格快速创建
右键菜单
右键点击任意任务可执行：
编辑任务 — 完整编辑弹窗（描述、优先级、日期、重复、标签）
创建笔记 — 从任务生成 wiki 链接笔记（同名或别名）
设置优先级 — 6 个等级：最高 / 高 / 中 / 普通 / 低 / 最低
设置状态 — 自定义状态（重要、有疑问）
延期任务 — 延迟 1/3/7 天（从截止日期或从今天算起）
取消 / 恢复 — 切换任务取消状态
删除 — 从 Markdown 文件中移除任务
飞书同步
双向同步 — 将本地任务推送到飞书，从飞书拉取任务到 Obsidian
OAuth 2.0 — 安全认证，自动刷新令牌
推送过滤 — 按文件路径、完成状态、日期筛选
冲突解决 — 多种策略：本地优先 / 远程优先 / 最新优先 / 手动
自动同步 — 可配置自动同步间隔
同步结果弹窗 — 详细的逐任务同步结果和统计信息
开发路线图
任务解析
☑
Tasks 和 Dataview 双格式任务解析
☑
全局筛选标记
☑
任务标签
☑
任务描述
☑
6 种优先级
☑
6 种时间属性（含时间精度 HH:mm）
☑
重复任务识别与显示
□
嵌套标签识别
□
多行任务识别
□
子任务识别
□
任务依赖关系
视图功能
☑
日视图 Daily Note 集成（嵌入式编辑器）
☑
日视图时间轴布局
☑
周视图双模式（列表 + 时间轴）
☑
周/月视图拖拽
☑
年视图热力图和任务统计
☑
任务视图（多维筛选 + 日期范围）
☑
甘特视图（拖拽 + 增量刷新 + 导航）
☑
侧边栏视图（任务列表 + 每日时间线）
工具栏
☑
视图切换
☑
标签 / 状态 / 优先级筛选
☑
日期导航按钮
☑
时间字段选择
☑
添加任务按钮
交互功能
☑
任务卡片（描述、标签、优先级）
☑
右键菜单（编辑、创建笔记、优先级、状态、延期、取消、删除）
☑
悬浮提示
☑
空时间格快速创建
未来计划（v 2.0.0）
□
第三方日历订阅（飞书日历、Outlook 日历）
□
Microsoft To Do 同步
□
通过 CalDAV 接入 Google / Apple 日