Web Client
About 847 wordsAbout 3 min
2026-10-19 20:00:00
Quick start - no install, no login, just open a browser
Access
| Entry | Address |
|---|---|
| Main site | https://classsoftwarehub.us.ci |
| Mirror | https://classsoftwarehub.132614.xyz |
The mirror is usually faster, but users in northern and western Fujian may find it unreachable. The site is also mirrored to GitHub Pages and FTP, plus a netdisk copy.
The web site is a pure static site. No account is required to browse or download. A single-file build (~2 MB) can be opened offline by double-clicking, with the same features as the online version.
Accounts
The web site has no account system and no sign-in. Identity-related features work as follows:
- Submit software, echo cave posts, feedback: fill in and submit directly, no GitHub account needed. Submissions enter the repository review queue and are handled by maintainers via GitHub Issues.
- Contact encryption: the contact field in "submit software" and the feedback centre is encrypted locally in the browser with an age public key before submission, so public records contain ciphertext only; only maintainers can decrypt it with the private key.
Features
| Feature | Description |
|---|---|
| Browse | Home page groups software by category (system / schedule / teaching / other) |
| Detail page | Full description, version, size, OS limits, official site and repository, plus per-platform download entries and checksums |
| Download | File links start downloading in-page; vendor pages open in a new tab; netdisk links open the share page |
| Checksums | First and last characters shown; hover for the full value, click to copy |
| Accelerated download | A mirror channel button appears next to GitHub file links; official links and non-GitHub hosts show none |
| Global search | Ctrl + K or Ctrl + F opens the panel, searching software, built-in tools, AI nav sites and pages at once |
| Built-in tools | 11 local-only tools, listed below |
| AI navigation | Full-width clickable rows for Chinese AI sites |
| Welcome dialog | Shown once when you first land on the home page |
| Echo cave | Expandable on the settings page; group members' posts are typed out one by one |
Built-in tools
| Group | Tools |
|---|---|
| Images & colours | Image colour picker, colour conversion / palette |
| Classroom | Random draw, classroom timer, full-screen clock |
| Text & encoding | Text processing, encoding / hashing, Markdown preview |
| Utilities | QR code generator, timestamp conversion, OS mirror download |
Typical workflows
Download a piece of software
- Open the site, browse by category on the home page, or type a name in the search panel.
- Click a card to open the detail page (URL like
#/download/7-zip). - Check the version, OS limits and size.
- Pick an entry in the download area:
- Button labelled "下载" (Download) → starts in-page;
- Button labelled "前往官网" (Official site) → opens the vendor page in a new tab;
- Button labelled "前往网盘" (Netdisk) → opens the share page in a new tab.
- To verify integrity, click the checksum to copy the full hash and compare it yourself.
Use the classroom drawing tool
- Enter "Built-in tools" via the search panel or bottom navigation, then choose "Random draw".
- Enter a number range (for example student IDs 1–50).
- Optionally set how many to draw at once, whether to avoid repeats, and whether to group randomly.
- Start drawing.
Submit a piece of software
- Go to the "Submit software" page (
#/submit). - Fill it in directly, or use "Import from GitHub" to auto-fill repository information.
- Fill in the required fields:
id,name,category,tagline,description,system, a contact, and at least one direct file link. - Optionally add a checksum;
MD5:prefixes and byte-separated forms are accepted. - After submitting, it enters the review queue; a maintainer labels the issue
approvedto merge and publish.
Permissions
| Role | Allowed actions |
|---|---|
| Visitor | Browse, search, download, use all built-in tools, submit software, post to the echo cave, file feedback |
| Maintainer | Merge or reject submissions, edit software data and site copy, change CI configuration |
The web site has no server-side authorization; every "submission" is fundamentally a draft file written to the public repository or an Issue created.
FAQ
| Symptom | Cause | Resolution |
|---|---|---|
| Red bar at the top of the page | A software JSON file is malformed | That file is skipped and the rest render normally. Report the file name and line number to a maintainer |
| Detail page says "software not found" | 5 historical id values contained ? & = | Already fixed; report the exact URL if it still happens |
| Clicking "Download" does nothing | The entry is a vendor page or netdisk link; the button reads "前往官网" or "前往网盘" | Check the button label and description |
| Icon shows a first-letter placeholder | The icon field is empty or the image failed to load | Does not affect downloads; report it so a maintainer can add an icon |
| Mirror site unreachable | Regional network issue | Use the main site |
| Store link loops back to the Store | Microsoft Store is not installed (LTSC / slim builds / removed) | Press Win + R, run wsreset -i; fallback winget install 9WZDNCRFJBMP |
Contributors
Changelog
b86a9-docs: 添加 docs/en/doc/guide/web.mdon
Copyright
Copyright Ownership:ClassSoftwareHub
License under:GPL-3.0
