自由模式
用 HTML/JS 构建完全自定义的互动游戏,通过 Storvia SDK 接入 AI 对话和状态管理
自由模式允许你用 HTML + JavaScript 编写完全自定义的游戏界面和逻辑,通过 Storvia SDK 接入平台的 AI 对话、角色管理、状态追踪等能力。
和简单模式、高级模式不同,自由模式不使用平台内置的聊天界面 —— 你可以自由设计任何形式的交互:直播间、社交平台、卡牌对战、文字冒险……只要你能用网页实现。
核心概念
Storvia SDK
SDK 是你的游戏和 Storvia 平台之间的桥梁。它提供:
- AI 对话 — 发送消息获取 AI 回复,支持流式输出
- 消息管理 — 独立保存消息、请求 AI 生成回复
- 状态管理 — 读写世界状态、玩家属性、角色属性、关系、物品、自定义数据
- 设置面板 — SDK 自动在页面右下角挂载设置按钮,用户可选择模型、调节参数
Topic(话题隔离)
每次 AI 对话可以指定一个 topic,不同 topic 的对话历史互相隔离。比如:
dm_npc1— 和 NPC1 的私信dm_npc2— 和 NPC2 的私信group_chat— 群聊
AI 在回复时只看到同一 topic 下的历史消息,不会混淆不同场景的对话。
Context(场景上下文)
每次 AI 调用可以传入 context,告诉 AI 当前的场景信息。比如当前扮演哪个角色、在什么场景下对话、最近发生了什么。Context 会注入到 AI 的提示词中,但不会保存到历史记录。