/ 目錄 / 演練場 / paperbanana-skill
● 社群 PlutoLei ⚡ 即開即用

paperbanana-skill

作者 PlutoLei · PlutoLei/paperbanana-skill

從文字描述生成出版品質的學術圖表——架構圖、訓練曲線、系統示意圖——PaperBanana 風格。

一個封裝 PaperBanana 工作流程的 Claude Code skill,專為學術論文圖表設計。不再需要與 TikZ 或 Inkscape 搏鬥,只要描述圖表內容,即可輸出符合論文視覺規範的 SVG/PDF(乾淨的字體排版、一致的箭頭樣式、無彩虹色系)。

為什麼要用

核心特性

即時演示

實際使用效果

paperbanana-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "paperbanana-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PlutoLei/paperbanana-skill",
        "~/.claude/skills/paperbanana-skill"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "paperbanana-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PlutoLei/paperbanana-skill",
        "~/.claude/skills/paperbanana-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "paperbanana-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PlutoLei/paperbanana-skill",
        "~/.claude/skills/paperbanana-skill"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "paperbanana-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PlutoLei/paperbanana-skill",
        "~/.claude/skills/paperbanana-skill"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "paperbanana-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PlutoLei/paperbanana-skill",
        "~/.claude/skills/paperbanana-skill"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "paperbanana-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/PlutoLei/paperbanana-skill",
          "~/.claude/skills/paperbanana-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add paperbanana-skill -- git clone https://github.com/PlutoLei/paperbanana-skill ~/.claude/skills/paperbanana-skill

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: paperbanana-skill

為會議論文繪製模型架構圖

👤 ML 研究人員、正在寫論文的研究生 ⏱ ~30 min intermediate

何時使用: 距離截止日期還剩 5 天,卻還沒有一張乾淨的架構圖。

前置條件
  • Skill 已安裝 — git clone https://github.com/PlutoLei/paperbanana-skill ~/.claude/skills/paperbanana-skill
步驟
  1. 描述模型結構
    Use paperbanana-skill. Architecture figure: input → tokenizer → transformer stack (6 layers) → classifier head. Use the skill's default paper style.✓ 已複製
    → SVG 包含乾淨的方塊、箭頭與一致的字體排版
  2. 細節調整
    Label the transformer block internals — attention + FFN.✓ 已複製
    → 更新後的圖表加入子模組細節
  3. 匯出供 LaTeX 使用
    Export as PDF sized for a two-column paper.✓ 已複製
    → PDF 具有正確的長寬比

結果: 無需花一週時間使用 Inkscape,即可得到一張審稿人認可的圖表。

注意事項
  • 圖表裝飾過度 — 以克制為原則;一個強調色、黑色箭頭、保留充足留白
搭配使用: filesystem

將訓練日誌轉換為出版品質的圖表

👤 擁有 wandb/tensorboard 匯出資料的 ML 研究人員 ⏱ ~20 min beginner

何時使用: 手邊有訓練指標的 CSV 檔案,需要製作論文用圖表。

步驟
  1. 提供 CSV 資料
    Use paperbanana-skill. Plot loss and accuracy curves from training.csv in two-panel layout.✓ 已複製
    → 雙面板圖表,座標軸乾淨清晰
  2. 加入基準線
    Overlay the baseline model's curves (baseline.csv) as dashed.✓ 已複製
    → 以虛線疊加基準線並附上清晰圖例

結果: 一張符合論文整體美感的圖表。

維持論文中所有圖表的視覺一致性

👤 擁有 6 張以上風格不統一圖表的作者 ⏱ ~45 min intermediate

何時使用: 翻閱論文時發現每張圖表使用了不同的字體。

步驟
  1. 定義樣式
    Use paperbanana-skill. Create a shared style: 10pt sans-serif, #1f77b4 primary, black stroke 0.8pt.✓ 已複製
    → 樣式檔案已儲存
  2. 套用至所有圖表
    Regenerate figures 1-6 using this style.✓ 已複製
    → 批次輸出風格一致的圖表

結果: 所有圖表看起來都屬於同一篇論文。

搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

paperbanana-skill + filesystem

將圖表整理至論文的 /figures 目錄

Save all figures under paper/figures/ with source.svg + out.pdf per figure.✓ 已複製
paperbanana-skill + mermaid-skill

日常文件用 Mermaid,出版品質用 PaperBanana

Sketch in Mermaid for discussion; produce with PaperBanana for camera-ready.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
architecture_diagram description 系統架構圖 0
plot_curves data file, metrics 訓練/評估指標圖 0
apply_style style file, figures 跨圖表樣式一致性 0

成本與限制

運行它的成本

API 配額
None
每次呼叫 Token 數
Moderate
費用
Free
提示
樣式定義一次後,套用至所有圖表,避免重複決策。

安全

權限、密鑰、影響範圍

憑證儲存:
資料出站: None from skill

故障排查

常見錯誤與修復

Exported PDF has wrong font in LaTeX

嵌入字體或使用標準 PDF 字體系列;檢查 paperbanana 的匯出設定

SVG renders differently in browser vs LaTeX

LaTeX 使用 PDF 格式;網頁/簡報使用 SVG 格式

替代方案

paperbanana-skill 對比其他方案

替代方案何時用它替代權衡
TikZ / PGFPlots需要完整的 LaTeX 整合且熟悉 TikZ 語法學習曲線陡峭
mermaid-skill日常文件,非出版用途美觀程度不符合出版品質要求

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills