vibecoding了一个项目管理插件

经验分享
1

插件作者：Fullsail
GitHub：June-Yan/obsidian-note-timeline
小红书： FullsailLog

这是什么？

Note Timeline 是一款 Obsidian 插件，为你的笔记提供月历、周、三日、项目时间线四种视图。笔记按 frontmatter 日期字段自动归类，支持拖拽改期、条件配色、筛选排除和项目进度追踪。

一句话：把你的笔记目录变成一张可视化日历。

四种视图，随心切换

工具栏最左侧有四个按钮，一键切换：

月视图 — 经典月历

5 行 × 7 列的月历布局，相邻月份补齐灰色日期。每个格子里展示当日笔记，点击即打开。

月视图

  • 左上角显示年月，左右箭头 ±1 月翻页

  • 左上角「今天」按钮快速回到当天

  • 今天格高亮显示

  • 右侧格子属于其他月份时半透明弱化

周视图 — 聚焦一周

周一至周日七列，适合查看本周任务密度。

三日视图 — 今天前后

昨天 / 今天 / 明天三栏，更大空间展示笔记，适合每日规划。

项目视图 — 时间线进度

这是本插件最有特色的视图。左侧列出项目名称和进度条，右侧展示前 30 天 ~ 后 29 天共 60 天的时间线，可滚动查看。每个项目的笔记文件按日期排列在对应格子中。

只能放一张图，评论区继续~

2

项目视图

  • 时间线水平滚动，默认定位到今天附近

  • 今天列高亮

  • 左右两侧垂直滚动同步

  • 100% 完成的项目自动沉底并弱化

拖拽改期

日历中按住文件名块，拖到另一个日期格子即可修改笔记的 frontmatter 日期。

  • 支持纯日期格式：date: 2026-05-03

  • 支持 ISO 格式："2026-05-03T10:00:00+08:00"

  • 松开后自动写回笔记文件

3

分类配色

工具栏「分类配色」按钮打开规则管理面板：

分类配色

每条规则：颜色 + 字段名 + 关键词 + 显示模式

两种显示模式可选：

模式 效果 举例
标签条 文件名左侧 3px 细色条（同文件最多 3 条） categories = CS → 蓝色条
整块 文件名块整体覆盖颜色 state = published → 绿色底

支持的匹配逻辑：

  • 字段值支持单值（categories: CS）和列表（categories: [CS, Math]）

  • 不区分大小写，精确匹配

  • 同日文件按规则顺序排列：匹配规则的在上方，无规则的沉底

  • 颜色从预设 20 色板选择，含 4 个浅色推荐色（浅色推荐覆盖整块，其他颜色推荐用于标签条）

筛选排除

工具栏「筛选」按钮添加排除规则：

  • 按文件名包含或路径包含关键词排除

  • 匹配的文件完全不显示

  • 激活时筛选按钮高亮提示

  • 筛选规则对项目视图同样生效

4

项目进度管理

点击「+ 项目」按钮创建项目：

新增项目

每个项目支持：

  • 按文件夹或按分类筛选笔记

  • 文件夹选择器：直接点选 vault 中的目录

  • 自定义进度状态字段（如 state）和完成值（如 published）

  • 进度公式：状态=完成值的文件数 ÷ 总文件数 × 100%

进度条实时反映项目完成情况，一目了然。

其他特性

  • 右键新建笔记：任意日期格子右键 → 新建笔记，自动填充 frontmatter 日期

  • 自定义日期字段：工具栏输入框可改为任意字段名（如 created、due）

  • 实时刷新：文件修改/删除/创建时日历自动同步

  • 完全离线：不依赖任何外部服务，所有数据都在本地

下载安装

  1. 打开 GitHub Releases

  2. 下载 main.js、manifest.json、styles.css 三个文件

  3. 放入 vault 的 .obsidian/plugins/note-timeline/ 目录

  4. 重启 Obsidian，在设置中启用插件

最后

这个插件是我用 Vibe Coding 方式做的第一个 Obsidian 插件。如果你有功能建议或遇到了 bug，欢迎在 GitHub Issues 提出。

希望这个小工具能提升你的笔记管理和项目管理的体验~

1 个赞