功能级准入改为「权限键」,`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,历史通知按本地日期回填),升级前请先备份。
273 lines
12 KiB
HTML
273 lines
12 KiB
HTML
<!doctype html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||
<title>下载 ClassHelper —— 挑版本、挑平台</title>
|
||
<meta
|
||
name="description"
|
||
content="从 GitHub Releases 直接下载 ClassHelper:教室机器要的班级端、服务器要的服务端(Windows 安装程序 / Linux 压缩包)、教室大屏要的 ClassIsland 联动插件。版本与文件清单取自本仓库的发布页,显示什么就能下什么。"
|
||
/>
|
||
<meta name="theme-color" content="#16231e" />
|
||
<meta property="og:title" content="下载 ClassHelper" />
|
||
<meta
|
||
property="og:description"
|
||
content="班级端、服务端(Windows / Linux)、ClassIsland 联动插件 —— 选好版本,下面显示什么就能下什么。"
|
||
/>
|
||
<meta property="og:type" content="website" />
|
||
<!-- 页面上所有版本号与文件名都从这一行起步:脚本会去 GitHub Releases 取真实清单,
|
||
取不到时(离线、被限流)就按这份版本号 + 发布命名约定拼直链。
|
||
它和根 package.json 一起由 `pnpm version:bump` 维护 —— 别在这儿单独改。 -->
|
||
<meta name="ch-version" content="1.3.0" />
|
||
<link rel="icon" href="assets/icon.png" />
|
||
<link rel="apple-touch-icon" href="assets/icon.png" />
|
||
|
||
<!-- 标题与引文用的楷体(霞鹜文楷 Screen)。加载失败时自动回落到系统的楷体 / 衬线 -->
|
||
<link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin />
|
||
<link
|
||
rel="stylesheet"
|
||
href="https://cdn.jsdelivr.net/npm/lxgw-wenkai-screen-webfont@1.7.0/style.css"
|
||
media="print"
|
||
onload="this.media = 'all'"
|
||
/>
|
||
<link rel="stylesheet" href="assets/styles.css" />
|
||
<!-- 脚本在,先把标题藏起来准备逐字上浮;4 秒兜底,脚本坏在半路也不会把标题永久藏住 -->
|
||
<script>
|
||
document.documentElement.classList.add('reveal-pending');
|
||
setTimeout(function () {
|
||
document.documentElement.classList.remove('reveal-pending');
|
||
}, 4000);
|
||
</script>
|
||
</head>
|
||
|
||
<body>
|
||
<a class="skip" href="#main">跳到正文</a>
|
||
|
||
<header class="topbar">
|
||
<div class="wrap topbar-inner">
|
||
<a class="brand" href="index.html" data-press="0.96">
|
||
<img class="brand-mark" src="assets/icon.png" alt="" width="32" height="32" />
|
||
<span class="brand-name">ClassHelper</span>
|
||
</a>
|
||
<nav class="topnav" aria-label="站内导航">
|
||
<span class="nav-pill" aria-hidden="true"></span>
|
||
<a href="index.html">官网首页</a>
|
||
<a href="index.html#parts">组成部分</a>
|
||
<a href="index.html#shots">实机</a>
|
||
<a href="docs/index.html">文档站</a>
|
||
</nav>
|
||
<a
|
||
class="btn btn-quiet"
|
||
href="https://github.com/LoveChengke/ClassHelper/releases"
|
||
target="_blank"
|
||
rel="noreferrer"
|
||
data-press="0.95"
|
||
>
|
||
全部版本
|
||
</a>
|
||
</div>
|
||
<!-- 阅读进度:beUI ScrollProgressBar(2px,origin-left,弹簧缓跟) -->
|
||
<div class="scroll-progress" aria-hidden="true"></div>
|
||
</header>
|
||
|
||
<main id="main">
|
||
<!-- ═══════════════════════ 首屏:挑版本、挑平台 ═══════════════════════ -->
|
||
<section class="band band-board hero" id="top">
|
||
<div class="wrap">
|
||
<div class="hero-intro">
|
||
<h1 class="display" data-reveal>
|
||
<span class="reveal-line">先挑一个版本,</span>
|
||
<span class="reveal-line reveal-grad">再挑要装的那一份</span>
|
||
</h1>
|
||
|
||
<p class="hero-sub intro-seq" style="--intro-delay: 150ms">班级端 · 服务端 · ClassIsland 插件</p>
|
||
|
||
<p class="lead intro-seq" style="--intro-delay: 200ms">
|
||
下面的版本与文件清单是当场从本仓库的 GitHub Releases 读出来的:文件名、体积都照抄发布页,
|
||
页面显示什么,就真能下到什么。
|
||
</p>
|
||
|
||
<!-- 版本选择:Tab 由 assets/download.js 按发布列表建出来 -->
|
||
<div class="dl-pick intro-seq" style="--intro-delay: 250ms">
|
||
<p class="sr-only" id="ver-label">选择版本</p>
|
||
<div class="dl-seg" role="tablist" aria-labelledby="ver-label" id="ver-tabs">
|
||
<span class="dl-seg-indicator" id="ver-indicator" aria-hidden="true"></span>
|
||
</div>
|
||
<p class="dl-pick-note" id="ver-note" role="status">正在读取版本列表……</p>
|
||
</div>
|
||
|
||
<noscript>
|
||
<p class="dl-pick-note">
|
||
这一页的版本清单要脚本才能读。直接去
|
||
<a href="https://github.com/LoveChengke/ClassHelper/releases">GitHub Releases</a>
|
||
挑一份 —— 文件名与体积那儿都有。
|
||
</p>
|
||
</noscript>
|
||
|
||
<div class="actions intro-seq" style="--intro-delay: 300ms">
|
||
<a
|
||
class="btn btn-solid"
|
||
id="ver-primary"
|
||
href="https://github.com/LoveChengke/ClassHelper/releases/latest"
|
||
data-press="0.93"
|
||
>
|
||
下载最新版客户端
|
||
</a>
|
||
<a
|
||
class="btn btn-line"
|
||
href="https://github.com/LoveChengke/ClassHelper/releases"
|
||
target="_blank"
|
||
rel="noreferrer"
|
||
data-press="0.93"
|
||
>
|
||
全部版本与更新日志
|
||
</a>
|
||
</div>
|
||
|
||
<ul class="hero-badges intro-seq" style="--intro-delay: 350ms">
|
||
<li>Windows 10/11 x64</li>
|
||
<li>Linux x64 · Docker</li>
|
||
<li>ClassIsland 2.x 插件</li>
|
||
<li>包内自带 Node 运行时</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ═══════════════════════ 装什么、装到哪台机器 ═══════════════════════ -->
|
||
<section class="band band-paper" id="pick">
|
||
<div class="wrap">
|
||
<h2 class="h2">装什么,挑一下</h2>
|
||
<p class="lead narrow">
|
||
四个交付物互不依赖安装顺序,但
|
||
<strong>服务端要先有一台机器跑着</strong>
|
||
,另外三个才连得上 —— 不确定就先切到「服务端」看一眼。
|
||
</p>
|
||
|
||
<div class="dl-groups">
|
||
<p class="dl-pick-label" id="group-label">装什么</p>
|
||
<div class="dl-seg" role="tablist" aria-labelledby="group-label" id="group-tabs">
|
||
<span class="dl-seg-indicator" id="group-indicator" aria-hidden="true"></span>
|
||
<button class="dl-seg-item" type="button" role="tab" data-value="client">客户端</button>
|
||
<button class="dl-seg-item" type="button" role="tab" data-value="server">服务端</button>
|
||
<button class="dl-seg-item" type="button" role="tab" data-value="plugin">插件</button>
|
||
</div>
|
||
<p class="dl-pick-note" id="group-note" role="status"></p>
|
||
</div>
|
||
|
||
<!-- 卡片由 assets/download.js 按「当前版本 + 当前分组」渲染 -->
|
||
<div class="dl-grid" id="dl-grid" role="tabpanel" tabindex="0" aria-live="polite"></div>
|
||
|
||
<p class="dl-note" id="dl-note"></p>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- ═══════════════════════ Linux 与 Docker ═══════════════════════ -->
|
||
<section class="band band-board" id="server-linux">
|
||
<div class="wrap">
|
||
<h2 class="h2">Linux 服务器上,一行命令装完</h2>
|
||
<p class="lead narrow">
|
||
脚本自己去 Releases 取这一版的压缩包、核对旁边的
|
||
<code>.sha256</code>
|
||
,再装成 systemd 服务,顺手把
|
||
<code>classhelper</code>
|
||
运维命令放到
|
||
<code>/usr/local/bin</code>
|
||
里。
|
||
</p>
|
||
|
||
<div class="snippet">
|
||
<div class="snippet-head">
|
||
<span class="snippet-label">在服务器上跑这一条</span>
|
||
<button
|
||
class="copy"
|
||
type="button"
|
||
data-press="0.97"
|
||
data-copy="#cmd-linux"
|
||
data-copy-done="已复制"
|
||
>
|
||
<span class="copy-label">复制</span>
|
||
</button>
|
||
</div>
|
||
<pre
|
||
id="cmd-linux"
|
||
><code>curl -fsSL -o /tmp/classhelper-install.sh https://raw.githubusercontent.com/LoveChengke/ClassHelper/master/deploy/install.sh && sudo bash /tmp/classhelper-install.sh</code></pre>
|
||
</div>
|
||
|
||
<p class="lead narrow">
|
||
想先不改动系统,在末尾加
|
||
<code>--check</code>
|
||
就只体检。装完之后
|
||
<code>classhelper upgrade</code>
|
||
、
|
||
<code>backup</code>
|
||
、
|
||
<code>doctor</code>
|
||
、
|
||
<code>password</code>
|
||
这些命令都在等着,升级与回滚也走它们。
|
||
</p>
|
||
|
||
<p class="lead narrow">
|
||
云服务器、多终端共享的场合可以走 Docker Compose —— MySQL 与 SQLite 两种编排都在仓库的
|
||
<code>deploy/</code>
|
||
里,镜像 tag 与版本号对齐。完整步骤见
|
||
<a href="docs/management/production.html">生产部署</a>
|
||
与
|
||
<a href="docs/management/linux-deploy.html">Linux 运维</a>
|
||
。
|
||
</p>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- 收尾 CTA:装完去哪儿 -->
|
||
<section class="band cta" aria-label="装完之后">
|
||
<div class="wrap">
|
||
<!-- prettier-ignore -->
|
||
<h2 class="cta-title">装完,<span class="act-hl">从这三页开始</span></h2>
|
||
<p class="cta-lead">
|
||
一台机器装完就能跑起来,学生机和教室大屏接上同一个地址就行。第一次部署大约半小时,
|
||
每一步都对着截图写好了。
|
||
</p>
|
||
<div class="cta-actions">
|
||
<a class="btn btn-solid" href="docs/get-started/index.html" data-press="0.93">第一次装</a>
|
||
<a class="btn btn-line" href="docs/management/production.html" data-press="0.93">
|
||
部署形态怎么选
|
||
</a>
|
||
<a class="btn btn-line" href="docs/faq.html" data-press="0.93">装不上怎么办</a>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
</main>
|
||
|
||
<!-- ═══════════════════════ 页脚 ═══════════════════════ -->
|
||
<footer class="foot">
|
||
<div class="wrap foot-inner">
|
||
<div class="foot-brand">
|
||
<img src="assets/icon.png" alt="" width="36" height="36" />
|
||
<div>
|
||
<p class="foot-name">
|
||
ClassHelper
|
||
<span>Class Helper</span>
|
||
</p>
|
||
<p class="foot-ver">版本以 GitHub Releases 为准 · 源码公开 · 装在你自己的机器上</p>
|
||
</div>
|
||
</div>
|
||
<nav class="foot-nav" aria-label="相关链接">
|
||
<a href="index.html">官网首页</a>
|
||
<a href="docs/index.html">文档站</a>
|
||
<a href="https://github.com/LoveChengke/ClassHelper/releases" target="_blank" rel="noreferrer">
|
||
全部版本
|
||
</a>
|
||
<a href="https://github.com/LoveChengke/ClassHelper" target="_blank" rel="noreferrer">源码仓库</a>
|
||
<a href="https://classisland.tech" target="_blank" rel="noreferrer">ClassIsland</a>
|
||
</nav>
|
||
</div>
|
||
</footer>
|
||
|
||
<script src="assets/motion.js" defer></script>
|
||
<script src="assets/main.js" defer></script>
|
||
<script src="assets/download.js" defer></script>
|
||
</body>
|
||
</html>
|