用途:对用户提供的 1 张或多张论文 Figure,输出一份“教会人类如何读图”的高可读性 Markdown 报告。
主要能力:将 Figure 转为 .jpg 用于视觉理解(转换失败则保留原图并显式说明);在 Figure 附近自动检索生成该图的源代码(可能找不到,找不到则为 NULL);综合三类信息——视觉理解、源代码理解(以代码为准,代码决定图的真实含义)、用户人工解读(帮助猜测关注点,可能有误)。报告含文件位置、源代码行号、图表核心含义、变量定义、解读要点、解释、科学价值等部分。
使用方式:在当前目录运行脚本,例如 python3 paper-explain-figures/scripts/paper_explain_figures.py --fig /abs/path/to/figure1.png --fig /abs/path/to/figure2.pdf --note "关注点/背景解释(可选)"。常用参数:--parallel 启用并行(默认串行,减少 API 限流风险)、--max-parallel 3 设并发上限(默认 3,也可改 config.yaml:defaults.max_parallel)、--runner codex 指定 runner(codex/claude/local)。为保证每张图解读相互独立,采用 worker 脚本在 shell 中启动独立进程,通过 codex exec 或 claude -p 执行。
输出:最终报告默认输出到当前工作目录 paper-explain-figures_report.md,每张图以 ## 级标题分隔;中间文件与日志落到 .bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/paper-explain-figures/。
限制:--runner shell 已禁用;全程只读访问用户的 Figure 与源代码,严禁修改;中间产物必须托管在上述隐藏目录内,运行时辅助文件也需重定向收纳其中;不得超出声明范围,不将未验证信息伪装成确定结论。若因本 skill 设计缺陷导致 bug,先用 bensz-collect-bugs 记录到 ~/.bensz-skills/bugs/,不直接修改已安装源码。