developerJSOptionString reads the first matching key as a trimmed-free string (no trim, callers trim where needed), returning "" when none are present

emailConfigured 判定邮箱子系统是否可用：总开关开启 + 有 SMTP 主机 + 有可用的 发件地址（from_address 或回退 smtp_username）。前端入口展示、后端发码守卫都以 此为准，避免 force_bind=true 却没配 SMTP 把用户锁死在仪表盘外。

normalizeRegCodeDays 规范化卡码天数的历史哨兵语义，必须与 addDaysToExpiry / expiryFromDays 的口径一致： - days == 0（或字段未设）：历史默认值，按 30 天处理； - days < 0：永久（-1 是唯一的"永久"哨兵）； - day

addBatchOutcome 累加单条 outcome 到批量响应里。code 可空字符串，表示"未携 带结构化码"——这种调用点应当尽快迁移到具名 ErrCode（参见 R64-8）。前端约 定按 errors[].code 做 switch，errors[].error 仅作运维日志用文案。

PutEmailVerification 原子地清掉同一 (purpose,email) 下的旧记录再写入新记录， 保证每个用途+邮箱最多只有一份在用验证码（重复发码不累积，最新码生效）。

embyApplyEnabledState 启停 Emby 后把状态镜像回本地 EmbyDisabled，让用户列表无需逐行 查 Emby 即可展示真实的 Emby 启停。uid 已知时走 O(1) 的 UpdateUser，刻意不用按 EmbyID 的线性扫描，避免在批量/调度场景退化成 O(n^

SetUserActiveAtomic 与 SetUserRoleAtomic 同理，处理"禁用最后一个 active admin"。 解决 handleAdminToggleUser 把"是否最后 admin"放在闭包外快照读取的问题。

TicketTypes 返回当前工单类型列表。

renewExpiryAndReactivate 把"续期"语义统一成一个动作：bump ExpiredAt 同时 在新到期时刻仍然有效（> now）的前提下复位 Active=true。 历史背景：check_expired 调度对**非邀请**用户会直接 `Active=false`（参见 s

uploadTicketImage 通过 multipart 上传一张图片，返回响应记录。

ConsumeEmailVerificationAtomic 校验候选哈希并按结果原子更新状态： - 过期：删除记录，返回 Expired； - 命中：删除记录（消费），返回 OK； - 不命中且尝试未达上限：Attempts+1 落盘，返回 Mismatch； - 不命中且达上限：删除记录，返回

developerJSOptionInt reads the first matching key from an exported JS options object as an int, falling back to the supplied default when absent.

enableTicketSystem 在运行时打开工单系统并按需覆盖并发上限 / 图片限制。 直接走 runtime.Store 替换 cfg，原因同 TestSessionCookieRespectsConfiguredDomain： New() 之后 cfg 副本存在 runtimeState

hashEmailCode 用服务端密钥对 (id|code) 做 HMAC-SHA256，返回 hex。store 只存这个 哈希并做定长常量时间比较；即使 state 泄露也读不出明文码，配合短码 + 尝试上限 + 短 TTL，离线爆破窗口受限。

pngBytes 返回一段最小可被 http.DetectContentType 识别为 image/png 的字节。

requireAdmin 是 admin-only handler 的入口断言。AuthAdmin 路由已在 dispatcher（app.go:611）处把非 admin 阻挡在外，但 handler 自身再确认一次 caller 角色，避免： 1. 路由表手抖把 admin handler 挂

requireEmbyConfigured 把"Emby URL 或 Token 未配置 → 写一致的 400 响应"的样板收敛 到一处。同时校验 URL 和 Token：仅配置 URL 而 Token 为空时，所有 Emby API 调用 都会以未鉴权身份发出，可能导致数据泄露或被 Emby 拒绝

SetUserEmailVerifiedAtomic 绑定邮箱并设置验证状态。约定： - email 非空则更新 User.Email；为空则保留现有邮箱（用于仅切换验证态）。 - verified=true 且 force=false 时做占用冲突校验（其它已验证账号占用 → ErrConflic

UserLatestRebindRequest returns the most recent rebind request for a user, regardless of status. Returns (request, true) if found, or (zero, false) if

ValidateUsername 校验用户名。