📌 这个插件到底能做什么？

lark-attendance 本质上是一个 AI Skill（技能包），它的核心任务只有一个：帮你在 AI 对话中直接调取飞书考勤打卡数据。

你不需要打开飞书管理后台，不需要导出 Excel，甚至不需要记住任何 API 参数。只需要在 AI 助手的对话窗口里说一句“帮我查一下上个月的考勤记录”，lark-attendance 就会自动完成认证、参数填充、数据拉取全过程，把结果呈现在你面前。

技术上，它封装了飞书开放平台的 attendance:task:readonly 只读接口，通过 lark-cli 命令行工具与飞书通信。插件会自动注入两个固定参数——employee_type 设为 "employee_no"，user_ids 保持为空数组——你完全不需要关心这些技术细节。

简单来说：这是一个让 AI 替你跑腿查考勤的“小秘书”。

🔧 安装步骤：两条命令，三分钟搞定

lark-attendance 的安装非常简单，前提是你的电脑上已经安装了 Node.js 和 npx。

在终端中执行以下命令即可完成安装：

npx skills add https://github.com/larksuite/cli --skill lark-attendance

或者使用另一个镜像源：

npx skills add https://github.com/wecode-ai/wework-plugins --skill lark-attendance

安装完成后，首次调用前需要运行一次环境准备脚本：

  • macOS / Linux：
sh "<插件根目录>/scripts/ensure-lark-ready.sh"
  • Windows：
powershell -NoProfile -ExecutionPolicy Bypass -File "<插件根目录>\scripts\ensure-lark-ready.ps1"

这个脚本会帮你配置好 lark-cli 环境，包括 OAuth 认证和权限校验。整个过程由官方 CLI 在本机管理，不需要你在对话中粘贴 App Secret 或 Access Token，安全性有保障。

💼 谁适合用这个插件？

lark-attendance 覆盖的场景比你想象的要广：

  • 👨‍💻 开发者 & AI 工具重度用户：如果你在用 Claude Code、Codex CLI 或 Cursor 这类 AI 编程助手，lark-attendance 能让你的 AI 助理直接“看到”你的考勤数据。写周报、填工时、复盘出勤，全部在对话中完成。

  • 🧑‍💼 HR 与行政人员：做考勤抽查、异常核对的时候，不需要反复登录后台查这查那。让 AI 批量拉取数据、汇总异常记录，效率提升不止一个档次。

  • 📊 数据分析师：把考勤数据拉到本地做分析、做报表，lark-attendance 提供了最干净的 API 入口。结合自动化脚本，你可以实现“每日考勤自动归档”。

  • 🧑‍💼 普通打工人：月底核对考勤的时候，直接在 AI 对话框里问一句“我这个月迟到几次”，比打开 App 翻半天快得多。

📋 真实使用案例

案例一：月度考勤自查

小王是某互联网公司的后端工程师，每个月发工资前都要核对考勤。以前他要打开飞书 App → 考勤模块 → 选择日期范围 → 截图保存，一套操作下来至少五分钟。现在他在 Claude Code 里输入：

“帮我查一下 2026 年 8 月的考勤打卡记录”

lark-attendance 自动调用 API，几秒钟就把整个月的打卡记录返回给他。

案例二：HR 批量抽查

某公司 HR 小张需要每周抽查一次各部门的考勤异常情况。她写了一个简单的自动化脚本，每天凌晨通过 lark-attendance 拉取全公司（需配置相应权限）的考勤数据，自动生成异常报告并发送到工作群。原来需要半天的工作，现在全自动完成。

案例三：个人时间管理

自由职业者小李同时在多个项目之间切换，需要精准记录自己的工作时间。他通过 lark-attendance 的 API 接口，把飞书打卡记录同步到自己的时间追踪仪表盘上，每周自动生成工时统计报表。

⚙️ 调用方式：懂技术的人看这里

如果你需要在自己的脚本或工具中调用 lark-attendance，核心 API 方法只有一个：

lark-cli attendance user_tasks query [flags]

调用前务必先用 schema 命令查看参数结构，不要凭感觉猜测字段格式：

lark-cli schema attendance.user_tasks.query

插件会自动为你填充两个固定参数，不需要你在请求中手动添加：

参数固定值说明
employee_type"employee_no"固定为工号类型
user_ids[]（空数组）始终为空，查询当前用户

所需权限范围：attendance:task:readonly——只读权限，不会对你的考勤数据做任何修改。

✅ 常见问题

Q：这个插件收费吗？
A：完全开源免费，MIT 协议。

Q：支持 Windows 吗？
A：支持。macOS、Linux、Windows 全平台覆盖，每个平台都有对应的脚本。

Q：需要飞书管理员权限吗？
A：不需要。只需要你有飞书账号，并且企业开启了考勤功能即可。OAuth 认证由 CLI 在本机完成。

Q：能查别人的考勤吗？
A：默认只能查自己的。如果需要查询他人数据，需要额外的企业级权限配置。

Q：数据安全吗？
A：认证信息存储在本地 ~/.lark-cli 目录中，不会被上传或记录。所有通信走飞书官方 API，只读权限不会修改任何数据。

🚀 写在最后

lark-attendance 不是什么颠覆性的产品，它解决的是一个很小但很真实的问题——让考勤数据触手可及。

在 AI 工具越来越普及的今天，我们缺的不是数据，而是让数据流动起来的“管道”。lark-attendance 就是这样一根管道：一头连着飞书，一头连着你的 AI 助理。安装一次，随时调用。

目前这个插件在各大 Skill 平台上的安装量已经超过 30 万次，GitHub 上获得了 1.5 万+ Stars——数据说明一切，它确实帮很多人省下了时间。

如果你也在用飞书、也在用 AI 编程助手，不妨花三分钟装上试试。说不定下个月的考勤核对，就再也不用你亲自动手了。