495083f9b4a37cebd84631b86e7660a65dc0bace
Open Maopaoya 🦆
冒泡鸭开源复刻:AI 角色扮演平台 + 动态小说引擎(AI 编剧自主扩列建角色)。
快速启动
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
商业化 API(v1 稳定契约)
- 前缀
/v1,独立于/api演进;契约只加字段不改语义 - 认证:
X-API-Key头(sha256 落库,明文仅创建时返回一次) - scope:
chat(仅对话)/full(含角色读取);每 key 独立限流(req/min) - 端点:
GET /v1/ping、POST /v1/keys、GET /v1/keys、DELETE /v1/keys/{id}、GET /v1/usage(用量账本,计费底座)、GET /v1/characters、POST /v1/chat - 多实例部署时限流换 Redis(现为进程内滑动窗口)
性能
- 全局 httpx 连接池复用(不再每请求握手)
- 站点设置进程内缓存(写时失效)
- 复合索引覆盖热查询路径(消息/记忆/朋友圈/会话),旧表启动时自动补建
- GZip 响应压缩(>1KB)
- 部署建议:
uvicorn app.main:app --workers 2或 nginx 反代 + 多 worker;量大切 PG
Languages
Python
55%
JavaScript
23.2%
Vue
11.8%
CSS
5.7%
HTML
4.2%