跳到主要内容
AI教程

EditaPlot 教程：用 Codex 与 Origin 生成可编辑科研图

本教程介绍如何在 Windows 上安装并使用 EditaPlot，让 Codex 理解科研数据、推荐图形、确认列用途，随后调用 Origin 2026 生成可编辑 OPJU，并导出和验证 PNG、PDF、TIF。

AI我搜编辑部阅读约 15 分钟
EditaPlot 教程：用 Codex 与 Origin 生成可编辑科研图

EditaPlot 是什么

EditaPlot（艾迪图）是一个面向 Codex 的 Windows 本地科研绘图 Skill。它读取 CSV、TXT、XLS 或 XLSX 数据，解释每一列的用途，推荐合适的图形与配色，并在获得用户确认后调用本机 Origin，生成可继续编辑的 OPJU 项目以及 PNG、PDF、TIF 文件。

它不是简单替换数字的静态模板，也不会把 Python 预览冒充 Origin 成图。科学含义、列角色和最终图形选择始终由用户决定；遇到含义不明确的列时，EditaPlot 会暂停并询问，而不是自行补列、拟合或推断结论。

平台限制：当前完整验证范围是 Windows 10/11 x64 实体电脑、64 位 Python 3.10–3.12，以及 Origin/OriginPro 2026（10.30）。macOS、Linux、WSL、Wine、CrossOver、Parallels 和其他虚拟机暂不受支持。

工作流程与关键特性

先理解数据，再决定画什么

EditaPlot 不会默认把每一个数值列都画成曲线。读取表格后，它会把列划分为以下角色，并用清单请你确认：

  • 主要证据：实测点、主曲线、柱体等核心图形元素。
  • 可见辅助：背景、拟合线、残差、参考线或物相刻线。
  • 仅用于计算或验证：用于权重、筛选、坐标和布局，但不直接显示。
  • 保留但不绘制：继续保留在数据映射和可编辑项目中。
  • 仍不确定：暂停规划，等待用户说明含义、单位、误差或变换方式。

只要源文件、列映射或数据理解结果发生变化，之前的科学确认就会失效，需要重新核对。

生成真正可编辑的 Origin 项目

确认完成后，EditaPlot 会自动启动一个专用 Origin 实例。用户无需提前打开 Origin，但必须已经在电脑上安装受支持的 Origin/OriginPro 2026。项目不会替你安装、升级或修改 Origin。

正常交付内容包括可编辑 OPJU、PNG、PDF、TIF、RenderPlan、对象反读信息和验证结果。默认情况下，这些文件会被写入原始数据旁边新建的“数据文件名_EditaPlot_时间”文件夹，原文件不会被覆盖。

科研绘图覆盖范围

EditaPlot 覆盖多类材料、光谱、统计和医学图形，包括 XPS、普通 XRD、GSAS/GSAS-II Rietveld、XAS、FTIR、NMR、DSC、PL/TRPL、UV–Vis/Tauc、EIS、CV、LSV、柱状图、误差棒、堆叠图、散点图、热力图、箱线图、小提琴图、Raincloud、ROC、PR、校准曲线、DCA、Bland–Altman、混淆矩阵和预计算 SHAP 可视化等。

覆盖某种图形不代表工具会替你完成上游分析。例如，它不会擅自平滑数据、删除异常值、补峰、计算误差、识别物相、训练模型或拟合曲线。寿命、带隙和 SHAP 等结果需要由用户明确提供，或在允许派生时先确认公式、来源与用途。

参考图只作为视觉简报

你可以提供 PNG、JPEG 或 TIFF 参考图。EditaPlot 只提取面板结构、点线柱元素、数据编码和有限的视觉风格，不会从像素反推实验数据，也不会复制其中的数值、文字、拟合结果、物相、Logo 或水印，更不会把参考图片直接塞进 OPJU。

当参考图、模板默认值和你的精确要求发生冲突时，以你明确确认的要求为优先，但只有经过当前模板验证并能够反读的设置才会采用。处理结果会被区分为“采用”“保留模板默认”“拒绝”和“仍需确认”。

安装前准备

  1. 操作系统：使用 Windows 10 或 Windows 11 x64 实体电脑。
  2. Origin：预先安装 Origin 或 OriginPro 2026（10.30）。
  3. Python：准备 64 位 Python 3.10–3.12。启动器会自动寻找兼容版本并创建项目隔离环境。
  4. 数据文件：支持 CSV、TXT、XLS 和 XLSX，可使用中文列名与中文路径。
  5. Codex：需要能够安装并调用本地 Skill，同时读取仓库和你的数据文件。

如果电脑完全没有兼容 Python，启动器会给出明确诊断。通过 winget 安装用户范围的 Python 3.12 前，Codex 应先解释系统变更并征得你的同意。普通使用不需要管理员权限，也不需要修改 DCOM、注册表、防火墙或 Origin 安装。

安装 EditaPlot Codex Skill

在 PowerShell 中运行以下命令。这里显式把仓库克隆到 editaplot 目录，以便后续命令保持一致：

git clone https://github.com/liushunqi8-hash/editaplot2026.git editaplot
Set-Location editaplot
.\editaplot.cmd setup

必须下载完整仓库，因为 skill/editaplot 与 runtime/ 需要配合工作。只复制 Skill 子目录会缺少绘图引擎。如果不使用 Git，也可以下载仓库的 Source ZIP，完整解压后在根目录运行相同的 setup 命令。

安装完成后，重新打开一个 Codex 任务，并通过 $editaplot 调用该 Skill。项目采用 Apache License 2.0 开源，源码与进一步说明可在 EditaPlot GitHub 仓库中查看。

第一次使用：从数据到候选图

方式一：直接把文件交给 Codex

最简单的方法是把数据文件拖入 Codex，然后发送：

请使用 $editaplot 帮我画这份数据。
不要修改原文件。请先识别每一列的用途，推荐合适的图，
并列出哪些列要画、哪些只作辅助或验证、哪些保留但不画。
如果有不确定的列，请先问我，不要猜。
等我确认科学目的和图形元素后再调用 Origin 绘图。

随后应先检查 EditaPlot 给出的数据解释，而不是立即批准绘图。重点核对列名、单位、误差列、分组列、拟合结果和需要反向显示的坐标轴。

方式二：从启动命令开始

也可以在仓库根目录运行：

.\editaplot.cmd start "$HOME\Documents\my-data.csv"

start 会组织环境检查、只读识别、候选图推荐与确认流程。对于第一次使用者，这是比手动执行整条流水线更合适的入口。

分步骤命令行工作流

1. 检查本机环境

.\editaplot.cmd doctor

doctor 只做只读发现，不代表 Origin 自动化已经可以正常工作，也不会主动启动 Origin。

2. 检查和理解数据

.\editaplot.cmd inspect data.csv
.\editaplot.cmd recommend data.csv --intent "比较模型并展示误差"
.\editaplot.cmd understand data.csv --template-id bar --output data-understanding.json

inspect 用于查看表格结构，recommend 根据科学意图推荐图形，understand 则生成更正式的列角色理解结果。模板 ID 应根据实际数据和推荐结果选择，不要为了套用示例而强行指定。

3. 浏览配色

.\editaplot.cmd palettes
EditaPlot 中文科研配色选择

EditaPlot 首屏提供 8 套推荐色组，完整目录另有 2 套进阶色组。涉及 XPS 组分、正负值、热力图和诊断参考线时，颜色可能具有科学含义，不应只为美观随意更换。

4. 创建 RenderPlan

确认科学主张、证据角色、列映射和配色后，可以生成正式绘图计划：

.\editaplot.cmd plan data.csv `
  --template-id bar `
  --claim "模型 A 指标更高" `
  --evidence-role comparison `
  --palette-id ocean_coral `
  --semantic-confirmation-json semantic-confirmation.json `
  --output render-plan.json

semantic-confirmation.json 应来自已经完成的语义确认过程。不要跳过确认，也不要把未经核对的列映射直接送入正式渲染。

5. 运行真实 Origin smoke

$smokeDir = Join-Path $env:TEMP ("EditaPlot-origin-smoke-" + (Get-Date -Format "yyyyMMdd-HHmmss"))
.\editaplot.cmd origin-smoke --output-dir $smokeDir

origin-smoke 会启动 EditaPlot 自有的隔离 Origin 实例，并完成最小导出闭环。只有 smoke 通过后，才应继续正式渲染。

6. 渲染并验证

.\editaplot.cmd render render-plan.json
.\editaplot.cmd verify "C:\path\to\Origin-output-directory"

普通绘图建议省略 render 的 --output-dir，让结果自动保存到源数据旁的新目录。验证不能只检查 PNG 是否存在，还应确认 OPJU、PDF、TIF、坐标轴、字体、图层、颜色条、数据映射和对象反读结果。

典型科研数据的使用要点

GSAS 与 GSAS-II XRD Rietveld

对于精修数据，EditaPlot 可以把 Observed 识别为实测点、Calculated 识别为计算线，并按文件实际内容加入 Background、Difference 和身份明确的 Phase 刻线。weight、Q、Used、diff/sigma 与 Axis-limits 等列会作为辅助或控制数据保留，不会被误画成新的强度曲线。

Publication CSV 中已有显示位置的 Diff 会按源值绘制，不会再次偏移。工具不会自动计算背景、差值、Rwp、χ²，也不会替用户识别物相或峰归属。

SHAP 可视化

SHAP 路线读取上游已经计算好的逐样本长表，至少需要 Feature、SHAP value 和 Feature value。还可以提供 Sample ID、Feature Order、Mean absolute SHAP、Feature Group 和 Group contribution (%)。

若使用 SHAP 分栏与双层环图，还必须提供 Feature Group，每个特征至少包含 3 个观测。EditaPlot 不会训练模型或自行计算 SHAP；需要从已提供 SHAP 值派生汇总量时，会先列出公式并请求确认。

请用 $editaplot 的 SHAP 分栏与双层环图，
配色选紫绿金，保留所有数据。

光谱与热分析数据

  • FTIR/IR：需要波数和至少一条吸光度或透过率，波数从高到低显示；不自动校正、平滑、标峰或指认官能团。
  • NMR：需要化学位移和强度，化学位移从高到低显示；不自动进行相位校正、积分、认峰或归属。
  • DSC：需要温度和热流，并先确认吸热或放热方向；不自动识别 Tg、Tm、Tc 或计算焓变。
  • PL/TRPL：需要波长或时间与发光强度；拟合列和寿命必须由用户提供。
  • UV–Vis/Tauc：不会自动换算光子能量、选择指数、拟合或计算带隙。

高级技巧

精确控制视觉样式

你可以明确给出系列颜色、线宽、填充透明度、画幅尺寸以及图例是否显示、是否无框和放置位置。以 XPS 为例，可以这样告诉 Codex：

这次选精确自定义：
Raw 使用 #173F5F，Envelope 使用 #C94C4C，
线宽 2.4 pt，填充透明度 38%，画幅 18 × 18 cm，隐藏图例。
科学含义和列角色保持不变。

EditaPlot 会核对字段并把确认值冻结到 --visual-style-json。不合法的精确值会要求修正，不会静默回退到默认值，也不会把未验证的能力描述为已经采用。

保持最小权限

Codex 通常只需要读取完整仓库、数据文件和可选参考图，写入仓库、用户 Skill 目录及数据所在文件夹，并运行本地 PowerShell、Python、editaplot.cmd 和 Origin Automation。普通使用不需要整个 C 盘写权限、鼠标控制或管理员权限。

如果 Codex 沙箱无法在当前登录用户上下文调用 Origin，EditaPlot 会在 COM 调用前停止。此时应只为原来的精确 origin-smoke 或 render 命令申请受限的本地执行权限；不要通过管理员权限、修改 DCOM 或注册表来绕过限制。

处理并发任务

多个 Codex 任务可以并行理解数据、推荐图形和制定方案，但同一 Windows 登录会话一次只执行一个 Origin 自动化阶段。其他任务会进入 origin_job_queue，约每 30 秒更新一次状态。看到排队提示时不要重复启动同一任务。

判断运行是否异常

环境已配置、数据量正常且无需等待确认时，完成本地识别、smoke、Origin 绘图、导出和验证通常以 4–5 分钟为合理范围，但这不是固定承诺。首次安装依赖、大型 Excel、复杂图层、较慢磁盘或安全扫描都可能延长时间。

如果在没有等待确认或权限审批的情况下 30–60 分钟没有新进度，应先确认停在哪个阶段：

  1. setup：检查 GitHub、Python 包源、代理和网络。
  2. 数据理解：确认是否正在等待用户回复或权限批准。
  3. origin-smoke：检查 Origin Automation 是否成功启动或返回稳定错误。
  4. render：检查 Origin 对话框、目录写权限或同步软件锁定。
  5. verify：检查 OPJU、PNG、PDF、TIF 与反读报告，而不是直接重画。

不要让 Codex 无限重试、反复重装环境或扩大系统权限。若需要再次尝试，应使用新的空白同级输出目录，以保留首次诊断。

保护数据与隐私

EditaPlot 自带 runtime 和 Origin 自动化不会主动上传数据，但交给 Codex 的文件仍受所用账号、组织和数据保留策略约束。医学数据与参考图应先按机构要求去标识化，并检查图片中是否烧录身份信息；项目不承诺自动发现受保护健康信息。

完成前的检查清单

  • 原始 CSV、TXT、XLS 或 XLSX 没有被改写。
  • 每一列的科学含义和图中角色都已确认。
  • 不确定列没有被自动变成曲线或分析结果。
  • OPJU 可以继续编辑，数据映射仍然存在。
  • PNG、PDF 和 TIF 均已成功导出。
  • 坐标轴、单位、字体、图层、图例和颜色条完整且未裁切。
  • 对象反读与人工视觉检查都已通过。
  • 没有把 Python 预览图当作最终 Origin 成图。

结语

EditaPlot 的核心价值不是替用户做科学判断，而是把“理解数据、确认语义、制定计划、调用 Origin、导出产物、反读验证”组织成可审计的工作流。对于需要 Origin 可编辑项目、同时又希望利用 Codex 减少重复操作的 Windows 用户，它提供了一条谨慎而实用的科研绘图路径。