保存时明确写入项目设置
PivoGraph 会明确写出解析后的项目状态；生成文件可省略可选字段或只给部分设置，其余由当前默认值补齐。
项目文件格式
保存和重新打开 PivoGraph 项目
一份 .pivograph 文件会保存项目中的数据表、分析、图形设置、标题与标注。之后可以重新打开继续修改，也可以随论文归档，或发给导师和合作者检查。
- 完整项目数据表、分析与图形设置一起保存
- 本地保存研究数据继续留在你的设备上
- Schema version 3自 PivoGraph 1.7 起为当前版本；v1、v2 文件仍可打开
文档与示例
格式规范、JSON Schema 和项目示例
格式规范说明字段含义与兼容规则，JSON Schema 用于校验，示例项目可直接作为编写文件时的参考。规范正文以英文版为准。
格式规范
v3 格式规范
文件语义、相对 v2 的变化、兼容策略、限制条件与校验行为。
阅读 HTML 规范（英文） JSON SchemaJSON Schema v3
字段名、类型、枚举值与结构限制的机器可读定义。
打开 draft-07 schema 项目示例项目示例
覆盖每种数据表的最小文件，以及一份由 PivoGraph 保存的完整项目。
打开完整代表性示例 MarkdownMarkdown 规范
以紧凑的纯文本形式提供同一份 v3 规范；站点索引另见 llms.txt。
浏览全部 schema v3 示例
AI 助手
使用 AI 助手创建 PivoGraph 项目
PivoGraph 内置了一份格式提示词，可用于让 AI 助手根据你的数据与作图要求生成项目文件。
- 复制格式提示词在 PivoGraph 中选择帮助 → 复制给 AI 助手的提示词…，提示词会与当前运行版本保持一致。
- 描述数据与目标图形要求 AI 只返回一份
.pivographJSON 文档。自动化工具还应同时提供 schema 与最接近的示例。 - 打开、核对并精修把回复保存为
.pivograph并拖入 PivoGraph。应用会先校验文件，再替换当前项目。
开发脚本或集成工具时：先阅读 Markdown 规范，用 JSON Schema 核对字段，并参考最接近的示例。未知键会连同 JSON 路径一起被拒绝。
兼容与安全
PivoGraph 如何处理项目文件
旧 schema 通过迁移打开
结构与渲染默认值发生变化时必须启用新的整数 schemaVersion 并提供迁移；旧文件在内存中迁移，源文件不被改写。
项目文件不含可执行代码
项目文件只包含数据，不包含可执行代码。打开时不会请求外部引用，包括可选的 $schema URL。
文件错误不会覆盖当前项目
非法字段会给出 JSON 路径，并且不会替换当前项目；可恢复的不匹配则在成功打开后明确警告。
当前版本
Schema version 3
当前版本 随 PivoGraph 1.7 引入。
v3 新增：以 pt 表示的尖峰宽度，基线设置与柱状图一致；填充到 X 轴的区域填充；尖峰图可选的符号与连线、前后对比图的均值柱、浮动柱上的个体点；生存曲线的删失标记、双向误差线与新的默认坐标轴；连续轴的次刻度；饼图、环图、条带与点阵按设定尺寸绘制；以及单因素 ANOVA、描述统计、非参数 t 检验、曲线下面积与 XY 相关分析。规范中列出了全部变化以及 v2 文件的迁移方式（英文）。
PivoGraph 的兼容策略是通过迁移继续打开已发布的旧版本。每个 schema 版本都有固定不变的规范、schema 与示例 URL。文件中的 $schema 应指向带版本号的 URL，因此不提供 latest 别名；工具可通过版本目录查询当前版本。
历史版本
Schema version 2
已被取代 随 PivoGraph 1.6 引入。v2 文件仍可在 PivoGraph 中打开，并自动迁移到 v3。
v2 曾新增：可按片段设置加粗、倾斜、上标与下标的富文本；以角度表示的标题旋转；行距；饼图与环图的扇区分离；拟合曲线的叠放次序；堆叠柱的误差线；显著性括号的完整格式；散点图的汇总符号；更多热图色标；以净距离表示的首末间距；Grouped 表的前后对比排布与逐行 t 检验。规范中列出了全部变化以及 v1 文件的迁移方式（英文）。
历史版本
Schema version 1
已被取代 随 PivoGraph 1.3 引入。v1 文件仍可在 PivoGraph 中打开，并自动迁移到 v3。
编辑器集成
在编写时完成校验
把 *.pivograph 或 *.pivograph.json 关联到 https://pivograph.com/schemas/project/v3.json，或把该 URL 写入文档的 $schema 字段。版本目录是全部已发布版本的机器可读入口。