01它是什么

ngplot-draw 是 NGplot 官方出图 skill。装在支持 SKILL.md 的 Agent 里（WorkBuddy、Codex、TraeWork等）， 之后「画图」这件事就变成一段对话：你给数据和模板，它把中间所有琐碎环节做完。

02下载

03安装

两步：上传安装包 → 复制一句提示词。 不用解压到目录、不用改文件、不用装依赖，账号和密钥由 AI 写进配置并当场验证。

1. 上传安装包（以 WorkBuddy 为例）

   下载本页的 ngplot-draw-skill.zip，不用解压 —— 在 WorkBuddy 里按「技能 → 上传本地技能」选中它即可：

2. 调起 ngplot-draw，把提示词粘进对话框

   点开 ngplot-draw 技能，复制下面这段（把尖括号里的值换成自己的），直接粘贴发送：

   提示词 · 配置账号复制

   ngplot-draw 配置：账号是 <账号>，ngplotApiKey 是 <密钥>，工作目录是 <比如 D:/ngplot-workspace>。

   AI 会跑 scripts/set_config.py 把三项写进 config.json，并当场验一次账号和密钥 —— 验不过就不写，原配置不受影响。地址一项都不用配。

04使用案例

两个常见场景：数据本来就是模板要的样子，或者手里只有原始记录、得按模板的数据要求先算一遍。 两条路都从「模板编号 + 数据」开始，区别只在中间要不要处理数据。

你在官网挑好了模板，手里那份表也正好是模板要的列（分组、数值、误差都齐）。把模板编号和数据文件一起发过去 —— 取模板要求、对表头、出图、按你的意见续改，一路到底，中间只在「对不齐」时才会来问你。

1. 一句话说清模板编号 + 数据在哪

   「按模板 67d9443b11eeb4461e7205df 画这张表：D:/data/exp.xlsx」。 编号就是官网地址栏里 ?id= 后面那一串，给一位都不差。

2. 它取模板要求、对表头

   列名对得上就直接开工；对不上（要转置、改列名、把重复测量算成均值±标准差）会先给一份对齐方案， 你点头它才写处理脚本，不擅自猜你的数据。

3. 出图后接着说，还是同一个任务

   「柱子换深蓝」「纵轴标题写 Dry weight (g)」—— 这些都是这个任务的续改，每版留档，随时能回到上一版。 要 PDF / PNG / TIFF 说一声就行，300 dpi 起、透明底或白底可选。

数据是记录表：每个处理组一列、重复测量堆在一起，没有现成的均值和标准差。模板照样由你指定 —— 它读这个模板的数据要求（要几列、每列装数值还是分组、误差怎么给），把你的原始表折算成模板要的样子， 中间的统计处理写进可复跑的脚本，然后才出图。

1. 指定模板，再把原始记录丢过来

   「按模板 67d9443b11eeb4461e7205df 画，数据在 D:/data/raw.xlsx， 是三个品种、四个处理的干重原始记录」。表头乱、有空行、数值带单位都没关系，先给它。

2. 它读模板的数据要求，对着你的表算差在哪

   模板要哪几列、每列装数值还是分组、误差是单独一列还是要现算 —— 一条条对上，告诉你缺什么： 比如「模板要 value + sd 两列，你只有一个宽表，分组还挤在表头里」。

3. 方案你点头，它才动手处理数据

   转长表、按组算均值±标准差、算 p 值做显著性字母标记，都写进一个 prep.py。 口径它不替你做主（SD 还是 SE、误差按哪个分组算），先问你；数据更新了重跑脚本就行。

4. 按模板出图，还能让它读图

   图出好后可以顺手让它检查一遍：轴范围合不合理、图例挡没挡数据、显著性字母有没有错位。 它只讲看得见的事实，不硬凑显著性，也不替你编结论。

05不想全靠对话？可以自己接手

skill 不是「必须一直对话改图」。每个任务都带一个任务详情页，里面把这张图的画图元数据按顺序摆好了 —— 一键复制、粘到官网，剩下的你在网页上点。对话和手动，随时能换手。

怎么接管：三步

1. 打开任务详情页，点「画图数据配置一键复制」

   按钮在「在官网打开这个模板」后面。复制到的内容按 ##id（模板编号）、##arg（运行参数）、 ##props（属性）、##data1（数据）分段，多份数据依次往下排。

2. 粘到官网的对应位置

   点「在官网打开这个模板」跳过去，把整段贴进画图页的配置区就行，各段自己对号入座。 数据和参数不用你再填一遍。

3. 在页面上调，所见即所得

   属性面板里改一处，图当场重画；不想要的效果直接撤回。调顺了想留档，就把改动发回对话， 让它更新这个任务、记一版，而不是重新开一个。

06图存在哪、能拿走什么

任务都落在你自己配的工作目录里，不在 skill 里面 —— 打开文件夹就能看到全部东西。

<work_dir>/
├─ 任务总览.html                 所有任务的货架：缩略图 + 筛选 + 点进详情
├─ 刷新总览.bat                    一键刷新并打开总览页
├─ _trash/                        任务清理区
└─ 任务/
   └─ 干重汇总柱状图-67d944/         模板层：同一模板的任务聚在一起
      └─ 20261018-干重汇总/          任务层：一条迭代线
         ├─ 任务详情-干重汇总.html   图 + 数据 + 参数 + 属性 + 版本，双击即看
         ├─ out.svg                 当前版本的图
         ├─ data1.tsv               画图数据（固定不变）
         ├─ props.json / arg.json   改了哪些属性 / 运行参数
         ├─ prep.py                 数据处理脚本，可复跑
         ├─ render.py                投稿用画图代码（自包含）
         ├─ result.md               交付说明：数据来源、结论、复跑命令
         └─ history/v001_…/         历史版本：属性 + 参数 + 图

python render.py --api-key 你的密钥 --out myfigure

脚本里已经把模板、参数、属性、数据路径填好。换台机器时，数据路径找不到会自动退到脚本同目录的同名文件。

07常见问题