创建第一个世界并启动模拟¶
本快速开始假设后端和前端已经运行。如果还没有,请先阅读使用 Docker 最快本地部署或在 Windows 从源码快速本地部署。
1. 创建提供商配置¶
打开 Configurations,创建最小运行时配置:
- Connection:为 LLM 提供商创建连接。对于本地 Ollama,base URL 使用
http://localhost:11434。 - LLM config:选择该连接,输入模型 id,第一次运行先保留默认生成设置。
- Embedding config:选择支持 embedding 的提供商。当前 embedding 提供商包括 Ollama、OpenAI、Google GenAI、Mistral AI、Cohere、Perplexity 和 Cloudflare Workers AI。
图像、TTS 或 STT 配置可以之后再加。第一次模拟不需要它们。
2. 创建作者¶
打开 Authors,创建一个作者配置。世界需要归属作者,所以先创建作者再创建世界。
3. 创建世界¶
打开 Worlds,创建一个世界,填写:
- 简短名称。
- 简洁的设定描述。
- 刚创建的作者。
保存后打开世界详情页。
4. 添加足够的世界状态¶
第一次运行建议保持世界很小:
- 添加一个地点。
- 在该地点添加一个玩家可交互角色。
- 可选添加一个背景角色、物品、地标或装备。
小世界更容易调试,因为每个生成动作都能追溯到少量结构化状态。
5. 分配模型配置¶
在世界配置区域分配:
- 把 LLM 配置分配给核心 LLM 组件。
- 把 embedding 配置分配给支持 embedding 的组件。
至少确保 narrator、input interpreter、action validator、character simulator、scene coordinator、state committer、memory summarizer 和 perspective resolver 都有可用 LLM 配置。
6. 启动模拟¶
从世界页面创建一个 simulation。打开 simulation chat 页面,然后发送一个简单的第一步动作,例如:
模拟会解释输入、校验动作、模拟角色反应、提交状态变更,并渲染这一回合。
7. 如果第一回合失败¶
按这个顺序检查:
- 后端终端是否有提供商认证或连接错误。
- 所选的 LLM 模型 id 在该提供商下是否真的存在。
- 创建记忆后是否更换过 embedding 模型维度。
- 是否有必要组件没有分配 LLM 或 embedding 配置。
- 模型是否连续多次返回了无法修复的结构化输出。
第一个世界跑通后,再逐步加入媒体生成、语音、提示词覆盖和更复杂的背景状态。