feishu-attendance

核心用法

该Skill是一款基于Node.js的飞书考勤监控工具，通过命令行接口提供灵活的考勤检查能力。基础用法为执行node index.js check进行当日考勤检查，支持--date参数指定任意历史日期（如"2023-10-27"），以及--dry-run参数开启测试模式（仅模拟运行不实际发送消息）。工具通过调用飞书开放平台的官方API获取员工考勤数据，智能识别迟到、早退、缺勤等异常状态，自动生成富文本交互卡片报告发送给管理员，同时可选向员工推送个人异常提醒。

显著优点

该工具在工程设计和安全考量上表现突出：集成timor.tech API自动识别中国大陆节假日与周末，避免在休息日误发通知打扰员工；独创的Safe Mode安全机制在节假日API故障时自动禁用用户通知，有效防止消息轰炸风险；采用本地文件缓存策略（用户列表24小时TTL、节假日数据），既显著提升性能又减少API调用成本；权限申请严格遵循最小化原则，仅申请读取考勤、用户列表和发送消息三项必要权限；完善的输入验证机制支持智能日期解析（如"1.27"自动补全为"2026-01-27"），并支持批量用户ID分块处理（每批50个）。

潜在缺点

作为T3级别（个人开发者GitHub账号）的社区开源项目，其长期维护的稳定性与持续性相比飞书官方或企业级方案存在一定不确定性；功能强依赖第三方节假日API服务（timor.tech），若该服务长期不可用或数据错误，虽会触发Safe Mode，但仍可能影响节假日判断的准确性；目前仅深度适配飞书（Lark）平台，无法迁移至钉钉、企业微信等其他办公系统；本地缓存机制虽提升性能，但员工列表等敏感数据存储在本地文件，需确保服务器文件权限配置得当。

适合目标群体

主要面向已部署飞书办公系统的中小企业HR部门、行政管理人员及团队负责人。特别适合当前依赖人工每日登录飞书后台、手动导出Excel统计考勤异常并逐一通知员工的场景，可将耗时的人工检查流程完全自动化。对于注重数据隐私合规、不愿将考勤数据上传至第三方SaaS平台，希望数据严格保留在企业自有飞书租户内的组织尤为适合。同时适合需要灵活定制考勤规则通知逻辑的技术驱动型团队。

使用风险

使用该Skill需妥善保管飞书应用凭证（FEISHU_APP_ID与FEISHU_APP_SECRET），若环境变量配置不当导致泄露，可能导致企业通讯录及考勤数据被非法访问；依赖外部网络服务（timor.tech节假日接口）存在可用性风险，尽管有Safe Mode兜底，但极端情况下可能影响功能完整性；批量发送消息场景可能触发飞书开放平台API的频率限制；本地缓存文件若服务器权限配置不当，可能导致员工个人信息泄露。建议生产环境部署前务必使用--dry-run参数充分测试验证，并建立定期凭证轮换机制。