Files
OpenMaopaoya/README.md
T

36 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`