mcpField
L
luxonis-device-setup

luxonis-device-setup

github.com/luxonis开发1972 次安装8 周前更新
代码仓库

关于 luxonis-device-setup

luxonis-device-setup 是用于准备 Luxonis OAK 硬件开发环境的技能，可在应用开发前或期间使用。它验证主机连接的 DepthAI 或独立 OAK App 路径，并记录结果供后续会话参考。

主要功能

  1. 01检查主机和已连接设备
  2. 02验证真实帧或消息链路
  3. 03逐层排查设备准备问题
  4. 04记录设备信息和未解决事项

适用场景

  1. 01为开发准备 OAK 设备
  2. 02检查主机连接的 DepthAI 管线
  3. 03验证独立 OAK App 路径
  4. 04为后续会话留下设置记录

MCP 相关

该技能可使用 Luxonis MCP 工具获取当前设备和 DepthAI 信息。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/luxonis/skills --skill luxonis-device-setup

安装后在 Claude Code 中输入/luxonis-device-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
DEVICE.template.md
scripts/
luxonis_doctor.py

详细介绍

Luxonis 设备设置

让 OAK 硬件正常工作，以便后续开发使用。即使应用尚不存在，也可以先完成此步骤。不要开始产品访谈。有关问题或相机建议 → luxonis。构建或修改应用 → luxonis-app。oakctl 安装和 AGENTS.md → luxonis-workspace。

完成条件

主机连接或独立运行路径能够传输真实相机或应用数据，并且 docs/device.md 中记录了供下次会话使用的设置说明（除非用户要求仅检查并提供报告）。说明可以涵盖多台设备。受阻意味着指出故障层、证据和一个后续操作。硬件故障（橙色 LED、启动失败、疑似校准问题）请联系 [email protected]。

1. 当前事实

切勿凭记忆编造 DepthAI API。仅使用 DepthAI v3。

优先使用最可靠的来源：Luxonis MCP 工具（显示的名称因主机而异），然后是这些工具返回的确切示例或文档来源，再然后是 https://docs.luxonis.com/llms.txt，最后是观察到的行为；记忆仅用于一般推理。对于 oakctl 命令和标志，已安装的 oakctl --help 优先级高于文档和 MCP：本地版本（可能较旧或为测试版）决定了此处可用的功能，因此应以此为准。如果它缺少当前文档所述的功能，建议更新 oakctl。如果观察到的主机或设备行为与文档或 MCP 冲突，应以观察结果为准，并注明冲突。如果处于离线状态，应依据 oakctl --help 和本地示例操作，并指出哪些事实尚未验证。

此主机必须安装 oakctl（用于 udev、检查和后续主机配置）。如果缺少 AGENTS.md 或 oakctl，请指出 luxonis-workspace 并按其说明操作，然后继续验证硬件。不要复制其中的流程。

2. 先检查再修改

如果存在 docs/device.md，请将其作为说明阅读，而非视为事实依据。如果存在旧版根目录文件 DEVICE.md，也要阅读；新的说明写入 docs/device.md。接线、IP 和桌面上的设备可能会变化。运行 scripts/luxonis_doctor.py --format json 获取非破坏性主机信息。以实时状态为准，不要以文件记录为准。

  • RVC2 在已连接的主机上运行 DepthAI 管道，不会显示在 oakctl 中。oakctl list 结果为空并不表示没有设备。
  • RVC4 可以通过 DepthAI 连接主机，也可以作为独立 OAK App 运行。
  • 首次连接时优先使用 DepthAI 发现功能；它可以检测这两个系列。

发现已连接的设备。连接多台设备很正常，应将它们记录下来。仅为当前命令指定 id、地址或序列号（open、flash、adopt、oakctl -d）。不要认为该指定值是此文件夹唯一允许使用的设备。

只有在特权操作或修改操作的目标不明确时，才询问用户使用的是哪台实体相机。按顺序执行探测；切勿让多个进程同时访问同一设备。

3. 建立可用的开发路径

以直接观察证实的最高层级为准：已发现、可访问或已就绪（收到真实帧或消息）。设备元数据不能证明管道或 OAK App 正在运行。验证用户关心的路径；如果用户未指定，则验证实际存在的路径。两台相机应记两份说明，而不是强行选出一台。

主机连接的 DepthAI

使用隔离环境：

  1. 使用受支持的 Python，并可导入 DepthAI v3。
  2. 本次检查所用的设备可以从此主机独占访问。
  3. 最小化的已知可用管道能够传输一帧真实画面或一条结构化消息。
  4. 探测能够正常关闭，设备仍可用。
独立运行的 OAK 4
  1. 本次检查所用的设备是 RVC4。
  2. 已确认当前 oakctl 命令和版本。
  3. 可以为当前命令以非交互方式选择设备。
  4. 路径所需的身份验证以及主机与设备之间的网络连接均可用。
  5. 最小化的已知可用 OAK App 能够走完所需的构建和运行流程，或者现有应用能够在不修改无关状态的情况下验证该路径。

4. 排查一个就绪层

在仅更改一个受支持原因的同时，保持一个验证命令不变：解释器和 DepthAI 版本；USB 权限、供电、线缆或速度；PoE 供电、路由、DHCP/链路本地、VPN 或防火墙；OAK 4 是出厂状态还是已受管理；独占访问；身份验证或时钟。

请从文档确认当前的 USB、PoE 和发现详情。可参考的起始提示：Linux 上的 USB RVC2 可能显示为 Movidius 03e7:2485；OAK 4 上的红色 LED 通常表示 PoE 供电不足。

5. 编写设置说明

除非用户要求仅检查并报告，或没有项目工作区，否则请从 assets/DEVICE.template.md 创建或更新 docs/device.md。其中应包含主机信息、发现的每台设备、每种连接路径最近一次成功验证的命令，以及未解决的问题。保留仍然有效的说明；用实时证据替换过时信息。即使会话受阻，也应记录失败的事项。

防护措施

  • 对 sudo/管理员权限更改、固件/操作系统更新、刷写、恢复出厂设置、Hub 接入、全局 pip、持久化网络配置，或部署到无关的运行中应用，均须先征得同意。
  • 绝不从源代码编译 DepthAI。
  • 不要假装沙盒、虚拟机或 WSL 环境具备其实际不具备的 USB 或广播访问能力。
  • 绝不针对同一台设备同时运行相互竞争的探测。

评论

支持 Markdown