快速开始
克隆、安装、生成世界、运行共享展示与沙盒,并用 Python SDK 操作一个会话
本页从"机器上还没有源码"开始,到"我在本机运行了共享展示,并用程序创建、操作并结束了一个沙盒会话"为止。终点是三样具体的东西:本机一个运行中的 World Runtime(共享展示,浏览器可访问)、一个本机沙盒控制面(sandbox-pool 与 sandbox-api),以及一段经开放接口完成"创建会话、添加无人机、读取状态、结束会话"的 Python 程序。
下面每一段输出都来自 2026-10-13 以 0.2.0 版本在一台 8 核 x86-64 开发机(Ubuntu、Python 3.12.3、Node 22.12.0、无 GPU)上按本页步骤从
git clone 开始的真实运行。为便于阅读,仓库路径统一写成 ~/ANet4D,端口写成默认值(8000、8002、7447);运行编号、进程号、会话编号与耗时会随机器不同,版本行会随发布版本不同。
前提条件
项 |
要求 |
|---|---|
系统 |
Linux x86-64(Ubuntu 22.04 或 24.04) |
工具 |
Python 3.12(含 venv)、Node 22.12.x、make、git、curl |
资源 |
约 20 GB 可用磁盘, |
网络 |
首次安装需访问 GitHub、PyPI 与 npm 仓库 |
获取源码:git clone
cd ~
git clone https://github.com/ANetResearch/ANet4D.git ANet4D
cd ANet4D
Cloning into 'ANet4D'...
Updating files: 100% (3245/3245), done.
git clone 的第二个参数把工作目录命名为 ANet4D,与仓库名一致。本次运行的工作树约 126 MB,克隆用时 5.8 s。仓库不包含任何点云、世界包或运行产物:worlds/、data/raw/ 与 runs/ 都在
.gitignore 中,由后续步骤在本机生成。
main 分支是持续维护的分支;需要与已发布版本逐字节一致时,切到版本标签:
git checkout v0.3.2
安装依赖:make setup
make setup
创建 .venv(python3.12)
自举 uv 0.12.19
cd ~/ANet4D && ~/ANet4D/.venv/bin/uv pip sync requirements.lock --python ~/ANet4D/.venv/bin/python
Resolved 70 packages in 757ms
Uninstalled 1 package in 118ms
Installed 69 packages in 174ms
+ annotated-doc==0.0.5
+ annotated-types==0.8.0
...
+ zstandard==0.25.0
cd ~/ANet4D && ~/ANet4D/.venv/bin/pip install --quiet -e . --no-deps
added 829 packages in 36s
gen.py: up to date (layout_id 0x009600AE, contracts 1.2.0)
gen_golden.py: up to date
gen_frames_golden.py: 4106 cases, up to date
gen_env_golden.py: 10261 cases, up to date
gen_fixtures.py: up to date
gen.mjs: up to date (layout_id 0x009600AE, contracts 1.2.0)
DOC-01 OK CPU 架构:x86_64
DOC-02 OK Python 3.12:3.12.3
DOC-04 OK Node 22.12.x:22.12.0
DOC-08 OK 依赖版本(含 zenoh 1.10.1):与 pyproject 锁定一致
DOC-22 OK 配置与访问模式:profile=dev access=loopback bind=127.0.0.1
DOC-09 OK 端口空闲:[8000, 7447, 5173] 空闲
DOC-10 OK /dev/shm 可写且 ≥ 1 GiB:/dev/shm/awr free=31.4 GiB writable=True
DOC-11 OK 残留运行目录:无
DOC-12 OK 磁盘余量:free=18.7 GB
DOC-14 WARN 原始数据:0 个 PLY(~/ANet4D/data/raw/urbanscene3d)
修复:make fetch-data
DOC-15 WARN 默认世界:~/ANet4D/worlds/shenzhen/world.json 尚未构建(make run 会自动构建)
修复:make worlds
M11-R1 OK StateRing 自测:publish/attach/read_latest/header
M11-R2 OK zenoh 自环:query/reply 成功(35 ms)
awr doctor --quick: 通过(0.2 s)
make setup 完成
make setup 是幂等的,按顺序做四件事:
Python 依赖。 用
python3.12创建.venv,自举固定版本的 uv,再以uv pip sync requirements.lock按锁文件(带哈希)安装 70 个包,最后以可编辑方式安装本仓库的awr包。上面省略了 69 行安装清单。前端依赖。
npm ci按package-lock.json安装;锁文件未变化且上次安装成功时跳过(FORCE=1强制重装)。契约生成物校验。 75 份 JSON Schema 生成的 Python 与 TypeScript 类型、二进制布局与 golden 用例必须与仓库中的版本一致(
up to date);不一致说明工作树被改动过,按提示执行make contracts重新生成。快速诊断。
awr doctor --quick逐项检查环境,WARN不阻塞,ERROR以非零退出码失败并给出修复命令。
本次运行用时 73 s,uv 与 npm 的本地缓存已存在;首次在新机器上安装需要下载依赖,通常为 3 至 8 min。
输出中的告警
两项 WARN 在没有 UrbanScene3D 数据的机器上是预期的:DOC-14 说明 data/raw/ 中没有六城原始数据,DOC-15 说明缺省世界深圳尚未构建。下一步生成的合成演示城市会成为回退世界。
完整输出中还有两类与功能无关的告警,上面未列出:npm 对 react-doctor、eslint-scope 等四个开发期工具包给出的
EBADENGINE(它们声明需要 Node 22.13 或更高,不参与构建与运行),以及 FastAPI 生成 OpenAPI 时,对唯一一条同时服务 GET 与 HEAD
的接口(segment_file,运行分段下载)给出的 Duplicate Operation ID 提示。生成的操作 id 以 _get 或 _head 结尾取决于解释器的哈希种子,两次运行可能不同(segment_file_api_runs__run__segments__name__get 或 ..._head);两种形式都是预期且无害的,已提交的
OpenAPI 快照不受影响(tools/contracts/gen_openapi.py 会将其规范化)。
生成合成演示城市:make demo-world
make demo-world
[worldpkg] synthcity: generate (missing; synthetic, ADR-077)
[worldpkg] 1-minute loadavg 7.2 > 4: --jobs reduced to 1 (M03 R-2)
[synthcity] ingest done 13.56 s points=3924500
[synthcity] dsm done 3.30 s
[synthcity] tile done 5.30 s
[synthcity] tile summary roots=1 nodes=439 depth=5 first_screen_g=190507/2286084
[synthcity] zones done 0.15 s
[synthcity] hash done 0.73 s
[synthcity] validate done 1.85 s
[synthcity] published 9e05c2364f58 in 25.3 s
OK synthcity exit=0 cv=9e05c2364f58 built 25.3 s
ANet Synthetic City 按固定种子程序生成:1.2 km × 1.2 km、约 390 万点,含道路、河道、公园与两座 300 m 级塔楼,不含任何第三方数据。它走与真实城市相同的流水线:
阶段 |
产物 |
|---|---|
ingest |
规范化后的 World ENU 点(米、右手、+Z 向上)与逐点属性 |
dsm |
2 m 数字表面模型与 10 m 数字地面模型 |
tile |
Potree 2.0 兼容八叉树(ANET_Q16 点编码),以及首屏层级的字节范围 |
zones |
剧本使用的区域与禁飞区( |
hash |
内容版本 |
validate |
语义与结构校验,错误为 0 才发布 |
第二行说明构建时 1 分钟负载高于 4,构建器自动把并行度降为 1,避免挤占同机的其他工作;空闲机器上不会出现这一行。--missing 语义保证重复执行时只重建缺失或失效的世界。
启动共享展示:make run
make run
DOC-01 OK CPU 架构:x86_64
...
awr doctor --quick: 通过(0.2 s)
~/ANet4D/.venv/bin/python -m awr.sim.runtime.warm
numba warmup s plugins=2.04 m08=0.34 m10_plan=0.06 m20_cover=0.01 m04_geom=0.06
m10 numba warmup s 1.77
[worldpkg] chicago: 原始数据缺失(~/ANet4D/data/raw/urbanscene3d/Chicago_sampled_5m.ply);修复:make fetch-data
...
[worldpkg] synthcity: up to date
FAIL chicago exit=4 0.0 s chicago: 原始数据缺失(~/ANet4D/data/raw/urbanscene3d/Chicago_sampled_5m.ply);修复:make fetch-data
...
OK synthcity exit=0 cv=9e05c2364f58 0.0 s
提示:原始数据缺失,运行 make fetch-data(无数据试用:make demo-world 生成合成演示城市 synthcity,ADR-077)
提示:有城市缺少原始数据,运行 make fetch-data
提示:默认世界为合成演示城市 synthcity(/world/synthcity,剧本 s0-synthcity-showcase)
警告:部分世界构建失败(退出码 4),其余照常;详情见 worlds/.status/
[synthcity] geo warm hit 0.02 s derive_sha8=d98119e8 empty=0.01633 pits_filled=1.0 mem_mib=6.5 grid25=[301, 301]
cd ~/ANet4D && AWR_PROFILE=${AWR_PROFILE:-demo} exec ~/ANet4D/.venv/bin/python -m awr.runtime.supervisor
提示:默认世界 shenzhen 未构建,回退到合成演示城市 synthcity(剧本 s0-synthcity-showcase;ADR-077);有 UrbanScene3D 数据时运行 make fetch-data && make worlds
READY run=r20261013-143216-2988 profile=demo world=synthcity access=loopback
api http://127.0.0.1:8000/world/synthcity
bus tcp/127.0.0.1:7447(namespace awr/synthcity/r20261013-143216-2988)
logs ~/ANet4D/runs/r20261013-143216-2988/logs
ssh ssh -N -L 8000:127.0.0.1:8000 <user>@<host>
admin ~/ANet4D/runs/r20261013-143216-2988/admin.token
make run 在前台运行,按 Ctrl+C 或在另一个终端执行 make stop 停止。启动前它依次完成:
预检。 再次执行快速诊断;端口被占用等
ERROR会在这里以退出码 3 中止(见 排错)。numba 预热。 把飞行、规划、覆盖与几何内核编译进
~/.cache/awr/numba。上面是第二次启动(缓存命中,合计约 4 s);同一台机器第一次启动时为全量编译,本次在负载较高的 8 核机器上为plugins=103.73 m08=57.76(单位 s)。世界构建。 对全部七个世界执行
--missing构建;六城缺少原始数据时标为失败(退出码 4)但不阻塞,只要缺省世界可用即可继续。geo warm生成规划用的 25 m 栅格等派生缓存。生产构建。
apps/web/dist不存在或比源码旧时执行npm run build -w apps/web(本次首次构建 vite 用时 5.8 s),随后prod-bundle-scan检查产物中不含部署机密。上面的第二次启动跳过了这一步。启动 supervisor。 按运行档
demo拉起 sim-core、api、recorder、agent-runtime 与 job-worker,全部就绪后打印READY。
READY 块的五行依次是:浏览器入口、进程间总线与命名空间、本次运行的日志目录、远程访问用的 SSH 转发命令,以及管理令牌文件(操作员界面与 /api 的受保护接口使用,文件权限 0600,不要分享)。
supervisor 的结构化日志(每行一个 JSON 对象,例如 proc state RUNNING)与上述输出交错打印,这里省略。sim-core 缺少
CAP_SYS_NICE 时会输出一行 nice not permitted, using 0,不影响运行。
确认服务就绪:make status
在另一个终端中:
make status
~/ANet4D/.venv/bin/awr status
run r20261013-143216-2988 supervisor pid 2305695
ring head=3231 t_sim_s=25.84 state=PLAYING rate=1.0 epoch=1 segment=0 writer_pid=2305735 writer_age_ms=3.9 step_seq=6460 step_p99_us=3199 rtf=0.997 roster_version=9
NAME STATE PID RESTARTS UPTIME_S HB_AGE_MS CPU% RSS_MB
sim-core RUNNING 2305735 0 31.4 7.2 17.9 245.1
api RUNNING 2305831 0 28.5 10.6 3.0 93.2
recorder RUNNING 2305833 0 28.5 10.3 7.0 57.9
replay-worker STOPPED - 0 - - - -
agent-runtime RUNNING 2305839 0 28.5 79.4 4.0 54.8
job-worker RUNNING 2305841 0 28.4 323.5 - 54.9
ring 一行读自共享内存状态环的头部:t_sim_s 是仿真时间,state=PLAYING 表示时钟在走,rtf 是实时因子(1.0 为与墙钟同速),step_p99_us 是最近窗口内单步耗时的 p99。进程表中 RESTARTS 应为 0;replay-worker 按需启动,平时为 STOPPED。
就绪探针与健康接口不需要令牌:
curl -s http://127.0.0.1:8000/api/health/ready
curl -s http://127.0.0.1:8000/api/health
{"status":"ready","sim":"ok","ring_attached":true,"world_loaded":true,"run_id":"r20261013-143216-2988"}
{"status":"ok","build":{"version":"0.2.0","channel":"local","release":"local-06731a8f76"}}
release 中的 06731a8f76 是构建时的提交短哈希,与浏览器启动屏上的版本行一致。
在浏览器中打开
打开 http://localhost:8000/world/synthcity。本机没有 UrbanScene3D 数据时,合成演示城市是缺省世界,运行剧本 S0:七架 P600 分上下两段螺旋扫描 318 m 的 ANet Tower、两架覆盖两个街区、三架以 V 形编队沿河巡航,天气从晴转小雨再转雾(约 5 min 仿真时间)。
服务器在远程机器上时,在本地电脑执行 READY 块中的 SSH 转发命令,再打开同一个地址。界面的使用方式见 共享展示。
停止:make stop
make stop
~/ANet4D/.venv/bin/awr stop
已停止 r20261013-143216-2988
awr stop 经 supervisor 的控制通道优雅停止全部进程(每个进程 5 s 宽限期),删除 /dev/shm/awr/<run> 下的运行目录,runs/<run>/ 中的日志与录制保留。前台的 make run 随之退出。
启动沙盒服务:AWR_PROFILE=sandbox make run
AWR_PROFILE=sandbox make run
...
cd ~/ANet4D && AWR_PROFILE=${AWR_PROFILE:-demo} exec ~/ANet4D/.venv/bin/python -m awr.runtime.supervisor
提示:默认世界 shenzhen 未构建,回退到合成演示城市 synthcity(剧本 s0-synthcity-showcase;ADR-077);有 UrbanScene3D 数据时运行 make fetch-data && make worlds
READY run=r20261013-144754-296c profile=sandbox world=synthcity access=loopback
api http://127.0.0.1:8000/world/synthcity
bus tcp/127.0.0.1:7447(namespace awr/synthcity/r20261013-144754-296c)
logs ~/ANet4D/runs/r20261013-144754-296c/logs
ssh ssh -N -L 8000:127.0.0.1:8000 <user>@<host>
admin ~/ANet4D/runs/r20261013-144754-296c/admin.token
运行档 sandbox 在共享展示之外再启动沙盒控制面,make status 的进程表中多出三行:
sandbox-pool RUNNING 2320617 0 17.3 67.2 6.0 140.7
sandbox-api RUNNING 2320754 0 15.6 18.4 6.9 92.9
vite RUNNING 2320756 0 15.6 - - 73.3
sandbox-pool 负责会话的准入、排队、驻留与回收,并为每个会话拉起一个独立的 sim-core(沙盒时钟档 sandbox100)。
sandbox-api 在
http://127.0.0.1:8002/api/sandbox/v1提供沙盒 REST v1 与实时连接,即 SDK 的缺省地址。vite 是开发服务器,随运行档中的 dev 进程组启动。
本机配额档为 local:不做地址前缀配额与工作量证明,批处理端点开放。
查询沙盒接口
curl -s http://127.0.0.1:8002/api/sandbox/v1/meta
{"access_mode":"loopback","active_sessions":0,"api_version":1,"build":{"channel":"local","release":"local-06731a8f76","version":"0.2.0"},"contracts":"1.2.0","features":["queue","batch"],"max_sessions":1,"pow":{"bits":20,"required_now":false},"queue_len":0,"sdk":{"min_version":"1.0.0"}}
max_sessions 是本机可同时运行的沙盒会话数,由容量模型按 CPU 预算计算(硬上限 6);本机为 1,第二个会话会进入排队。pow.required_now=false 表示当前不要求工作量证明。全部端点见 开放接口。
用 Python SDK 操作一个会话
SDK 是单文件 tools/sdk/awr_sandbox.py,依赖 httpx、websockets 与 msgpack,.venv 中已经具备。在仓库根目录创建
sdk_quickstart.py:
"""快速开始:创建沙盒会话、添加无人机、读取状态、结束会话。"""
import sys
import time
sys.path.insert(0, "tools/sdk") # 仓库内的单文件 SDK
from awr_sandbox import Sandbox
sb = Sandbox("http://127.0.0.1:8002", timeout_s=30)
meta = sb.meta()
print("server:", meta["build"]["version"], "api", meta["api_version"], "max_sessions", meta["max_sessions"])
print("worlds:", [w["world_id"] for w in sb.worlds() if w["available"]])
with sb.create("synthcity", "t5_area_guard") as s:
info = s.state()
print("session:", s.sid, info["state"], "expires_in_s", info["expires_in_s"])
print("template:", info["template_id"], "vehicles", len(s.vehicles.list()["items"]),
"targets", len(s.targets.list()["items"]), "nests", len(s.nests.list()["items"]))
v = s.vehicles.add("p600_mid360", nest_id="nest-b", label="docs-1")
print("added:", v)
for _ in range(20): # 新加入的机体在数秒内完成启动
snap = s.vehicles.state(v["id"])
st, ext = snap["state"], snap.get("state_ext") or {}
if ext.get("battery"):
break
time.sleep(0.5)
print("state:", st["lifecycle"], st["flight_state"], "pos_enu_m", st["pos_enu_m"],
"soc_pct", ext["battery"]["soc_pct"])
print("closed:", s.sid)
.venv/bin/python sdk_quickstart.py
server: 0.2.0 api 1 max_sessions 1
worlds: ['synthcity']
session: sb-da5ygnnr3z READY expires_in_s 1795
template: t5_area_guard vehicles 7 targets 2 nests 2
added: {'id': 'p600-07', 'agent_no': 7, 'lifecycle': 'STARTING', 'model_id': 'p600_mid360', 'nest_id': 'nest-b'}
state: BOOTED DISARMED pos_enu_m [-120.9, -339.7, 0.0] soc_pct 100.0
closed: sb-da5ygnnr3z
全程 6 s。逐行说明:
Sandbox(...)连接时先读取GET /meta,校验接口主版本与契约主版本,不兼容时立即报错。timeout_s=30把单次请求超时设为 30 s:服务器满员时创建请求进入排队,SDK 以单次最长 25 s 的长轮询等待空位,超时必须大于它(见 排错)。worlds()返回七个世界及其可用性。本机只构建了合成演示城市,因此只有synthcity可用。create("synthcity", "t5_area_guard")创建会话并等待其就绪:需要时自动求解工作量证明,满员时自动排队并在轮到时认领。T5 区域值守与接力是缺省场景模板,装配 2 个机巢(机巢箱与垂起起降台)、7 架无人机(P600 与 AWR-V1)与 2 个识别物。会话初始寿命 30 min(expires_in_s约 1,800)。vehicles.add("p600_mid360", nest_id="nest-b")添加一架 MID-360 配置的 P600,放入垂起起降台nest-b。nest_id与home_enu_m(World ENU 坐标)必须且只能给出一个。返回的lifecycle为STARTING,机体在数秒内完成启动。vehicles.state(vid)返回完整状态:BOOTED DISARMED表示已启动、未解锁、停在机巢;pos_enu_m是 World ENU 坐标(米),state_ext.battery.soc_pct是电量百分比。离开
with块 时 SDK 先导出一次配置快照(结束后 10 min 内仍可取回),再以DELETE /sessions/{sid}结束会话、释放槽位。
本机沙盒的浏览器界面需要把 /api/sandbox/ 路径分流到 8002 端口(公开实例由 nginx 完成,见 部署);本页的步骤只使用开放接口。
停止沙盒服务
make stop
~/ANet4D/.venv/bin/awr stop
已停止 r20261013-144754-296c
sandbox-pool 停止时先停止接受创建,再为仍在运行的会话导出配置快照并以 maintenance 结束,在 12 s 宽限期内完成。
排错
启动时报"端口空闲"错误
错误(退出码 3):DOC-09 端口空闲
修复:ss -ltnp | grep -E ':(7447)';或设置 AWR_PORT_OFFSET=<k>
...
awr doctor --quick: 失败(0.2 s)
make[1]: *** [Makefile:83: _need-supervisor] Error 3
make: *** [Makefile:68: run] Error 2
预检发现端口被占用。本次运行中,它出现在 make stop 之后立即再次 make run 时:上一次运行的总线端口尚未释放,数秒后重试即通过。端口确实被其他实例占用时,按提示查看占用者,或以 AWR_PORT_OFFSET=<k> 让本实例的全部端口平移 10·k。
sim-core 反复被判定为挂起
supervisor 日志中连续出现:
{"lvl":"WARN","proc":"supervisor","logger":"awr.runtime.supervisor","msg":"proc hung","kv":{"name":"sim-core","heartbeat_age_ms":2027}}
{"lvl":"INFO","proc":"supervisor","logger":"awr.runtime.supervisor","msg":"standby promoted","kv":{"name":"sim-core","pid":2302046,"restarts":1}}
(为便于阅读,删去了时间戳等字段。)sim-core 的心跳超过 2 s 未更新,supervisor 判定挂起,用热备用进程接替。窗口内第 6 次重启会触发熔断。本次运行中的原因是:同机另一份实例也把它的 sim-core 钉在 1 号核上,两个 250 Hz 主循环争用同一个核。8 核及以上的机器缺省启用钉核;与其他负载共用的机器上请关闭:
AWR_CPU_PIN=off make run
也可以把 AWR_CPU_PIN=off 写入仓库根目录的 .env.local,对之后的每次 make 生效。
添加无人机返回 110 PARAM_OUT_OF_RANGE
awr_sandbox.AwrError: 110 PARAM_OUT_OF_RANGE: 参数越界或超过上限
vehicles.add() 既没有给 nest_id 也没有给 home_enu_m(或两者都给了)。错误的 detail 为
{"field": "nest_id|home_enu_m", "why": "EXACTLY_ONE"}。二者择一即可。
添加无人机返回 525 NEST_INCOMPATIBLE
awr_sandbox.AwrError: 525 NEST_INCOMPATIBLE: 机巢类型、充电器节数或槽位不兼容
detail 为 {"why": "slots", "slots": 6}:T5 模板中的机巢箱 nest-a 已放满 6 架。改放 nest-b,或先用 s.nests.list() 查看各机巢的槽位与库存。机巢箱只接收多旋翼,垂起起降台接收垂起机型与多旋翼。
创建会话返回 409 SANDBOX_EXISTS
awr_sandbox.AwrError: 409 SANDBOX_EXISTS: an active session already exists for this principal and address prefix; attach() with its token or create(force_new=True)
同一主体与地址前缀已有一个未结束的会话(例如上一次脚本异常退出而未离开 with 块,会话处于运行或驻留状态)。持有其令牌时用
sb.attach(sid, token) 接回;否则以 create(..., force_new=True) 新建,或等待旧会话因无连接空闲而被驻留并过期。SDK 的主体提示保存在 ~/.config/awr_sandbox/principal,只用于幂等与配额聚合,不是凭据。
排队时出现 httpx.ReadTimeout
httpx.ReadTimeout: timed out
服务器满员,创建请求进入排队;SDK 1.1.0 及更早版本以单次最长 25 s 的长轮询等待,却沿用 Sandbox() 缺省的单次请求超时 10 s。升级到 SDK 1.1.1(长轮询使用单独的读超时),或在创建 Sandbox 时传入 timeout_s=30(本页示例的写法)。
六城构建失败的提示
make run 输出 FAIL chicago exit=4 等六行与"部分世界构建失败(退出码 4)"是没有 UrbanScene3D 数据时的预期结果,不影响合成演示城市。需要六城时执行 make fetch-data && make worlds,见 安装与环境要求。
更多问题见 常见问题。
这一步之后你有什么、没有什么
有了: 一份锁定依赖的本机安装;一个可自由分享的合成世界 worlds/synthcity;能在浏览器中观看并在 make status 中检视的
World Runtime;一个本机沙盒控制面;以及一段经开放接口完成会话全生命周期的程序。每次运行的日志与生效配置都在 runs/<run>/ 下:
~/ANet4D/runs/r20261013-144754-296c/
├── logs/ # 每个进程一个日志文件:sim-core.log、api.log、sandbox-pool.log 等
├── effective-config.yaml # 生效配置(机密已掩码)
├── admin.token # 管理令牌(0600)
├── rec-000.mcap # 共享展示的录制(MCAP),可在本机回放
├── inputs.msgpack # 输入日志,可据此确定性地重新仿真
├── audit.jsonl # 审计记录
└── ckpt/ # 崩溃恢复用的 checkpoint
还没有: UrbanScene3D 六城(需要下载数据并接受其条款);本机沙盒的浏览器界面(需要按部署套件做路径分流);以及 GPU 重建、真实飞控栈等后续版本的能力。下一步可以:
阅读 沙盒,了解场景模板、管理面板与手动控制。
阅读 Python SDK,用
tools/sdk/examples/中的示例驱动手动飞行、传感器、识别物捕获与 GSD 扫描预览。阅读 架构与坐标系,了解进程拓扑与坐标约定。