# WLSA Plus 论坛 macOS 版说明书(1.0.0)

WLSA Plus 论坛(WLSA Plus Forum)的 Mac 桌面客户端。打开就是论坛,不用再开浏览器、记网址。

## 它是什么

- 一个独立的 Mac 应用,窗口里显示的就是**线上论坛网页** `https://lt.spacehubxyz.hk`(连不上时自动换备用地址 `https://lt.spacehubxyz.香港`)。论坛有更新时**不用重新下载应用**,打开就是最新的。
- 用的是论坛专门为应用准备的「嵌入模式」:底部导航栏(主页 / 墙投稿 / 墙查询 / 发布 / 登录),界面更像手机 App。
- **浅色 / 深色自动跟随 macOS 系统外观**,系统一切换,论坛立刻跟着变;也可以在菜单里固定成浅色或深色。
- 登录一次,关掉应用再打开**仍保持登录**(论坛的登录有效期为 12 小时,过期后重新登录即可)。
- 帖子里的**外部链接会用你的默认浏览器打开**,不会在应用里乱跳。
- 网络断了会显示「暂时连不上论坛」页面,可以一键重试,网络恢复后会自动重试。

## 包里有什么

下载 **`wlsaplusforum1.0.0.zip`**,解压后得到 `wlsaplusforum1.0.0` 文件夹:

| 文件 | 说明 |
| --- | --- |
| `WLSA Plus Forum.app` | 应用本体(universal 通用版:Apple 芯片和 Intel 芯片 Mac 都原生运行) |
| `note.pdf` / `note.md` | 本说明书 |

## 系统要求

- **macOS 13(Ventura)或更新版本**(应用基于 Electron 44,最低支持 macOS 13)。
- **Apple 芯片(M1 / M2 / M3 / M4 …)和 Intel 芯片的 Mac 都支持**,只有一个安装包,两种 Mac 都原生运行,不需要 Rosetta。
- 需要能访问论坛网站(`lt.spacehubxyz.hk`);不需要科学上网。
- 约 600 MB 硬盘空间。

## 安装

1. 打开下载页 <https://wlsaplus.spacehubxyz.hk/forum/>,点「下载 macOS 版」,得到 `wlsaplusforum1.0.0.zip`。
2. (可选)校验文件是否完整:打开「终端」,输入下面一行,结果应与下载页上显示的 SHA-256 一致:

   ```bash
   shasum -a 256 ~/Downloads/wlsaplusforum1.0.0.zip
   ```

3. 双击 zip 解压(用系统自带的「归档实用工具」即可)。
4. 把 **`WLSA Plus Forum`** 拖进「**应用程序**」文件夹。
   - 中文系统里,它在访达和程序坞里显示为「**WLSA Plus 论坛**」。
   - 已经装过旧版本:选择「替换」即可,登录状态和设置会保留。

## 第一次打开(重要)

本应用**没有使用苹果开发者证书签名,也没有经过苹果公证**(只做了 ad-hoc 自签名),所以第一次打开时 macOS 会拦一下,这是正常的。按你的系统版本选一种方法,**只需要做一次**:

### 方法一:「隐私与安全性」→「仍要打开」(所有版本通用,macOS 15 起只能用这个或方法三)

1. 在「应用程序」里双击 **WLSA Plus 论坛**,弹出「无法打开」/「Apple 无法验证…是否包含恶意软件」时,点 **「完成」**(不要点「移到废纸篓」)。
2. 打开 **「系统设置」→「隐私与安全性」**,拉到最下面「安全性」一栏,在「已阻止使用“WLSA Plus Forum”」旁边点 **「仍要打开」**。
3. 输入开机密码(或用触控 ID),再点 **「打开」**。

### 方法二:右键 → 打开(macOS 13 / 14)

在「应用程序」里**按住 Control 点按(或右键)** WLSA Plus 论坛 → 选「**打开**」→ 在弹窗里再点「**打开**」。

> macOS 15(Sequoia)及以后,「右键 → 打开」已经不能绕过这个拦截,请用方法一或方法三。

### 方法三:终端命令(提示「已损坏,无法打开」时用)

打开「终端」,粘贴下面一行并回车(不需要 `sudo`),然后再双击打开:

```bash
xattr -dr com.apple.quarantine "/Applications/WLSA Plus Forum.app"
```

## 登录

- 不登录也可以浏览论坛。
- 要发帖,点底部导航的 **「登录」**,用**论坛自己的登录页**登录(学校 PowerSchool 账号密码,由论坛服务器向 PowerSchool 校验身份)。
- 应用本身**不读取、不保存你的密码**,只保存论坛发给它的登录 Cookie(和浏览器一样),保存在你自己的 Mac 上。
- **帖子依旧完全匿名**,论坛不记录是谁发的。
- 登录有效期 12 小时,过期后重新登录即可。
- 主线路和备用线路是两个不同的网址,登录状态**各自独立**:如果应用自动换到了备用线路,可能需要在备用线路上再登录一次。

## 外观(浅色 / 深色)

- 默认**跟随系统**:「系统设置 → 外观」切换浅色 / 深色 / 自动时,论坛立即跟着变,不用刷新。
- 想固定外观:菜单栏 **「显示」→「外观」→「跟随系统 / 浅色 / 深色」**。选择会被记住。

## 常用操作

| 操作 | 方法 |
| --- | --- |
| 回到论坛主页 | 菜单「前往」→「论坛主页」(⇧⌘H) |
| 返回 / 前进 | ⌘[ / ⌘],或右键菜单 |
| 刷新 | ⌘R(强制刷新 ⇧⌘R) |
| 放大 / 缩小 / 实际大小 | ⌘+ / ⌘- / ⌘0 |
| 在浏览器里打开当前页 | 菜单「前往」→「在浏览器中打开当前页」(⇧⌘O) |
| 复制 / 粘贴 | ⌘C / ⌘V,或右键菜单 |
| 换线路 | 菜单「前往」→「切换线路(主线路 / 备用线路)」 |
| 检查新版本 | 菜单「WLSA Plus Forum」→「检查更新…」 |
| 全屏 | 菜单「显示」→「进入全屏幕」(⌃⌘F) |

关掉窗口后应用仍在程序坞里,点程序坞图标即可重新打开窗口;完全退出用 ⌘Q。

## 常见问题

### 显示「暂时连不上论坛」

1. 先确认 Wi-Fi 已连接、其它网站能打开;
2. 点 **「重试」**,或点 **「换备用线路重试」**;
3. 开着代理 / VPN 的话,试试关掉或换节点;学校网络有限制时可以先用手机热点;
4. 点「在浏览器中打开」,如果浏览器也打不开,说明是网络或论坛服务器的问题,稍后再试。

网络恢复后,这个页面会自动重试(每 30 秒一次)。

### 登录状态不对 / 页面显示异常 / 想退出登录

菜单栏 **「帮助」→「退出论坛登录并清除数据…」**,确认后会清除应用保存的论坛登录状态、Cookie 和缓存,然后回到论坛主页(不影响论坛上的帖子)。需要时重新登录即可。

如果应用打不开、菜单也用不了,可以手动清除:退出应用(⌘Q),在访达里按 ⇧⌘G,输入下面的路径,把 `WLSA Plus Forum` 文件夹移到废纸篓:

```
~/Library/Application Support/
```

### 第一次打开被拦 / 提示「已损坏」

见上面「第一次打开」一节。提示「已损坏」并不是文件真的坏了,是 macOS 对未公证应用的提示,用方法三的命令即可。

### 字太小 / 太大

⌘+ 放大,⌘- 缩小,⌘0 恢复。

### 怎么知道有新版本

应用每天会自动检查一次,有新版本时弹窗提示;也可以随时用「检查更新…」,或打开下载页 <https://wlsaplus.spacehubxyz.hk/forum/>。

## 更新到新版本

下载新版 zip → 解压 → 把新的 `WLSA Plus Forum` 拖进「应用程序」并选择「替换」。登录状态和设置会保留。新版本第一次打开时可能需要再做一次「第一次打开」里的步骤。

## 卸载

1. 退出应用(⌘Q);
2. 把「应用程序」里的 **WLSA Plus 论坛** 拖进废纸篓;
3. (可选,彻底删除登录数据和缓存)在访达按 ⇧⌘G,分别前往下面的位置删除对应项目:
   - `~/Library/Application Support/WLSA Plus Forum`
   - `~/Library/Preferences/hk.spacehubxyz.wlsaplus.forum.plist`
   - `~/Library/Saved Application State/hk.spacehubxyz.wlsaplus.forum.savedState`(如果有)

## 隐私与安全

- 应用只连接论坛网站(`lt.spacehubxyz.hk` / `lt.spacehubxyz.香港`)和检查更新用的 `wlsaplus.spacehubxyz.hk`;不收集任何使用数据。
- 论坛网页运行在 Chromium 沙盒里,不能访问你的文件或系统(上传图片时只能读取你在文件选择框里选中的文件)。
- 非论坛的链接一律交给默认浏览器打开;应用不会请求摄像头、麦克风、定位等权限。

## 版本说明

### 1.0.0(2026-10-06)

- 首个版本。
- universal 通用应用:Apple 芯片(arm64)与 Intel(x86_64)原生运行;要求 macOS 13 或更新;基于 Electron 44.5.1。
- 窗口加载线上论坛(嵌入模式 + 底部导航),主线路连不上时自动切到备用线路;断网时显示重试页面并自动重试。
- 浅色 / 深色跟随系统,可在「显示 → 外观」固定。
- 登录状态持久保存;外部链接用默认浏览器打开;原生 macOS 菜单(编辑、显示、前往、窗口、帮助)和右键菜单。
- 「帮助 → 退出论坛登录并清除数据」;启动时每天自动检查一次新版本。