如何切换Hermes3D 2D像素办公室:低配电脑的轻量渲染模式
如何切换Hermes3D 2D像素办公室:低配电脑的轻量渲染模式
Hermes3D 是一个面向 AI Agent 的 3D 虚拟办公室开源项目,你可以在里面实时观察 Agent 们协作、开会、跑任务。如果你的电脑配置较低,3D 渲染太吃力,Hermes3D 内置了一套 2D 像素办公室渲染模式——用像素风替代 Three.js 3D 场景,大幅降低 GPU 负担。本文用 5 分钟带你学会一键切换 Hermes3D 2D 像素办公室的完整方法。
为什么要用 2D 像素办公室?
Hermes3D 默认的办公室是完整的 3D 场景(Three.js + 阴影 + 后期特效),对显卡有一定要求。当出现以下情况时,建议切换到 2D 像素办公室:
- 🐢 网页卡顿、掉帧,浏览器风扇狂转
- 💻 没有独立显卡的低配笔记本 / 核显设备
- 🖥️ 远程桌面、无头浏览器、CI 环境等软件渲染场景(SwiftShader、llvmpipe)
2D 像素办公室采用 Phaser 引擎的像素风实现,是"同一个办公室"的轻量视图:Agent 们的位置、状态、聊天、互动都保留,只是用 2.5D 像素画面呈现,低配机器也能流畅运行。
两种模式的官方定义在 renderMode.ts 中:
| 模式 | 渲染器 | 特点 |
|---|---|---|
3d(3D immersive) |
Three.js | 阴影、后期特效,视觉最佳 |
2d(2D pixel) |
Phaser 像素风 | 轻量、低配友好,官方标注 "Great for low-power machines" |
一键切换方法:3 个入口
方法一:办公室工具栏的 2D 按钮(最快)
进入办公室页面(路由 /office)后,在场景顶部工具栏中找到 2D 按钮,点击即切换。切到 2D 后,工具栏会反过来出现 3D 按钮,可随时切回。3D 场景中的切换按钮逻辑见 RetroOffice3D.tsx,2D 场景中的切回按钮见 PixelOffice2D.tsx。
方法二:Settings → Office renderer(推荐)
点击办公室右上角的 **设置(Studio settings)**图标,打开设置面板后找到 Office renderer 区块,两个选项卡片里点一个即可,当前生效的会显示 Active 徽标:
- 3D immersive:Full Three.js office with shadows and post-processing.
- 2D pixel:Gather-style pixel office. Great for low-power machines.
该区块的完整实现见 SettingsPanel.tsx。未连接 Gateway 的连接页(GatewayConnectScreen)上也能直接选择渲染模式,方便低配机器在加载 3D 场景前先降级。
方法三:不配置,让系统自动检测(零操作)
Hermes3D 很贴心:如果你从未手动选择过,它会先探测你的显卡——
如果 WebGL 是软件光栅化(CPU 渲染),自动启动 2D 像素办公室;否则默认 3D。
核心逻辑只有一行,在 renderMode.ts:
loadStoredOfficeRenderMode() ?? (detectSoftwareWebGL() ? "2d" : "3d")
也就是说:你的选择永远优先,没选过时才按硬件能力决定。
切换后会记住吗?—— 会,存在浏览器 localStorage
模式选择会写入浏览器 localStorage,键名为 hermes-office-render-mode-v1,刷新页面、重启浏览器都会保留你的选择。对应的保存与读取函数是 saveOfficeRenderMode / loadStoredOfficeRenderMode(renderMode.ts),相关行为由单元测试 officeRenderMode.test.ts 覆盖,包括"损坏的值会被忽略、用户选择优先于硬件检测"等边界情况。
💡 如果想重置为自动检测,用浏览器开发者工具清除该 localStorage 键即可。
低配但不想放弃 3D?试试 Graphics quality 降档
如果你希望保留 3D 画面只是帧率低,还有一条折中路线:在同一个设置面板里,Graphics quality 提供三档:
- Low:最快,关闭后期特效,小阴影贴图
- Balanced(默认):环境光遮蔽、泛光、软阴影
- Ultra:最高画质,4096 阴影贴图 + 全套特效
低配机器直接选 Low 就能省下大量 GPU 开销。三档的具体参数(阴影贴图大小、像素比上限、特效开关)定义在 graphicsQuality.ts。它同样会被自动探测:软件渲染机器会默认降到 low 档,避免 3D 管线一开始就把显卡压垮。
常见问题 FAQ
Q1:2D 模式会丢失 Agent 的功能吗? 不会。2D 像素办公室展示的是同一批实时 Agent,点击 Agent 依然可以聊天、管理,看板、点唱机等互动入口也都在,只是画面从 3D 换成了像素风。
Q2:切换模式需要重装或重启 Gateway 吗? 不需要,纯前端偏好,点击立即生效并自动持久化。
Q3:为什么我的机器一进来就是 2D? 说明 Hermes3D 检测到你没有硬件加速的 WebGL(软件渲染),已自动帮你选了更省心的像素模式;随时可以手动切回 3D。
Q4:修改办公室布局时也能切换吗?
可以,办公室编辑页(/office/builder)与主办公室共享同一套渲染模式偏好。
小结
- 低配电脑看 Hermes3D 办公室卡?点工具栏 2D 按钮或走 Settings → Office renderer 切到 2D 像素办公室即可
- 选择保存在
localStorage(hermes-office-render-mode-v1),刷新不丢失 - 未手动选择时,软件渲染环境会自动落到 2D 模式
- 想保留 3D 就降 Graphics quality 到 Low 档
相关源码路径速查:

