导语｜开源双目不是演示仓库
当具身团队说“我们开源了 SDK”，读者真正想知道的不是仓库是否公开，而是：克隆之后能否在可复现步骤内得到一条带时间戳、可训练、可拒收的双目时间线。TOBI 通过 china-langhui-ego/e2-sdk 把 E2 双目采集头环的录制能力摊开：C 录制 API（libsxr_recorder）、双路 HEVC/fMP4 与 800Hz IMU 同步。本文按工程顺序写清从 git clone 到首条可训练样本的门禁，避免把 README 当成营销页误读。
先锁定权威：仓库、LICENSE 与 README 版本
入口固定为 https://github.com/china-langhui-ego/e2-sdk 。推荐命令：git clone https://github.com/china-langhui-ego/e2-sdk.git 。克隆后第一件事不是改代码，而是记录 commit、子模块状态、LICENSE 文本与 README 中声明的主机与设备版本矩阵。开源协作里，版本漂移造成的“我这边能编、你那边不能录”往往比 API 设计缺陷更耗时。
把 README 当作第一权威，意味着冲突时以仓库文档与交付包书面规格为准，而不是以第三方博客或口头承诺为准。若你们同时持有商业交付包，应建立开源 commit 与交付包版本对照表，防止算法同学按 GitHub tip 集成、产线同学按旧 ROM 验收。
许可边界要单独开一页内部说明：训练、蒸馏、再分发、对客户二次交付分别允许到哪一步。很多团队在试点阶段忽略 LICENSE，到扩容采购或融资尽调才补，成本极高。
对安全合规，克隆镜像应落在公司允许的代码区；不要把含内网地址的本地改动意外推到 fork 公网。只读起步的纪律，比急着提 PR 更重要。
环境准备：从依赖矩阵到最小可编译样例
按 README 安装编译依赖与示例工程。建议在干净容器或专用工作站复现，而不是在已被其他 XR 栈污染的开发机上碰巧编过。最小目标是：样例可编译、设备可被识别、一次短录制能落盘。
调试资料不要与源码混放。E2 的调试环境、手机端 APP 与 SDK、设备 SDK、头环 ROM、使用说明、样例视频分属不同 Google Drive 与百度网盘包；源码仓库负责接口与构建，网盘包负责固件与联调二进制。混装会导致无法回答此刻到底在跑哪一版。
建议在内部知识库固化：克隆目录、工具链版本、ADB 授权策略、存储路径配额、失败时回滚到哪一个 tag。把这些写成新人半天可完成的清单，才能独立产出第一条时间线。
若编译警告被当成错误，先区分第三方头文件噪声与 recorder 相关告警。把警告分级，避免无意义洁癖阻断联调，也避免把真实 API 误用淹没在海量日志里。
libsxr_recorder：把录制当成可测试契约
E2 开源价值的核心之一是 C 录制 API（libsxr_recorder）。对嵌入式与算法联调来说，API 不是能调用就够，而要明确开始与停止语义、缓冲策略、错误码、掉帧通知、元数据写入时机。把这些写进契约测试：用短会话反复启停，断言文件完整、时间戳单调、左右目成对。
可训练时间线要求左右目与 IMU 能被同一读取脚本消费。若左右目封装在独立 fMP4 中，必须有可机器读取的关联键，例如会话编号、起始单调时钟、帧索引映射。缺关联键的两路看起来同步的视频，在训练侧会退化成软对齐猜谜。
把录制契约纳入持续集成不一定要真机常驻：可用黄金样例包做读取端断言；真机侧做夜间烟测。开源仓库若更新 recorder 行为，契约失败即阻断升级。
对多操作者并行采集，会话命名必须防碰撞。推荐时间戳加设备序列加任务编号。开源样例若使用固定文件名，生产脚本必须改写，否则会静默覆盖。
双路 HEVC/fMP4：容器选择与训练侧读取
双路 HEVC 落盘到 fMP4，是带宽、画质与生态工具链之间的折中。对 Ego 双目，关键不是码率广告值，而是关键帧是否在接触窗口可辨、时间基是否被播放器或转码器改写、音视频轨若存在是否引入额外时钟域。
训练管道常见事故是为了入库方便再转一层。再编码可能丢掉精确时间戳或改变帧时间。正确做法是：原始 fMP4 作为只读资产；派生格式显式声明是否保时；质检以原始会话为准。
建议在数据卡写明编码档位、分辨率、目标帧率、实际帧率分布、关键任务是否启用更高码率策略。没有这些字段，模型组无法解释跨批次域差。
存储规划要按有效小时而非原始小时估算。掉帧、过曝、佩戴松动造成的废段应在入库前剔除，并保留拒收原因码，供飞轮改进操作规程。
800Hz IMU：高频惯性如何钉住视觉因果
八百赫兹惯性测量的意义，是给视觉帧之间的运动提供稠密证据。若 IMU 时间戳与视频时间基不一致，高频反而变成高频噪声标签。开源栈应暴露 IMU 时钟源、单位、坐标系、与帧时间的对齐方式。
算法侧验收可用简单实验：静止、匀速转头、快速点头三段，检查角速度积分与视觉光流方向是否同号、相位是否稳定。不必一开始就上完整定位建图，也能发现授时或轴向错误。
把 IMU 健康分写入会话元数据：丢样率、间隙直方图、饱和次数。训练时可降权或拒收异常段，而不是让扩散策略去拟合传感器故障。
若后续引入腕部相机或外置第三人称视角，惯性与多相机应共享同一可解释时间语义。E2 开源是双目入门，但时间线语言要从第一天就按多模态预留。
首条可训练样本的验收清单
“可训练”不是损失能降，而是监督语义可信。把下列项写成签发表，由录制负责人与算法接口人共同签字，作为进入小规模自采的门票。
- 左右目文件成对，会话编号一致，起始时间差在约定阈值内；
- 惯性文件可读，时间戳单调，单位与轴向有文档；
- 至少一段含接触或快速头部运动的短任务，便于人工目检相位；
- 标定或外参版本号写入元数据；
- 开源许可与操作者授权可追溯；
- 读取脚本在干净环境一次跑通，无需手工改路径。
资料包、组织分工与小规模自采
GitHub 解决怎么编、怎么调接口；网盘资料解决用哪版固件、哪版手机应用、哪份使用说明。第一条时间线失败时，按层排查：电源与佩戴、应用配置、固件、录制参数、主机导出。不要在未核对固件版本时怀疑算法。
样例视频包用于对齐正常长什么样。把它当作视觉回归基线：新固件下录同等动作，对比曝光、拖影、左右同步目检。开源团队若只丢源码不丢样例，集成成本会成倍上升。
建议明确三角角色：设备固件负责人、录制软件负责人、数据质检负责人。没有签字人，第一条时间线会在都能解释、没人负责中反复横跳。
首条样本通过后，不要立刻追求小时数。先固定任务脚本、光照、操作者、存储与命名。用同一规程连采二十到五十条，观察掉帧与惯性健康分布是否稳定，再谈扩人扩场景。
常见失败模式与发布门禁
编不过：多半是工具链或依赖未按 README 锁定，用容器固化。能录但左右不同步：检查是否错误地事后软对齐，或导出时重封装损坏时间基。惯性曲线乱跳：先确认单位与轴向，再查缓冲导致的成批延迟。
训练损失很好、真机接触差：回头检查接触窗口码率与是否需要腕部模态，而不是先怪模型宽度。将克隆提交号、资料包校验和、样例读取哈希写入发布门禁，任何临时包不得进入训练集群。
对外沟通时，区分开源可用性与项目验收范围：前者帮助生态，后者保护双方。TOBI 文档页把设备软件开发包与书面规格并列，正是这一治理姿态。
把本文清单打印成一页纸贴在联调工位。开源的胜利不在星标数，而在陌生人能按同样步骤得到同样可训练时间线。
工程深挖、现场门禁、问答与附录要求
围绕「双目」，建议在项目周报单列进展与风险：已验证的事实、未验证的假设、下一步实验各写一句。这样开源集成不会停在感觉良好，而会停在可检查的证据。对外部协作方，也可以用同一格式同步，减少会议空转。
在涉及「libsxr_recorder」的变更窗口，冻结并行大改：先完成小范围回归，再放开多人提交。硬件开源最怕多变量同时动。回归包应包含最短路径的成功样例与已知失败样例，保证失败可重复。
把「fMP4」写入新人首周任务：不是阅读口号，而是亲手完成一次操作并提交记录截图或日志摘要。通过率低说明文档缺口，而不是只说明新人能力。文档缺口要回流到仓库或资料台账。
针对「800Hz IMU」建立反例库：正确做法旁必须放错误做法与后果。现场人员对反例的记忆深于对条文的记忆。反例库每个季度删增一次，保持与当前固件和工具链同步。
若指标与「E2 固件」相关出现漂移，先做分层诊断：设备、主机、网络、规程、人因。禁止直接跳到改模型或改硬件选型。分层诊断记录保留九十天，供审计与复盘。
对外演示「左右目关联键」时，优先展示门禁与日志，而不是只展示最终画面。决策者更信任可重复过程。演示脚本版本化，避免每次临场发挥造成承诺不一致。
与「容器保时」相关的责任人必须有明确的否决权与升级路径。没有否决权的质量角色等于装饰。升级路径写到支持手册，节假日也能执行。
度量「佩戴短录」不要只用二元是否成功，而要保留分布：百分之五十、百分之九十五分位与极端尾部。尾部决定生产痛苦。分布图进周会，比平均值更能推动资源分配。
当「读取脚本」需要跨团队协作时，先写一页接口：输入、输出、超时、失败码、所有者。接口比共识会议便宜。接口变更走短评审，避免私聊决定影响全局。
回顾「LICENSE」的历史事故时，使用统一模板：现象、影响会话、根因、修复、是否需要重采。模板强制区分偶发与系统性。系统性必须回流到固件、文档或规程，而不是靠个人英雄。
在预算讨论里，把「资料包校验和」的成本拆成工具时间、人因时间、返工时间。只看工具采购价会低估总拥有成本。拆分后的数字更能支持开源治理投资。
保持「基线几何」相关的最小可运行样例永远可运行：样例损坏等于文档损坏。持续集成夜间跑样例，失败即阻断合并。样例也是客户 onboarding 的最快路径。
围绕「掉帧标记」，建议在项目周报单列进展与风险：已验证的事实、未验证的假设、下一步实验各写一句。这样开源集成不会停在感觉良好，而会停在可检查的证据。对外部协作方，也可以用同一格式同步，减少会议空转。
在涉及「会话命名」的变更窗口，冻结并行大改：先完成小范围回归，再放开多人提交。硬件开源最怕多变量同时动。回归包应包含最短路径的成功样例与已知失败样例，保证失败可重复。
把「腕部扩展预留」写入新人首周任务：不是阅读口号，而是亲手完成一次操作并提交记录截图或日志摘要。通过率低说明文档缺口，而不是只说明新人能力。文档缺口要回流到仓库或资料台账。
针对「干净容器编译」建立反例库：正确做法旁必须放错误做法与后果。现场人员对反例的记忆深于对条文的记忆。反例库每个季度删增一次，保持与当前固件和工具链同步。
若指标与「导出一致性」相关出现漂移，先做分层诊断：设备、主机、网络、规程、人因。禁止直接跳到改模型或改硬件选型。分层诊断记录保留九十天，供审计与复盘。
对外演示「接触窗口码率」时，优先展示门禁与日志，而不是只展示最终画面。决策者更信任可重复过程。演示脚本版本化，避免每次临场发挥造成承诺不一致。
从克隆到首条时间线，建议按“半天可读、一天可录、三天可训”的节奏管理预期。半天内读完 README、LICENSE 与资料台账；一天内完成短录与目检；三天内跑通读取脚本并训一个极小基线，用接触或转头任务验证时间线是否可学。节奏写进项目周报，比只报“仓库已克隆”更能暴露风险。
左右目几何与基线应在数据卡中写清。即便开源阶段以录制连通为先，后续立体或深度相关实验仍依赖这些字段。字段缺失会在第二个月才爆雷，那时会话已堆积，补标成本远高于第一天多写三行元数据。
对电量与存储，开源样例往往默认理想条件。生产自采要加班前检查：剩余电量、可用空间、镜片清洁、绑带松紧。把检查结果写进会话旁路日志，质检才能区分设备问题与任务问题。
若使用 Wi-Fi 或线缆导出，记录导出工具版本与耗时。导出阶段重封装是时间戳损坏的高发区。能用校验和比对设备侧与主机侧文件一致性的，优先做一致性门禁。
安全上，开源仓库可能包含示例配置。严禁把真实产线服务地址、账号或内网拓扑提交回 fork。内部 fork 与上游同步时用路径过滤，避免机密回流。
与手机端应用联调时，明确谁拥有“开始录制”权威。双端同时触发会造成会话碎片。规程应指定单一控制平面，并把该选择写进操作手册。
对标注团队，提前说明双目文件如何成对送标。送错目别或颠倒左右，会污染立体与手眼相关监督。开源读取脚本应提供左右预览拼图，降低人工拿错概率。
若计划把 E2 数据与 E6 数据混训，先统一时间戳单位与坐标系约定，再谈模型结构。开源两套 SDK 并存时，最贵的不是编译，而是两套元数据方言。
采购侧若把“已开源”当成降价理由，应同时要求可复现步骤与样例哈希。没有哈希的开源，只是降低了获取摩擦，并不自动降低集成风险。
最后用一次盲测：换一台干净电脑，只按文档页与 README 操作，看能否复现首条时间线。复现失败则文档未完成，而不是执行人能力问题。
把 E2 开源集成写成内部服务等级目标：工作日内完成克隆与编译，两个工作日内完成短录，五个工作日内完成读取脚本与微型基线。逾期不是责备个人，而是触发文档或环境缺陷排查。服务等级让开源 onboarding 可管理。
左右目关联键设计建议同时包含设备序列、会话起始单调时间和任务编号。只用文件名时间戳在夏令时或跨时区团队中会出事。关联键一旦确定，禁止训练脚本用启发式猜左右。
对 libsxr_recorder 的错误码做中文对照表，贴在联调群公告。现场工程师看不懂英文枚举时，会用重启大法掩盖真正的存储满或权限问题。对照表也是开源文档的优质 PR 候选。
短录样例应覆盖：室内稳定光、窗边强逆光、快速转头、伸手抓取。四类动作分别压力测试曝光、拖影、惯性相位与双目重叠。只录“站着说话”无法证明可训练。
导出到主机后，立即计算校验和并与设备侧清单比对。任何不一致都先当事件，而不是当“大概差不多”。一致性门禁能抓住隐性重封装。
若团队使用 Windows 工作站编译，另备一台 Linux 读取机，避免“只有编译者环境能读”。交叉环境失败说明依赖未声明。
把 IMU 八百赫兹的磁盘写入成本纳入存储规划。高频文本或二进制日志可能比视频更先打满小型存储。规划错误会在长录中表现为莫名停止。
开源 LICENSE 允许的研究使用，不自动覆盖客户现场人像授权。两条线并行：代码许可与数据采集同意书。缺一则数据集不可对外交付。
当第一条时间线用于论文或对外演示，仍需脱敏流程，且脱敏必须保时。开源成功不等于合规成功。
建立“E2 黄金十分钟”课程：十分钟内从加电到短录完成。课程视频与文档互证，新人只看其一容易漏步。
与腕部相机联调前，先保证头戴双目时间线干净。脏的基础模态上叠加腕部，只会放大排障空间。
每个月回溯一次上游提交，评估是否跟进。无评估的长期游离 fork 会变成私有债务。
若编译依赖需要内网镜像，把镜像地址写在私有附录，不写进将推送的公开提交。
对采购友好的说法是：开源降低集成不确定性，不降低硬件与数据质量门槛。用门禁证明质量。
最终验收以“陌生工程师按文档完成”为准。本团队熟手完成只能证明熟手存在。
问：克隆后是否必须用最新提交？ 答：试点应锁定经过样例验证的标签或提交号；追新要走回归，避免把上游实验性改动直接送进产线。
问：没有设备能否先做阅读端准备？ 答：可以先用样例视频与黄金包跑读取断言，但首条可训练时间线仍需真机短录闭环。
问：左右目文件大小差很多正常吗？ 答：可能是码率波动或一路异常；应检查实际帧率与掉帧标记，而不是只看能否播放。
问：IMU 频率声明与文件行数对不上怎么办？ 答：先查单位与丢样；再查导出是否截断。对不上不得入库。
问：能否只用软件时间戳对齐双目？ 答：开源栈目标是可验收时间语义；软对齐可作为诊断，不能替代录制契约。
问：容器转成常用训练格式会丢时间吗？ 答：可能会。派生格式必须声明保时结果，并以原始会话为质检基准。
问：多人同时采集如何避免覆盖？ 答：会话命名加设备序列与任务号；禁止固定文件名用于生产。
问：编译警告很多是否必须清零？ 答：分级处理：recorder 相关当错误，第三方噪声可抑制，但要记录抑制理由。
问：LICENSE 允许商用训练吗？ 答：以仓库 LICENSE 文本为准，并另审数据采集授权；两者不可互相替代。
问：第一条时间线要训多大模型？ 答：用极小基线验证可学性即可，目的是验数据，不是刷榜。
问：佩戴松动如何体现在数据？ 答：可能出现外参级几何抖动与运动模糊；班前检查与拒收原因码要覆盖。
问：与 E6 数据混训要注意什么？ 答：先统一时间戳单位与元数据方言，再谈网络结构。
问：导出很慢是否影响同步？ 答：导出不改采集时钟，但重封装可能改时间基；要做一致性校验。
问：没有网盘资料能否只靠 GitHub？ 答：源码可起步，但固件与应用版本可能不对齐；资料包仍是生产必需。
问：如何证明复现性？ 答：换干净机器按文档操作；失败则修文档，而不是只培养熟手。
问：掉帧率多少算可接受？ 答：按任务定阈值并写附件；接触任务通常更严。
问：是否需要立体标定才能训？ 答：取决于算法；但版本化内参字段即便暂不用也建议写入。
问：短录多长合适？ 答：验收短录一到三分钟足够；结构稳定后再加长。
问：错误码没有文档怎么办？ 答：提 Issue 补文档，同时在内部对照表暂存；不要靠猜。
问：能否在虚拟机里编译？ 答：可以尝试，但通用串行总线直通与调试桥接常出问题，真机联调仍建议物理机。
问：数据卡最小字段有哪些？ 答：会话号、设备、提交号、资料包版本、帧率分布、IMU 健康、许可与授权。
问：训练损失好但真机差可能是时间线吗？ 答：有可能；先做相位灵敏度实验，再改大模型。
问：开源更新频率如何跟进？ 答：月度评估上游变更，必要则回归后升级。
问：内部 fork 怎么同步？ 答：定期 rebase 或 cherry-pick，并跑契约测试。
问：演示给客户看什么？ 答：看门禁、日志与短录回放，不只看外观渲染。
问：谁对首条时间线签字？ 答：录制负责人与算法接口人共同签字。
问：失败后的回滚点在哪？ 答：预先记录的标签提交与匹配固件包。
问：如何避免聊天传临时包？ 答：强制台账编号；无编号不排障。
下一步：从开源 SDK 进入可验收联调
若你的团队正在评估E2 开源 SDK 与双目录制链路，请先以 GitHub README 与交付包为准完成克隆、资料包核对与主机侧联调，再把同步、上传、标定与许可边界写进项目验收附件。开源仓库帮助你快速起步；书面规格决定交付范围。
前往 开发者文档 · E2／E6 Device SDK 获取克隆命令、Drive／百度资料与 Linux 对接说明，或直接 联系技术接入 对齐版本、样例与验收字段。