---
url: /doc/guide/web.md
---
> **快速上手** - 无需安装、无需登录，打开浏览器即可使用

## 访问方式

| 入口 | 地址 |
| --- | --- |
| 主站 | `https://classsoftwarehub.us.ci` |
| 备用站点 | `https://classsoftwarehub.132614.xyz` |

备用站点的服务速度通常更快，但福建闽北、闽西地区用户可能遇到无法打开的情况。站点同时提供 GitHub Pages 与 FTP 镜像，以及网盘副本。

网页端为纯静态站点，**无需注册账号**即可浏览与下载。单文件版本（约 2 MB）可离线双击打开，功能与在线版一致。

## 登录与账号

网页端**不提供账号体系**，无登录环节。涉及身份的功能通过以下方式实现：

1. **提交软件、回声洞投稿、反馈中心**：填写内容后直接提交，无需 GitHub 账号；提交记录进入仓库审核队列，由维护者在 GitHub Issue 上处理。
2. **联系方式加密**：「提交软件」与「反馈中心」的联系方式字段在浏览器本地用 age 公钥加密后再提交，公开记录中仅为密文，仅维护者可用私钥解密。

## 主要功能

| 功能 | 说明 |
| --- | --- |
| 软件浏览 | 首页按分类（系统工具 / 教学软件 / 教学辅助 / 其他工具）展示软件卡片 |
| 软件详情 | 详细介绍、版本号、体积、系统限制、官方网站与 GitHub 仓库，以及逐平台下载项与校验值 |
| 下载 | 文件直链项在本页直接开始下载；官网下载页项在新标签页打开；网盘项跳转分享页 |
| 校验值 | 显示首尾各几位，悬停可查看完整值，点击即可复制 |
| 加速下载 | 识别为 GitHub 文件链接的下载项旁显示镜像通道按钮；官方链接与非 GitHub 主机不显示 |
| 全站搜索 | `Ctrl + K` 或 `Ctrl + F` 唤出搜索面板，一次搜索软件、内置工具、AI 导航站点与页面 |
| 内置工具 | 11 个纯本地工具，见下方清单 |
| AI 导航 | 国产 AI 网站的整行可点导航 |
| 欢迎弹窗 | 首次访问落在首页时弹出一次，提供仓库地址、作者主页、相关文章、QQ 群、投喂作者入口 |
| 回声洞 | 设置页可展开，逐条显示群友投稿并逐字打出 |

### 内置工具清单

| 分组 | 工具 |
| --- | --- |
| 图片与颜色 | 图片取色、颜色转换 / 配色 |
| 课堂 | 随机抽号、课堂计时器、全屏时钟 |
| 文本与编码 | 文本处理、编码 / 哈希工具、Markdown 预览 |
| 实用工具 | 二维码生成、时间戳转换、系统镜像下载 |

## 典型操作流程

### 下载一个软件

1. 打开站点，首页按分类浏览，或在搜索面板输入软件名称。
2. 点击卡片进入详情页（地址形如 `#/download/7-zip`）。
3. 核对版本号、系统限制与体积。
4. 在下载区选择对应平台的条目：
   * 按钮文字为「下载」→ 本页直接开始下载；
   * 按钮文字为「前往官网」→ 新标签页打开厂商下载页；
   * 按钮文字为「前往网盘」→ 新标签页打开分享页。
5. 如需校验完整性，点击校验值复制完整哈希，与下载到的文件自行比对。

### 使用课堂抽号工具

1. 通过搜索面板或底部导航进入「内置工具」，选择「随机抽号」。
2. 输入号码范围（例如学号 1~50）。
3. 按需设置一次抽取数量、是否抽过不重复、是否按号码随机分组。
4. 开始抽取。

### 提交一个软件

1. 进入「提交软件」页（`#/submit`）。
2. 可直接填写，或使用「从 GitHub 一键读取」自动填充仓库信息。
3. 填写必填项：`id`、`name`、`category`、`tagline`、`description`、`system`、联系方式，以及至少一条文件直链。
4. 可选填写校验值，支持带 `MD5:` 前缀或按字节分隔的写法。
5. 提交后进入审核队列；维护者在 Issue 上标注 `approved` 后合并发布。

## 权限说明

| 角色 | 可执行的操作 |
| --- | --- |
| 访客 | 浏览、搜索、下载、使用全部内置工具、提交软件、回声洞投稿、提交反馈 |
| 维护者 | 合并或驳回提交、编辑软件数据与站点文字、修改 CI 配置 |

网页端不存在服务端鉴权；所有「提交」本质是向公开仓库写入草稿文件或创建 Issue。

## 常见问题

| 现象 | 原因 | 处理方式 |
| --- | --- | --- |
| 页面顶部出现红色提示条 | 某个软件 JSON 格式错误 | 该文件被跳过，其余软件正常显示。将提示中的文件名与行号反馈给维护者修正 |
| 详情页显示「未找到该软件」 | 历史数据中有 5 个 `id` 混入了 `?` `&` `=` 等参数符号 | 该问题已修复；如仍出现，请反馈具体地址 |
| 点击「下载」没有反应 | 该下载项是官网下载页或网盘，按钮文字分别为「前往官网」「前往网盘」 | 查看按钮文字与说明 |
| 图标显示为首字母占位 | 该软件 `icon` 为空或图片加载失败 | 不影响下载；可向维护者反馈补充图标 |
| 备用站打不开 | 区域性网络问题 | 改用主站 |
| 商店链接点击后要求先安装商店 | 本机未安装 Microsoft Store（LTSC / 精简版 / 被卸载过） | 按 `Win + R` 输入 `wsreset -i` 让 Windows 联网装回商店；备用命令 `winget install 9WZDNCRFJBMP` |