Skip to content
minorcellPublic

About

住在蛛岛上的 3D 蜘蛛宠物,用自然语言与它互动。

Topics

Resources

Contributing

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

蛛小八标志

蛛小八

住在蛛岛上的 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。

About

住在蛛岛上的 3D 蜘蛛宠物,用自然语言与它互动。

Topics

Resources

Contributing

Stars

13 stars

Watchers

0 watching

Forks

Contributors

Languages