Persona 是一个跨平台桌面端“虚拟角色/桌宠”应用，为语音对话场景提供实时可视化角色表现。它可以监听指定应用的语音输出进程，根据播放状态驱动本地 VRM/VRMA 角色动画，并通过本地 MCP 服务与 Codex 集成，让 Codex 控制角色播放动画、显示/隐藏窗口或查询状态。项目基于 JavaScript/Electron 生态，支持 Linux、Windows、macOS，但角色模型和动画资源不包含在仓库中，发布前必须自行替换并处理授权。
适用领域
桌面应用 / 实时语音交互 / 虚拟角色 / AI 助手可视化 / Electron 应用 / MCP 集成 / VRM/VRMA 动画 / 跨平台音频监听
配置难度
中等偏高。普通前端/Electron 开发者可以运行和改造界面，但如果涉及跨平台音频捕获、native listener、打包发布、资产授权和 MCP 集成，则需要熟悉桌面系统权限、原生构建工具链以及 VRM/VRMA 资源流程。
商业价值
适合用于 AI 语音助手、桌面 Agent、虚拟陪伴、企业内部智能助手等产品的视觉表现层，可提升语音交互的情感化和存在感。其隐私友好的本地音频监听和 MCP 集成对开发者有吸引力。不过它本身不包含语音合成、语音识别或大模型能力，商业化落地需要结合现有 AI/语音系统，并解决角色资产版权、跨平台兼容和用户权限体验问题。
01
技术亮点
- 支持 Linux、Windows、macOS 三大桌面平台
- 针对不同系统使用原生音频输出监听机制：Linux PipeWire、Windows WASAPI、macOS Core Audio
- 监听范围限定在受支持应用的播放进程，不采集麦克风、不保存音频、不转录内容、不通过网络发送音频，隐私边界较清晰
- 提供本地 MCP 服务，可与 Codex 集成，适合 AI Agent 桌面可视化场景
- 窗口设计偏桌宠化：无内置控件，支持缩放、旋转、平移，并尽可能保持置顶显示
- Hyprland 下有专门窗口行为优化，如 floating、pinned、topmost、无阴影、无装饰等
- 提供跨平台原生包构建脚本和 GitHub Actions 流水线
- 对素材发布有 release gate 机制，避免误发布未授权角色资产
02
目标用户
- 希望为 AI 语音助手增加虚拟形象的开发者
- 使用 Codex 或 MCP 工具链的开发者
- 桌面端 AI Agent/助手产品团队
- 虚拟主播、桌宠、数字人应用开发者
- 需要跨平台音频输出检测能力的 Electron 开发者
03
配置要求
- Node.js 24+
- npm
- 本地硬件加速图形桌面环境
- 必须自行提供 VRM 角色模型和 VRMA 动画文件
- assets/manifest.json 需要填写素材来源、许可证信息，并在可分发时设置 distributionAllowed 为 true
- Linux 需要 pw-dump 和 pw-record 位于 PATH 中，用于 PipeWire 音频捕获
- Windows 进程回环捕获需要 Windows 10 build 20348 或更新版本
- Windows 构建需要 Visual Studio Build Tools，并安装 C++ desktop workload
- macOS 需要 macOS 14.2+，并授予 System Audio Recording 权限
- macOS 构建需要 Xcode Command Line Tools 和 macOS 14.2+ SDK 支持
- macOS 和 Windows 从源码运行前需要先构建 native listener
- 发布前必须确认角色资产许可证允许分发
04
适用场景
- 为语音 AI 助手添加桌面虚拟角色表现
- 在 Codex 会话中控制本地角色动画、窗口显示和状态查询
- 根据目标应用的音频输出自动触发说话动画
- 构建桌宠、虚拟伴侣、数字人助理原型
- 研究 Linux PipeWire、Windows WASAPI、macOS Core Audio 的进程级音频输出监听
- 打包跨平台桌面应用，生成 AppImage、DEB、NSIS、DMG、ZIP 等安装包
05
部署与配置
- 安装 Node.js 24 或更新版本以及 npm
- 确保当前桌面环境支持硬件加速图形渲染
- 克隆仓库：git clone https://github.com/xikhar/persona.git
- 进入项目目录：cd persona
- 安装依赖：npm install
- 准备本地角色资源，将 model.vrm、manifest.json 和 animations 下的 VRMA 动画文件放入 assets/ 指定位置
- 运行演示：npm run demo
- 如需后台启动：npm start -- --background
- 如需连接 Codex，在 Persona 运行后执行：codex mcp add persona --url http://127.0.0.1:47831/mcp
- 如需构建安装包，在目标操作系统上执行对应命令：npm run dist:linux、npm run dist:windows 或 npm run dist:mac
06
风险与注意事项
- 仓库不包含角色媒体资源，开箱即用程度有限，必须自行准备 VRM/VRMA 文件
- Node.js 24 要求较新，部分开发环境可能需要升级
- 音频监听依赖系统能力和权限，Linux、Windows、macOS 的兼容性问题可能较多
- Windows 要求较新的系统构建版本，旧版 Windows 10 可能不可用
- macOS 需要 System Audio Recording 权限，用户接受度和权限引导需要额外设计
- 应用源码是 MIT，但角色资产不属于该许可证，商业发布时素材授权风险较高
- 项目 stars 约 398、forks 约 35，社区规模中等偏小，生态和长期维护稳定性需要观察
- 描述中强调不生成语音、不转录内容，因此它不是完整语音助手，只是视觉表现层
- 许可证字段为 NOASSERTION，虽然 README 提到源码 MIT，但仍建议核对仓库 LICENSE 文件和资产许可文件
2026-08-04
第10名
新收录 · github_search
2026-08-03
第9名
新收录 · github_search
2026-08-02
第6名
新收录 · github_search
2026-08-01
第5名
新收录 · github_search
2026-07-31
第7名
新收录 · github_search
2026-07-30
第16名
新收录 · github_search
