feat(website,docs,build): 官网加一个下载页（挑版本装机），文档站的照片换成与 README 同一份
下载页（`website/download.html` + `assets/download.js`） - 官网首页的「立即下载」、顶栏与页脚的「取安装包」全部指向新页 `/download.html`。 那一页是「先挑一个版本，再挑要装的那一份」：一个版本分段控件 + 四张卡 （班级端 / 服务端 Windows / 服务端 Linux / ClassIsland 插件），每张卡列出这一版里 真实存在的文件、体积与直链； - 版本与文件清单**不在站点里存副本**，每次打开都由 `assets/download.js` 当场读 GitHub Releases —— 文件名、体积、链接照抄发布页，不靠命名约定去猜； - 读不到时（离线，或匿名接口 60 次/小时按出口 IP 被限流）退回页面上那份 `<meta name="ch-version">`，按发布命名约定拼直链，并在页面上**明说这是拼出来的**； - 老版本缺哪个包就显示「这一版没有发布…」（`v0.1.0-fix` 只有插件包，实测正确）； Linux 那一行安装命令跟着选中版本钉上 `--version`（tag 不是 `x.y.z` 时不带）； - 动态建出来的卡片与文件行派发 `ch:content`，由 `main.js` 补挂按压反馈 —— 这些元素是拉到清单之后才出现的，启动时还看不到它们。 文档站的照片（`docs/images/`） - 页面里的图一律从 `docs/screenshots/**` 换成 `docs/images/**`：后者就是 README 与官网 吃的那一份（字节相同），前者是 9-26 的冒烟留档，比 README 落后一个版本； - 展示图与回归留档这两套图的分工写进 `docs/dev/testing.md`「截图留档」，含重新采集命令 （冒烟会把「岛外留白对照图」落在同一个目录，所以要先落临时目录再挑）； - 顺带修 README 手机截图那张标错的图注（`mobile-dashboard.jpg` 是仪表盘，不是抽屉菜单）； - `docs/reference.md` 验收表里那张 ClassIsland「真机实测截图」不再嵌图：它是连着桌面、 任务栏和另一个窗口整屏截下来的，当文档配图不能用。断言与用例名都保留，另外注明了抓图位置。 版本落点 - `scripts/version.mjs` 增加 `website/download.html` 的兜底版本号，落点 13 → 14 处 （`AGENTS.md` §4.4 与 `docs/dev/release.md` 同步）； - README「开始使用」表里那三个文件名改成**发布页上真实的名字** （`-x64-client-setup` / `-x64-client-portable` / `-x64-server-setup`）—— 原来写的是构建 产物的名字；「上传前把产物改成 ASCII 名」这一步也一并写进发布流程， 它是官网下载页离线兜底与 README 表格的共同依据。
This commit is contained in:
LoveChengke committed
1 parent
ded10118f5
commit
0ea6bd887f
15 files changed
+1235
-167
No files matched your search
@@ -2,9 +2,9 @@
|
||||
|
||||
<div align="center">
|
||||
|
||||
# <img src="build/classhelper.png" width="30" height="30" alt="" /> 班级小助手
|
||||
# <img src="build/classhelper.png" width="30" height="30" alt="" /> ClassHelper
|
||||
|
||||
<img src="docs/images/web-dashboard.jpg" alt="班级小助手 · Web 管理端仪表盘" />
|
||||
<img src="docs/images/web-dashboard.jpg" alt="ClassHelper · Web 管理端仪表盘" />
|
||||
|
||||
[](https://github.com/LoveChengke/ClassHelper/releases/latest)
|
||||
[](https://github.com/LoveChengke/ClassHelper/releases)
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
[](https://github.com/LoveChengke/ClassHelper)
|
||||
|
||||
班级小助手是给中小学班级用的一套信息管理系统。<br/>
|
||||
ClassHelper是给中小学班级用的一套信息管理系统。<br/>
|
||||
**老师发一条通知，教室那台机器上的灵动岛和 [ClassIsland](https://classisland.tech) 会同时弹出来**；<br/>
|
||||
学生打开客户端就能看到当天的课表和作业。
|
||||
|
||||
@@ -78,7 +78,7 @@
|
||||
|
||||
- [x] 教室机器上报课表与上课状态，Web 端能看到「现在在上什么」
|
||||
- [x] 老师发的提醒在教室大屏上全屏弹出，支持语音朗读，播完回执不重复弹
|
||||
- [x] 可以把班级小助手排好的课表镜像回 ClassIsland，不影响老师原有的课表
|
||||
- [x] 可以把ClassHelper排好的课表镜像回 ClassIsland，不影响老师原有的课表
|
||||
- [x] 提醒弹在客户端还是 ClassIsland，由教室那台机器自己选
|
||||
|
||||
### 部署与运维
|
||||
@@ -150,18 +150,22 @@
|
||||
|
||||
| 场景 | 截图 |
|
||||
| --- | --- |
|
||||
| 抽屉菜单 | <img src="docs/images/mobile-dashboard.jpg" alt="手机 · 仪表盘" /> |
|
||||
| 仪表盘 | <img src="docs/images/mobile-dashboard.jpg" alt="手机 · 仪表盘" /> |
|
||||
| 通知发布 | <img src="docs/images/mobile-notifications.jpg" alt="手机 · 通知发布" /> |
|
||||
|
||||
</details>
|
||||
|
||||
## 开始使用
|
||||
|
||||
| 装在哪 | 装什么 | 从 Releases 里拿 |
|
||||
| ----------------------- | ------------------------------------------------- | --------------------------------------------------------- |
|
||||
| 教师的电脑 / 学校服务器 | **服务端**（内含 Web 管理端与 Node 运行时） | `班级小助手服务端-<版本>-x64-setup.exe` |
|
||||
| 教室机器 / 学生电脑 | **学生客户端** | `班级小助手-<版本>-x64-setup.exe`，或 `-portable.exe` 免安装 |
|
||||
| 教室机器的 ClassIsland | **联动插件** | `ClassHelper.ClassIslandPlugin.cipx` |
|
||||
| 装在哪 | 装什么 | 从 Releases 里拿 |
|
||||
| ----------------------- | ------------------------------------------------- | --------------------------------------------------------------------------- |
|
||||
| 教师的电脑 / 学校服务器 | **服务端**（内含 Web 管理端与 Node 运行时） | `ClassHelper-<版本>-x64-server-setup.exe` |
|
||||
| 教室机器 / 学生电脑 | **学生客户端** | `ClassHelper-<版本>-x64-client-setup.exe`，或 `-client-portable.exe` 免安装 |
|
||||
| 教室机器的 ClassIsland | **联动插件** | `ClassHelper.ClassIslandPlugin.cipx` |
|
||||
|
||||
也可以在官网的[下载页](https://lovechengke.github.io/ClassHelper/download.html)上挑：
|
||||
选一个版本，四个包排成四张卡，文件名、体积与 SHA256 清单都在那儿 ——
|
||||
那一页的清单是**当场**读 GitHub Releases 的，显示什么就能下什么。
|
||||
|
||||
服务端**装上就算跑起来了**：双击安装程序，建库、建号、开机自启都由它自己办，
|
||||
装完在浏览器打开 `http://<服务器地址>:4000` 就能登录。教师的电脑、学校的服务器、
|
||||
@@ -208,7 +212,7 @@ pnpm dev # 后端 4000 + Web 端 5
|
||||
| -------------- | --------------- | ------------ |
|
||||
| 管理员 | `admin` | `admin123` |
|
||||
| 教师 | `teacher1` | `teacher123` |
|
||||
| 学生端（班级） | 班级码 `G101` | `123456` |
|
||||
| ClassHelper 班级端（班级） | 班级码 `G101` | `123456` |
|
||||
|
||||
- [AGENTS.md](AGENTS.md) —— 工程约定与本机踩坑，**改代码前先读它**
|
||||
- [docs/reference.md](docs/reference.md) —— 完整参考（功能行为、接口、验收记录）
|
||||
|
||||
Reference in new issue
Block a user