OpenMinis/OpenMinis

OpenMinis – 面向 iOS 與 Android 的裝置端 AI 代理

它是什麼 – OpenMinis 是一個開源的行動應用程式，讓您能在手機上直接執行大型語言模型助手（如 Claude、GPT、Gemini 等）。該應用程式內建沙盒化的 Alpine Linux 環境，使代理可安裝套件、執行指令碼並操作真實檔案，同時也將原生裝置服務（健康、日曆、HomeKit、藍牙、剪貼簿、媒體等）作為工具提供給模型呼叫。

核心功能

功能	提供的價值
自備模型	透過 API 金鑰或帳戶登入，連接任何 LLM 提供者。
Linux 沙盒	在裝置上執行沙盒化的 Alpine 環境（iOS 使用 iSH，Android 使用 PRoot）；代理可安裝套件、執行 shell 指令，並維持持久化的檔案系統。
深度裝置整合	直接存取健康資料、日曆、聯絡人、HomeKit、藍牙、剪貼簿、媒體播放、鬧鐘等。
瀏覽器自動化	代理可開啟網頁、擷取內容，並代表您與網站互動。
技能與記憶	可重複使用的「技能」資料夾（含 SKILL.md 及可選指令碼）可依需求載入；代理可在不同會話間保留持久記憶。
工作區	透過 minis://workspace/ 位址區分不同情境，讓您組織各項專案。
原生卸載	複雜或平台特定的任務可委由編譯後的 Swift/Kotlin 程式碼處理，而非依賴沙盒環境。

常見使用者工作流程

• 營養記錄 – 拍攝一餐照片，代理辨識餐點、估算卡路里與營養成分，並寫入 Apple Health。
• 早晨簡報 – 透過 Shortcut 觸發 Minis 取得您的 X/Twitter 动態，摘要內容，合成語音，並以鬧鐘播放。
• 任務萃取 – 從 Telegram 群組中提取訊息，讓代理將錯誤與待辦事項轉換為 Apple Reminders，並自動去重。
• Obsidian 倉儲同步 – 使用工作區直接讀取、編輯並寫入 Markdown 記事至 Obsidian 倉儲。
• 分享至事件 – 透過 iOS 分享表單傳送任何網頁或訊息；Minis 自動建立包含時間、地點與描述的日曆事件。

生態系

• AwesomeMinis – 社群維護的使用案例與工作流程清單。
• MinisSkills – 提供可立即使用的技能套件（TTS、網路搜尋、媒體下載、健康分析、雲端 API 等）的程式庫，代理可依需求載入。

技術堆疊

• iOS – Swift / SwiftUI 應用程式，搭配分享、小工具與檔案提供者整合的延伸模組。
• Android – Kotlin / Jetpack Compose 應用程式，透過 JNI 橋接原生程式碼。
• 沙盒 – iOS 使用 iSH（ARM64 分支），Android 使用 PRoot，皆從原始碼編譯；Alpine Linux rootfs 提供使用者空間。
• 媒體處理 – FFmpeg 與 LAME 編譯進沙盒，用於音訊/視訊處理。
• LLM 連線 – 使用提供者 SDK 或原始 HTTP 呼叫（例如 SwiftAnthropic 用於 Claude，標準 OpenAI API 用於 GPT 等）。

建置 – 倉儲內含腳本，可編譯原生相依性（FFmpeg、LAME、iSH、PRoot）並準備 Alpine rootfs。克隆並取得子模組後，README 提供 iOS（Xcode 專案）與 Android（Gradle）的平台特定步驟。詳細說明位於 BUILDING.md。

授權 – GPL‑v3（應用程式連結 GPL 授權元件，因此整個發行版本皆為 GPL‑v3）。第三方授權資訊列於 THIRD_PARTY_LICENSES.md。

社群與貢獻

• 此私人鏡像不接受 Pull Request；問題是主要的回饋管道。
• 公開討論在 Telegram，另設獨立倉儲（AwesomeMinis、MinisSkills）接受貢獻。
• 測試版透過 TestFlight（iOS）與 GitHub APK 釋出（Android）。

總結 – OpenMinis 是一個完全開源、裝置端的 AI 助手平台，結合大型語言模型對話、真實 Linux 環境與深度行動作業系統整合，讓 iPhone 與 Android 能執行強大且保護隱私的自動化任務。