README.zh.md

PunchPal - 工时助手

English | 简体中文

PunchPal 是一款高效的工时管理工具。无论是手动添加打卡记录，还是配置 API 数据源，PunchPal 都能帮您轻松追踪、分析和优化工作时间。

---

🚀 功能特色

1. 手动记录或 API 集成

• 手动添加上下班打卡记录，灵活便捷。
• 配置 API 数据源，自动同步每日打卡记录。

2. 每日工时展示

• 以列表形式直观查看每日工时。
• 支持按日期范围筛选，专注特定时间段的数据。

3. 月度日历概览

• 在日历视图中直观查看整月的工时记录。
• 快速掌握每日工作情况。

4. 月度对比概览

• 当前月与上月的工时对比一目了然。
• 综合统计视图，助您发现规律，优化时间管理。

5. 交互式仪表盘

• 数据趋势可视化，界面清晰直观。
• 显示总工时、加班时长、每日平均工时等关键指标。

---

🛠️ 安装步骤

安装步骤

1. 克隆仓库：

   git clone https://github.com/hehang0/PunchPal.git

2. 进入项目目录：

   cd PunchPal

3. 构建并运行应用：

   dotnet build
   dotnet run

---

🎨 截图预览

每日工时列表

月度日历概览

仪表盘概览

---

🔧 配置指南

API 数据源设置

1. 在应用中打开 设置 菜单。
2. 输入 API 端点和认证信息。
3. 测试连接，确保数据同步正常。

---

🛡️ 许可证

PunchPal 使用 Anti-996 许可证。欢迎遵循许可证要求使用、修改和分发。

---

🤝 贡献方式

欢迎大家贡献代码！步骤如下：

1. Fork 此仓库。

2. 创建功能分支：

   git checkout -b feature-name

3. 提交更改并推送分支：

   git commit -m "添加新功能"
   git push origin feature-name

4. 提交 Pull Request，并描述您的更改。

---

📧 联系方式

如有任何问题或反馈，欢迎通过以下方式联系我们：

• GitHub 问题: 提交问题