WebToSparkJSON 是什么？
JSON 是 JavaScript Object Notation，是用于交换结构化值的文本格式，不是需要执行的程序。对象包含命名成员，数组保存有序值，数据可包含字符串、数字、布尔值和 null。
可以用文本编辑器打开 .json 文件，无需上传在线查看器。研究文件包含敏感来源材料时，优先在本地查看。大型文件可能需要支持相应文件大小的编辑器。
打开 JSON 文件的步骤
很多应用都使用 .json 后缀，但结构各不相同。这些字段描述的是 WebToSpark，不是所有 JSON 文件通用的结构。
- 保留原始导出。使用系统“打开方式”选择纯文本编辑器，支持 JSON 格式化与折叠的编辑器更方便查看层级。
- 确认看到的是导出文档，不是网页渲染结果。先检查 schemaVersion 和 source，再查看内容集合。
- 单个 WebToSpark 导出可查看 primary、items、comments 等实际存在的字段；多文档导出则查看批量外层对象中的 documents。
- 沿 replies 查看嵌套评论。字段为空或缺失可能表示页面未提供；分析前对照来源与提取警告。
WebToSpark 中哪些字段值得检查？
JSON 保留采集到的结构，不保证讨论完整。普通导出不会获取隐藏回复、已删除评论或额外页面。图片和视频仍然是 URL 引用。
| 字段 | 含义 |
|---|---|
| schemaVersion | 导出结构版本，不是扩展的发布版本号。 |
| source | 来源网页上下文，例如 URL 与标题。 |
| primary / items | 主要记录和列表记录，取决于页面类型。 |
| comments / replies | 已采集评论和嵌套回复。 |
| documents | 批量外层对象中的多个文档。 |
| extraction | 采集元数据与提取警告。 |
JSON 与 CSV 的选择及转换边界
下一步是在 Excel 筛选平面记录时选 CSV，需要层级或程序处理时保留 JSON。其他 JSON 转 CSV 工具仍需为嵌套数组配置映射，改文件后缀不等于转换。WebToSpark 不接受任意 JSON 上传转换。
同一已采集来源仍可用时，可通过扩展补充另一种导出格式。普通文件不会运行实验性 Research Agent，打开 JSON 也不会调用 AI 服务。