Skip to content

luhui111/qywx-kaoqin-assistant

Repository files navigation

企业微信考勤小助手 · HR提效

企业微信导出的打卡记录和审批表,一键汇总成月度考勤表。纯离线、单文件、数据不上传。

给 HR 提效的小工具:每月几百人的迟到 / 缺卡 / 加班 / 调休 / 请假 / 出勤天数,自动算好、自动汇总,并列出需人工复核的异常清单。

企业微信考勤小助手 · 拖入导出表,一键汇总成 3 份结果


✨ 特性

  • 🔒 纯离线:单个 HTML 文件,浏览器打开即用,数据全程在本地,不联网、不上传,断网也能跑
  • 📦 零安装:Windows / Mac 双击即可,不依赖任何软件
  • 🤖 自动汇总:迟到 / 缺卡 / 加班 / 调休 / 请假 / 出差 / 实际出勤天数
  • 👥 中途入离职自动折算出勤天数
  • 📄 三份产出:汇总表(成品)+ 考勤明细 + 复核清单(异常待核)
  • ⚙️ 上班时间、节假日、月份等都可在页面上改

🚀 快速开始(给 HR)

干净的拖拽界面:6 个框,前 5 必需 + 离职表可选

直接用打包好的 考勤汇总工具.html

  1. 双击用浏览器打开(Chrome / Edge / Safari 都行)
  2. 把导出的几份表拖进对应的框(按文件名自动识别)
  3. 点「开始汇总」,下载 3 份结果

完整步骤见 使用说明.txt

📥 需要的输入(从企业微信导出)

文件 来源 必需
打卡记录 企业微信 → 考勤 → 统计 → 打卡时间记录 → 导出
请假审批 企业微信 → 审批 → 导出明细
加班审批 企业微信 → 审批 → 导出明细
出差审批 企业微信 → 审批 → 导出明细
汇总表模板 上个月的「考勤汇总表」(提供员工名单 + 表格样式)
花名册 / 离职表 含「员工姓名 / 入职日期 / 离职时间」,离职名单放在「离职人员」工作表 可选,建议

📤 输出

  • X月考勤汇总表(自动).xlsx —— 最终成品,套用你的模板样式
  • 考勤记录明细表(自动).xlsx —— 每人每天打卡 + 请假/加班/调休标注 + 出勤天数
  • 复核清单(自动).xlsx —— 迟到 / 缺卡 / 本月离职 / 新增人员 / 审批中 等需人眼确认的项

📐 计算口径

  • 迟到:上班时间(默认 9:00)之后算迟到,无宽限;补卡、管理员校准不算
  • 早退:默认不考核
  • 缺卡:工作日只打了一次卡
  • 加班 / 调休:以审批表为准(备注「加班费」计入加班、「调休」计入调休;休息日加班按特殊加班)
  • 请假:审批通过小时数 ÷ 8 = 天
  • 实际出勤天数 = 应出勤(默认 26)− 入职前/离职后的工作日 − 事假 − 病假
  • 出差:不扣出勤,仅作记录

默认工作制为「上六休一」(周日休),应出勤 = 当月非周日天数。月份、节假日、上班时间、每日小时数都可在页面「设置」区调整。

🛠 自行构建 / 二次开发

npm install
npm run build                 # 生成单文件 考勤汇总工具.html
npm test                      # 运行引擎单元测试
node src/cli.mjs <数据目录>    # 命令行批处理同目录下的导出表

技术栈:纯 JS 引擎(src/engine/*,零运行时依赖)+ ExcelJS 读写 xlsx + esbuild 内联打包成单文件 HTML(离线、可直接分发)。

src/
  engine/   口径与汇总逻辑(calendar/rules/aggregate/parse/names/special/time)
  io/       xlsx 读写(readWorkbook/writeSummary/writeDetail/writeReview)
  ui/       浏览器界面(拖拽、运行、下载)
  cli.mjs   命令行入口
build/      esbuild 打包脚本

🔐 隐私

工具完全在你电脑的浏览器里运行,不联网、不上传任何数据。本仓库不包含任何真实考勤数据,仅含工具代码。

📄 License

MIT

About

【企业微信考勤小助手·HR提效】企业微信打卡/审批一键汇总成月度考勤表,纯离线单文件,数据不上传

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages