origin-figure-skill

name	origin-figure-skill
description	Origin 出版级科研绘图。自然语言、Origin 模板或参考图片收敛到 StyleSpec v2，支持灰度/彩图、误差棒、多面板、可编辑 OPJU、矢量/高分辨率导出和视觉 QA 闭环。
version	2.0.0

Origin Figure Skill

出版级 Origin 图表制作：可复用模板、灰度/色盲友好彩图、OPJU 工程、论文格式导出和双语 caption。

路由（三入口 → StyleSpec）

根据用户意图选择入口，所有入口最终产出一份 StyleSpec JSON（schema 见 schema/style-spec.md）。

入口 ① 模板选择

触发词：套模板、用预设、my-journal、line/scatter/column/line-2y。

1. 读 templates/INDEX.md 和模板组 metadata.json，按图型、颜色模式、列数/图层数和标签匹配。
2. 用户选定后，读对应 .spec.json 作为 StyleSpec 基础；模板只保存图形结构与样式，不替代数据映射。
3. 按用户补充需求覆盖个别字段（三层优先级：单图覆盖 > 期刊预设 > 硬默认）。
4. 进入执行。

入口 ② 自然语言描述

触发词：画一张……图、帮我出图、做个折线图/散点图/柱状图。

1. 按 schema/style-spec.md 字段表，把用户描述翻译为 StyleSpec v2 JSON。
2. 缺省字段填安全默认值。颜色未说明时用灰度；明确要求彩图时用色盲友好 palette，并保留线型/符号区分。
3. 进入执行。

入口 ③ 参考图风格提取

触发词：照着这张图画、复刻这个风格、提取参考图。

1. 用视觉能力查看用户提供的参考图；只提取风格，除非用户另行要求，不从图片臆测数据。
2. 按 references/style-extraction.md 生成符合 schema/reference-profile.schema.json 的观察档案；每项记录 value / confidence / evidence。
3. 把高置信度观察映射到 StyleSpec；低置信度字段列入 uncertain_fields，不得伪装成确定值。
4. 匹配 templates/ 中最近似模板作为起点，进入预校验和复刻循环。

执行（双轨）

检测

调用 origin_status（MCP）或在 skill 根目录运行 uv run python scripts/_common.py（脚本）确认 Origin COM 连接。

轨道 A — MCP 工具（优先）

条件：origin-figure-mcp 已连接（origin_status 返回正常）。

典型调用链：

validate_style_spec → import_data → create_graph(preset/template)
→ add_plot × N → apply_style_spec → [add_error_bars]
→ inspect_graph → view_graph / export_graph(PNG) → 视觉与自动 QA
→ save_project(.opju) → export_graph(PDF/EMF/TIFF 等)
→ release_origin（隔离测试/批处理会话）

多面板：先分别完成并检查各子图，再用 compose_graphs 合并。微调优先 set_axis 或 StyleSpec；run_labtalk 只作已知安全命令的最后手段。

双 Y 图先用 create_graph(figure_type="double_y")，左轴曲线使用 add_plot(..., layer_index=0)，右轴曲线使用 add_plot(..., layer_index=1)；随后传入 axes.y2 的 StyleSpec。

轨道 B — 独立脚本（降级）

条件：MCP 未连接或用户指定脚本模式。

cd origin-figure-skill
uv sync
uv run python scripts/plot_from_spec.py --data 数据.csv --spec spec.json --out 成图.opju [--x 0 --y 1 2 3]
uv run python scripts/export_preview.py --graph SpecGraph --out preview.png

pyproject.toml 已声明 originpro、pywin32 与 Pillow。预览脚本导出当前 Origin 会话中的图，audit_preview.py 对预览做客观预检；--graph 接受图短名或工作流长名。

产图后必做（workflow 第 5-6 步）

无论哪条轨道，产图后必须：

1. 多模态视觉自检：严格执行 references/review-loop.md。必须显式调用 view_file 查看导出的 preview.png，利用多模态视觉能力复核文字符号渲染（无裸露 Markdown 标记）、图例与多图层索引匹配度、最高峰呼吸空间（$\ge 10%$）、误差棒方向与颜色。
2. 产出物打包：
   • OPJU 工程文件（可编辑主交付）
   • 用户/期刊需要的 PDF、EPS、EMF、SVG、PNG 或 TIFF 副本
   • QA 报告与审阅 PNG
   • 双语 caption 草稿（caption.zh / caption.en）
   • 参数符号清单（符号 | 含义 | 单位）
   • 正文引用说明草稿（一段话）
3. 会话资源自动释放：作图与导出完成后，必须显式调用 release_origin 工具（MCP 轨道）或 op.detach()（脚本轨道）自动关闭/断开 Origin 实例，防止句柄残留。

完整六步流程见 references/workflow.md。

关键约束

• 灰度是未指定颜色策略时的默认值；用户可选彩图。彩图优先使用 okabe-ito、tol-bright 或 tol-muted，且不得只靠颜色区分曲线。
• OPJU 是主交付；排版副本优先矢量格式，图像/连续色场可按期刊要求使用 TIFF/PNG。
• 字体：Times New Roman + 宋体；轴标题斜体单字母 + 正体括号单位。
• 字号默认 ≥ 9 pt；低于 qa.min_font_pt 必须报告。
• Origin 2024b，模板 .otpu 优先。
• 不把通用 my-journal 预设称为 Nature/IEEE/Elsevier 官方模板。

文件索引

路径	用途
schema/style-spec.md	StyleSpec 字段定义 + 示例
schema/reference-profile.schema.json	参考图观察档案 JSON Schema
references/style-guide.md	期刊六条规范 + 硬默认值
references/style-extraction.md	多模态提取八项清单
references/review-loop.md	结构、像素和视觉四道审阅门
references/com-gotchas.md	COM/LabTalk 真机怪癖
references/workflow.md	标准六步流程
templates/INDEX.md	模板预设索引
scripts/plot_from_spec.py	降级核心脚本
scripts/export_preview.py	预览导出
scripts/audit_preview.py	预览边界/留白/颜色模式自动预检

Pitfalls

• save -t windowName fileName 必须双参数，缺窗口名静默失败。
• 切层用 page.active = n，layer -s 经 COM 静默无效。
• 双 Y 轴右轴标题是第 2 层的 yr 标签对象。
• 禁用 template_saveas X-Function（弹模态框卡死 COM）。
• 中文路径用 ensure_ascii_copy 先复制到 ASCII 临时路径再操作。
• figure.grayscale 是 v1 兼容字段；v2 同时出现时以 figure.color_mode 为准。
• expGraph 的宽度与 DPI 属于不同配置树；不得再用固定 8.6 cm 估算所有图。
• 自动 QA 不能判断审美是否协调；最终预览必须实际查看。
• 防止 Markdown 文本在 Origin 中泄露：Origin 不解析 Markdown *t* 或 \Delta，必须使用 Unicode（如 t (ps)、ΔT/T₀ (10⁻³)）或标准 Origin 标签 \it(t)。
• 多图层/双 Y 轴图例跨层索引：图例在 Layer 1 时引用 Layer 2 曲线必须使用双参数索引 \L(layer, plot)（如 \L(1, 2)），防止指向 Layer 1 的 Error Bar 导致图标样式严重错位。
• 垂直误差棒颜色与上限：add_error_bars 需指定 direction="y" 且颜色跟随主散点系列，cap_width 保持在 $\le 2\text{ pt}$，避免水平长段遮挡。