feat(permissions,clients,ai,system,server,web,client,shared)!: 权限组 + 客户端设备远控与自动更新 + 大模型助手 + 系统诊断（1.3.0）
功能级准入改为「权限键」，`requireRole` 退成默认模板。 权限组 - 权限目录（39 键：键 / 中文名 / 分类 / 默认角色）收口到 shared，路由挂 requirePermission / requireAnyPermission - 有效权限每请求实时算，改完分组立刻生效：ADMIN 全集且 permission:manage、system:manage 不可剥夺； CLASS_DEVICE 空集（不受分组影响）；有分组 = 并集（因此也能用来**收回**权限）；无分组 = 角色默认模板 - 新增「权限组」页：组增删改、成员分配、生效权限预览 - 班级维度的科目规则（assertCanManageSubjectContent）故意不可被权限组覆盖 客户端设备（ClassHelper 桌面端） - 设备身份是 deviceKey（首次启动生成的 UUID，saveConfig 拒绝改写、退出登录也保留） - 心跳走「DB 记状态 + 客户端定时拉」，不引入新的长连接：30 秒一次，在线窗口 90 秒 - 远控命令 shutdown / restart / logoff / lock：服务端有效期 10 分钟，客户端弹默认选中「取消」的对话框、 60 秒未确认按取消处理，执行后必须回执（重复回执幂等），同一台机器同一条命令只弹一次 - 新增「客户端设备」页：版本一览、一键推送更新、下发远控 客户端安装包由服务端下载并缓存（教室机常常没有外网，浏览器也受 CSP 限制） - POST /api/update/client/fetch 由服务端下载到 data/client-releases/<版本>/ 并登记 sha256 + size - 自动安装三条护栏：没有 sha256 就拒收、必须等到非上课且主窗口隐藏满 5 分钟、冒烟模式永不安装 大模型助手：只解析、不落库 - POST /api/ai/interpret 返回**待确认**的结构化动作（建作业 / 发通知 / 叫人）， 真正落库仍调既有端点 —— 权限断言、上课时段紧急通知保护、ClassIsland 推送全部自动复用 - 模型给的 params 用与手动入口**同一份** zod 再校验（模型输出不可信） - API Key 走 AES-256-GCM（密钥由 JWT_SECRET 经 scrypt 派生）加密存 AppSetting，只进不出 - provider=mock 是离线确定性解析，自动化验收一律用它；每次解析写一条 AiAudit（不含密钥） 系统与运维 - 开发者模式（服务端内存缓存开关，热路径不查库；开启后 500 才附 error.stack）、运行诊断（绝不回传密钥） - 开机自启动运行期可改：Windows 改 HKCU\...\Run、Linux systemctl enable/disable， **非安装形态一律返回 supported:false**，不往开发机的注册表里写自启项 - 服务端侧栏折叠只用 CSS 收拢（不重建 DOM），关怀模式只放大字号与控件、不动任何几何令牌 客户端 - 崩溃自愈：渲染进程挂掉 / 超 10 秒无响应先静默重建主窗口（10 分钟最多 3 次）， 未捕获异常只在「没在上课、没人看着」时才重启进程；冒烟模式绝不重启（会杀掉验证实例） - 上线补弹离线期间收到的消息只做一次：起点只在「可达 → 不可达」的边界写，恢复时取最近 5 条按时间升序推 发布内容批量 - POST /notifications/bulk、POST /homeworks/bulk：**单班失败不影响整批**，逐班返回结果 - 作业的科目名跨班**按名匹配**已有课程，找不到就整班记失败，绝不自动建课 （自动建课会把创建者写成任课老师，等于越权改任教关系） - 通知与作业同口径按「所属日期」归档，新增 /notifications/days 与 /notifications/creators BREAKING CHANGE: 能不能做某件事不再看角色名，而是看权限键（GET /api/permissions/me）。 未分组的账号按角色默认模板生效，行为与 1.2.0 一致；分组之后生效集合只由组的并集决定。 服务端首次启动会自动应用 1 个数据库迁移（权限组 3 表 / AppSetting / 客户端设备·命令·安装包 / AiAudit / Notification.assignDate / User.careMode，历史通知按本地日期回填），升级前请先备份。
This commit is contained in:
LoveChengke committed
1 parent
e51879667a
commit
817af02357
131 files changed
+12995
-538
No files matched your search
@@ -0,0 +1,414 @@
|
||||
import { spawn } from 'node:child_process';
|
||||
import os from 'node:os';
|
||||
import { BrowserWindow, app, dialog } from 'electron';
|
||||
import {
|
||||
CLIENT_COMMAND_LABELS,
|
||||
CLIENT_HEARTBEAT_INTERVAL_MS,
|
||||
isNewerVersion,
|
||||
type ClientCommandDto,
|
||||
type ClientCommandKind,
|
||||
type ClientHeartbeatRequest,
|
||||
type ClientHeartbeatResponse,
|
||||
type ClientUpdateInfoDto,
|
||||
} from '@classhelper/shared';
|
||||
import { maybeInstallPendingUpdate, considerUpdate } from './auto-update.js';
|
||||
import { getConfig } from './config.js';
|
||||
import { island } from './island.js';
|
||||
import { logger } from './logger.js';
|
||||
|
||||
/**
|
||||
* 桌面客户端的服务端联动代理（心跳上报）。
|
||||
*
|
||||
* **为什么是"客户端定时拉"而不是服务端推**：教室机的连接经常断（代理、休眠、重启），
|
||||
* 而「这台机器是什么版本、要不要更新、有没有待执行命令」必须下次上线就能补上 —— 所以统一用
|
||||
* 「服务端记状态 + 客户端定时上报」的范式（与 ClassIsland 插件的上报同一套路），不引入新的长连接握手。
|
||||
* 每次上报的响应里同时带回「服务端指定的目标版本 + 待执行命令」。
|
||||
*
|
||||
* 三条边界：
|
||||
* 1. **没有 token 就不上报**：未登录时静默跳过（登录后下一次自然就上报了），
|
||||
* 不能拿空令牌去打服务端，否则日志里会刷满 401；
|
||||
* 2. **401/403 退避到 5 分钟**：令牌可能已失效（班级密码被改 / 令牌过期），
|
||||
* 继续 30 秒一次只是白刷服务端与日志；
|
||||
* 3. **冒烟模式默认不上报**：每次冒烟都在服务端库里造一条设备记录没有意义，
|
||||
* 只有显式 `ELECTRON_SMOKE_CLIENT_AGENT=1` 时才照常跑（给需要验证这条链路的用例用）。
|
||||
*/
|
||||
|
||||
/** 启动后第一次上报的延迟：等窗口、登录流程与灵动岛都就绪，也不跟首屏抢带宽 */
|
||||
const FIRST_BEAT_DELAY_MS = 3_000;
|
||||
|
||||
/** 令牌失效（401/403）后的退避间隔：5 分钟一次，直到用户重新登录 */
|
||||
const UNAUTHORIZED_BACKOFF_MS = 5 * 60_000;
|
||||
|
||||
/** 单次上报的超时：教室机网络慢，但也不能挂着不放 */
|
||||
const HEARTBEAT_TIMEOUT_MS = 10_000;
|
||||
|
||||
/**
|
||||
* 远控命令的「本机二次确认」等待时长：60 秒内没人点确认就按取消处理。
|
||||
*
|
||||
* 为什么必须有这个超时：管理员在办公室下发关机，而教室里可能已经没人了 ——
|
||||
* 一个永远挂着等确认的对话框会让这条命令一直"待执行"，既没执行也看不出失败。
|
||||
*/
|
||||
const COMMAND_CONFIRM_TIMEOUT_MS = 60_000;
|
||||
|
||||
/**
|
||||
* 「在线」判定窗口：与 shared 的 `CLIENT_ONLINE_WINDOW_MS`（90 秒）同口径 ——
|
||||
* 连续丢两次心跳（30 秒 × 3）才算离线。这里不复用那个常量是因为它属于**服务端**的判定口径，
|
||||
* 客户端展示的是"我这边的上报还新不新"，单独留一个本地常量更容易看出两边的关系。
|
||||
*/
|
||||
const ONLINE_WINDOW_MS = 90_000;
|
||||
|
||||
/** 对外暴露的联动状态（设置页「服务端联动状态」与冒烟断言用） */
|
||||
export interface ClientAgentStatus {
|
||||
/** 设备标识尾号（服务端设备列表里显示的那串用来对账，完整 UUID 不上界面） */
|
||||
deviceKeyTail: string;
|
||||
/** 最近一次上报成功的时刻（ISO 字符串；从未上报过为 null） */
|
||||
lastHeartbeatAt: string | null;
|
||||
/** 最近一次失败的原因（空串 = 最近一次是成功的） */
|
||||
lastError: string;
|
||||
/** 已下载待安装的版本（空串 = 无） */
|
||||
pendingUpdateVersion: string;
|
||||
/** 服务端最近一次要求升到的版本（空串 = 没要求） */
|
||||
updateTargetVersion: string;
|
||||
/** 是否接受服务端统一下发的自动更新（配置值，供设置页回显） */
|
||||
autoUpdate: boolean;
|
||||
/** 最近 90 秒内上报成功过（与服务端的在线口径一致） */
|
||||
online: boolean;
|
||||
}
|
||||
|
||||
interface AgentState {
|
||||
running: boolean;
|
||||
/** 当前心跳定时器（退避期间与正常节奏共用它） */
|
||||
timer: ReturnType<typeof setTimeout> | null;
|
||||
/** 正在上报：避免手动「立即上报」与定时器撞在一起 */
|
||||
beating: boolean;
|
||||
lastHeartbeatAt: string | null;
|
||||
lastError: string;
|
||||
updateTargetVersion: string;
|
||||
}
|
||||
|
||||
const state: AgentState = {
|
||||
running: false,
|
||||
timer: null,
|
||||
beating: false,
|
||||
lastHeartbeatAt: null,
|
||||
lastError: '',
|
||||
updateTargetVersion: '',
|
||||
};
|
||||
|
||||
/** 设备标识尾号：取后 8 位（足够对账，又不至于把完整 UUID 贴到界面上） */
|
||||
export function deviceKeyTail(deviceKey: string): string {
|
||||
const trimmed = deviceKey.trim();
|
||||
if (!trimmed) return '';
|
||||
return trimmed.length > 8 ? trimmed.slice(-8) : trimmed;
|
||||
}
|
||||
|
||||
/** 冒烟模式且没有显式打开联动开关时，一律不上报（避免每次冒烟都在库里造设备记录） */
|
||||
function isAgentSuppressed(): boolean {
|
||||
return process.env.ELECTRON_SMOKE_TEST === '1' && process.env.ELECTRON_SMOKE_CLIENT_AGENT !== '1';
|
||||
}
|
||||
|
||||
/**
|
||||
* 上报里的"这台机器现在在干什么"。
|
||||
*
|
||||
* 取值就三种（服务端设备列表直接展示这段文字）：
|
||||
* - `上课中` —— 灵动岛按渲染进程上报的课表状态判定正在上课（此时绝不安装更新）；
|
||||
* - `使用中` —— 主窗口可见，人正在用；
|
||||
* - `待机` —— 窗口隐藏（最小化到托盘），机器空闲。
|
||||
*/
|
||||
function currentStateNote(): string {
|
||||
if (island.getState().inClass) return '上课中';
|
||||
const win = BrowserWindow.getAllWindows().find((item) => !item.isDestroyed());
|
||||
return win?.isVisible() ? '使用中' : '待机';
|
||||
}
|
||||
|
||||
/** 已下载待安装的版本；没有则 null（服务端把它记进设备的 `pendingVersion`） */
|
||||
function pendingVersionOrNull(): string | null {
|
||||
const pending = getConfig().pendingUpdateVersion.trim();
|
||||
return pending ? pending : null;
|
||||
}
|
||||
|
||||
/** 清掉待执行的心跳定时器（幂等） */
|
||||
function clearTimer(): void {
|
||||
if (state.timer !== null) {
|
||||
clearTimeout(state.timer);
|
||||
state.timer = null;
|
||||
}
|
||||
}
|
||||
|
||||
/** 排下一次上报；`delayMs` 不传时用正常节奏 */
|
||||
function scheduleNext(delayMs: number = CLIENT_HEARTBEAT_INTERVAL_MS): void {
|
||||
if (!state.running) return;
|
||||
clearTimer();
|
||||
state.timer = setTimeout(() => {
|
||||
state.timer = null;
|
||||
void beat();
|
||||
}, delayMs);
|
||||
}
|
||||
|
||||
/**
|
||||
* 一次上报（含响应处理）。
|
||||
*
|
||||
* 失败一律**不抛**：网络抖动是教室机的常态，只记一行日志并按原节奏重试；
|
||||
* 只有 401/403 才退避（见文件头说明）。
|
||||
*/
|
||||
async function beat(): Promise<void> {
|
||||
if (state.beating) return;
|
||||
if (isAgentSuppressed()) {
|
||||
// 冒烟模式：照原节奏空转（不碰服务端，也不在库里造设备记录）
|
||||
state.lastError = '';
|
||||
scheduleNext();
|
||||
return;
|
||||
}
|
||||
const config = getConfig();
|
||||
const token = config.token?.trim() ?? '';
|
||||
if (!token) {
|
||||
// 未登录：不打服务端、不记错误，等下次心跳（登录后自然会带上令牌）
|
||||
logger.debug('客户端上报：尚未登录（没有令牌），本次跳过');
|
||||
scheduleNext();
|
||||
return;
|
||||
}
|
||||
|
||||
state.beating = true;
|
||||
let backoff = false;
|
||||
try {
|
||||
const body: ClientHeartbeatRequest = {
|
||||
deviceKey: config.deviceKey,
|
||||
name: os.hostname(),
|
||||
clientVersion: app.getVersion(),
|
||||
platform: `${process.platform}-${process.arch}`,
|
||||
pendingVersion: pendingVersionOrNull(),
|
||||
stateNote: currentStateNote(),
|
||||
};
|
||||
const response = await fetch(`${config.serverUrl}/api/clients/heartbeat`, {
|
||||
method: 'POST',
|
||||
headers: {
|
||||
'content-type': 'application/json',
|
||||
authorization: `Bearer ${token}`,
|
||||
},
|
||||
body: JSON.stringify(body),
|
||||
signal: AbortSignal.timeout(HEARTBEAT_TIMEOUT_MS),
|
||||
});
|
||||
|
||||
if (response.status === 401 || response.status === 403) {
|
||||
// 令牌失效：退避到 5 分钟一次，直到用户重新登录
|
||||
backoff = true;
|
||||
state.lastError = `上报被拒绝（HTTP ${response.status}），可能登录已过期，请重新登录`;
|
||||
logger.warn(`客户端上报：服务端返回 HTTP ${response.status}，退避为 5 分钟一次`);
|
||||
return;
|
||||
}
|
||||
if (!response.ok) {
|
||||
state.lastError = `服务端返回 HTTP ${response.status}`;
|
||||
logger.warn(`客户端上报失败：HTTP ${response.status}（${HEARTBEAT_INTERVAL_TEXT}）`);
|
||||
return;
|
||||
}
|
||||
|
||||
const payload = (await response.json()) as ClientHeartbeatResponse;
|
||||
state.lastHeartbeatAt = new Date().toISOString();
|
||||
state.lastError = '';
|
||||
state.updateTargetVersion = payload.updateTargetVersion?.trim() ?? '';
|
||||
logger.debug(
|
||||
`客户端上报成功（设备尾号 ${deviceKeyTail(config.deviceKey)}，状态 ${body.stateNote ?? '-'}` +
|
||||
`${state.updateTargetVersion ? `，服务端要求升到 ${state.updateTargetVersion}` : ''}）`,
|
||||
);
|
||||
|
||||
void handleCommand(payload.command);
|
||||
await handleUpdate(payload.update, payload.updateTargetVersion);
|
||||
} catch (error) {
|
||||
// 网络错误 / 超时 / JSON 解析失败：按原节奏重试
|
||||
state.lastError = error instanceof Error ? error.message : String(error);
|
||||
logger.warn(`客户端上报失败（将于 ${HEARTBEAT_INTERVAL_TEXT} 后重试）：${state.lastError}`);
|
||||
} finally {
|
||||
state.beating = false;
|
||||
// 每次心跳（无论成败）都顺手看一下有没有下载好的更新该装了 —— 上课/窗口可见时会自动跳过
|
||||
void maybeInstallPendingUpdate();
|
||||
scheduleNext(backoff ? UNAUTHORIZED_BACKOFF_MS : CLIENT_HEARTBEAT_INTERVAL_MS);
|
||||
}
|
||||
}
|
||||
|
||||
const HEARTBEAT_INTERVAL_TEXT = `${Math.round(CLIENT_HEARTBEAT_INTERVAL_MS / 1000)} 秒`;
|
||||
|
||||
/**
|
||||
* 服务端下发的远控命令（关机 / 重启 / 注销 / 锁屏）。
|
||||
*
|
||||
* 两道护栏缺一不可（用户要求「必须二次确认」）：
|
||||
* 1. **本机二次确认**：弹一个默认选中「取消」的对话框，60 秒不确认按取消处理 ——
|
||||
* 服务端那边虽然也确认过，但真正会被关掉的机器上必须有人当场知道；
|
||||
* 2. **同一条命令只弹一次**：它随每次心跳重复下发，用内存集合去重，避免 30 秒弹一个框。
|
||||
*
|
||||
* 执行后**必须回执**（`POST /api/clients/commands/:id/ack`，body 带 deviceKey）：
|
||||
* 否则服务端那条命令会一直挂在"待执行"里，Web 端看不到结果。回执失败时把结果暂存，
|
||||
* 下一次心跳只重试回执、不重复弹窗。
|
||||
*/
|
||||
const inFlightCommands = new Set<string>();
|
||||
const unackedResults = new Map<string, { ok: boolean; result: string }>();
|
||||
|
||||
async function handleCommand(command: ClientCommandDto | null): Promise<void> {
|
||||
if (!command) return;
|
||||
const label = CLIENT_COMMAND_LABELS[command.kind] ?? command.kind;
|
||||
|
||||
const expired =
|
||||
command.expiresAt !== null && Number.isFinite(Date.parse(command.expiresAt))
|
||||
? Date.parse(command.expiresAt) < Date.now()
|
||||
: false;
|
||||
if (expired) {
|
||||
logger.warn(`收到已过期的远控命令（${label}），已忽略：${command.payload || '无备注'}`);
|
||||
return;
|
||||
}
|
||||
|
||||
// 处理过但回执没送达：只重试回执
|
||||
const pending = unackedResults.get(command.id);
|
||||
if (pending) {
|
||||
await ackCommand(command.id, pending.ok, pending.result);
|
||||
return;
|
||||
}
|
||||
// 正在等本机确认：不要再弹第二个框
|
||||
if (inFlightCommands.has(command.id)) return;
|
||||
|
||||
inFlightCommands.add(command.id);
|
||||
try {
|
||||
const confirmed = await confirmCommand(label, command.payload);
|
||||
if (!confirmed) {
|
||||
const result = '本机用户取消（或 60 秒未确认）';
|
||||
logger.warn(`远控命令「${label}」未执行：${result}`);
|
||||
await ackCommand(command.id, false, result);
|
||||
return;
|
||||
}
|
||||
const outcome = await executeCommand(command.kind);
|
||||
logger.warn(`远控命令「${label}」执行${outcome.ok ? '成功' : '失败'}：${outcome.result}`);
|
||||
await ackCommand(command.id, outcome.ok, outcome.result);
|
||||
} finally {
|
||||
inFlightCommands.delete(command.id);
|
||||
}
|
||||
}
|
||||
|
||||
/** 本机二次确认对话框：默认「取消」，60 秒未操作按取消处理 */
|
||||
async function confirmCommand(label: string, note: string): Promise<boolean> {
|
||||
const answered = dialog
|
||||
.showMessageBox({
|
||||
type: 'warning',
|
||||
title: '来自管理员的远程指令',
|
||||
message: `管理员要求本机「${label}」`,
|
||||
detail: `${note ? `备注：${note}\n` : ''}确认后本机将立即${label}；60 秒内未确认视为取消。`,
|
||||
buttons: ['取消', '确认执行'],
|
||||
defaultId: 0,
|
||||
cancelId: 0,
|
||||
noLink: true,
|
||||
})
|
||||
.then((result) => result.response === 1)
|
||||
.catch(() => false);
|
||||
|
||||
return Promise.race([
|
||||
answered,
|
||||
new Promise<boolean>((resolve) => setTimeout(() => resolve(false), COMMAND_CONFIRM_TIMEOUT_MS)),
|
||||
]);
|
||||
}
|
||||
|
||||
/** 执行系统命令：只支持 Windows（本项目客户端只发 Windows 版） */
|
||||
async function executeCommand(kind: ClientCommandKind): Promise<{ ok: boolean; result: string }> {
|
||||
if (process.platform !== 'win32') return { ok: false, result: '仅支持 Windows' };
|
||||
|
||||
const commands: Record<ClientCommandKind, { file: string; args: string[] }> = {
|
||||
shutdown: { file: 'shutdown.exe', args: ['/s', '/t', '0'] },
|
||||
restart: { file: 'shutdown.exe', args: ['/r', '/t', '0'] },
|
||||
logoff: { file: 'shutdown.exe', args: ['/l'] },
|
||||
lock: { file: 'rundll32.exe', args: ['user32.dll,LockWorkStation'] },
|
||||
};
|
||||
const plan = commands[kind];
|
||||
|
||||
try {
|
||||
// detached + unref：不能等它退出（关机/注销会把本进程一起带走）
|
||||
spawn(plan.file, plan.args, { detached: true, stdio: 'ignore', windowsHide: true }).unref();
|
||||
return { ok: true, result: '已下达系统命令' };
|
||||
} catch (error) {
|
||||
return { ok: false, result: error instanceof Error ? error.message : String(error) };
|
||||
}
|
||||
}
|
||||
|
||||
/** 回执：服务端用 body 里的 deviceKey 校验"这条命令是发给这台机器的" */
|
||||
async function ackCommand(commandId: string, ok: boolean, result: string): Promise<void> {
|
||||
const config = getConfig();
|
||||
if (!config.token) return;
|
||||
try {
|
||||
const response = await fetch(`${config.serverUrl}/api/clients/commands/${commandId}/ack`, {
|
||||
method: 'POST',
|
||||
headers: { 'content-type': 'application/json', authorization: `Bearer ${config.token}` },
|
||||
body: JSON.stringify({ deviceKey: config.deviceKey, ok, result }),
|
||||
signal: AbortSignal.timeout(HEARTBEAT_TIMEOUT_MS),
|
||||
});
|
||||
if (!response.ok) {
|
||||
logger.warn(`远控命令回执失败（HTTP ${response.status}），将在下次心跳重试`);
|
||||
unackedResults.set(commandId, { ok, result });
|
||||
return;
|
||||
}
|
||||
unackedResults.delete(commandId);
|
||||
logger.info(`远控命令回执已送达（${ok ? '成功' : '失败'}）：${result}`);
|
||||
} catch (error) {
|
||||
logger.warn(
|
||||
`远控命令回执失败（${error instanceof Error ? error.message : String(error)}），将在下次心跳重试`,
|
||||
);
|
||||
unackedResults.set(commandId, { ok, result });
|
||||
}
|
||||
}
|
||||
|
||||
/** 响应里的更新信息：服务端指定了目标版本、且该版本确实比本机新，才交给 auto-update */
|
||||
async function handleUpdate(info: ClientUpdateInfoDto | null, targetVersion: string | null): Promise<void> {
|
||||
const target = targetVersion?.trim() ?? '';
|
||||
if (!target) return;
|
||||
if (!info) {
|
||||
// 服务端指定了目标版本但还没有这份安装包：只记一行，客户端只能提示手动更新
|
||||
logger.warn(`服务端要求升到 ${target}，但服务端还没有这个版本的安装包（无法自动下载）`);
|
||||
return;
|
||||
}
|
||||
if (!isNewerVersion(app.getVersion(), target)) return;
|
||||
await considerUpdate(info, target);
|
||||
}
|
||||
|
||||
/** 启动心跳（重复调用无副作用） */
|
||||
export function startClientAgent(): void {
|
||||
if (state.running) return;
|
||||
state.running = true;
|
||||
logger.info(
|
||||
isAgentSuppressed()
|
||||
? '客户端上报代理：冒烟模式下不上报（需要时设 ELECTRON_SMOKE_CLIENT_AGENT=1）'
|
||||
: `客户端上报代理已启动：${FIRST_BEAT_DELAY_MS / 1000} 秒后首次上报，之后每 ${HEARTBEAT_INTERVAL_TEXT} 一次`,
|
||||
);
|
||||
scheduleNext(FIRST_BEAT_DELAY_MS);
|
||||
}
|
||||
|
||||
/** 停止心跳（退出清理调用；幂等） */
|
||||
export function stopClientAgent(): void {
|
||||
if (!state.running) return;
|
||||
state.running = false;
|
||||
clearTimer();
|
||||
logger.info('客户端上报代理已停止');
|
||||
}
|
||||
|
||||
/**
|
||||
* 手动触发一次上报并返回最新状态（设置页「立即上报」按钮）。
|
||||
* 返回的是**报告之后**的状态，界面直接照它刷新即可。
|
||||
*/
|
||||
export async function beatNow(): Promise<ClientAgentStatus> {
|
||||
if (!state.running) startClientAgent();
|
||||
if (isAgentSuppressed()) {
|
||||
logger.info('客户端上报：冒烟模式下跳过手动上报');
|
||||
return getClientAgentStatus();
|
||||
}
|
||||
clearTimer();
|
||||
await beat();
|
||||
return getClientAgentStatus();
|
||||
}
|
||||
|
||||
/** 当前联动状态（纯数据，可直接跨 contextBridge 传给渲染进程） */
|
||||
export function getClientAgentStatus(): ClientAgentStatus {
|
||||
const config = getConfig();
|
||||
const lastAt = state.lastHeartbeatAt ? Date.parse(state.lastHeartbeatAt) : Number.NaN;
|
||||
return {
|
||||
deviceKeyTail: deviceKeyTail(config.deviceKey),
|
||||
lastHeartbeatAt: state.lastHeartbeatAt,
|
||||
lastError: state.lastError,
|
||||
pendingUpdateVersion: config.pendingUpdateVersion ?? '',
|
||||
updateTargetVersion: state.updateTargetVersion,
|
||||
autoUpdate: config.autoUpdate !== false,
|
||||
online: Number.isFinite(lastAt) && Date.now() - lastAt < ONLINE_WINDOW_MS,
|
||||
};
|
||||
}
|
||||
Reference in new issue
Block a user