PivoGraph

项目文件格式

保存和重新打开 PivoGraph 项目

一份 .pivograph 文件会保存项目中的数据表、分析、图形设置、标题与标注。之后可以重新打开继续修改，也可以随论文归档，或发给导师和合作者检查。

阅读 v1 规范（英文） 打开 PivoGraph
  • 完整项目数据表、分析与图形设置一起保存
  • 本地保存研究数据继续留在你的设备上
  • Schema version 1随 PivoGraph 1.3 推出

文档与示例

格式规范、JSON Schema 和项目示例

格式规范说明字段含义与兼容规则，JSON Schema 用于校验，示例项目可直接作为编写文件时的参考。规范正文以英文版为准。

格式规范

v1 格式规范

文件语义、兼容策略、限制条件与校验行为。

阅读 HTML 规范（英文） JSON Schema

JSON Schema v1

字段名、类型、枚举值与结构限制的机器可读定义。

打开 draft-07 schema 项目示例

项目示例

覆盖每种数据表的最小文件，以及一份由 PivoGraph 保存的完整项目。

打开完整代表性示例 Markdown

Markdown 规范

以紧凑的纯文本形式提供同一份 v1 规范；站点索引另见 llms.txt。

阅读 Markdown 版本（英文）
浏览全部 schema v1 示例
Column XY Grouped 热图 Nested Contingency Survival Parts of whole Multiple variables 完整代表性项目

AI 助手

使用 AI 助手创建 PivoGraph 项目

PivoGraph 内置了一份格式提示词，可用于让 AI 助手根据你的数据与作图要求生成项目文件。

  1. 复制格式提示词在 PivoGraph 中选择帮助 → 复制给 AI 助手的提示词…，提示词会与当前运行版本保持一致。
  2. 描述数据与目标图形要求 AI 只返回一份 .pivograph JSON 文档。自动化工具还应同时提供 schema 与最接近的示例。
  3. 打开、核对并精修把回复保存为 .pivograph 并拖入 PivoGraph。应用会先校验文件，再替换当前项目。

开发脚本或集成工具时：先阅读 Markdown 规范，用 JSON Schema 核对字段，并参考最接近的示例。未知键会连同 JSON 路径一起被拒绝。

兼容与安全

PivoGraph 如何处理项目文件

保存时明确写入项目设置

PivoGraph 会明确写出解析后的项目状态；生成文件可省略可选字段或只给部分设置，其余由当前默认值补齐。

旧 schema 通过迁移打开

结构与渲染默认值发生变化时必须启用新的整数 schemaVersion 并提供迁移；旧文件在内存中迁移，源文件不被改写。

项目文件不含可执行代码

项目文件只包含数据，不包含可执行代码。打开时不会请求外部引用，包括可选的 $schema URL。

文件错误不会覆盖当前项目

非法字段会给出 JSON 路径，并且不会替换当前项目；可恢复的不匹配则在成功打开后明确警告。

当前版本

Schema version 1

当前版本 随 PivoGraph 1.3 引入。

HTML 规范 Markdown JSON Schema

PivoGraph 的兼容策略是通过迁移继续打开已发布的旧版本。每个 schema 版本都有固定不变的规范、schema 与示例 URL。文件中的 $schema 应指向带版本号的 URL，因此不提供 latest 别名；工具可通过版本目录查询当前版本。

编辑器集成

在编写时完成校验

把 *.pivograph 或 *.pivograph.json 关联到 https://pivograph.com/schemas/project/v1.json，或把该 URL 写入文档的 $schema 字段。版本目录是全部已发布版本的机器可读入口。