mcapfixindex 0.1.0

Rebuild missing MessageIndex / Summary / ChunkIndex for local MCAP files

mcapfixindex

为缺少 MessageIndex 的本地 MCAP 文件补全索引（同时重建 Summary / ChunkIndex），生成新的 MCAP。消息内容不变。

安装

pip install mcapfixindex

环境要求：Python 3.10+，macOS / Linux / Windows。

快速开始

检查索引：

mcapfixindex inspect --input /path/to/bag.mcap

补全单个文件：

mcapfixindex fix --input /path/to/bag.mcap --output /path/to/fixed.mcap

批量处理目录：

mcapfixindex fix --input /path/to/mcap_dir --output ./output

常用参数

参数	默认值	说明
--input	必填	.mcap 文件路径，或包含多个 .mcap 的目录
--output	<stem>_indexed.mcap	输出文件或目录
--compression	preserve	chunk 压缩：preserve / zstd / lz4 / none
--force	关闭	即使已有 MessageIndex 也强制重写

说明

• 典型输入：已有 Summary / ChunkIndex，但 ChunkIndex.message_index_offsets 为空
• 输出为新文件，不原地覆盖
• 消息 payload、schema、channel、attachment、metadata 保持不变