首次配置走通：接模型、导角色卡、发出第一条消息
三分钟初始化清单
无论你用哪种方式装的（电脑 / Docker / APK / 鸿蒙），首次配置都是同样三步：
第一步：进入界面
- 电脑 / Docker：浏览器访问
localhost:8000 - 安卓 APK / 鸿蒙 HAP：打开应用即可，服务在内置启动，无需地址
第二步：配置至少一个 API
没有模型就没有回复。点顶栏的 API 连接 图标：
- 选择 API 类型（OpenAI、Claude、Gemini、OpenRouter、OpenAI 兼容自建等）
- 填 API 地址与密钥
- 点测试连接，确认通过
详细说明见API 连接配置教程。
第三步：选卡或导卡
- 从内置角色列表选一个角色直接开聊
- 或点 导入 按钮，导入
.png/.json角色卡（社区下载的卡基本都是 PNG 卡）
角色卡字段与导入导出细节见角色卡入门。
config.yaml 常用项速查
配置文件在项目根目录，首次启动会从默认模板复制生成。常用项：
| 配置 | 作用 |
|---|---|
port: 8000 | 服务监听端口 |
dataRoot | 数据目录位置，默认 ./data |
basicAuthMode | 简单密码保护开关，见鉴权与安全 |
enableUserAccounts | 多用户账户模式开关 |
whitelistMode | IP 白名单开关 |
storage | 存储后端设置（文件 / SQLite / MySQL / PostgreSQL） |
改动配置后重启服务生效。Docker 用户注意：配置目录已挂载到宿主机，直接改宿主机文件即可。
装完先做什么
- 想让角色记住剧情 → 开记忆图
- 想让回复质量上一个台阶 → 开多 Agent 编排
- 老酒馆用户 → 先做数据搬家