Mane AI

Mane AI 是什麼？

Mane AI 是一個私有的、在本機上運行的 macOS AI 知識庫，能對文檔、程式碼、圖片與音訊進行索引，並實現與資料的自然語言對話。它完全在您的機器上運行，沒有雲端流量、沒有遙測、也沒有帳號。該應用使用 SwiftUI 建構，提供快速、原生的體驗，並由 Ollama 提供本地大規模語言模型。Mane AI 提供語意搜尋和多模態能力，因此您不僅可以查詢文字，還可以查詢程式碼、圖片與音訊。

主要特徵

• 統一知識庫：匯入資料夾與檔案以建立您的個人知識庫，能自動偵測程式專案並智慧索引。
• 基於 RAG 的聊天：就您的文件提問，獲得帶有來源引用的 AI 回應，優先檢索相關上下文。
• 語意搜尋：透過含義搜尋檔案，而不僅僅是關鍵字，在文檔、程式碼與圖像描述中進行檢索。
• 多模態支援：對圖像（帶 AI 字幕）與音訊（轉寫）進行索引與查詢。
• 100% 私有：沒有遙測、沒有雲端、沒有帳號。您的資料保留在您的 Mac 上。
• 原生效能：採用 SwiftUI 建構，提供快速、回應敏捷的體驗，動畫流暢，Metal 提供動力。
• 專案偵測：透過 package.json、Cargo.toml 等清單檔自動偵測軟體專案。
• 本地架構：SwiftUI 客戶端與本地後端通訊，使用向量儲存進行語意檢索。

如何使用 Mane AI

先決條件與安裝步驟為在您的 Mac 上設定一個完整的本地 AI 工作流程提供所需資訊。

先決條件

• macOS 14+ Sonoma 或更高版本
• 透過 brew install ollama 安裝 Ollama
• 透過 brew install node 安裝 Node.js 20+
• 透過 npm install -g pnpm 全域安裝 pnpm

步驟 1：安裝 Ollama 並拉取模型

• 安裝 Ollama：brew install ollama
• 啟動 Ollama：ollama serve
• 在另一個終端機中拉取 AI 模型：ollama pull qwen2.5

步驟 2：下載 Mane AI

• 從倉庫的 Releases 頁面下載最新版本
• 或從原始碼編譯：克隆倉庫、安裝後端相依性、打開 Xcode 專案

命令範例：

• git clone https://github.com/ajagatobby/Mane-mac-app.git
• cd Mane-mac-app
• cd mane-ai-backend
• pnpm install
• 在 Xcode 中打開：open ../ManeAI/ManePaw.xcodeproj

步驟 3：在開發環境中執行應用

• 啟動 Ollama：ollama serve
• 啟動後端：cd mane-ai-backend; pnpm start:dev
• 執行應用：在 Xcode 中打開 ManeAI/ManePaw.xcodeproj，然後按 Run

匯入內容

點擊 匯入 以將檔案或資料夾新增至您的知識庫。內容類型的處理如下：

• 程式碼：透過 package.json、Cargo.toml 等清單檔偵測，並以函式與類別簽名進行索引。
• 文字：文字檔案會被分塊並嵌入以利語意搜尋。
• 圖像：AI 產生的字幕描述視覺內容。
• 音訊：音訊會轉寫成可搜尋的文字。

支援的檔案類型：

• 文字：.txt、.md、.json、.yaml、.xml、.html、.css、.csv
• 程式碼：.swift、.ts、.js、.py、.rs、.go、.java、.rb、.php
• 圖像：.png、.jpg、.jpeg、.gif、.webp、.heic
• 音訊：.mp3、.wav、.m4a、.aiff、.flac、.ogg

專案偵測：

• Mane AI 會透過一組清單檔（例如 Node/JS 的 package.json、Rust 的 Cargo.toml、Python 的 pyproject.toml、Go 的 go.mod、Java 的 pom.xml、Flutter 的 pubspec.yaml、Swift 的清單等）自動偵測專案。

聊天範例：

• 您可以就已索引的內容提問，並取得具相關引註的簡潔 AI 回應。

架構

Mane AI 由一個 SwiftUI 客戶端與本地 NestJS 後端組成。流程包含用於快速語意搜尋的本地向量存儲以及用於情境感知回應的 RAG 介面。所有資料皆留在裝置上，確保隱私與安全。

使用場景

• 個人開發者知識庫：索引程式碼、文件與筆記，快速回答專案相關問題。
• 私人研究庫：本機保存筆記、PDF 與媒體，並以自然語言查詢。
• 創作者的多模態知識中心：對圖像與音訊轉寫進行索引，以探索視覺與聽覺內容。
• macOS 上的教育與輔導：為課程、講座與程式碼範例建立私有知識助手。
• 私有團隊知識庫：適用於個人或小型團隊，希望在本機保留敏感資料並具備本地存取控制。

常見問題

Q：Mane AI 免費且開源嗎？ A：Mane AI 授權為 MIT，並於 GitHub 開源。您可以下載、修改並在本地運行。

Q：系統需求是什麼？ A：macOS 14+ Sonoma 或更高版本、Ollama、Node.js 20+，以及能夠運行 Xcode 專案以開發 macOS 應用。

Q：我的資料存放在哪裡，私密性有多高？ A：所有資料都保留在您的 Mac 上，沒有雲端或遙測；該應用設計為完全本地運作。

Q：如何開始？ A：下載最新版本或克隆倉庫，安裝相依性，配置 Ollama 並拉取模型，然後在 Xcode 打開 ManePaw.xcodeproj 並運行。