SETUP GUIDE · 0.4.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 核對連線。前往「裝置 → 匯入配對檔」核對名稱、位址與指紋，再確認連線；也可使用「配對碼」。最多保存 12 部電腦，每次選一部。
- 傳送前先確認。課堂按「用 AI 整理」，選用電腦時核對要傳送的文字摘錄。先看預覽的節錄與段數；這不是傳送整堂課。結果請對照原文，再保存成有來源的筆記。
使用時保持電腦喚醒與助手運作。找不到電腦時，檢查本機網路權限、私人網路防火牆與 Wi-Fi 用戶端隔離；校園訪客網路可能無法互連。換網路後重新取得配對檔。本版沒有公網中繼或自動裝置探索。若提示文字過長，縮短問題或減少節錄再試；電腦不會默默截斷全文。
已有 Ollama，或想清出電腦容量？
已有環境可選「我原有的 Ollama（進階）」，依助手檢查僅本機模式。助手不會卸載原有 Ollama，也不提供刪除該環境模型的操作；該環境與模型由你自行管理。
- 只移除專屬模型：在「管理與移除專屬模型」勾選模型，再按「移除選定模型」。使用中的模型先「停止裝置連線」。
- 只移除專屬程式：「移除專屬 Ollama」預設保留模型，重新安裝後可再使用完整模型。
- 程式與模型一起移除：另外勾選刪除專屬全部模型／未完成下載，再確認。這不會刪除原有 Ollama、App 課程或配對金鑰。
- 安裝取消：未完成的 runtime 暫存會清理，再試需重下；已完成的 runtime 保留。模型分片由專屬 Ollama 管理，重試可能利用已有內容，但不承諾續傳。
多個電腦模型可能共享權重層，不能直接把每款標示大小相加當成實際磁碟佔用。App 內的 Gemma 檔與電腦專屬 Ollama 模型分別管理。
第一堂課與資料搬移
- 完成三步導覽：認識功能、查看收音與容量、開始使用。
- 建立課程，只填課名。開始課堂後可收音、貼上文字或匯入逐字稿；開始收音才要求權限。
- 語音資源未就緒，先用文字開始；不會自動轉送雲端辨識，也不保存原始錄音。開始語音前先取消本機模型，待資源釋放後再收音。
- 核對來源筆記、待辦及日期，再加入行事曆／提醒事項，或匯出 PDF／Markdown。
- 搬移課程時，在「裝置」匯出備份，用 AirDrop、USB、檔案 App 或自己的檔案服務帶到另一部 Apple 裝置。匯入先預覽再合併，衝突保留本機修改。
這是手動搬移，沒有自動雙向同步。配對金鑰與本機模型不包含在課程備份裡。單份備份與匯入後合併工作區均有 20 MiB 上限，分批匯入不能繞過合併限制。
容量與驗證
在「設定」查看課堂資料、上一版備份、分享暫存、App 本體與裝置剩餘容量。學期試算只估文字；App 的 Gemma、電腦 Ollama 程式／模型、語音資源、PDF 與備份另計。
目前是 0.4.0 Preview。Android App、雲端同步與自動探索尚未提供。短文模型自測不能代替 90 分鐘教室收音、模型與 Speech 並行、耗電、溫度或摘要品質實測。