Aholo Viewer 3DGS渲染器 开源html

「42 Aholo Viewer 3DGS与 Mesh​ 的高性能渲染器」

/~e5413Yt5kB~:/

链接：https://pan.quark.cn/s/4712fff6b4af
Aholo Viewer 是一个面向 3DGS（3D Gaussian Splatting） ​ 与 Mesh ​ 的高性能渲染器。

它采用 **Chunked Streaming LOD（分块流式 LOD）**​ 机制，可高效加载和渲染超大规模 3DGS 场景。

---

✨ 特性

• ⚡ 高性能：针对大规模点云 / 3DGS 优化

• 🧩 分块流式加载：按需加载，支持海量数据

• 🎮 内置示例与 Playground：在线编辑与调试渲染代码

• 📦 Monorepo 架构：渲染器 + 文档站点统一管理

• 🔧 TypeScript + Node ≥ 22：现代化前端工具链

---

📦 仓库结构

aholo-viewer/
├── AGENTS.md              # AI 代理与开发指引
├── website/               # Astro 文档站点（首页 / 手册 / 示例 / API / Playground）
├── packages/renderer/     # 渲染器 TypeScript 源码包
├── scripts/               # 构建与文档生成脚本
├── docs/                  # 架构说明与 AI 协作指南
├── external/              # 上游依赖源码（含子模块，只读）
├── .codex/skills/         # Codex 本地技能配置

---

🚀 快速开始

环境要求

• Node.js：≥ 22.22.1

• pnpm（推荐使用 corepack）

克隆仓库（包含子模块）

git clone --recurse-submodules https://github.com/manycoretech/aholo-viewer.git
cd aholo-viewer

安装依赖

pnpm install

启动开发环境

pnpm dev

浏览器访问提示地址即可看到示例场景。

---

🛠 常用命令

根目录通用命令

命令	说明
pnpm install	安装依赖
pnpm dev	启动开发服务器
pnpm build	构建全部包
pnpm preview	预览生产构建
pnpm check	执行全量检查

定向构建与检查

命令	说明
pnpm build:renderer	仅构建渲染器
pnpm build:website	仅构建文档站点
pnpm check:renderer	渲染器类型与代码检查
pnpm check:website	站点内容检查
pnpm check:content	手册、示例、图片与链接校验
pnpm docs:api	生成 API 文档

---

📖 使用方式

详细用法请参考 使用手册（构建后自动生成）。

如果一切正常，你将看到类似官方示例的 3DGS 场景。

---

🌐 Playground

Playground 支持通过 URL 直接恢复代码状态：

/zh-CN/playground/?example=basic-scene&code=<压缩后的源码>

• 示例存储在 website/src/content/examples/

• 每个示例包含：

  • <slug>.json（元数据）

  • <slug>.ts（源码）

---

📚 项目文档

• AGENTS.md：AI 代理与后续开发快速指引

• docs/architecture.md：当前工作区结构与依赖关系

• docs/ai/vibe-coding-guide.md：AI 辅助开发规范与写作风格

• .codex/skills/：按模块划分的 Codex 本地技能

---

🔗 外部依赖说明

⚠️ external/ 目录下为只读上游代码

• external/egs-core：必需的上游子模块

• external/splat-transform：必需的 workspace 依赖包

  除非任务明确说明，否则不要修改这些目录中的代码。

---

📄 License

本项目采用 MIT License。