代码仓库分析

Jev Drone 无人机仿真

RomanSlack · High-Frequency & Simulation

解析 Jev Drone 无人机仿真：Jev 以约 2.5–3 Hz 提供战术判断，本地代码负责相机感知、安全否决、制导与飞行控制。

E2 · 资料已核对已检查公开资料或源码证据；仅有固定提交链接并经对应源码核对，才可称固定版本核验。不代表本站运行过、认可性能或保证安全。

打开 GitHub 仓库 ↗ 观看作者原始演示 ↗ 返回项目雷达

Stars: 170
Forks: 19
协议: MIT
最近提交: 2026-09-22

JEV · 决策点

Jev 在这里做什么

根据距离扇区、障碍高度与目标状态选择机动、评估风险和目标丢失状态。

作用

把战术判断与本地制导、避障和飞控分层。

来源与说明

2.5/50/500 Hz 是作者架构与仿真设置，不能写成飞行安全保证；未在真实飞行器上核验。已核对固定版本 README 与集成源码。

已核对的源码链接

查看 Jev 战术源码 ↗阅读固定版本 README ↗

SEARCH QUESTION · VERIFIED ANSWER

Jev Drone 是什么？

Jev Drone（仓库名 jev-drone）是一个基于 MuJoCo 的自主四旋翼仿真实验。普通代码从机载深度与分割图像提取结构化场景，Jev 从封闭选项中选择战术动作、评估风险并判断目标是否真正丢失；实时飞行与安全仍由本地控制层负责。

Jev 负责: 选择绕行、爬升、刹车或重新搜索等战术，并返回风险与目标丢失概率。
代码负责: 相机处理、几何计算、动作执行、50 Hz 安全反射与 500 Hz 飞控。
证据边界: 固定版本源码和作者记录已核对，但本站没有复现实验；仿真结果不能推算真机性能。

JEV DRONE · ARCHITECTURE

Jev Drone 怎么工作？

它把慢速语义判断与快速确定性控制拆成四层。Jev 不读取像素，也不直接控制电机；它只读取由代码整理出的 JSON 状态，并在后台线程中提供可过期、可覆盖的战术建议。

15 Hz · 相机感知 NumPy 处理深度与分割缓冲区，形成五个距离扇区、障碍物高度和目标位置。
最高 3 Hz · Jev 战术 场景值得判断且发生实质变化时才调用；典型 65 秒飞行约 110 次请求。
50 Hz · 制导与安全 安全反射始终拥有否决权；障碍接近时可以覆盖 Jev 的动作建议。
500 Hz · 飞行控制 几何控制器负责姿态、推力与电机混控，Jev 不进入这一实时闭环。

CHOICE · SCORE · NOUL

一次请求回答哪三个问题？

Choice · maneuver: 从保持航向、向左/向右绕行、爬升、刹车和重新搜索中选择一个动作。
Score · risk: 在“开阔”到“即将碰撞”的有序尺度上评估当前风险。
Noul · target_truly_lost: 区分短暂遮挡与真正丢失目标，决定是否放弃旧方位并重新搜索。

STATE DESIGN

最重要的工程经验：State 必须包含决策证据

早期状态只有五个水平距离扇区，Jev 因而无法推断“从障碍物上方飞过”。加入障碍物顶部高度、顶部是否进入相机视野以及无人机爬升上限后，climb 才成为有依据的选项。这里的问题不是提示词不够强，而是输入状态缺少垂直信息。

RUN IT · LOW-RISK PATH

先运行免费的无 Jev 基线

下面是固定版本 README 与 CLI 中能够相互核对的最短路径。本站检查了命令和参数，但没有下载模型或运行仿真。先确认 MuJoCo 与渲染环境可用，再决定是否发送付费 Jev 请求。

1 · 安装并运行本地基线

git clone https://github.com/RomanSlack/jev-drone.git
cd jev-drone
./setup.sh
export MUJOCO_GL=glfw
.venv/bin/python run.py --no-jev --fast --seconds 5 --seeds 0

2 · 再做一个短时 Jev 实验

cp .env.example .env
# Add TYPESAFE_API_KEY to .env, then load it:
set -a && . ./.env && set +a
.venv/bin/python run.py --seconds 5 --seeds 0 --budget 5

--budget 统计成功返回的评估，不应被当作请求次数或费用的绝对上限。测试网络模型时不要添加 --fast，否则仿真时间会快于真实请求。

固定版本 README架构、运行方法、作者结果与限制 Jev 战术层问题、选项、阈值、缓存与失败回退 制导与仿真循环安全否决、CLI 参数、指标与视频输出 相机与飞控深度/分割感知和几何控制器

RESULTS · LIMITATIONS

作者结果与证据边界

固定版本 README 报告：无 Jev 的启发式基线在 3 个种子中都停在 17.7 米；启用 Jev 的一次 65 秒运行完成 77.5 米路线，目标可见率 82%，安全反射占用时间 9%，碰撞为 0。但两列并非同种子平均对比，作者也披露更早的 3 种子实验中 Jev 与基线同为 0/3。可辩护的结论只是 Jev 为该基线补上了其无法表达的战术机动，而不是“Jev 让无人机全面变好”。

FAQ

Jev Drone 常见问题

Jev Drone 使用视觉模型吗？

不是。相机深度与分割图像由普通代码处理，Jev 只读取整理后的 JSON 场景状态。

Jev 会直接控制无人机电机吗？

不会。Jev 提供低频战术建议；500 Hz 姿态与推力控制以及 50 Hz 安全反射都在本地代码中。

这个项目证明 Jev 可以安全控制真实无人机吗？

不能。仓库展示的是 MuJoCo 仿真实验，本站也没有复现实验或验证任何真机集成。