FigMirror
参照论文图表风格,将你的数据生成可编辑绘图代码和成稿级 PDF。
- Star 数
- ★ 574
- 最近更新
- 1 个月前
- 主语言
- Python
- FA 评分
- 46/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 科研作者已经选定论文中的参考图,希望用自己的实验数据制作风格一致、可继续编辑的 matplotlib 图表。
- 不适合
- 只使用其他 OpenAI 兼容或本地 Agent 后端的团队,目前仅支持 Codex 与 Claude Code
- 需要完全可复现基准评测的研究者,PlotTwin-Bench 产物尚未发布
- 在安全受控环境中无法审查远程安装脚本的组织
- 官网
- arxiv.org/abs/2608.28814 ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-09-30最新版本 v0.1.0(2026-05-23)
- 源码审查
- 46/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
FigMirror 是一个面向科研图表的参考风格复现工具:用户提供论文图像和自己的数据,系统生成可编辑的 matplotlib 脚本及成稿级 PDF。它提供 Codex 与 Claude Code 技能,也提供运行在本机的浏览器界面,用于上传素材、预览结果、查看迭代历史和继续细化。其顶层 Orchestrator 在 figmirror-drawer 与 figmirror-reviewer 两个角色代理之间组织有次数上限的迭代;两种运行环境共用决策状态机,仅子代理传输方式不同。Reviewer 会同时检查远视图、原尺寸参考图和候选图,返回带边界框的结构化反馈、修改清单与保留清单,再交给下一轮 Drawer。系统支持二维及三维图表,并以本地工作区保存运行产物。论文在 PlotTwin-Bench 的 150 个实例子集上报告了 72.7 和 76.4 的两项最高综合分,但尚未发布可复现的完整基准产物。
用户上传或附加一张论文图表,并提供待绘制的数据。顶层 Orchestrator 调用 figmirror-drawer,通过 Grounded Measurement 测量视觉目标的坐标、裁剪区域及像素颜色等属性,再生成和运行 matplotlib 绘图代码。随后,figmirror-reviewer 对参考图与候选图进行远近两级视觉审核,输出结构化评价、边界框、修改清单和需要保持不变的元素。Orchestrator 将边界框转成标注图和文字说明,供下一轮 Drawer 修订;保留清单会跨轮次累积,以减少风格漂移。循环遵循统一决策状态机和硬性迭代上限,最终产出可编辑的 matplotlib 脚本与 PDF。针对三维图表,提示流程还会检查相机、比例、曲面、光照和几何修复。
- 科研作者已经选定论文中的参考图,希望用自己的实验数据制作风格一致、可继续编辑的 matplotlib 图表。
- 研究团队需要统一多张结果图的字体、配色、布局和视觉层级,同时保留生成脚本供复现实验。
- 没有合适参考图的用户,可先从包含 25 类、139 张论文图的图库中选择样例,再开展风格复现。
- 需要复杂多面板、联合 hexbin 与边缘直方图等布局的用户,可让 Drawer 和 Reviewer 反复生成并检查候选图。
- 制作三维瀑布图或其他三维科研图的用户,可利用针对相机、比例、曲面和光照的几何感知提示。
- 希望在浏览器中上传素材、比较历史版本并继续细化的 Codex 或 Claude Code 用户,可运行本地 Web UI。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://raw.githubusercontent.com/VILA-Lab/FigMirror/main/scripts/install.sh | bash
- 端口
8765- 环境变量
UV_CACHE_DIR
如何安装或部署这个 Agent?
完整本地 Web UI 安装:
git clone https://github.com/VILA-Lab/FigMirror.git && cd FigMirror
bash scripts/install.sh
uv run python scripts/figcopy_serve.py --workspace .artifacts/figmirror-workspace --backend codex然后打开 http://127.0.0.1:8765/。如使用 Claude Code,将最后一个参数改为 --backend claude。若未安装 uv,先运行 python3 -m pip install uv。
只安装技能:
curl -fsSL https://raw.githubusercontent.com/VILA-Lab/FigMirror/main/scripts/install.sh | bash也可明确选择目标:在命令末尾使用 bash -s -- --codex、bash -s -- --claude 或 bash -s -- --all。安装器会自动检测 Codex 和 Claude Code,并安装 figmirror 技能以及 figmirror-drawer、figmirror-reviewer 自定义代理。共享机器或根分区较小的环境应先运行 df -h,并将 UV_CACHE_DIR 指向容量较大的用户可写文件系统。资料没有给出独立 API 凭据配置;使用者需具备可运行的 Codex 或 Claude Code 环境。
如何使用这个 Agent?
技能模式下,在 Codex 或 Claude Code 中附加论文图表截图、粘贴数据,然后输入:Use FigMirror to mirror this figure's style with my data. 系统会启动 Drawer–Reviewer 循环并生成可编辑 matplotlib 代码和 PDF。Web UI 模式下,先启动 scripts/figcopy_serve.py,再访问 http://127.0.0.1:8765/,通过浏览器上传参考图和数据、预览候选结果、浏览迭代记录并继续调整。工作区示例为 .artifacts/figmirror-workspace。
这个 Agent 有哪些优点和局限?
- 同时交付可编辑的 matplotlib 脚本和 PDF,不会把结果限制为不可修改的位图。
- Drawer 与 Reviewer 职责分离,Reviewer 提供边界框、修改清单和跨轮保留清单,形成有明确反馈结构的迭代流程。
- Codex 与 Claude Code 使用相同的决策状态机和有界迭代约定,并可通过同一个本地 Web UI 切换后端。
- Grounded Measurement 将坐标识别转换为裁剪、像素取色等可执行检查,减少完全依赖主观文字描述的情况。
- 明确覆盖二维复杂布局与三维图表,并为三维相机、比例、曲面和光照提供专门检查。
- 附带覆盖 25 个图表类别的 139 张参考图图库,降低寻找起始样例的成本。
- 当前明确支持的执行环境只有 Codex 和 Claude Code;迁移到其他 OpenAI 兼容服务或本地代理仍在路线图中,需要适配。
- 运行依赖 Python、
uv、Shell、文件系统以及可用的 Codex 或 Claude Code 环境,对受限或小根分区机器需要额外配置缓存目录。 - 虽然论文报告了 PlotTwin-Bench 结果,但参考图、目标数据、生成结果和评测元数据等完整可复现产物仍未发布。
- 许可证状态未知,组织在采用、修改或再分发前需要自行确认授权条件。
- 方法依赖多轮绘制和视觉审核;资料只说明存在硬性迭代上限,没有给出运行成本、时延或失败率。
- 安装示例包含从网络拉取仓库或直接将远程脚本传入 Shell,受严格安全策略管理的环境需要先审查脚本。
这个 Agent 与同类方案有什么区别?
论文将 FigMirror 与 Plot2Code、METAL、ChartGalaxy 和 ChartIR 进行定量与定性比较。所有方法在该比较中均使用 GPT-5.5;FigMirror 在 50 个手工筛选参考图和 100 个随机增强参考图上分别取得 72.7 与 76.4 的最高综合分。资料未提供这些替代方案的部署方式或功能明细,因此不能据此判断安装成本或平台兼容性。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| FigMirror 当前 | 46 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 574 | 1 个月前 | Python | Codex · Claude Code |
| 策略可视化工作台 | 74 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 177 | 1 个月前 | Python | Codex · Claude Code |
| Auto-Research-Skills 研究工具箱 | 61 · 存在缺口 | 命令行工具免费 | ★ 265 | 今天 | Python | — |
| Feynman 研究助手 | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 10k | 5 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
材料描述本地 Web UI、工作目录和上传参考图,并要求绘图前回显数据结构、默认请求用户确认,支持用户确认对输入数据的控制,因此确认度得 2。安装说明也提供 curl 管道执行脚本,且可写入运行产物,但所给材料没有权限边界、数据留存或传输细节、依赖审查、外部副作用说明、回滚方案或清晰的署名/维护主体,故其余信任项仅得 1。
材料给出迭代上限、角色分工和结构化审查流程,但新旧技能材料呈现不同架构描述,测试配置注释还称依赖为空、与 pyproject 的运行依赖不符;没有足够材料确认依赖供应与故障提示质量,故各项得 1。
用途及所需输入明确,覆盖 2D/3D 风格迁移并设置 3D 门槛,也明确不面向无参考图的通用绘图;两种运行环境和本地 Web UI 均有安装说明,因此得 2。材料没有更详尽用户角色或环境兼容范围,未给更高分。
README、安装文档、技能说明形成可导航的信息结构,包含命令、示例请求和基本故障准备提示;但技能标识与历史归档材料并存,已知限制说明有限,版本历史不完整,维护责任主体不清,许可元数据未知且未见许可文本,故相关项扣分。
输出目标包括可编辑 matplotlib 脚本、PNG 和 PDF,并提供浏览迭代、修订与展示案例;参考图风格迁移有明确附加价值。但迭代代理及图像/模型流程的成本、资源需求和收益权衡未充分说明,故成本效益仅得 1。
README 报告论文和基准结果,并链接对应材料;所给包内没有可交叉核对结果的论文内容或完整实现,且材料未系统区分实测事实与产品主张,故追溯、交叉印证和事实/推断区分均仅得 1。
- 安装命令会从远程地址下载脚本并交给 shell 执行;审阅材料没有说明脚本权限范围或上传参考图及数据的处理方式。
- README、现行技能和退休技能材料存在架构描述差异;评估结果仅依据提供的静态材料,不能视为运行验证。
- 许可元数据未知,且材料中未提供许可文本;使用或再分发前应核实。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.1.0 FigMirror v0.1.0: Public Preview
发布说明摘录
FigMirror is now publicly available. FigMirror helps you plot your own data in the visual style of a reference paper figure. Pick a reference figure, provide your data, and get an editable matplotlib script plus a camera-ready PDF. Highlights: - Reference-to-figure Drawer / Reviewer loop - Local Web UI for uploading data, browsing iterations, and refinement - Codex and Claude Code skill support - 139-figure gallery for starting from real paper-style examples - English and Chinese README - Contribution guide for showcase cases, prompt improvements, UI polish, and evaluation cases …在 GitHub 查看 ↗
常见问题
必须使用 Codex 或 Claude Code 吗?
--backend codex 或 --backend claude 选择其一。其他 OpenAI 兼容或本地代理后端仍属于路线图项目。需要 API 密钥或付费服务吗?
生成结果能否继续修改?
它会无限迭代直到完全匹配吗?
基准成绩是否可以立即完整复现?
FigMirror 用哪个端口?
FigMirror 官网是什么?
FigMirror 开源吗?
FigMirror 安全吗?
FigMirror 还在维护吗?
FigMirror 是谁开发的?
谢谢反馈,我们会据此改进页面。