Worklog

Worklog 是一个本地化工时管理插件，用于在 Obsidian 中维护月度任务、每日工时、日历完成状态和年度统计看板。

当前能力

• 打开当月工时工作台，没有当月数据时自动创建
• 创建工时工作台时可手动输入年份、选择月份，并按对应年份目录创建数据
• 跳转到月份工时工作台时可手动输入年份、选择月份；已有数据直接打开，无数据时会询问是否创建
• 跳转到年度工时看板时可手动输入年份；已有数据直接打开，无数据时只提示暂无数据
• 年度工时看板默认打开当年，按“上方总数据统计、下方月度趋势 + 任务类型占比 + 近期月份卡片”展示年度统计
• 年度任务类型占比使用该任务类型的计划工时 / 全年总计划工时统计
• 年度工时看板包含项目统计，可查看全年项目汇总，也可筛选到某个月
• 使用本地 JSON 保存月度数据，并按年份目录归档
• 可在插件设置中开启月度笔记创建，开启后实时同步看板、分类工时、日历、任务清单和每日工时明细；关闭时只维护本地 JSON 数据
• 可在插件设置中维护任务类型和默认任务模板
• 新月份按启用的默认任务模板自动创建任务；没有模板时不会自动生成任务
• 新增任务时可填写归属项目，内部任务标识自动生成且不在界面中展示
• 已登记过工时的任务不能删除，避免历史工时失去任务引用
• 新增工时，同一天同任务防重复
• 每日工时记录支持编辑和删除
• 月度数据看板，包含统计卡和计划/实际柱状图
• 日历按实际月份天数渲染
• 日历中的当日工时合计以悬浮层显示
• 手动勾选日期完成状态
• 任务状态下拉修改

启用方式

1. 确认插件目录位于：

.obsidian/plugins/worklog/

2. 重启 Obsidian 或在社区插件里刷新插件列表。
3. 启用 Worklog 插件。
4. 使用左侧日历按钮，或命令面板执行：

打开工时工作台
创建工时工作台
跳转到月份工时工作台
跳转到年度工时看板
打开年度工时看板

数据路径

插件配置路径：

.obsidian/plugins/worklog/config.json

默认数据路径：

<vault-config-dir>/plugins/worklog/data/YYYY/YYYY-MM.json

默认月度笔记路径：

worklog/YYYY-MM.md

旧版本的扁平数据路径 .obsidian/plugins/worklog/data/YYYY-MM.json 仍可读取；打开或保存对应月份后会迁移到年份目录中。

数据目录在设置中留空时会自动使用当前插件安装目录下的 data 文件夹；如果你的库配置目录不是 .obsidian，插件也会跟随 Obsidian 的实际配置目录保存数据。

首次启用时，任务类型和默认任务模板为空，需要先在 Worklog 设置中手动新增。设置面板中可以维护：

• 任务类型、颜色、启用状态、是否要求填写 issue
• 新月份默认任务模板、归属项目、计划工时
• 月度笔记同步开关和月度笔记目录
• JSON 数据保存位置

初始化

初始化插件数据时，只需要删除 config.json 和数据目录下的年份目录或月份 JSON。不要删除插件目录中的 main.js、styles.css、manifest.json 和 README.md。