jofizcd/Soul-of-Waifu

它解決的問題

Soul of Waifu 是一款桌面應用程式，旨在將 AI 角色從單純的文字聊天中解放出來。它為 AI 角色建立了一個持續且不斷演進的身份，使其能在不同互動模式——聊天、桌上角色扮演遊戲（TTRPG），以及作為自主的桌面代理——之間存在，同時保持連續的記憶與個性。

如何運作

該專案採用多維度架構，讓單一角色身份在四個主要模組中共享：

• 靈魂記憶（Soul Memory）： 一種認知架構，以四個專用層（心理、關係、情節、日記）取代基本的 RAG，用來追蹤情緒、信任度與歷史。
• 文字與語音聊天（Text & Voice Chat）： 一個對話介面，支援 Live2D/VRM 偶像、即時語音通話，以及多種 TTS/STT 引擎。
• 靈魂舞台（Soul Stage）： 一款桌上角色扮演遊戲引擎，內建虛擬遊戲主持人、確定性擲骰機制與世界狀態追蹤。
• 靈魂夥伴（Soul Companion）： 一個自主的 Windows 桌面代理，可讀取螢幕、操控滑鼠與鍵盤、瀏覽網路，並在沙盒環境中執行程式碼。

支援本地 LLM 執行（透過 Llama.cpp，支援 CUDA/HIP/SYCL/Vulkan）與雲端 API（OpenAI、Claude、Gemini 等）。

適用對象

適合希望擁有高度沉浸式 AI 伴侶的使用者、需要結構化桌上角色扮演遊戲模擬器的玩家，以及尋找桌面自動化 OS 層代理的使用者。

主要特色

• 自主 OS 代理： 可控制 GUI 元素、透過 Playwright 瀏覽網路，並執行 Python/PowerShell 指令碼，具備人工審核的批准系統。
• 進階記憶： 具備情緒衰減機制、自我修復的記憶日誌以修正矛盾，以及由 AI 寫下的個人日記。
• 桌上角色扮演遊戲引擎： 內建專用遊戲主持人層、隱藏的故事線，以及帶有壓力計時器的劇情看板。
• 以本地為首的隱私保護： 預設完全在本地運行，無需訂閱或過濾。
• 可擴展性： 支援自訂 Python 插件與 MCP 伺服器，供桌面代理使用。