---

💡 我们想做的事

论文里那张让你眼前一亮的图，背后往往是某个作者熬到凌晨两点才调出来的。我们觉得，这些用心做的图谱，不该只属于一篇论文。

所以我们做了 PaperPlotHub —— 一个面向所有研究者的图表分享空间。在这里：

• 🤝 你可以分享自己曾经画过、自己骄傲的论文图，连同那段调好的脚本，留给后来人参考。
• 🛠️ 我们也会持续复现一些高质量论文里值得一看的图表，把脚本附上，放进这个画廊。
• 🌱 想画图的同学可以从这些模板里找灵感、复用配色和排版，把精力留给自己的想法和实验，而不是跟 matplotlib 的某个边角参数较劲。

我们的初衷很简单：把"这张图怎么画"的时间还给"我到底想说什么"的思考，让大家能更顺利地把论文写完。 ✍️📈

---

🌍 画廊里有什么

每条提交是三件套并排，方便你把"论文里发表的那张"和"在你笔记本上跑出来的那张"对照着看。

🖼️ 论文原图	✅ 复现图	🐍 脚本
从论文里截下来的小图	用脚本本地跑出来的图	独立、可复制、能跑

…再加上 arXiv 链接、图表类型标签（bar / line / heatmap / radar / …）、风格标签、中英双语描述。

每条提交在公开前会过一遍轻量 AI 审核：静态安全扫描、arXiv 元数据抓取、视觉 LLM 校验渲染图确实来自这段脚本。我们的标准是 "这对其他人有用吗？"，而不是 "是否像素级还原论文里那张图？"。 🛡️

---

🚀 怎么用这个网站

👀 当访客（不用登录）

想干啥	去哪儿
🏠 浏览最新画廊	/
🗂️ 按图表类型筛选	/c/bar、/c/line、/c/heatmap……
🔬 看原图 vs 复现图并排	/p/[slug]
📋 复制脚本	详情页绿色 copy 按钮
💾 下载渲染好的 PNG	图片下方 download 链接
🌗 切换亮 / 暗 / 跟随系统	顶部导航栏的主题按钮

💁 整个画廊免费看、免费用。如果一段脚本帮你省了一个小时，那就是它存在的意义。

✍️ 当贡献者

按你手头有什么，三种贡献方式都同样欢迎 —— 每一条都在帮别人画得更快。

模式	你要传啥	什么时候用
FULL 🟢	论文原图 + 复现图 + 脚本	默认款。你看上了一张论文图，自己复现了，脚本也整理过了。
REPRO_ONLY 🔵	复现图 + 脚本	你跑了自己的实验、自己的图、自己的脚本，引用了某篇论文的设定。
PAPER_ONLY 🟠	仅论文原图	你看到一张值得复现的图，但暂时没空动手。把它丢上来挂个 🎯 reproduction wanted，让社区里的人接力。

怎么贡献：

1. 🔑 在 /login 用 GitHub 登录。
2. ⬆️ 进 /upload，先选模式，粘 arXiv 链接或 ID。
3. 📎 按所选模式补齐文件。
4. 🤖 AI 流水线审核。置信度高（≥ 0.85）的自动公开；其余进入人工二审队列。
5. 📈 在 /me 看状态；标题 / 标签 / 描述随时可以在 /me/edit/[slug] 微调。

🛡️ 安全说明： 任何尝试调 eval / exec、走外网、或夹带可识别 API key 的脚本会在人看到之前自动拒收。本站永远不会执行上传的脚本 —— 你的脚本是给人看的，渲染图是你自己提供的，仅此而已。

---

🤖 给 AI Agent 用

现在很多图本来就是 Agent 帮忙画的，所以我们做了两套协议，让 Agent 不用离开对话就能把成果分享回社区。

1. 🛰️ MCP server —— 直接接进 Claude Desktop / Cursor 等任何支持 MCP 的宿主。
2. 🌐 REST API —— Bearer token、multipart/form-data，对 curl 和 CI 友好。

🪄 1 分钟接入

1. 打开 https://paperplothub.tech/me/tokens
2. 点 "+ create token"，起个名比如 "claude-desktop"
3. 复制 pph_… 这串 token（只显示一次，请像 SSH key 一样保存好）
4. 通过环境变量 PPH_API_TOKEN 交给你的 Agent

这一个 token 就足以让 Agent：

• 🔍 列出你已有的提交
• ⬆️ 用三种模式中的任意一种新增提交
• 🪪 校验身份（whoami）
• 🚪 在同一页面随时撤销

🛰️ MCP server

paperplothub-mcp 走 stdio transport，注册了下面这些工具。把这一段直接喂给 Claude / Cursor / Codex，它就知道怎么干活。

工具	作用
🪪 pph_whoami	校验 token，返回 GitHub login + 角色
📋 pph_list_my_uploads	按 status / mode 过滤列出自己的提交
📤 pph_upload_full	上传 FULL 模式（原图 + 复现图 + 脚本）
📤 pph_upload_repro	上传 REPRO_ONLY（仅复现图 + 脚本）
📤 pph_upload_paper	上传 PAPER_ONLY（仅原图，求社区复现）

Claude Desktop / Cursor 配置示例：

{
  "mcpServers": {
    "paperplothub": {
      "command": "npx",
      "args": ["-y", "paperplothub-mcp"],
      "env": {
        "PPH_API_TOKEN": "pph_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "PPH_API_BASE_URL": "https://paperplothub.tech"
      }
    }
  }
}

💬 推荐的 system prompt

*"你可以使用 paperplothub MCP server。当用户写完一个绘图脚本想分享时，收集（a）论文原图（如果有）、（b）渲染好的输出 PNG、（c）脚本文件、（d）所引用论文的 arXiv ID 或 URL，然后调用对应的 pph_upload_* 工具。如果用户只有一张论文里的图、想让社区帮忙复现，那就用 `pph_up

... View full README on GitHub