yoji
有情緒的 AI 桌面伴侶 | 隱私優先 · 語音喚醒 · 協助辦公 · MCP 無限擴展 | An AI desktop companion with emotions — privacy-first, voice wake, office assistance, and
yoji 是什麼？
有情緒的 AI 桌面伴侶 | 隱私優先 · 語音喚醒 · 協助辦公 · MCP 無限擴展 | An AI desktop companion with emotions — privacy-first, voice wake, office assistance, and MCP extensibility
yoji 概覽
這是什麼
Yoji 是一款在本機運行的 AI 桌面伴侶。它能直接操作你的作業系統——管理檔案、執行腳本、搜尋網路、呼叫外部 API。它擁有持續運作的情緒引擎、Live2D 虛擬形象、語音喚醒（僅限 macOS），並可透過 Model Context Protocol（MCP）無限擴充能力。所有資料都留在你的電腦上，不會上傳至任何雲端服務。
主要功能
- 電腦操控：建立、編輯、搜尋檔案；執行 Shell 指令與 Python 腳本；進行網路搜尋；敏感操作需經由彈窗確認。
- MCP 擴充：連接任何符合 MCP 規範的服務（例如 12306、食譜、網頁抓取）來擴充能力。AI 甚至可以在你同意後自行安裝新的 MCP 工具。
- 語音喚醒（僅限 macOS）：說「小優」即可開始對話；使用離線的 SFSpeechRecognizer，不需網路。
- 情緒系統：模擬 8 種神經傳導物質（多巴胺、皮質醇、血清素等），影響回覆語氣與風格；介面背景會隨心情變化。
- Live2D 虛擬形象：銀白髮貓耳少女，有情緒表情、說話時嘴巴張合、依時間更換服裝，並可互動（摸頭、戳臉等）。
- 三層記憶：使用者設定檔（AGENTS.md）、對話快照（SQLite）、語意記憶（sqlite-vec 向量資料庫）。
- 子 Agent 系統：在工坊中建立自訂 Agent；支援同步（阻塞）與非同步（背景）執行；每個 Agent 可擁有自己的 MCP 工具集。
- 智慧文件處理：直接讀取 PDF 與 Word（.docx）檔案；不支援的格式會自動阻擋。
- 微信連接：透過 iLink ClawBot 協定連接個人微信帳號；桌面與手機的聊天記錄互相隔離。
- 隨身攜帶：將整個伴侶（記憶、情緒、設定）匯出為
.ecompanion檔案；在另一台電腦匯入即可還原。
使用情境
- 個人生產力助手，管理檔案、執行腳本、自動化重複任務。
- 隨時可用的 AI 伴侶，擁有持續的人格與情緒反應。
- 開發者與進階使用者的可擴充工具平台，可整合自訂 MCP 服務。
- macOS 使用者的離線語音控制助手，適合免手持操作。
快速開始
bash git clone https://github.com/wangxijie001/yoji.git cd yoji pnpm install pnpm dev 啟動後，前往「模型」頁面填入 API Key（DeepSeek 或 Qwen）並選擇模型。若要安裝 MCP 擴充，前往「MCP」頁面填入名稱、URL 與傳輸協定（SSE/HTTP）。若要建立自訂子 Agent，使用「工坊」頁面。
授權與價格
本專案採用 MIT 授權條款。為開源軟體，可免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。
