dootask/resources/ai-kb/zh/howto/system-setting/checkin.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
system-setting.checkin.howto	签到规则设置	howto	system-setting	admin	zh	签到设置 打卡规则 配置签到 签到时间 上下班时间 地理围栏 人脸打卡 配置打卡 跨天打卡 签到地图			需要系统管理员权限 启用人脸模式必须先安装 face 插件 启用定位模式必须有对应地图服务商的 Key	提前 + 延后时间之和必须 < 24h-工时，否则报「提前和延后时间设置存在重叠」 关闭签到（open=close）时 key 会自动轮换（再开启需要重新分发设备） 不支持给不同部门设置不同打卡规则，全公司共享一套 不支持自动按公历节假日跳过打卡	v1.7.90

签到规则设置

入口

桌面端：左上角头像 →「系统设置」→「签到」。 对应后端：POST api/system/setting/checkin，参数 type=save。

字段说明

• open — 签到总开关（open / close）
• time — 上下班时间数组，如 ["09:00","18:00"]（支持跨天班次）
• advance — 允许提前打卡分钟数（默认 120）
• delay — 允许延后打卡分钟数（默认 120）
• remindin — 上班前 X 分钟提醒（默认 5）
• remindexceed — 下班后超 X 分钟未打卡提醒（默认 10）
• edit — 是否允许员工自行补卡（open / close）
• modes — 支持的打卡方式数组，取值 auto / manual / locat / face
• manual_remark — 手动签到的展示文案
• face_upload / face_remark / face_retip — 人脸打卡配置
• locat_map_type — 地图服务商（baidu / amap / tencent）
• locat_bd_lbs_key / locat_amap_key / locat_tencent_key — 对应地图 Key
• locat_*_point — {lng, lat, radius} 单点电子围栏
• key — 签到机器自动生成的访问密钥（关闭再开启会重置）

操作步骤

1. 选择支持的打卡方式（多选）
2. 填写上下班时间、提前/延后窗口
3. 启用「定位」时选地图服务商并填 Key + 中心点+半径
4. 启用「人脸」时确认 face 插件已装
5. 保存后系统会自动创建/复用 check-in 机器人账号
6. 服务端返回 cmd 字段（base64），是签到机/考勤机的接入命令

不支持

• 不支持单日多班次（如午休拆成 4 个时间点），只取 time[0] 和 time[1]
• 不支持给部门 / 项目单独配置规则
• 不允许提前 + 延后窗口之和超过「24 小时 - 工时长度」（会校验失败）
• 人脸模式必须依赖 face 插件，不能用浏览器 WebRTC 直采