Overtime Visualizer

English

Overtime Visualizer is an offline-first Obsidian dashboard for reviewing late departures, overnight work, weekend attendance, and recent workload pressure from local attendance records.

Features

• Calculates a standardized workload pressure score for the latest 30 days.
• Groups late departures into six mutually exclusive time ranges, including overnight work.
• Displays daily departure trends, reference lines, weekend markers, and a 30-day heatmap.
• Provides a dedicated attendance data management view.
• Imports attendance records from JSON files, JSON code blocks in Markdown, or pasted text.
• Previews added, updated, skipped, and invalid records before saving.
• Recognizes leave, missing punches, and overnight attendance records.
• Stores versioned data locally in the current vault and supports rolling back import batches.
• Exports a sanitized JSON backup that can be imported again.
• Supports both light and dark Obsidian themes.

Installation

After the plugin is available in the Community Plugins directory, search for Overtime Visualizer under Settings → Community plugins → Browse and install it.

For manual installation, copy the following files into <vault>/.obsidian/plugins/overtime-visualizer/:

main.js
manifest.json
styles.css

Reload Obsidian, then enable Overtime Visualizer in the Community plugins settings. Open the dashboard from the clock icon in the ribbon or run Open overtime dashboard from the command palette.

Import format limitation

The current version only supports the internal JD attendance data format. Attendance exports from other companies, platforms, or custom systems are not supported by default. To import another format, you must develop your own parser and conversion adapter.

Privacy

• Attendance records, relief records, and plugin settings remain in the current Obsidian vault.
• The plugin contains no telemetry, analytics, or advertising and does not upload attendance data to network services.
• Exported backups contain only allowlisted fields, and the user explicitly chooses the export location.

中文

一个离线优先的 Obsidian 下班压力看板，用于分析晚下班、跨夜工作和周末加班。

安装

发布到社区插件市场后，可在 Obsidian 的 设置 → 第三方插件 → 浏览 中搜索 Overtime Visualizer 并安装。

手动安装时，将以下文件放入仓库的 .obsidian/plugins/overtime-visualizer/ 目录：

main.js
manifest.json
styles.css

重新加载 Obsidian 后，在第三方插件设置中启用 Overtime Visualizer。

数据导入限制

当前版本仅支持导入京东内部的考勤数据格式，不保证兼容其他公司、平台或自定义格式的考勤数据。如需导入其他格式，请自行开发相应的数据解析与转换适配。

当前进度

当前版本已经打通本地真实数据链路：

• 固定近 30 天的标准化压力分、强制升级红线和轻松、适中、疲惫、痛苦评价
• 21:00–21:29、21:30–21:59、22:00–22:59、23:00–23:29、23:30–23:59 和跨夜六档互斥指标
• 22:00 后下班的上线日归因与前 30 天压力变化
• 默认展示含今天在内近 30 天、并可自定义日期区间的每日下班时间折线图
• 带 21:00、21:30、22:00、23:00、23:30 和跨夜参考线及周末标记
• 固定近 30 天下班时间热力图
• 独立的考勤数据管理 ItemView
• JSON 文件、Markdown 多 JSON 代码块和粘贴文本导入
• 新增、更新、跳过、错误的写入前预览
• 隐私字段白名单清洗、请假/缺卡/跨夜识别
• Obsidian data.json 版本化本地存储和导入批次回滚能力
• 可通过命令面板导出可重新导入的脱敏 JSON 备份
• Obsidian 深色与浅色主题适配

本地开发

npm install
npm run dev

插件 ID 为 overtime-visualizer。用于本地测试的插件目录或软链接名称应与该 ID 保持一致。若源码目录不在测试笔记库中，可在笔记库的 .obsidian/plugins/ 目录创建名为 overtime-visualizer 的软链接。

生产校验：

npm run test:run
npm run build
npm run lint

在 Obsidian 命令面板执行 打开加班时长仪表盘，或点击左侧栏的时钟图标。

隐私

• 所有考勤记录、舒缓记录和插件设置仅保存在当前 Obsidian 仓库的插件数据中。
• 插件不包含遥测、分析或广告，不会把考勤数据上传到网络服务。
• 导出的备份仅包含白名单字段；导出文件的位置由用户主动选择。

发布文件

GitHub Release 的标签必须与 manifest.json 中的版本完全一致。每个 Release 应分别上传：

• main.js
• manifest.json
• styles.css

License

MIT