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 2026-10-11 11:49:32 +08:00
1 parent e51879667a
commit 817af02357
131 files changed
+12995 -538

No files matched your search

+33 -7
View File
@@ -4,14 +4,22 @@
* 交付产物统一落到 releases/server/<版本>/(releases/ 不入库,与客户端/插件同级):
*
* 产出(Windows):
* releases/server/<版本>/免安装/ 可直接运行的免安装目录
* releases/server/<版本>/安装包/ClassHelper 服务端-<版本>-x64-setup.exe Windows 安装程序(NSIS)
* releases/server/<版本>/构建中间/server-installer.generated.nsi NSIS 生成脚本(可重新生成)
*
* 产出(Linux,加 --platform linux,即 pnpm dist:server:linux):
* releases/server/<版本>/linux-x64/classhelper-server-linux-x64-<版本>.tar.gz Linux 一键安装器的输入
* releases/server/<版本>/linux-x64/classhelper-server-linux-x64-<版本>.tar.gz.sha256
* releases/server/<版本>/linux-x64/classhelper-server-linux-x64/ tar 的解包目录(同内容留档)
*
* 交付产物里**没有免安装目录**。组装出来的运行时(Node + node_modules + dist + web,Windows 侧
* 约 335MB)只是打安装程序 / 打 tar.gz 的中间物,留在 `.cache/server-staging/<版本>/` 下,
* 打完就删:
* · NSIS 把整个 staging 目录编进 setup.exe,编完没人再读它;
* · Linux 侧 tar 已经把它压成 tar.gz,那份解包目录与 tar 内容完全一样,纯属重复留档。
* 迭代打包用的 `--reuse-deps`(跳过两分钟 npm install)改从 `.cache/server-staging/` 复用,
* 所以反复打包时中间物会一直在缓存里 —— 想彻底腾空间就删 `.cache/`。
* **别把 staging 挪回 releases/**:交付目录里混着一个能直接双击运行的副本,
* 既容易被误当成"这是我该拷走的东西",又让每个版本多占 335MB。
*
* 为什么 Linux 包要在 Linux 上构建:`@libsql/linux-x64-gnu`、`@prisma/adapter-libsql` 都是
* 平台相关依赖,在 Windows 上 npm install 出来的 node_modules 装到 Linux 跑不起来。
@@ -47,7 +55,7 @@ const outRoot = path.join(root, 'releases', 'server', VERSION);
const INSTALLER_DIR = path.join(outRoot, '安装包');
const GENERATED_DIR = path.join(outRoot, '构建中间');
/** win = 免安装目录 + NSIS 安装程序;linux = 带运维工具的 tar.gz(给 deploy/install.sh 用) */
/** win = 组装运行时 + NSIS 安装程序;linux = 带运维工具的 tar.gz(给 deploy/install.sh 用) */
const PLATFORM = (() => {
const index = process.argv.indexOf('--platform');
const value = index >= 0 ? process.argv[index + 1] : process.platform === 'win32' ? 'win' : 'linux';
@@ -57,10 +65,12 @@ const PLATFORM = (() => {
const isLinux = PLATFORM === 'linux';
// Linux 侧 staging 的目录名会原样成为 tar 里的顶层目录(deploy/install.sh 用 --strip-components=1
// 展开),保持 ASCII 不动;Windows 侧目录名只影响本地留档,直接用中文分类名。
// 展开),保持 ASCII 不动。
// 两侧都放在 .cache/ 下:staging 是纯粹的一次性中间物(见文件头),不该出现在交付目录里;
// 放缓存里同时让 `--reuse-deps` 有地方复用上一轮的 node_modules。
const staging = isLinux
? path.join(outRoot, 'linux-x64', 'classhelper-server-linux-x64')
: path.join(outRoot, '免安装');
? path.join(root, '.cache', 'server-staging', VERSION, 'linux-x64', 'classhelper-server-linux-x64')
: path.join(root, '.cache', 'server-staging', VERSION, 'win');
const LINUX_TARBALL = path.join(
outRoot,
@@ -922,6 +932,13 @@ function main() {
}
log(`Linux 安装包:${path.relative(root, file)}(${sizeMb(LINUX_TARBALL)} MB)`);
log(`校验文件:${path.relative(root, shaFile)}`);
// tar.gz 才是交付物;生成它的那份解包目录与 tar 内容一模一样,删掉。
try {
fs.rmSync(staging, { recursive: true, force: true });
log(`已清理组装中间物 ${path.relative(root, staging)}`);
} catch (error) {
log(`组装中间物清理失败(不影响交付物):${error.message}`);
}
log('完成。部署方式:sudo bash deploy/install.sh --package <上面的 tar.gz>');
return;
}
@@ -930,9 +947,18 @@ function main() {
writeRuntimeScripts();
writeReadme();
const stagingMb = sizeMb(staging);
const installer = buildInstaller();
log(`免安装目录:${path.relative(root, staging)}(${sizeMb(staging)} MB)`);
// NSIS 已经把整个 staging 目录编进 setup.exe,编完这份组装结果就没人再读了 ——
// 删掉,别让交付目录/缓存里堆着一个能直接双击运行的 335MB 副本(见文件头)。
try {
fs.rmSync(staging, { recursive: true, force: true });
log(`已清理组装中间物 ${path.relative(root, staging)}(${stagingMb} MB)`);
} catch (error) {
log(`组装中间物清理失败(不影响交付物):${error.message}`);
}
if (installer)
log(
`安装程序:${path.relative(root, installer)}(${Math.round(fs.statSync(installer).size / 1024 / 1024)} MB)`,