@xiaoyuanhao/yunzhi-cli 2.0.0 → 2.1.0

package/lib/cli.cjs

@@ -4,6 +4,129 @@ const { Failure, invalid, success } = require('./result.cjs');
 const guidance = require('./command-guidance.cjs');
 const { unknownCommand, unknownOption } = require('./suggestions.cjs');
 const usage = {
+  ...require('./contact-help.cjs').usage,
+  ...require('./school-help.cjs').usage,
+  'leave approval-entry': '--task-id <task_id>',
+  'leave resumption-approval-entry': '--task-id <task_id>',
+  'student-leave approval-entry': '--task-id <task_id>',
+  'student-leave resumption-approval-entry': '--task-id <task_id>',
+  'attendance correction-approval-entry': '--task-id <task_id>',
+
+
+
+  'leave approval-form-people-search': '--task-id <task_id> --field-key <field_key> --keyword <text>',
+  'leave resumption-approval-form-people-search': '--task-id <task_id> --field-key <field_key> --keyword <text>',
+  'student-leave approval-form-people-search': '--task-id <task_id> --field-key <field_key> --keyword <text>',
+  'student-leave resumption-approval-form-people-search': '--task-id <task_id> --field-key <field_key> --keyword <text>',
+  'leave form-people-search': '--workflow-code <program_code> --field-key <field_key> --keyword <text>',
+  'leave resumption-form-people-search': '--workflow-code <program_code> --field-key <field_key> --keyword <text> --leave-id <leave_id>',
+  'student-leave form-people-search': '--workflow-code <program_code> --field-key <field_key> --keyword <text> --class-id <class_id> --student-id <student_id>',
+  'student-leave resumption-form-people-search': '--workflow-code <program_code> --field-key <field_key> --keyword <text> --leave-id <leave_id> [--student-id <student_id>]',
+
+
+
+
+
+  'student-leave resumption-approvals': '--category pending|handled|copied [--page <page>] [--page-size 1..50] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--applicant-id <id>] [--applicant-name <name>] [--subject-id <id>] [--subject-name <name>]',
+  'student-leave resumption-approval': '--category pending|handled|copied --task-id <task_id> [--notice-id <notice_id>]',
+  'student-leave resumption-approve': '--task-id <task_id> [--opinion <text>] [--field-values <json-array|@path>]',
+  'student-leave resumption-reject': '--task-id <task_id> --return-to start|previous [--opinion <text>]',
+  'student-leave approvals': '--category pending|handled|copied [--page <page>] [--page-size 1..50] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--applicant-id <id>] [--applicant-name <name>] [--subject-id <id>] [--subject-name <name>]',
+  'student-leave approval': '--category pending|handled|copied --task-id <task_id> [--notice-id <notice_id>]',
+  'student-leave approve': '--task-id <task_id> [--opinion <text>] [--field-values <json-array|@path>]',
+  'student-leave reject': '--task-id <task_id> --return-to start|previous [--opinion <text>]',
+
+  'student-leave resumption-list': '--scope managed|mine [--class-id <class_id>] [--student-id <student_id>] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--status <status>] [--page <n>] [--page-size <1-50>]',
+  'student-leave resumption-show': '--id <id>',
+  'student-leave resumption-remind': '--id <id>',
+  'student-leave resumption-withdraw': '--id <id>',
+  'student-leave resumption-form': '--leave-id <leave_id> [--student-id <student_id>] [--workflow-code <program_code>] [--resumption-time <datetime>] [--reason <text>] [--field-values <json-array|@path>]',
+  'student-leave resumption-submit': '--leave-id <leave_id> [--student-id <student_id>] --workflow-code <program_code> --resumption-time <datetime> [--reason <text>] [--field-values <json-array|@path>]',
+
+
+  'student-leave submit': '--class-id <class_id> --student-id <student_id> --workflow-code <program_code> [--field-values <json-array|@path>]',
+  'student-leave form': '--class-id <class_id> --student-id <student_id> [--workflow-code <program_code>] [--field-values <json-array|@path>]',
+  'student-leave list': '--scope managed|mine [--class-id <class_id>] [--student-id <student_id>] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--status <status>] [--page <n>] [--page-size <1-50>]',
+  'student-leave show': '--id <id>',
+  'student-leave remind': '--id <id>',
+  'student-leave withdraw': '--id <id>',
+  'student-leave classes': '',
+  'student-leave students': '[--class-id <class_id>] [--name <text>] [--page <n>] [--page-size <1-50>]',
+  'dormitory-attendance applicable-rule': '--target-user-id <user_id> --date YYYY-MM-DD',
+  'student-attendance applicable-rule': '--target-user-id <user_id> --date YYYY-MM-DD',
+  'attendance applicable-rule': '--date YYYY-MM-DD [--scope mine|managed] [--target-user-id <user_id>]',
+  'attendance show': '--date YYYY-MM-DD [--scope mine|managed] [--target-user-id <user_id>]',
+  'attendance clock-entry': '',
+  'attendance configuration-entry': '[--target rules|devices|workflows|resumption-method]',
+  'student-attendance configuration-entry': '[--target rules|devices|workflows|resumption-method]',
+  'dormitory-attendance configuration-entry': '[--target rules|devices]',
+  'attendance statistics': '--month YYYY-MM',
+  'attendance report-summary': '--month YYYY-MM [--rule-id <rule_id>] [--keyword <text>] [--page <n>] [--page-size <1-100>]',
+  'attendance correction-show': '--id <id>',
+  'attendance correction-list': '[--status <draft|processing|completed|returned|withdrawn>] [--page <n>] [--page-size <1-50>] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD]',
+  'attendance correction-approval': '--category <pending|handled|copied> --task-id <task_id> [--notice-id <notice_id>]',
+  'attendance correction-approve': '--task-id <task_id> [--opinion <text>] [--field-values <json-array|@path>]',
+  'attendance correction-reject': '--task-id <task_id> --return-to <start|previous> [--opinion <text>]',
+  'attendance correction-approvals': '--category <pending|handled|copied> [--page <n>] [--page-size <1-50>] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--applicant-id <id>] [--applicant-name <name>]',
+
+
+  'attendance correction-submit': '--date <YYYY-MM-DD> --result-id <result_id> --correction-time <YYYY-MM-DD HH:mm:ss> [--field-values <json-array|@path>]',
+  'attendance correction-approval-form-people-search': '--task-id <task_id> --field-key <field_key> --keyword <text>',
+  'attendance correction-form-people-search': '--date YYYY-MM-DD --result-id <result_id> --field-key <field_key> --keyword <text>',
+  'attendance correction-form': '--date YYYY-MM-DD --result-id <result_id> [--correction-time <datetime>] [--field-values <json-array|@path>]',
+  'student-attendance remark': '--target-user-id <user_id> --date YYYY-MM-DD --result-id <result_id> (--remark <text> | --clear)',
+  'student-attendance manual-entries': '--date YYYY-MM-DD',
+  'student-attendance manual-entry-delete': '--id <id>',
+  'dormitory-attendance manual-entries': '--date YYYY-MM-DD',
+  'dormitory-attendance manual-entry-delete': '--id <id>',
+  'student-attendance manual-entry': '--target-user-id <user_id> --class-id <class_id> --date YYYY-MM-DD [--time-window <time_bucket> --direction <in|out>]',
+  'student-attendance report-remark': '--target-user-id <user_id> --date YYYY-MM-DD --time-window <time_bucket> (--remark <text> | --clear)',
+  'dormitory-attendance report-remark': '--target-user-id <user_id> --date YYYY-MM-DD --time-window <time_bucket> (--remark <text> | --clear)',
+  'student-attendance report-tag': '--report-id <report_id>',
+  'student-attendance report-class': '--report-id <report_id> --class-id <class_id>',
+  'student-attendance report-summary': '--report-id <report_id>',
+  'dormitory-attendance report-group': '--report-id <report_id>',
+  'dormitory-attendance manual-entry': '--target-user-id <user_id> --room-id <bedroom_id> --date YYYY-MM-DD [--group-id <manage_id>] [--report-id <report_id>] [--time-window <time_bucket>]',
+  'dormitory-attendance report-room': '--report-id <report_id> --room-id <bedroom_id>',
+  'dormitory-attendance report-summary': '--report-id <report_id>',
+  'student-attendance reports': '(--delivery-date YYYY-MM-DD | --start-date YYYY-MM-DD --end-date YYYY-MM-DD)',
+  'dormitory-attendance reports': '(--delivery-date YYYY-MM-DD | --start-date YYYY-MM-DD --end-date YYYY-MM-DD)',
+  'student-attendance report-remarks': '--target-user-id <user_id> --date YYYY-MM-DD',
+  'dormitory-attendance report-remarks': '--target-user-id <user_id> --date YYYY-MM-DD',
+  'dormitory-attendance remark': '--target-user-id <user_id> --date YYYY-MM-DD --result-id <result_id> (--remark <text> | --clear)',
+  'attendance remark': '[--scope mine|managed] [--target-user-id <user_id>] --date YYYY-MM-DD --result-id <result_id> (--remark <text> | --clear)',
+  'student-attendance show': '--target-user-id <user_id> --date YYYY-MM-DD',
+  'attendance list': '[--scope mine|managed] --start-date YYYY-MM-DD --end-date YYYY-MM-DD [--target-user-id <user_id>] [--name <text>] [--rule-id <rule_id>] [--abnormal | --status <status>] [--page <n>] [--page-size <1-50>]',
+  'dormitory-attendance show': '--target-user-id <user_id> --date YYYY-MM-DD',
+  'dormitory-attendance rooms': '[--name <text>] [--building-name <text> | --building-id <id>] [--page <n>] [--page-size 1..50]',
+  'dormitory-attendance statistics': '--start-date YYYY-MM-DD --end-date YYYY-MM-DD [--target-user-id <user_id>] [--name <text>] [--rule-id <rule_id>] [--period <n>] [--abnormal | --status <status>] [--class-id <class_id> | --group-id <manage_id>]',
+  'dormitory-attendance list': '--start-date YYYY-MM-DD --end-date YYYY-MM-DD [--target-user-id <user_id>] [--name <text>] [--rule-id <rule_id>] [--period <n>] [--abnormal | --status <status>] [--page <n>] [--page-size <1-50>] [--class-id <class_id> | --group-id <manage_id>]',
+  'student-attendance tags': '--name <text>',
+  'student-attendance list': '--start-date YYYY-MM-DD --end-date YYYY-MM-DD [--target-user-id <user_id>] [--name <text>] [--rule-id <rule_id>] [--abnormal | --status <status>] [--page <n>] [--page-size <1-50>] [--class-id <class_id>] [--tag-id <tag_id>]',
+
+  'leave resumption-form': '--leave-id <leave_id> [--workflow-code <program_code>] [--resumption-time <datetime>] [--reason <text>] [--field-values <json-array|@path>]',
+  'leave resumption-list': '[--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--leave-type <type>] [--status draft|processing|completed|returned|rejected|withdrawn|unknown] [--reason <text>] [--page <n>] [--page-size <1-100>]',
+  'leave resumption-remind': '--id <id>',
+  'leave resumption-withdraw': '--id <id>',
+  'leave resumption-show': '--id <id>',
+  'leave resumption-submit': '--leave-id <leave_id> --workflow-code <program_code> --resumption-time <datetime> [--reason <text>] [--field-values <json-array|@path>]',
+
+
+  'leave submit': '--workflow-code <program_code> [--field-values <json-array|@path>]',
+  'leave resumption-approve': '--task-id <task_id> [--opinion <text>] [--field-values <json-array|@path>]',
+  'leave approve': '--task-id <task_id> [--opinion <text>] [--field-values <json-array|@path>]',
+  'leave resumption-reject': '--task-id <task_id> --return-to start|previous [--opinion <text>]',
+  'leave reject': '--task-id <task_id> --return-to start|previous [--opinion <text>]',
+  'leave resumption-approval': '--category pending|handled|copied --task-id <task_id> [--notice-id <notice_id>]',
+  'leave approval': '--category pending|handled|copied --task-id <task_id> [--notice-id <notice_id>]',
+  'leave resumption-approvals': '--category pending|handled|copied [--page <page>] [--page-size 1..50] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--applicant-id <id>] [--applicant-name <name>] [--subject-id <id>] [--subject-name <name>]',
+  'leave approvals': '--category pending|handled|copied [--page <page>] [--page-size 1..50] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--submitted-start-date YYYY-MM-DD --submitted-end-date YYYY-MM-DD] [--applicant-id <id>] [--applicant-name <name>] [--subject-id <id>] [--subject-name <name>]',
+  'leave show': '--id <id>',
+
+  'leave form': '[--workflow-code <program_code>] [--field-values <json-array|@path>]',
+  'leave remind': '--id <id>',
+  'leave withdraw': '--id <id>',
+  'leave list': '[--scope mine|managed] [--start-date YYYY-MM-DD --end-date YYYY-MM-DD] [--leave-type <type>] [--status draft|processing|completed|returned|rejected|withdrawn|unknown] [--reason <text>] [--page <n>] [--page-size <1-100>]',
   'auth login': '--scope <scope> [--scope <scope>...]\n  或 auth login --device-code <device_code>',
   'auth connect': '--scope <scope> [--scope <scope>...]',
   'auth status': '[--verify]', 'auth logout': '',
@@ -46,6 +169,120 @@ Object.assign(usage, {
 });
 
 const summaries = {
+  ...require('./contact-help.cjs').summaries,
+  ...require('./school-help.cjs').summaries,
+
+
+  'leave approval-entry': '获取本人当前待办的原客户端审批入口',
+  'leave resumption-approval-entry': '获取本人当前待办的原客户端审批入口',
+  'student-leave approval-entry': '获取本人当前待办的原客户端审批入口',
+  'student-leave resumption-approval-entry': '获取本人当前待办的原客户端审批入口',
+  'attendance correction-approval-entry': '获取本人当前待办的原客户端审批入口',
+
+
+  'leave approval-form-people-search': '填写审批表单中的人员字段时，按姓名找人',
+  'leave resumption-approval-form-people-search': '填写审批表单中的人员字段时，按姓名找人',
+  'student-leave approval-form-people-search': '填写审批表单中的人员字段时，按姓名找人',
+  'student-leave resumption-approval-form-people-search': '填写审批表单中的人员字段时，按姓名找人',
+  'leave form-people-search': '填写申请表单中的人员字段时，按姓名找人',
+  'leave resumption-form-people-search': '填写申请表单中的人员字段时，按姓名找人',
+  'student-leave form-people-search': '填写申请表单中的人员字段时，按姓名找人',
+  'student-leave resumption-form-people-search': '填写申请表单中的人员字段时，按姓名找人',
+
+
+
+
+
+  'student-leave resumption-approvals': '查询学生销假待办、已办或抄送',
+  'student-leave resumption-approval': '查询学生销假审批详情与当前允许动作',
+  'student-leave resumption-approve': '同意当前学生销假审批节点',
+  'student-leave resumption-reject': '退回当前学生销假审批节点',
+  'student-leave approvals': '查询学生请假待办、已办或抄送',
+  'student-leave approval': '查询学生请假审批详情与当前允许动作',
+  'student-leave approve': '同意当前学生请假审批节点',
+  'student-leave reject': '退回当前学生请假审批节点',
+
+  'student-leave resumption-list': '按职责内或本人代办范围查询学生销假',
+  'student-leave resumption-show': '读取学生销假详情与进度',
+  'student-leave remind': '催办本人代学生提交的处理中请假申请',
+  'student-leave withdraw': '撤回本人代学生提交的处理中请假申请',
+  'student-leave resumption-remind': '催办本人指定的处理中学生销假申请',
+  'student-leave resumption-withdraw': '撤回本人指定的处理中学生销假申请',
+  'student-leave resumption-form': '查看代学生销假要填什么，汇总缺项和错误',
+  'student-leave resumption-submit': '为职责内学生提交销假申请',
+
+
+  'student-leave submit': '按实际表单为明确选定的学生提交请假申请',
+  'student-leave form': '查看代学生请假要填什么，汇总缺项和错误',
+  'student-leave list': '按职责内或本人代办范围查询学生请假', 'student-leave show': '查询学生请假详情、进度及关联销假',
+  'student-leave': '学生请假', 'student-leave classes': '查询学生请假职责班级',
+  'student-leave students': '在职责班级内按姓名查找学生',
+  'attendance list': '按日期区间查询本人或管理范围内教师考勤时段', 'student-attendance': '学生校门考勤',
+  'student-attendance tags': '按名称查找可用于学生考勤筛选的标签',
+  'student-attendance list': '按日期、班级或标签查询学生校门考勤',
+  'dormitory-attendance': '宿舍考勤', 'dormitory-attendance show': '查询职责范围内指定学生某日宿舍考勤详情', 'dormitory-attendance list': '查询职责范围内学生宿舍考勤时段',
+  'dormitory-attendance rooms': '按名称查找职责范围内的宿舍房间',
+  'dormitory-attendance statistics': '统计一段时间的正常、晚归、未归等宿舍考勤时段条数',
+  'attendance statistics': '查询本人已保存的月度考勤统计及逐日计数',
+  'attendance report-summary': '查询管理员范围内的教师月报汇总和逐日明细',
+  'student-attendance show': '查询职责范围内指定学生某日校门考勤详情',
+  'attendance correction-show': '查看本人补卡申请详情及审批进度',
+  'attendance correction-list': '查询本人补卡申请列表',
+  'attendance correction-approval': '查看补卡审批字段、进度和当前允许动作。',
+  'attendance correction-approve': '按老师明确决定同意当前补卡审批任务。',
+  'attendance correction-reject': '按老师明确决定退回当前补卡审批任务。',
+  'attendance correction-approvals': '查询当前老师的补卡审批待办、已办或抄送。',
+
+
+  'attendance correction-submit': '提交本人补卡申请并返回实际执行阶段。',
+  'attendance correction-approval-form-people-search': '填写补卡审批表单中的人员字段时，按姓名找人',
+  'attendance correction-form-people-search': '填写补卡表单中的人员字段时，按姓名找人',
+  'attendance correction-form': '查看本人补卡设置，读取可用表单并检查填写内容',
+  'student-attendance remark': '修改职责范围内学生的校门考勤时段备注',
+  'student-attendance manual-entries': '查询本人办理的校门补签到原始记录',
+  'student-attendance manual-entry-delete': '删除本人当天办理的明确校门补签到记录',
+  'dormitory-attendance manual-entries': '查询本人办理的宿舍补签到原始记录',
+  'dormitory-attendance manual-entry-delete': '删除本人当天办理的明确宿舍补签到记录',
+  'student-attendance manual-entry': '补记学生今天的进校或出校记录，也可先查可补时段',
+  'student-attendance report-remark': '填写或清空学生的校门考勤报表备注',
+  'dormitory-attendance report-remark': '填写或清空学生的宿舍报表备注',
+  'student-attendance report-tag': '查看按标签分组的学生考勤明细',
+  'student-attendance report-class': '查看考勤报表中某个班的学生明细',
+  'student-attendance report-summary': '查看学校或年级报表中的各班考勤汇总',
+  'dormitory-attendance report-group': '查看宿舍管理组报表中的异常人员和房间统计',
+  'dormitory-attendance manual-entry': '办理当天宿舍补签到；省略时段时只查询可补选项',
+  'dormitory-attendance report-room': '查看宿舍管理组报表中指定房间的学生考勤明细',
+  'dormitory-attendance report-summary': '查看全校宿舍报表的已保存汇总和各房间统计',
+  'student-attendance reports': '按日期查找学生校门考勤报表',
+  'dormitory-attendance reports': '查找宿舍考勤报表',
+  'student-attendance report-remarks': '查看学生某天的校门考勤报表备注',
+  'dormitory-attendance report-remarks': '查看学生的宿舍报表备注',
+  'dormitory-attendance remark': '修改职责范围内学生的宿舍考勤时段备注',
+  'attendance remark': '填写或清空本人、职责内教师考勤备注',
+  'attendance clock-entry': '获取教师本人现场定位打卡的原手机客户端入口',
+  'attendance configuration-entry': '获取教师考勤规则、设备、审批流程或销假方式配置网页入口',
+  'student-attendance configuration-entry': '获取学生校门考勤规则、设备、审批流程或销假方式配置网页入口',
+  'dormitory-attendance configuration-entry': '获取宿舍考勤规则或设备管理网页入口',
+  attendance: '考勤', 'dormitory-attendance applicable-rule': '查看住宿学生今天或未来的宿舍考勤规则和打卡时段', 'student-attendance applicable-rule': '查看学生今天或未来的校门考勤规则和打卡时段', 'attendance applicable-rule': '查看本人或指定教师今天或未来的考勤规则和打卡时段', 'attendance show': '查询本人或职责内教师某日打卡、考勤结果与规则',
+  'leave resumption-approve': '同意当前教师销假审批节点',
+  'leave resumption-reject': '退回当前教师销假审批节点',
+  'leave resumption-approval': '查询教师销假审批详情与当前允许动作',
+  'leave resumption-approvals': '查询教师销假待办、已办或抄送',
+
+  'leave resumption-form': '查看本人销假要填什么，汇总缺项和错误',
+  'leave resumption-list': '统一查询本人的申请与业务记录',
+  'leave resumption-remind': '催办本人指定的处理中销假申请',
+  'leave resumption-withdraw': '撤回本人指定的处理中销假申请',
+  'leave resumption-show': '统一读取本人申请内容、进度、附件链接和业务事实',
+  'leave resumption-submit': '提交本人提前返岗销假申请',
+
+
+  'leave submit': '提交本人教师请假申请',
+  'leave approve': '同意当前教师请假审批节点', 'leave reject': '退回当前教师请假审批节点',
+  'leave approval': '查询教师请假审批详情与当前允许动作',
+  'leave approvals': '查询教师请假待办、已办或抄送',
+  'leave remind': '催办本人处理中请假', 'leave withdraw': '撤回本人处理中请假',
+  leave: '请假', 'leave show': '查询本人请假详情与进度', 'leave list': '查询本人请假或管理范围内教师有效请假',  'leave form': '查看本人请假要填什么，汇总缺项和错误',
   auth: '登录与授权', config: '本地配置', 'lesson-prep': '备课空间', 'school-library': '校本库',
   'learning-tool': '本地 HTML 学具制作成品与个人备课学具',
   folder: '目录管理', textbook: '教材管理', report: '资源上报', review: '上报审批', reference: '资源引用',
@@ -79,7 +316,8 @@ const loginHelp = `登录与授权：创建授权会话，或在网页授权完
   data.authorization_url 是完整授权地址；data.device_code 用于后续兑换。
   data.expires_at 是会话过期时间；data.requested_scopes 是本次权限；data.message 提示下一步。
 下一步：
-  向用户展示完整授权地址，等待用户明确确认网页授权完成后再兑换，不轮询。
+  将 authorization_url 展示为可点击的 Markdown 链接：[完整 URL](完整 URL)，两处保留完整原始地址，不使用行内代码或代码块。
+  用用户的语言和业务名称说明所需权限，不直接展示权限代码。等待用户明确确认网页授权完成后再兑换，不轮询。
 
 2. 兑换登录态
 用法：yunzhi-cli auth login --device-code <device_code>
@@ -113,15 +351,58 @@ async function execute(args) {
       const title = command || '校园号 CLI';
       return { code: 0, text: `${title}\n\n可用命令：\n` + children.map(item =>
         `  ${item}  ${summaries[item] || summaries[item.split(' ').slice(1).join(' ')]}\n`).join('')
+        + (['student-leave', 'attendance'].includes(command) ? '\n通用约定：\n  参数不可重复传入；必填参数无默认值，可选参数的默认值见各命令 Help。\n  业务命令默认输出 JSON；失败时读取 error.message/error.hint。\n' : '')
         + '\n使用 yunzhi-cli <命令> --help 查看下一级或命令详情。\n' };
     }
     throw unknownCommand(command.split(' ').filter(Boolean), Object.keys(usage));
   }
   if (!Object.keys(usage).some(name => name.split(' ').every((word, index) => args[index] === word))) throw unknownCommand(args, Object.keys(usage));
+  if (args[0] === 'contact') return require('./contact.cjs').execute(args[1], args[2], args.slice(3));
+  if (args[0] === 'school' && args[1] === 'students' && args[2] === 'contacts') return require('./school-contacts.cjs').execute(args.slice(3));
+  if (args[0] === 'school') return require('./contact.cjs').execute(args[1], args[2], args.slice(3), 'school');
   if (args[0] === 'version' && args.length > 1) throw unknownOption(args[1], []);
   if (args[0] === 'version' && args.length === 1) {
     return { code: 0, value: { ok: true, data: { version } } };
   }
+  if ((['leave', 'student-leave'].includes(args[0]) && ['approval-entry', 'resumption-approval-entry'].includes(args[1])) || (args[0] === 'attendance' && args[1] === 'correction-approval-entry')) return require('./workflow-entry.cjs').execute(args[0], args[1], args.slice(2));
+
+  if (['leave', 'student-leave'].includes(args[0]) && ['form-people-search', 'resumption-form-people-search', 'approval-form-people-search', 'resumption-approval-form-people-search'].includes(args[1])) return require('./leave-form-users.cjs').execute(args[0], args[1], args.slice(2));
+  if (args[0] === 'student-leave') return require('./student-leave.cjs').execute(args[1], args.slice(2));
+  if (args[0] === 'student-attendance' && args[1] === 'tags') return require('./attendance.cjs').executeTags(args.slice(2));
+  if (['student-attendance', 'dormitory-attendance'].includes(args[0]) && args[1] === 'show') return require('./attendance.cjs').executeManagedDay(args.slice(2), args[0]);
+  if (['attendance', 'student-attendance', 'dormitory-attendance'].includes(args[0]) && args[1] === 'list') return require('./attendance.cjs').executeManaged(args.slice(2), args[0]);
+  if (args[0] === 'dormitory-attendance' && args[1] === 'rooms') return require('./dormitory-rooms.cjs').execute(args.slice(2));
+  if (args[0] === 'dormitory-attendance' && args[1] === 'statistics') return require('./dormitory-statistics.cjs').execute(args.slice(2));
+  if (args[0] === 'attendance' && args[1] === 'statistics') return require('./attendance-statistics.cjs').execute(args.slice(2));
+  if (args[0] === 'attendance' && args[1] === 'report-summary') return require('./attendance.cjs').executeReportSummary(args.slice(2));
+  if (args[0] === 'attendance' && ['correction-list', 'correction-show'].includes(args[1])) return require('./attendance-correction-applications.cjs').execute(args[1], args.slice(2));
+  if (args[0] === 'attendance' && ['correction-approvals', 'correction-approval', 'correction-approve', 'correction-reject'].includes(args[1])) return require('./attendance-correction-approval.cjs').execute(args[1], args.slice(2));
+  if (args[0] === 'attendance' && ['correction-submit'].includes(args[1])) return require('./attendance-correction-start.cjs').execute(args.slice(2), args[1]);
+  if (args[0] === 'attendance' && ['correction-form-people-search', 'correction-approval-form-people-search'].includes(args[1])) return require('./leave-form-users.cjs').execute(args[0], args[1], args.slice(2));
+  if (args[0] === 'attendance' && args[1] === 'correction-form') return require('./attendance.cjs').executeCorrectionForm(args.slice(2));
+  if (args[0] === 'student-attendance' && args[1] === 'remark') return require('./attendance.cjs').executeRemark(args.slice(2), 'student');
+  if (args[0] === 'student-attendance' && args[1] === 'report-tag') return require('./student-report-detail.cjs').execute(args.slice(2), true);
+  if (args[0] === 'student-attendance' && args[1] === 'report-class') return require('./student-report-detail.cjs').execute(args.slice(2));
+  if (args[0] === 'student-attendance' && args[1] === 'report-summary') return require('./student-report-summary.cjs').execute(args.slice(2));
+  if (args[0] === 'attendance' && args[1] === 'clock-entry') return require('./attendance-clock-entry.cjs').execute(args.slice(2));
+  if (['attendance', 'student-attendance', 'dormitory-attendance'].includes(args[0]) && args[1] === 'configuration-entry') return require('./attendance-configuration-entry.cjs').execute(args.slice(2), args[0]);
+  if (args[0] === 'dormitory-attendance' && ['report-group', 'report-room'].includes(args[1])) return require('./dormitory-report-detail.cjs').execute(args.slice(2), args[1] === 'report-room');
+  if (args[0] === 'dormitory-attendance' && args[1] === 'report-summary') return require('./dormitory-report-summary.cjs').execute(args.slice(2));
+  if (['student-attendance', 'dormitory-attendance'].includes(args[0]) && args[1] === 'reports') return require('./attendance-report-inbox.cjs').execute(args.slice(2), args[0]);
+  if (['student-attendance', 'dormitory-attendance'].includes(args[0]) && ['manual-entries', 'manual-entry-delete'].includes(args[1])) return require('./replenishment-records.cjs').execute(args.slice(2), args[0], args[1] === 'manual-entry-delete');
+  if (args[0] === 'dormitory-attendance' && args[1] === 'manual-entry') return require('./dormitory-replenishment.cjs').execute(args.slice(2));
+  if (args[0] === 'student-attendance' && args[1] === 'manual-entry') return require('./student-replenishment.cjs').execute(args.slice(2));
+  if (args[0] === 'student-attendance' && args[1] === 'report-remark') return require('./attendance-report-remarks.cjs').save(args.slice(2));
+  if (args[0] === 'dormitory-attendance' && args[1] === 'report-remark') return require('./attendance-report-remarks.cjs').save(args.slice(2), 'dormitory-attendance');
+  if (args[0] === 'student-attendance' && args[1] === 'report-remarks') return require('./attendance-report-remarks.cjs').read(args.slice(2));
+  if (args[0] === 'dormitory-attendance' && args[1] === 'report-remarks') return require('./attendance-report-remarks.cjs').read(args.slice(2), 'dormitory-attendance');
+  if (args[0] === 'dormitory-attendance' && args[1] === 'remark') return require('./attendance.cjs').executeRemark(args.slice(2), 'dormitory');
+  if (args[0] === 'attendance' && args[1] === 'remark') return require('./attendance.cjs').executeRemark(args.slice(2));
+  if (args[0] === 'dormitory-attendance' && args[1] === 'applicable-rule') return require('./attendance.cjs').executeApplicableRule(args.slice(2), 'dormitory');
+  if (args[0] === 'student-attendance' && args[1] === 'applicable-rule') return require('./attendance.cjs').executeApplicableRule(args.slice(2), 'student');
+  if (args[0] === 'attendance' && args[1] === 'applicable-rule') return require('./attendance.cjs').executeApplicableRule(args.slice(2));
+  if (args[0] === 'attendance') return require('./attendance.cjs').execute(args.slice(2));
+  if (args[0] === 'leave') return require('./leave.cjs').execute(args[1], args.slice(2));
   if (args[0] === 'learning-tool' && ['ls', 'upload-options', 'upload', 'update', 'move', 'remove'].includes(args[1]))
     return require('./learning-tool.cjs').execute(args[1], args.slice(2));
   if (['lesson-prep', 'school-library'].includes(args[0]) && ['ls', 'glob', 'search', 'grep', 'fetch'].includes(args[1])) return require('./lesson-prep.cjs').read(args[1], args.slice(2), args[0]);
@@ -178,6 +459,18 @@ async function run(args) {
           || exchanging) error.hint = guidance.errorHint(command, error, exchanging);
     }
   }
+  if (command && result.value) {
+    const enums = require('./attendance-leave-enums.cjs');
+    try {
+      if (result.value.ok) enums.project(command, result.value.data);
+      else enums.projectError(command, result.value.error);
+    } catch (error) {
+      if (!(error instanceof Failure)) throw error;
+      if (result.value.request_id) error.result.value.request_id = result.value.request_id;
+      result = error.result;
+    }
+  }
+  if (command && result.value) require('./attendance-operation-result.cjs').project(command, result.value);
   return result;
 }