# Worklog Obsidian Plugin

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

## 当前能力

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

## 启用方式

1. 确认插件目录位于：

```text
.obsidian/plugins/worklog/
```

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

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

## 数据路径

插件配置路径：

```text
.obsidian/plugins/worklog/config.json
```

默认数据路径：

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

默认月度笔记路径：

```text
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`。