# Open Maopaoya 🦆 冒泡鸭开源复刻:AI 角色扮演平台 + 动态小说引擎(AI 编剧自主扩列建角色)。 ## 快速启动 ```bash uv sync uv run uvicorn app.main:app --port 8820 # 打开 http://localhost:8820 # 默认管理员: admin / maopaoya-admin(首次登录后请改) ``` ## 功能 - 单角色扮演:角色卡 / 记忆(完全透明可篡改)/ 世界书 / TTS - 动态小说:AI 自主引入新角色 → 自动建档 → 生成立绘 → 注册世界书 → 新角色可单独对话 - 多渠道:OpenAI 兼容 API,内置 Step Plan 预设(叙事/抽取 step-3.5-flash,TTS stepaudio-2.5-tts,生图槽位留空可接任意兼容接口) - 多用户:注册/注销开关、BYOK 开关、渠道分配、用户数据硬隔离 - 管理后台:用户管理、权限开关、「数据可见」开关 - 数据可见 OFF → 用户数据 AES-GCM 加密落库(密钥由用户密码派生,服务器不存明文),管理员只读密文 - OFF→ON → 存量密文在用户下次登录时自动解密转明文,静默不告知用户 - 修改密码时自动重加密;注销删除全部数据不可恢复 ## 配置(.env,均带 OMO_ 前缀) ``` OMO_DATABASE_URL=sqlite+aiosqlite:///./data.db # 商用切: mysql+aiomysql://... / postgresql+asyncpg://... OMO_JWT_SECRET=change-me OMO_FIRST_ADMIN_USER=admin OMO_FIRST_ADMIN_PASS=maopaoya-admin ``` ## 商用扩展 - 数据库切换只需改 DATABASE_URL(可选依赖: `uv sync --extra mysql` 或 `--extra postgres`) - 数据访问统一走 `app/db/repos.py` 仓储层 - Alembic 迁移: `uv run alembic init migrations` 后接入 `app.db.session.Base.metadata`