cloudhouse-admin-cli 0.3.3

package/src/commands/applies.mjs

@@ -0,0 +1,89 @@
+import { register } from './index.mjs'
+import { usageError } from '../errors.mjs'
+import { collectQuery, parseNumber } from '../query.mjs'
+import { flagEnum, flagString, flagNumber, payloadFrom } from '../payload.mjs'
+import { requireReason } from '../sensitive.mjs'
+import { idParam } from '../path.mjs'
+
+const POSITIONS = ['CAPTAIN', 'LEADER', 'MEMBER']
+
+register('applies list', {
+  summary: '管理员申请审批列表',
+  usage: 'ch applies list [--status 0|1|2] [--pretty]',
+  endpoints: ['GET /admin/account-applications'],
+  run: async (ctx) => {
+    const query = collectQuery(ctx, { status: { parse: parseNumber } })
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/account-applications', query })
+    return data
+  },
+})
+
+register('applies pending-count', {
+  summary: '未审批申请数量',
+  usage: 'ch applies pending-count',
+  endpoints: ['GET /admin/account-applications/pending-count'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/account-applications/pending-count' })
+    return data
+  },
+})
+
+register('applies approve', {
+  summary: '审批通过（自动开通账号，账号=学号，初始密码=学号）',
+  usage: 'ch applies approve <id>',
+  endpoints: ['POST /admin/account-applications/{id}/approve'],
+  run: async (ctx) => {
+    const id = idParam(ctx.positionals[0], { label: '申请 id' })
+    const { data } = await ctx.client.request({ method: 'POST', path: `/admin/account-applications/${id}/approve` })
+    return data
+  },
+})
+
+register('applies reject', {
+  summary: '驳回申请（原因必填）',
+  usage: 'ch applies reject <id> --reason 驳回原因',
+  endpoints: ['POST /admin/account-applications/{id}/reject'],
+  run: async (ctx) => {
+    const id = idParam(ctx.positionals[0], { label: '申请 id' })
+    const reason = requireReason(ctx, { label: 'ch applies reject <id> --reason 驳回原因' })
+    const payload = payloadFrom(ctx, { reason })
+    const { data } = await ctx.client.request({ method: 'POST', path: `/admin/account-applications/${id}/reject`, body: payload })
+    return data === null ? { rejected: true, id: Number(id) } : data
+  },
+})
+
+register('applies status', {
+  summary: '按学号查询申请进度（公开接口，免登录）',
+  usage: 'ch applies status <studentNo>',
+  endpoints: ['GET /account-applications/status'],
+  auth: false,
+  run: async (ctx) => {
+    const studentNo = idParam(ctx.positionals[0], { label: '学号' })
+    const { data } = await ctx.client.request({
+      method: 'GET',
+      path: '/account-applications/status',
+      query: [['studentNo', studentNo]],
+      noAuth: true,
+    })
+    return data
+  },
+})
+
+register('applies submit', {
+  summary: '提交管理员账号申请（公开接口，免登录）',
+  usage: 'ch applies submit --studentNo 10位学号 --real-name 姓名 --position-code CAPTAIN|LEADER|MEMBER [--apply-group-id N]',
+  endpoints: ['POST /account-applications'],
+  auth: false,
+  run: async (ctx) => {
+    const studentNo = flagString(ctx, 'studentNo', { required: true, label: 'ch applies submit --studentNo 2026000001' })
+    if (!/^\d{10}$/.test(studentNo)) throw usageError('学号必须是 10 位数字')
+    const realName = flagString(ctx, 'real-name', { required: true, label: 'ch applies submit --real-name 姓名' })
+    const positionCode = flagEnum(ctx, 'position-code', POSITIONS, { required: true, label: `--position-code ${POSITIONS.join('|')}` })
+    const base = { studentNo, realName, positionCode }
+    const applyGroupId = flagNumber(ctx, 'apply-group-id')
+    if (applyGroupId !== undefined) base.applyGroupId = applyGroupId
+    const payload = payloadFrom(ctx, base)
+    const { data } = await ctx.client.request({ method: 'POST', path: '/account-applications', body: payload, noAuth: true })
+    return data
+  },
+})

package/src/commands/assistant.mjs

@@ -0,0 +1,53 @@
+import { register } from './index.mjs'
+import { usageError } from '../errors.mjs'
+import { flagString, flagNumber, flagBool, payloadFrom } from '../payload.mjs'
+import { idParam } from '../path.mjs'
+
+register('assistant search', {
+  summary: '面试官工作台：按学号/姓名搜索候选人',
+  usage: 'ch assistant search --keyword 张三',
+  endpoints: ['GET /admin/assistant/search'],
+  run: async (ctx) => {
+    const keyword = flagString(ctx, 'keyword', { required: true, label: 'ch assistant search --keyword 张三' })
+    const { data } = await ctx.client.request({
+      method: 'GET',
+      path: '/admin/assistant/search',
+      query: [['keyword', keyword]],
+    })
+    return data
+  },
+})
+
+register('assistant profile', {
+  summary: '面试官工作台：候选人一屏档案（含全部场次与历史评价）',
+  usage: 'ch assistant profile <userId>',
+  endpoints: ['GET /admin/assistant/candidates/{userId}'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/admin/assistant/candidates/${userId}` })
+    return data
+  },
+})
+
+register('assistant submit', {
+  summary: '面试官工作台：现场打分提交（结果+评语必填）',
+  usage: 'ch assistant submit --interview-id N --result 1|2|3 --evaluation-content 评语 [--score 85] [--starred true|false]',
+  endpoints: ['POST /admin/assistant/submit'],
+  run: async (ctx) => {
+    const interviewId = flagNumber(ctx, 'interview-id', { required: true, label: 'ch assistant submit --interview-id N' })
+    const result = flagNumber(ctx, 'result', { required: true, label: 'ch assistant submit --result 1|2|3' })
+    if (![1, 2, 3].includes(result)) throw usageError('--result 必须是 1|2|3')
+    const evaluationContent = flagString(ctx, 'evaluation-content', { required: true, label: 'ch assistant submit --evaluation-content 评语' })
+    const base = { interviewId, result, evaluationContent }
+    const score = flagNumber(ctx, 'score')
+    if (score !== undefined) {
+      if (!Number.isInteger(score) || score < 0 || score > 100) throw usageError('--score 必须是 0-100 的整数')
+      base.score = score
+    }
+    const starred = flagBool(ctx, 'starred')
+    if (starred !== undefined) base.starred = starred
+    const payload = payloadFrom(ctx, base)
+    const { data } = await ctx.client.request({ method: 'POST', path: '/admin/assistant/submit', body: payload })
+    return data
+  },
+})

package/src/commands/auth.mjs

@@ -0,0 +1,109 @@
+import { register, getRegistry } from './index.mjs'
+import { usageError, EXIT, CliError } from '../errors.mjs'
+import { flagOn } from '../payload.mjs'
+import * as sessionStore from '../session.mjs'
+import { decodeTokenExpiry, sessionExpiryState, promptPassword, promptText } from '../prompt.mjs'
+
+register('login', {
+  summary: '登录并保存会话（token 落盘 0600，含滚动续期自动换存）',
+  usage: 'ch login [--studentNo <学号>] [--password <密码>] [--profile local|prod] [--show-token]',
+  endpoints: ['POST /auth/login'],
+  auth: false,
+  run: async (ctx) => {
+    const flagStudentNo = typeof ctx.flags.get('studentNo') === 'string' ? ctx.flags.get('studentNo') : ''
+    const envStudentNo = typeof ctx.env.CH_STUDENT_NO === 'string' ? ctx.env.CH_STUDENT_NO.trim() : ''
+    let studentNo = (flagStudentNo || envStudentNo).trim()
+    if (!studentNo && process.stdin.isTTY) studentNo = (await promptText('学号：')).trim()
+    if (!studentNo) {
+      throw usageError('缺少学号', '用 --studentNo <学号> 或环境变量 CH_STUDENT_NO 提供')
+    }
+
+    let password = typeof ctx.flags.get('password') === 'string' ? ctx.flags.get('password') : ''
+    if (!password && typeof ctx.env.CH_PASSWORD === 'string') password = ctx.env.CH_PASSWORD
+    if (!password) {
+      if (process.stdin.isTTY) {
+        password = await promptPassword('密码（输入不回显）：')
+      } else {
+        throw usageError('非交互环境缺少密码', '用 --password 或环境变量 CH_PASSWORD 提供（避免写入 shell 历史）')
+      }
+    }
+    if (!password) throw usageError('密码不能为空')
+
+    const { data } = await ctx.client.request({
+      method: 'POST',
+      path: '/auth/login',
+      body: { studentNo, password },
+      noAuth: true,
+    })
+    if (!data || typeof data.token !== 'string') {
+      throw new CliError({ code: 'LOGIN_FAILED', message: '登录响应缺少 token', exitCode: EXIT.BUSINESS })
+    }
+
+    const session = {
+      version: 1,
+      profile: ctx.config.profile,
+      baseUrl: ctx.config.baseUrl,
+      token: data.token,
+      userId: data.userId ?? null,
+      studentNo: data.studentNo ?? studentNo,
+      role: data.role ?? null,
+      expiresAt: decodeTokenExpiry(data.token),
+      savedAt: Date.now(),
+    }
+    const file = sessionStore.saveSession(ctx.env, session)
+
+    const result = {
+      loggedIn: true,
+      userId: session.userId,
+      studentNo: session.studentNo,
+      role: session.role,
+      tokenExpiresAt: session.expiresAt ? new Date(session.expiresAt).toISOString() : null,
+      profile: ctx.config.profile,
+      baseUrl: ctx.config.baseUrl,
+      sessionFile: file,
+    }
+    if (flagOn(ctx, 'show-token')) result.token = data.token
+    ctx.log(`会话已保存至 ${file}（权限 0600；续期由后端 X-Renewed-Token 自动换存）`)
+    return result
+  },
+})
+
+register('whoami', {
+  summary: '查看当前会话与管理员权限（adminLevel / authorizedGroups）',
+  usage: 'ch whoami',
+  endpoints: ['GET /admin/profile'],
+  run: async (ctx) => {
+    const { data: profile } = await ctx.client.request({ method: 'GET', path: '/admin/profile' })
+    const session = ctx.session || sessionStore.loadSession(ctx.env)
+    const expiresAt = typeof session?.expiresAt === 'number' ? session.expiresAt : decodeTokenExpiry(ctx.token)
+    const state = sessionExpiryState(expiresAt)
+    return {
+      session: {
+        userId: session?.userId ?? null,
+        studentNo: session?.studentNo ?? null,
+        role: session?.role ?? null,
+        profile: ctx.config.profile,
+        baseUrl: ctx.config.baseUrl,
+        tokenSource: ctx.env.CH_TOKEN ? 'CH_TOKEN 环境变量' : session ? '本地会话文件' : '无',
+        tokenExpiresAt: expiresAt ? new Date(expiresAt).toISOString() : null,
+        tokenState: state,
+      },
+      profile,
+    }
+  },
+})
+
+register('logout', {
+  summary: '删除本地会话文件（不影响服务端 token，直至自然过期）',
+  usage: 'ch logout',
+  endpoints: [],
+  auth: false,
+  localWrite: true,
+  run: async (ctx) => {
+    const cleared = sessionStore.clearSession(ctx.env)
+    return { loggedOut: true, sessionFileRemoved: cleared }
+  },
+})
+
+const identity = getRegistry().get('whoami')
+register('auth status', { ...identity, name: 'auth status', usage: 'ch auth status' })

package/src/commands/candidates.mjs

@@ -0,0 +1,252 @@
+import { register } from './index.mjs'
+import { usageError } from '../errors.mjs'
+import { collectQuery, parseNumber } from '../query.mjs'
+import { flagEnum, flagString, flagNumber, flagBool, payloadFrom, parseBoolFlag, parseIdList } from '../payload.mjs'
+import { requireReason } from '../sensitive.mjs'
+import { idParam } from '../path.mjs'
+import { runWithVersionRetry } from '../idempotent.mjs'
+
+register('candidates list', {
+  summary: '候选人分页列表（后端过滤分页；全部筛选 AND）',
+  usage: 'ch candidates list [--page N] [--size N] [--keyword 关键词] [--status 1|2|3] [--second-round-group-id N] [--third-round-group-id N] [--third-round-choice-state ALL|SELECTED|UNSELECTED] [--starred true|false] [--starred-admin-id N] [--starred-by-me true|false]',
+  endpoints: ['GET /admin/users/info/page'],
+  run: async (ctx) => {
+    const query = collectQuery(ctx, {
+      page: { parse: parseNumber },
+      size: { parse: parseNumber },
+      keyword: {},
+      status: { parse: parseNumber },
+      'second-round-group-id': { key: 'secondRoundGroupId', parse: parseNumber },
+      'third-round-group-id': { key: 'thirdRoundGroupId', parse: parseNumber },
+      'third-round-choice-state': { key: 'thirdRoundChoiceState' },
+      starred: { parse: (v) => String(parseBoolFlag(v, { flag: 'starred' })) },
+      'starred-admin-id': { key: 'starredAdminId', parse: parseNumber },
+      'starred-by-me': { key: 'starredByMe', parse: (v) => String(parseBoolFlag(v, { flag: 'starred-by-me' })) },
+    })
+    const queryMap = new Map(query)
+    if (!queryMap.has('page')) query.push(['page', 1])
+    if (!queryMap.has('size')) query.push(['size', 20])
+    if (!queryMap.has('thirdRoundChoiceState')) query.push(['thirdRoundChoiceState', 'ALL'])
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/users/info/page', query })
+    return data
+  },
+})
+
+register('candidates list-all', {
+  summary: '候选人全量列表（旧接口，后端最多返回 200 条）',
+  usage: 'ch candidates list-all [--pretty]',
+  endpoints: ['GET /admin/users/info'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/users/info' })
+    return data
+  },
+})
+
+register('candidates get', {
+  summary: '候选人档案详情',
+  usage: 'ch candidates get <userId>',
+  endpoints: ['GET /users/{userId}/info'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/users/${userId}/info` })
+    return data
+  },
+})
+
+register('candidates application', {
+  summary: '候选人报名记录',
+  usage: 'ch candidates application <userId>',
+  endpoints: ['GET /users/{userId}/application'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/users/${userId}/application` })
+    return data
+  },
+})
+
+register('candidates interviews', {
+  summary: '候选人的全部面试记录',
+  usage: 'ch candidates interviews <userId>',
+  endpoints: ['GET /users/{userId}/interviews'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/users/${userId}/interviews` })
+    return data
+  },
+})
+
+register('candidates evaluations', {
+  summary: '候选人的全部面评',
+  usage: 'ch candidates evaluations <userId>',
+  endpoints: ['GET /admin/candidates/{userId}/evaluations'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/admin/candidates/${userId}/evaluations` })
+    return data
+  },
+})
+
+register('candidates starred-admins', {
+  summary: '特别关注面试官列表（含打星统计）',
+  usage: 'ch candidates starred-admins [--pretty]',
+  endpoints: ['GET /admin/candidates/starred-admins'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/candidates/starred-admins' })
+    return data
+  },
+})
+
+register('candidates second-round-groups', {
+  summary: '候选人二轮自选组别',
+  usage: 'ch candidates second-round-groups <userId>',
+  endpoints: ['GET /users/{userId}/second-round-groups'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/users/${userId}/second-round-groups` })
+    return data
+  },
+})
+
+register('candidates third-round-choice', {
+  summary: '候选人三面选组上下文',
+  usage: 'ch candidates third-round-choice <userId>',
+  endpoints: ['GET /admin/users/{userId}/third-round-choice'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const { data } = await ctx.client.request({ method: 'GET', path: `/admin/users/${userId}/third-round-choice` })
+    return data
+  },
+})
+
+register('applications list', {
+  summary: '报名记录分页列表',
+  usage: 'ch applications list [--page N] [--size N]',
+  endpoints: ['GET /admin/applications/page'],
+  run: async (ctx) => {
+    const query = collectQuery(ctx, { page: { parse: parseNumber }, size: { parse: parseNumber } })
+    const queryMap = new Map(query)
+    if (!queryMap.has('page')) query.push(['page', 1])
+    if (!queryMap.has('size')) query.push(['size', 200])
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/applications/page', query })
+    return data
+  },
+})
+
+register('applications list-all', {
+  summary: '报名记录全量列表（旧接口，后端最多返回 200 条）',
+  usage: 'ch applications list-all [--pretty]',
+  endpoints: ['GET /admin/applications'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/applications' })
+    return data
+  },
+})
+
+register('second-round-choices', {
+  summary: '二轮考核组别自选全量列表',
+  usage: 'ch second-round-choices [--pretty]',
+  endpoints: ['GET /admin/second-round-choices'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/second-round-choices' })
+    return data
+  },
+})
+
+register('candidates set-third-round-choice', {
+  summary: '修改候选人三面最终组别（原因必填；version 自动重读重试）',
+  usage: 'ch candidates set-third-round-choice <userId> --group-id N --reason 原因 [--version N]',
+  endpoints: ['PUT /admin/users/{userId}/third-round-choice'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const groupId = flagNumber(ctx, 'group-id', { required: true, label: '--group-id N' })
+    const reason = requireReason(ctx, { label: '--reason 修改原因（≤200 字）' })
+    const explicitVersion = flagNumber(ctx, 'version')
+    const path = `/admin/users/${userId}/third-round-choice`
+
+    return runWithVersionRetry({
+      explicitVersion,
+      readVersion: async () => {
+        const { data } = await ctx.client.request({ method: 'GET', path })
+        if (typeof data?.version !== 'number') {
+          throw usageError('选组上下文中没有可用 version（候选人可能尚未进入三面阶段）')
+        }
+        return data.version
+      },
+      log: (message) => ctx.log(message),
+      run: async ({ version }) => {
+        const payload = payloadFrom(ctx, { groupId, reason, version })
+        const { data } = await ctx.client.request({ method: 'PUT', path, body: payload })
+        return data
+      },
+    })
+  },
+})
+
+register('candidates star', {
+  summary: '切换对候选人的特别关注标记',
+  usage: 'ch candidates star <userId> --starred true|false',
+  endpoints: ['POST /admin/candidates/{userId}/star'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const starred = flagBool(ctx, 'starred')
+    if (starred === undefined) throw usageError('缺少 --starred', '用法：ch candidates star <userId> --starred true|false')
+    const payload = payloadFrom(ctx, { starred })
+    const { data } = await ctx.client.request({ method: 'POST', path: `/admin/candidates/${userId}/star`, body: payload })
+    return data
+  },
+})
+
+register('candidates update', {
+  summary: '手动调整成员资料（仅更新传入字段）',
+  usage: 'ch candidates update <userId> -d \'{"realName":"张三","phone":"138..."}\'',
+  endpoints: ['PUT /users/{userId}/info'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const payload = payloadFrom(ctx, {})
+    if (Object.keys(payload).length === 0) throw usageError('缺少更新字段', '用 -d \'{"字段":"值"}\' 提供')
+    const { data } = await ctx.client.request({ method: 'PUT', path: `/users/${userId}/info`, body: payload })
+    return data === null ? { updated: true, userId: Number(userId) } : data
+  },
+})
+
+register('candidates application-status', {
+  summary: '调整报名状态（仅未产生面试记录时可用）',
+  usage: 'ch candidates application-status <userId> --status 1|2|3',
+  endpoints: ['PATCH /admin/applications/{userId}/status'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const status = flagEnum(ctx, 'status', ['1', '2', '3'], { required: true, label: '--status 1|2|3' })
+    const payload = payloadFrom(ctx, { status: Number(status) })
+    const { data } = await ctx.client.request({ method: 'PATCH', path: `/admin/applications/${userId}/status`, body: payload })
+    return data === null ? { updated: true, userId: Number(userId) } : data
+  },
+})
+
+register('candidates set-second-round-groups', {
+  summary: '设置候选人二轮考核组别',
+  usage: 'ch candidates set-second-round-groups <userId> --group-ids 1,2',
+  endpoints: ['PUT /users/{userId}/second-round-groups'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const base = payloadFrom(ctx, {})
+    if (base.groupIds === undefined) {
+      const raw = flagString(ctx, 'group-ids', { required: true, label: '--group-ids 1,2（或用 -d \'{"groupIds":[1,2]}\'）' })
+      base.groupIds = parseIdList(raw, { flag: 'group-ids' })
+    }
+    const { data } = await ctx.client.request({ method: 'PUT', path: `/users/${userId}/second-round-groups`, body: base })
+    return data === null ? { updated: true, userId: Number(userId) } : data
+  },
+})
+
+register('candidates unbind-wechat', {
+  summary: '解除候选人微信绑定（原因必填；后端同时失效其会话）',
+  usage: 'ch candidates unbind-wechat <userId> --reason 原因',
+  endpoints: ['DELETE /admin/users/{userId}/wechat-binding'],
+  run: async (ctx) => {
+    const userId = idParam(ctx.positionals[0], { label: 'userId' })
+    const reason = requireReason(ctx, { label: '--reason 解绑原因（≤200 字）' })
+    const payload = payloadFrom(ctx, { reason })
+    const { data } = await ctx.client.request({ method: 'DELETE', path: `/admin/users/${userId}/wechat-binding`, body: payload })
+    return data === null ? { unbound: true, userId: Number(userId) } : data
+  },
+})

package/src/commands/checkin.mjs

@@ -0,0 +1,41 @@
+import { register } from './index.mjs'
+import { usageError } from '../errors.mjs'
+import { toArray } from '../argv.mjs'
+import { flagString } from '../payload.mjs'
+
+register('checkin launch', {
+  summary: '创建签到大屏会话（8 小时有效，screenToken 仅经 header 传递，不落盘）',
+  usage: 'ch checkin launch',
+  endpoints: ['POST /admin/checkin-screens'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'POST', path: '/admin/checkin-screens' })
+    return data
+  },
+})
+
+register('checkin snapshot', {
+  summary: '读取签到大屏当前快照（screenToken 经 X-Checkin-Screen-Token header，绝不携带管理员 JWT）',
+  usage: 'ch checkin snapshot --screen-token <token> [--group-id N ...]',
+  endpoints: ['GET /checkin-screens/current'],
+  auth: false,
+  run: async (ctx) => {
+    const screenToken =
+      flagString(ctx, 'screen-token') ||
+      (typeof ctx.env.CH_CHECKIN_SCREEN_TOKEN === 'string' ? ctx.env.CH_CHECKIN_SCREEN_TOKEN.trim() : '')
+    if (!screenToken) {
+      throw usageError('缺少 --screen-token', '大屏 token 来自 ch checkin launch 的响应；仅经 header 传递，不写入任何持久化文件')
+    }
+    const query = []
+    for (const entry of toArray(ctx.multi.get('group-id'))) {
+      query.push(['groupId', String(entry)])
+    }
+    const { data } = await ctx.client.request({
+      method: 'GET',
+      path: '/checkin-screens/current',
+      query,
+      headers: { 'X-Checkin-Screen-Token': screenToken },
+      noAuth: true,
+    })
+    return data
+  },
+})

package/src/commands/dashboard.mjs

@@ -0,0 +1,11 @@
+import { register } from './index.mjs'
+
+register('dashboard', {
+  summary: '招新总览统计（报名/录取/待处理/场次占用）',
+  usage: 'ch dashboard [--pretty]',
+  endpoints: ['GET /admin/dashboard'],
+  run: async (ctx) => {
+    const { data } = await ctx.client.request({ method: 'GET', path: '/admin/dashboard' })
+    return data
+  },
+})

package/src/commands/evaluations.mjs

@@ -0,0 +1,27 @@
+import { register } from './index.mjs'
+import { usageError } from '../errors.mjs'
+import { flagString, flagNumber, payloadFrom } from '../payload.mjs'
+import { idParam } from '../path.mjs'
+
+register('evaluations add', {
+  summary: '提交面试评价（评语必填，评分 0-100 整数选填）',
+  usage: 'ch evaluations add <interviewId> --content 评语 [--score 85]',
+  endpoints: ['POST /admin/interviews/{interviewId}/evaluations'],
+  run: async (ctx) => {
+    const interviewId = idParam(ctx.positionals[0], { label: 'interviewId' })
+    const content = flagString(ctx, 'content', { required: true, label: 'ch evaluations add <interviewId> --content 评语' })
+    const score = flagNumber(ctx, 'score')
+    if (score !== undefined && (!Number.isInteger(score) || score < 0 || score > 100)) {
+      throw usageError('--score 必须是 0-100 的整数')
+    }
+    const base = { content }
+    if (score !== undefined) base.score = score
+    const payload = payloadFrom(ctx, base)
+    const { data } = await ctx.client.request({
+      method: 'POST',
+      path: `/admin/interviews/${interviewId}/evaluations`,
+      body: payload,
+    })
+    return data
+  },
+})