SuperAPI AI 工具集

dingtalk-attendance

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:钉钉考勤 Skill 提供 dws attendance 命令族,用于查询与维护钉钉考勤相关数据,覆盖打卡记录、打卡结果、排班、班次、考勤组、补卡/加班/请假规则、假期余额、签到记录与考勤报表。

主要能力:查询类包括打卡流水(+check-record)、打卡结果(+check-result)、排班(+get-schedule)、考勤统计摘要(+get-summary)、考勤审批单(+list-approve)、假期规则与余额变更(+list-leave-types、+get-leave-records)、个人规则设置(+get-self-setting)、报表数据(+query-report-data,仅管理员)等;写操作覆盖创建班次、导入排班、加人入考勤组、保存个人规则设置、设置假期余额等。

使用方式:需先阅读 dws-shared skill 了解认证、全局参数、产品路由、URL 预检、错误码与安全规则,且 dws 二进制须在 PATH 中。命令前缀为 dws attendance,建议加 --format json。可用 dws shortcut list --service attendance --format json 查看 shortcut 参数与风险,用 dws attendance <shortcut> --help 核对 flags。典型命令如 dws attendance record get --user <userId> --date <YYYY-MM-DD>、dws attendance summary --user <userId> --date <YYYY-MM-DD> --stats-type week|month。

限制:本 Skill 为试验版(EXPERIMENTAL),multi 模式未达 stable,接口与命名可能调整,生产环境建议用 mono 模式(dws skill setup --mode mono)。命令可用性以当前 dws 二进制为准,服务发现已下线,若 dws <cmd> --help 不存在则说明该版本未暴露。写操作必须先展示参数摘要并二次确认,再加 --yes 执行。summary 必须同时传 --user、--date、--stats-type,缺一返回 C0002;shift list 跨度不超过 7 天、最多 50 人;record get 一次只查一个用户一天。report 系列仅管理员。查询迟到/缺勤时,空打卡结果不等于无人迟到,需结合排班、NotSigned、Absenteeism 与无记录人员分别说明。做部门 Top N 排名须输出 N 个部门,无数据部门按 0 或“无数据”保留。跨产品协作时,拿到 userId 前先用 dingtalk-aisearch 解析人名。