基础版包含核心甘特图、任务表格、快速添加、变更记录等功能，无需付费即可体验完整的任务可视化管理。
进入 设置 → 第三方插件 → 浏览
搜索 TaskNexus Free，点击安装并启用
启用后，左侧边栏出现 🗓️ 图标，点击即可打开甘特图
打开甘特图后，插件会自动扫描你设置的目录下所有 Markdown 笔记，识别其中的 - [ ] 任务列表，并渲染为可视化甘特图。
如果你还没有任务数据，可以用「快速添加」功能（下文介绍）快速创建第一个任务。
甘特图是 Task Nexus 的核心功能。它将笔记中的 Markdown 任务列表自动渲染为彩色时间线，让你一眼看清所有任务的进度和截止日期。
甘特图支持 6 种时间尺度切换，满足不同场景的查看需求：
| 时间尺度 | 适合场景 | 操作方式 |
|---|---|---|
| 周视图 (1w) | 本周冲刺，关注短期任务 | 工具栏点击「1w」 |
| 双周视图 (2w) | 短期迭代，两周规划 | 工具栏点击「2w」 |
| 月视图 (1m) | 月度规划，最常用 | 工具栏点击「1m」 |
| 季度视图 (3m) | 季度 OKR 跟踪 | 工具栏点击「3m」 |
| 半年视图 (6m) | 半年度项目规划 | 工具栏点击「6m」 |
| 年视图 (1y) | 年度战略，全局视角 | 工具栏点击「1y」 |
甘特条支持鼠标拖拽，可以直接在图上调整任务日期：
当父任务下有子任务且子任务有明确日期时，父任务的甘特条会自动取所有子任务的最小开始日期到最大截止日期，无需手动计算。父任务甘特条显示为半透明色，表示日期由子任务推导而来。
不同目录下的任务用不同颜色区分，方便快速识别任务所属项目。在「设置 → 目录颜色」中为每个目录指定颜色即可。
甘特图提供多种筛选选项：
任务表格是甘特图左侧的任务列表区域，以表格形式展示每条任务的详细信息。你可以自由配置显示哪些列。
| 列名 | 说明 | 是否可隐藏 |
|---|---|---|
| ☑️ 勾选框 | 标记任务完成状态，点击勾选即完成 | 可隐藏 |
| 任务名称 | 任务标题，点击可在插件内打开编辑 | 可隐藏 |
| 负责人 | 任务执行者，从 role/指派/xxx 标签解析 | 可隐藏 |
| 优先级 | ⏫高 / 🔺中 / 🔽低 / ⏬最低 | 可隐藏 |
| 开始日期 | 任务开始时间 | 可隐藏 |
| 截止日期 | 任务截止时间，逾期会高亮 | 可隐藏 |
| 进度 | 任务完成百分比 | 可隐藏 |
| 标签 | 任务的 Obsidian 标签 | 可隐藏 |
| 所属笔记 | 任务所在的笔记文件名 | 可隐藏 |
有两种方式配置表格列的显示/隐藏：
点击搜索框旁边的 👁 按钮，勾选要显示的列
进入「设置 → TaskNexus → 任务表格列显隐」，逐列配置
点击任务名称，会在插件右侧打开任务编辑框，可以修改属性（负责人、优先级、日期等）和正文内容。
快速添加让你一键创建任务，无需手动在笔记中编写 Markdown 语法。
Ctrl + Shift + T（macOS 为 Cmd + Shift + T）| 字段 | 说明 | 默认值 |
|---|---|---|
| 任务名称 | 必填，任务标题 | （空） |
| 目标文件 | 任务写入哪个笔记 | 当天日记 |
| 目标标题 | 写入笔记中哪个标题下方 | 文件末尾 |
| 负责人 | 任务执行者 | 设置中的默认负责人 |
| 优先级 | ⏫高 / 🔺中 / 🔽低 / ⏬最低 | 设置中的默认优先级 |
| 截止日期 | 任务截止时间 | 今天 |
截止日期提供 5 个快捷按钮：
按下 Ctrl+Shift+T 或点击工具栏按钮
输入任务名称（必填），其他字段使用默认值或手动调整
任务自动写入目标笔记，格式为 - [ ] 任务名称 📅 YYYY-MM-DD 🔺
局部排产让你只对勾选的任务重新排列日期，其他任务保持不变。适合调整部分任务的排期而不影响全局。
在任务表格中勾选需要重新排产的任务（点击 ☑️ 列）
点击工具栏的「📐 局部排产」按钮
插件按优先级和依赖关系，仅对勾选任务重新分配日期，未勾选的任务保持不变
变更记录自动追踪所有任务的操作历史，支持一键回退。让你的每次调整都有迹可循。
点击甘特图工具栏的「📝 变更记录」按钮，打开变更记录面板。
| 类型 | 说明 | 图标 |
|---|---|---|
| 日期修改 | 开始日期/截止日期调整 | 📅 |
| 状态切换 | 待处理 → 进行中 → 已完成 | 🔄 |
| 任务新增 | 新建任务 | ➕ |
| 任务删除 | 删除任务 | ➖ |
| 跨文件移动 | 任务从一个笔记移到另一个笔记 | 📁 |
如果操作有误，可以将任务回退到任意历史状态：
在变更记录面板中找到目标任务的历史记录
点击该记录右侧的「↩ 回退」按钮
确认后任务恢复到该历史状态，同时生成一条新的回退记录
.task-gantt/changelog.json 文件中，不会因 Obsidian 重启丢失。你可以手动备份此文件。
进入「设置 → TaskNexus」即可配置插件。以下为基础版包含的设置项：
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 包含路径 | 指定要扫描的笔记目录，多个路径用换行分隔 | 全部库 |
| 排除路径 | 排除不需要扫描的目录 | （空） |
| 默认负责人 | 快速添加时的默认负责人 | （空） |
| 默认优先级 | 快速添加时的默认优先级 | 🔺 中 |
| 设置项 | 说明 |
|---|---|
| 目录颜色 | 为每个目录指定甘特条颜色，按项目区分 |
| 显示任务所属笔记 | 开启后同一笔记的任务会归入虚拟分组行 |
| 父条工期自动聚合 | 父任务日期自动跟随子任务范围 |
| 缩进识别子任务 | 开启后 Tab 缩进的任务识别为子任务 |
| 读取有序列表任务 | 识别 1. [ ] / 2. [x] 等有序列表格式 |
| 设置项 | 说明 |
|---|---|
| 默认目标文件 | 任务写入位置：当天日记 / 指定文件 / 当前打开的文件 |
| 默认目标标题 | 写入笔记中哪个标题（##）下方 |
| 设置项 | 说明 |
|---|---|
| 插件内打开任务笔记 | 点击任务名称时在插件内打开编辑框，而非跳转到笔记标签页 |
| 添加子任务关联方式 | 新建/拖动子任务时的关联方式（wiki链接或缩进） |
| 开始日期图标 | 写入任务时使用的 emoji，需与 Tasks 插件格式一致 |
| 自动创建模块同名文件夹 | 按模块自动创建同名目录 |
在设置页「任务表格列显隐」区域，可以独立控制每个列的显示/隐藏。也可以通过甘特图搜索框旁的 👁 按钮快速配置。
检查「设置 → TaskNexus → 包含路径」是否正确配置。插件只会扫描指定目录下的笔记。如果留空，则扫描整个库。
确保任务行格式为 - [ ] 任务名称 📅 2026-08-22，需要有截止日期才会显示甘特条。
检查笔记文件是否为可编辑状态（非只读）。拖拽后日期会自动写回笔记。
需要先在任务表格中勾选至少一个任务，局部排产按钮才会激活。
点击甘特图工具栏的「📝 变更记录」按钮打开。变更数据存储在 .task-gantt/changelog.json。
Pro 版包含项目视图、今日面板、任务计时、统计面板、任务看板等更多功能。详情请访问首页 版本对比。
← 返回首页