feat(server): 统一课表解析并完善权限范围与年度升级

packages/server/src/modules/system/system.service.ts

@@ -1,3 +1,4 @@
+import { createAutostartController } from './autostart.js';
 import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -9,7 +10,6 @@ import {
 } from '@classhelper/shared';
 import { env } from '../../config/env.js';
 import { prisma } from '../../lib/db.js';
-import { ApiError } from '../../lib/http.js';
 import type { TokenPayload } from '../../lib/jwt.js';
 import { logger } from '../../lib/logger.js';
 import { SETTING_KEYS, getBooleanSetting, setBooleanSetting } from '../../lib/settings.js';
@@ -25,21 +25,12 @@ import type { UpdateAutostartInput, UpdateSystemSettingsInput } from './system.s
  * 1. 只在"装好的形态"里放行（开发机、免安装包、容器里返回 `supported:false`）；
  * 2. 失败原因是运维性质的（权限不足、单元文件不存在），一律带原文回给管理员，不吞成 500。
  */
-const RUN_KEY_PATH = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run';
-const RUN_KEY_NAME = 'ClassHelperServer';
-const SYSTEMD_UNIT = 'classhelper';
-
 function runCommand(file: string, args: string[]): { ok: boolean; output: string } {
   const result = spawnSync(file, args, { encoding: 'utf8', windowsHide: true });
   const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim();
   return { ok: result.status === 0, output: output || (result.error ? result.error.message : '') };
 }
 
-/** 安装器写在安装目录里的启动脚本：它存在才算"装好的形态" */
-function startCmdPath(): string {
-  return path.join(path.dirname(process.execPath), 'start.cmd');
-}
-
 export async function getSystemSettings(): Promise<SystemSettingsDto> {
   return { developerMode: await getBooleanSetting(SETTING_KEYS.developerMode, false) };
 }
@@ -55,74 +46,17 @@ export async function updateSystemSettings(
   return getSystemSettings();
 }
 
+const autostart = createAutostartController({
+  platform: process.platform,
+  root: path.resolve(env.serverRoot, '..'),
+  exists: fs.existsSync,
+  run: runCommand,
+});
 export async function getAutostartStatus(): Promise<AutostartStatusDto> {
-  if (process.platform === 'win32') {
-    const cmd = startCmdPath();
-    if (!fs.existsSync(cmd)) {
-      return {
-        supported: false,
-        enabled: false,
-        mechanism: 'unsupported',
-        detail: '未检测到安装形态（缺少 start.cmd）：开发环境或免安装目录不提供开机自启切换',
-      };
-    }
-    const query = runCommand('reg.exe', ['query', RUN_KEY_PATH, '/v', RUN_KEY_NAME]);
-    return {
-      supported: true,
-      enabled: query.ok,
-      mechanism: 'run-key',
-      detail: `注册表 HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\\${RUN_KEY_NAME} → "${cmd}"`,
-    };
-  }
-
-  if (process.platform === 'linux') {
-    const unit = `/etc/systemd/system/${SYSTEMD_UNIT}.service`;
-    if (!fs.existsSync(unit)) {
-      return {
-        supported: false,
-        enabled: false,
-        mechanism: 'unsupported',
-        detail: `未找到 ${unit}（不是 systemd 安装形态）`,
-      };
-    }
-    const query = runCommand('systemctl', ['is-enabled', SYSTEMD_UNIT]);
-    return {
-      supported: true,
-      enabled: query.ok,
-      mechanism: 'systemd',
-      detail: `systemctl is-enabled ${SYSTEMD_UNIT}`,
-    };
-  }
-
-  return {
-    supported: false,
-    enabled: false,
-    mechanism: 'unsupported',
-    detail: `当前平台（${process.platform}）不支持切换开机自启`,
-  };
+  return autostart.read();
 }
-
 export async function updateAutostart(input: UpdateAutostartInput): Promise<AutostartStatusDto> {
-  const current = await getAutostartStatus();
-  if (!current.supported) throw ApiError.badRequest(current.detail);
-
-  if (current.mechanism === 'run-key') {
-    const cmd = startCmdPath();
-    const result = input.enabled
-      ? runCommand('reg.exe', ['add', RUN_KEY_PATH, '/v', RUN_KEY_NAME, '/t', 'REG_SZ', '/d', `"${cmd}"`, '/f'])
-      : runCommand('reg.exe', ['delete', RUN_KEY_PATH, '/v', RUN_KEY_NAME, '/f']);
-    if (!result.ok) throw ApiError.internal(`写入开机自启项失败：${result.output}`);
-  } else {
-    const result = runCommand('systemctl', [input.enabled ? 'enable' : 'disable', SYSTEMD_UNIT]);
-    if (!result.ok) {
-      throw ApiError.badRequest(
-        `systemctl ${input.enabled ? 'enable' : 'disable'} ${SYSTEMD_UNIT} 失败：${result.output}（服务是否以特权用户运行？）`,
-      );
-    }
-  }
-
-  logger.info(`服务端开机自启已${input.enabled ? '开启' : '关闭'}（机制=${current.mechanism}）`);
-  return getAutostartStatus();
+  return autostart.write(input.enabled);
 }
 
 export async function getDiagnostics(): Promise<SystemDiagnosticsDto> {