jofizcd/Soul-of-Waifu

它解决了什么问题

Soul of Waifu 是一款桌面应用程序，旨在将 AI 角色从简单的文本聊天中解放出来。它为 AI 角色创建了一个持久且不断演化的身份，使其能够在不同交互模式——聊天、桌面角色扮演游戏（TTRPG）以及作为自主的桌面代理——之间持续存在，同时保持连续的记忆和个性。

它如何工作

该项目采用多维度架构，将单一角色身份共享于四个主要模块中：

• Soul Memory： 一种认知架构，用四个专门的层级（心理、关系、情景、日记）替代基础的 RAG，以追踪情绪、信任度和历史记录。
• 文本与语音聊天： 一个支持 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 编写的个人日记。
• TTRPG 引擎： 包含专用的游戏主持人层、隐藏的故事线，以及带有压力计时器的战役看板。
• 本地优先的隐私保护： 默认完全本地运行，无需订阅或过滤。
• 可扩展性： 支持自定义 Python 插件和 MCP 服务器，用于桌面代理。