住在蛛岛上的 3D 蜘蛛宠物,用自然语言与它互动。
蛛小八是一只住在蛛岛上的 3D 蜘蛛宠物,运行在浏览器中。接入语言模型后,你可以让它探索岛屿、寻找食物,或把物品搬回巢穴。模型根据蜘蛛感知到的环境选择行动,你可以在画面中观察它如何完成任务。
游戏实景 · 白天的巢穴 / 夜间活动 · 点击图片查看大图
蛛岛上有草地、山坡和水域,也有可以交互的食物与物品。蜘蛛需要走到目标附近才能吃东西、搬运物品或喝水;遇到障碍和陡坡时,需要绕行或调整身体高度。夜晚的视野会缩短,它也可以打开背上的灯。
接入模型后,在页面底部输入一句话,按回车发送。可以试试这些指令,实际行动取决于模型的选择和当时的环境。
- “找一个苹果,搬回巢里。”
- “去水边喝点水,把那里记作水边。”
- “回到巢里睡一觉。”
行动时,蜘蛛身边会显示它正在做什么。再次发送指令会打断当前任务。它还可以记录有名字的地点,之后再按名字返回,例如先让它记住“水边”,再让它“回水边”。
可以在右上角「设置」的模型页面选择以下接入方式:
- Ollama 本地运行:使用电脑上运行的模型服务。
- 在线模型:例如 DeepSeek;需要配置服务商提供的 API Key。
- Web LLM 浏览器运行(实验性):模型直接在浏览器中运行,无需连接在线模型服务,但对电脑性能要求较高。详见模型接入说明。
Ollama 和在线模型的安装配置、跨域要求与常见问题见模型接入说明。
世界进度默认保存在当前浏览器中,包括蜘蛛的位置、携带的物品、已标记的地点和待完成的指令。刷新或重新打开页面后会尝试恢复;清除站点数据会移除本地存档。日记用于保留对话摘要和蜘蛛记下的内容。
模型设置和 API Key 保存在当前浏览器中。调用模型时,浏览器直接向你配置的模型服务发送请求,内容包括对话、相关的环境信息和工具结果,API Key 随请求用于认证。
如需跨设备继续,可以在设置的「云端」中连接自己的 S3 兼容对象存储,同步世界和日记。模型设置、模型密钥、用量记录和对象存储密钥不包含在云端存档中;对象存储密钥用于向所配置的存储服务签名请求。配置要求、冲突处理和保存机制见存档与同步。
蜘蛛的行动由语言模型和本地模拟程序共同完成。模型收到用户指令后,可以调用工具观察附近的对象、移动、操作物品或记录地点。程序执行这些动作,再把结果交回模型,供它决定下一步。
例如收到“把苹果搬回巢里”后,模型可以先观察,找到苹果后走近并搬起,再返回巢穴存放。如果路被挡住,程序会返回失败原因和可用的行动提示,模型可以据此重试。模型接收的是结构化的环境信息,感知范围受距离、遮挡和光照限制。
观察包含周围八个方向可见地面的高度变化,以及巢穴、山顶和后山等家园地标。后山指山顶背离巢穴的一侧;地标是帮助定位的参考点,不保证路线畅通。家园地标由当前岛屿生成,与自己记录的地点分开保存和使用。
蛛小八的默认性格是好奇、亲近人,做成小事会有一点得意。人格提示词约定它的表达方式和行动偏好,环境事实与行动结果仍由模拟程序提供。人格设定和工具规则见系统提示词。
这里的 Agent 指这个能够观察、选择并执行行动的循环。Agent harness 是支持它运行的程序,包括环境描述、工具、执行反馈、对话与记忆管理。移动、碰撞、寻路和物品交互由模拟程序处理,Three.js 负责把世界呈现在浏览器中。
想了解具体实现,可以从这些文件开始阅读。
| 关注的问题 | 代码入口 |
|---|---|
| 如何把用户指令交给模型,接收并执行工具调用 | Agent 循环 |
| 蜘蛛能调用哪些工具,行动失败时得到什么反馈 | 工具定义 |
| 移动、观察和物品交互如何执行 | 模拟会话 |
| 模型能感知到哪些状态 | 状态与观察类型 |
| 对话、日记与摘要如何组织 | 日记与记忆 |
需要 Node.js 24 或更新版本,以及 pnpm。CI 使用 pnpm 11。
pnpm install
pnpm dev在浏览器中打开终端输出的地址,再按上面的步骤接入模型。
| 命令 | 用途 |
|---|---|
pnpm build |
构建生产版本 |
pnpm preview |
在本地预览生产构建 |
pnpm typecheck |
检查客户端 TypeScript 类型 |
pnpm lint |
检查代码规范 |
pnpm format:check |
检查文件格式 |
pnpm test |
运行测试,包含本地性能预算测试 |
pnpm bench |
运行性能基准,输出耗时和吞吐量 |
性能预算受机器负载影响,仅在本地运行;CI 会排除这组测试。后台线程的分工、各组基准覆盖的路径,以及如何理解测量结果,见性能与基准测试。
请先阅读贡献者指南,了解如何反馈 Bug、提议功能,以及提交 PR。