2026-11-15 16:15:32 +08:00
2026-11-15 16:15:32 +08:00

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
S
Description
开源的冒泡鸭精神续作
Readme MIT
29 MiB
Languages
Python 55%
JavaScript 23.2%
Vue 11.8%
CSS 5.7%
HTML 4.2%