SETUP GUIDE · 0.5.0 PREVIEW
從下載，到第一堂課。
這份文字指引不需要 JavaScript。Apple 裝置使用原生課堂 App；Windows、Mac、Linux 的助手可另外提供模型算力。基本功能不需要下載模型。
- iPhone／iPad：Sideloadly 安裝
- Apple Silicon Mac：原生 App
- 本機 AI：Gemma 4 容量、裝置條件與操作
- 運算電腦：偵測硬體、確認安裝、完成配對
- 第一堂課、備份與容量
- 較舊手機：雲端協助、用量與資料傳送
iPhone／iPad：用 Sideloadly 安裝
需要 iOS／iPadOS 17 以上、自己的 Apple ID、可傳輸資料的 USB 線，以及 Windows 或 Mac。IPA 由你使用 Sideloadly 重新簽署，不是在手機「檔案」裡直接開啟的安裝程式。
- 從 Sideloadly 官網下載對應電腦版本。Windows 依官網提供的 Apple 官方連結準備桌面版 iTunes 與 iCloud；Microsoft Store 版不適用此流程。Mac 預設流程不需要 Mail 外掛。
- USB 接上 iPhone／iPad、解鎖並確認「信任這部電腦」。在 Sideloadly 選擇自己的裝置。Apple USB 信任說明
- 拖入
LectureOS-iOS-Sideloadly.ipa，使用 Apple ID Sideload 模式。在電腦上的 Sideloadly 輸入自己的 Apple 帳號、按 Start，再依提示完成驗證。本網站與 App 不收集 Apple 帳密。不需要注入外掛、開啟 JIT 或降低最低系統版本。 - 依提示開啟「設定 → 隱私權與安全性 → 開發者模式」，重新啟動、解鎖，再確認啟用。如果顯示未受信任開發者，到「一般 → VPN 與裝置管理」信任自己簽署的項目。Apple 開發者模式
- 開啟 LectureOS、完成導覽。先建立測試課、匯入短文字並重開 App，確認資料能保留。
免費 Apple ID 的簽署在 7 天到期，需要續簽。Sideloadly 自動續簽仍需電腦與背景 Daemon 運作，且能透過 USB 或已設定的 Wi-Fi 找到裝置。Wi-Fi 續簽先用 USB 配對，再完成 Finder／iTunes 同步設定。官方續簽 FAQ
重簽或更新時保留相同 Apple 帳號與 Bundle ID。不要先刪除 App；先將課程備份另存到 App 以外。免費帳號有 App 數量與 App ID 額度，反覆更改 Bundle ID 可能消耗額度。安裝問題請查 官方 FAQ，分享紀錄前遮住帳密、識別碼與金鑰。
本機 Gemma 不假設普通簽署具有額外記憶體權限。Sideloadly 登入、實機安裝與續簽，以及模型和 Speech 長時間並行，目前仍需實測；IPA 結構檢查不能代替這些結果。
Apple Silicon Mac：原生 App
適用 M 系列晶片、macOS 14 以上；這不是 Intel Mac 原生 App 下載包。
- 打開 DMG，將 LectureOS 拖入「應用程式」。
- 預覽版採 ad-hoc 簽署，未完成 Developer ID 公證。若被系統阻擋，核對來源後依「系統設定 → 隱私權與安全性」處理，不需關閉整個系統的安全保護。Apple 安全開啟指引
- 完成兩步導覽，建立第一門課；基本使用不需要 Sideloadly 或 Ollama。
讓自己的電腦提供模型算力
這是選用功能。便攜包內含 Node，專屬 Ollama 程式與模型在確認容量後另下載；不會安裝系統服務或替你更新顯示卡驅動。
- Windows x64 · 37.11 MB：Windows 10 22H2 以上；解壓後雙擊
Start-LectureOS.cmd。 - Mac Apple Silicon · 41.48 MB：macOS 14 以上；解壓後開啟
Start-LectureOS.command。 - Linux x64 · 46.73 MB：在解壓目錄執行
bash Start-LectureOS.sh。最低發行版尚未實測，依套件檢查結果處理。
- 看硬體與方案。啟動檔開啟本機設定頁。「為這台電腦選一個方案」列出 CPU、總／可用 RAM，以及可偵測的 NVIDIA VRAM 或 Apple 統一記憶體。未知 GPU 只採保守的 CPU 小模型建議，不是速度保證。
- 保留專屬環境。「Ollama 環境」預設為「LectureOS 專屬環境（建議）」。選擇方案、查看理由，核對程式、模型下載量及安裝峰值的磁碟預算。較小 CPU 方案可能使用 Qwen；電腦方案不只 Gemma。
- 確認後安裝。勾選「我確認上述下載量與磁碟需求，安裝選定的專屬 Ollama 和模型」，再按「安裝選定方案」。助手下載、校驗、解壓專屬程式，啟動後下載並驗證模型。進度可見，也能取消；不保證取消後可從原位置續傳；已有裝置連線時，先按「停止裝置連線」再安裝另一模型。
- 完成後配對。選「已安裝模型」、裝置名稱與私人 Wi-Fi 位址，按「儲存並啟用這台裝置」，再下載配對檔或複製配對碼。配對檔包含金鑰，只帶到自己的 Apple 裝置。
- 在 App 核對連線。前往「AI 與裝置 → 匯入配對檔」核對名稱、位址與指紋，再確認連線；也可使用「配對碼」。最多保存 12 部電腦，每次選一部。
- 傳送前先確認。課堂的「課堂工具 → 用 AI 整理」，選用電腦時核對要傳送的文字摘錄。先看預覽的節錄與段數；這不是傳送整堂課。結果請對照原文，再保存成有來源的筆記。
使用時保持電腦喚醒與助手運作。找不到電腦時，檢查本機網路權限、私人網路防火牆與 Wi-Fi 用戶端隔離；校園訪客網路可能無法互連。換網路後重新取得配對檔。配對電腦不提供公網中繼或自動裝置探索；雲端 AI 協助是另外明確允許的服務。若提示文字過長，縮短問題或減少節錄再試；電腦不會默默截斷全文。
已有 Ollama，或想清出電腦容量？
已有環境可選「我原有的 Ollama（進階）」，依助手檢查僅本機模式。助手不會卸載原有 Ollama，也不提供刪除該環境模型的操作；該環境與模型由你自行管理。
- 只移除專屬模型：在「管理與移除專屬模型」勾選模型，再按「移除選定模型」。使用中的模型先「停止裝置連線」。
- 只移除專屬程式：「移除專屬 Ollama」預設保留模型，重新安裝後可再使用完整模型。
- 程式與模型一起移除：另外勾選刪除專屬全部模型／未完成下載，再確認。這不會刪除原有 Ollama、App 課程或配對金鑰。
- 安裝取消：未完成的 runtime 暫存會清理，再試需重下；已完成的 runtime 保留。模型分片由專屬 Ollama 管理，重試可能利用已有內容，但不承諾續傳。
多個電腦模型可能共享權重層，不能直接把每款標示大小相加當成實際磁碟佔用。App 內的 Gemma 檔與電腦專屬 Ollama 模型分別管理。
第一堂課：按下開始，其餘慢慢來
- 完成兩步導覽，查看收音與容量；也可以選「先開始，稍後設定」。新增課程只需要課名。
- 建立課堂後，按「開始收音」。優先使用 Apple 裝置端辨識；開始時才要求麥克風權限。需要改語言、貼上文字或匯入逐字稿，打開「課堂工具」。
- 主畫面只有「逐字稿、筆記、待辦」三個分頁。點筆記的「查看來源」會回到原文；「課堂工具」還有寫筆記、搜尋、翻譯、AI 與匯出。
- 核對待辦日期後，再加入行事曆／提醒事項。結束課堂後可回看，或從工具匯出 PDF／Markdown。
手機資源不足：選用輕量雲端協助
支援本版 iOS／iPadOS 17+、Apple Silicon macOS 14+，目前提供中文與英文。無需先安裝 Gemma、Ollama，也不用建立帳號或填入 API 金鑰。本機語音能用時，優先只傳較少量的文字；無法本機辨識時，畫面才建議音訊協助。
- 開啟「課堂工具 → 輕量雲端協助」。查看這部裝置的建議，按「設定這堂課的雲端協助」。
- 先確認這次的資料傳送。原文會經
https://lectureos-assist.arieswuofficial.workers.dev傳給 Cloudflare Workers AI，用於逐段整理筆記與英中翻譯。只有你按「允許這堂課傳送並啟用」後才開始傳送；開啟設定不會啟動麥克風。 - 音訊另外選擇。需要雲端辨識時，確認「允許音訊片段上傳」；屆時麥克風片段也送到同一 Cloudflare 服務，目的為產生逐字稿。也可以只允許文字。預設不回傳這堂課已有的原文；想補齊時另外勾選「也處理這堂課已有的原文」。
- 按「開始收音」後，原文、筆記與譯文會寫回這部裝置。可分別切換「即時整理筆記」與翻譯；課堂工具收合後仍繼續，狀態與錯誤保持可見。
- 遇到斷線、額度用完或服務失敗，查看狀態並「重試未完成項目」。已取得的文字保留；未完成音訊只暫存於記憶體，請先處理再離開。關閉雲端、離開課堂、進入背景或考試模式會停止傳送，下次需重新允許。
即時程度、流量與共享額度
雲端辨識約每 8 秒送一段，單段最多 12 秒，再加上網路與模型處理延遲；這不是連續串流或零延遲字幕。繁忙、斷線與較慢網路可能中斷，沒有整堂課不中斷的保證。
連續音訊約 115.2 MB／小時原始 PCM，含 base64 約 153.6 MB／小時（約 2.6 MB／分鐘），另加文字、重試及通訊開銷。暫存音訊上限約 1.3 MB，另有 App 執行記憶體開銷。能使用本機辨識時，只送文字較節省流量。
App 顯示本次嘗試上傳流量、文字請求數、音訊秒數、最近延遲與共享剩餘估算。公開試用以全體共用每日 9,000 個估算運算點作為保守預算，不是每位使用者的保留額度，也不是無限量。另有每堂課及請求頻率限制；任一額度或服務限制達到都可能暫停。重設時間由 App 顯示，實際供應商用量可能與估算不同。
雲端使用什麼模型？
筆記與翻譯使用 Cloudflare 上的 Qwen3 30B A3B；只整理筆記時可使用 Granite 4.0 H Micro。音訊辨識使用 Whisper Large V3 Turbo。模型在 Cloudflare 執行，手機不用下載權重。生成內容不是原文，仍需核對來源。
LectureOS 的服務不保存課堂內容或將原文寫入應用程式日誌；使用量與防濫用仍需必要紀錄。Cloudflare 依服務政策處理資料，不能把這理解成所有供應商層級均零留存。完整資料使用說明 · Cloudflare 官方資料政策
把課程帶到另一部裝置
在「AI 與裝置」匯出備份，用 AirDrop、USB、檔案 App 或自己的檔案服務帶到另一部 Apple 裝置。匯入先預覽再合併，衝突保留本機修改。雲端協助提供模型處理，不會替你同步整份課程。
這是手動搬移，沒有自動雙向同步。配對金鑰與本機模型不包含在課程備份裡。單份備份與匯入後合併工作區均有 20 MiB 上限，分批匯入不能繞過合併限制。
容量與驗證
在「設定」查看課堂資料、上一版備份、分享暫存、App 本體與裝置剩餘容量。學期試算只估文字；App 的 Gemma、電腦 Ollama 程式／模型、語音資源、PDF 與備份另計。
目前是 0.5.0 Preview。Android App、雲端同步與自動探索尚未提供。短文模型自測不能代替 90 分鐘教室收音、模型與 Speech 並行、耗電、溫度或摘要品質實測。