--- title: 3D-AI-Companion canonical_url: "https://www.modelscope.cn/studios/JerryWuModelScope/3D-AI-Companion" md_url: "https://www.modelscope.cn/studios/JerryWuModelScope/3D-AI-Companion.md" repository: JerryWuModelScope/3D-AI-Companion chinese_name: "3D AI 伴侣" last_updated: 2026-05-11 sdk_type: docker downloads: 0 stars: 5 --- # 3D-AI-Companion > 3D-AI-Companion - JerryWuModelScope 在 ModelScope 创建的在线 Demo。本项目旨在构建一个高度可定制、具身化的 3D AI 伴侣，致力于解决当前 AI 陪伴类产品存在的“缺乏真实感、互动单一、无法与现实连接”等问题。用户可以通过自定义外观、音色、性格与背景经历，在 3D 虚拟世界中创造出一个独一无二的智能体。该智能体支持语音交互，还具备视觉感知能力，能够“看见”所处的环境，并做出相应的动作反馈。未来还计划支持与现实世界的物联网设备联动，实现从虚拟到现实的跨维度互动。 JerryWuModelScope/3D-AI-Companion 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 docker 构建，中文名为「3D AI 伴侣」。 - **Repository**: JerryWuModelScope/3D-AI-Companion - **SDK**: docker - **Downloads**: 0 - **Stars**: 5 - **Last updated**: 2026-05-11 Source: https://www.modelscope.cn/studios/JerryWuModelScope/3D-AI-Companion --- # 3D-AI-Companion --- **目录** [toc] --- ## 项目简介 本项目旨在构建一个**高度可定制、具身化的 3D AI 伴侣**，致力于解决当前 AI 陪伴类产品存在的“缺乏真实感、互动单一、无法与现实连接”等问题。用户可以通过自定义外观、音色、性格与背景经历，在 3D 虚拟世界中创造出一个独一无二的智能体。该智能体支持语音交互，还具备视觉感知能力，能够“看见”所处的环境，并做出相应的动作反馈。未来还计划支持与现实世界的物联网设备联动，实现从虚拟到现实的跨维度互动。 ## 本地部署 ```bash git clone https://www.modelscope.cn/studios/JerryWuModelScope/3D-AI-Companion.git cd 3D-AI-Companion pip install -r "requirements.txt" python run.py ``` 然后访问 `http://127.0.0.1:7860/` 或 `http://localhost:7860/` 。 ## 交互与设计说明 ### 主界面 这是一打开网页就能看到的页面。 ![main](./README.assets/main.png) - 点击左、右箭头按钮可以来切换地图； - 点击“进入世界”按钮可以加载并进入地图； - 点击“我的模型”按钮可以进入模型库，更换自身人物模型； - 点击“我的智能体”按钮可以进入智能体库，创建和管理智能体。 ### 模型库 在主界面点击“我的模型”可以进入该页面。 ![model_library](./README.assets/model_library.png) - 点击“新建模型”按钮，会要求用户上传一个 `.glb` 模型文件，并将其添加到左侧的列表中。 - 点击“新建模型”按钮旁边的问号，会跳转到自制 3D 模型教程页面。 - 点击“选择该模型”按钮，用户将会使用所展示的模型作为自身模型。 - 点击“删除模型”按钮，可以将该模型从列表中删除。 - 可以用鼠标左键拖拽来旋转所展示的模型，可以用鼠标滚轮进行缩放。 ### 智能体库 在主界面点击“我的智能体”可以进入该页面。 ![agent_library](./README.assets/agent_library.png) - 左侧的列表展示了用户创建的所有智能体。 - 右侧的面板显示了所选智能体的信息，部分信息可编辑。 - 点击“新建智能体”按钮，会要求用户上传一个 `.glb` 模型文件，并将其添加到左侧的列表中。 - 点击“记忆管理”按钮，会打开记忆管理面板。 - 点击“保存智能体信息”按钮，会保存对该智能体的修改。 - 点击“删除该智能体”按钮，会删除该智能体的所有信息。 ### 记忆管理面板 在智能体库点击“记忆管理”可以进入该页面。 ![memory_management](./README.assets/memory_management.png) - 左侧展示了该用户与智能体的所有回忆。 - 中间展示了该智能体的长期记忆，可以编辑。 - 右侧展示了该智能体的短期记忆。 - 每一条记忆片段都以一张卡片的形式展示，可以点击卡片中的文本框来修改记忆，也可以点击卡片右上角的红色按钮来删除记忆。 ### 3D 世界 在主界面点击“进入世界”可以进入所选的地图。 ![world](./README.assets/world.png) - 用户可以按 ESC 或 Tab 键召唤菜单。 - 用户可以按住 W A S D 向四个方向移动，按 Space 跳跃，按住 Shift 奔跑，按住 C 蹲下，按 V 切换视角。 - 用户可以用鼠标旋转视角。 ### 菜单 在 3D 世界中按 ESC 键可以召唤菜单。 ![menu](./README.assets/menu.png) - 按“开始”按钮关闭菜单。 - 按“管理智能体”按钮来邀请智能体进入该世界，或让智能体离开。 - 按“脱离卡点”按钮以回到出生点。 ### 智能体派遣中心 在菜单中按“管理智能体”可以打开此面板。 ![agent_management](./README.assets/agent_management.png) - 左侧列出了智能体库中未进入该世界的智能体。 - 右侧列出了智能体库中已进入该世界的智能体。 - 可以按左侧的绿色按钮来邀请智能体加入。 - 可以按右侧的红色按钮使智能体离开。