IotaExcel Bytes Preview

用于在 VS Code 中只读预览 IotaExcel 导出的 .bytes 文件。

基础功能

• 自动以自定义预览方式打开 *.bytes 文件。
• 校验文件头 magic 魔数，只有 IOTB 格式会继续解析。
• 支持 IotaExcel 当前 .bytes version 1 格式。
• 支持自描述 .bytes 文件，展示列号、字段名、类型和数据。
• 支持非自描述 .bytes 文件，按文件内字段列号和 wire type 尽量展示数据。
• 支持分页浏览，可切换每页 25、50、100、200 行。
• 支持横向滚动，并保持表头与数据区域同步。
• 支持拖动表头列边界调整列宽。
• datetime 类型默认显示原始秒级字面值，鼠标悬浮时显示对应日期时间。
• key 字段会在字段名后追加 * 标记。
• version、self describing、字段数、行数、schema hash 等信息会以元信息 item 展示。

注意事项

• 本扩展只做只读预览，不会修改 .bytes 文件。
• 非法文件或 magic 不匹配时，会在预览界面显示错误提示。
• 非自描述 .bytes 不包含字段名和字段类型，因此不会显示字段名行。
• 非自描述 .bytes 的 varint 字段无法判断原始语义是 bool、int、datetime 等，预览会按 wire 原始值展示。
• 非自描述 .bytes 目前不会读取外部 Excel schema，所以无法还原字段名、精确类型、用途目标或注释。
• .bytes 文件本身不包含用途目标和注释信息，因此预览界面不会显示这两行。

开发

1. 安装依赖：npm install
2. 编译：npm run compile
3. 在 VS Code 中按 F5 启动扩展调试窗口
4. 打开 .bytes 文件，或在命令面板运行 IotaExcel Bytes Preview: Open Preview

打包与发布

本地打包：

npm run package

打包后会在 dist/ 目录生成 .vsix 文件和固定命名的 sha256sums.txt 校验文件。

发布到 GitHub：

1. 确认 package.json 中的版本号已经更新。
2. 提交代码并推送到 GitHub。
3. 创建并推送版本 tag，例如 v1.0.0。

git tag v1.0.0
git push origin v1.0.0

GitHub Actions 会在 tag 推送后自动构建 VSIX，并把 .vsix 与 sha256sums.txt 上传到对应的 GitHub Release。