PaperBanana-CN

English · 简体中文

PaperBanana-CN 可根据研究描述生成方法示意图，并根据 CSV 或 JSON 数据生成统计图。它采用 PaperBanana 科学工作流，并新增独立的 VLM 和图像服务连接、中文 Studio 界面，以及明确的宽高比和分辨率控制。

从输入到图，一次运行即可完成

此录屏展示了从提交输入到完成结果的方法示意图生成过程。

开始之前

你需要安装 Python 3.10-3.12、uv 和桌面浏览器。

每个连接都可单独指定协议、Base URL、API 密钥、模型名称和超时时间。VLM 和图像生成可以使用同一服务，也可以使用两个不同的服务。

快速开始

1. 启动 Studio

uvx paperbanana-cn studio

打开 http://127.0.0.1:7860。uvx 会在隔离环境中运行软件包，不会修改 Debian 或 Ubuntu 的系统 Python。

2. 添加模型连接

打开 Settings → VLM connection，填写服务字段，然后选择 Save and use。生成方法示意图之前，请在 Image connection 下重复此操作。

编辑已保存的连接不会使其生效。API 密钥字段留空时会保留已存储的密钥。Studio 不会将已存储的密钥回填到浏览器。

3. 生成图

打开 Methodology diagram，输入方法内容和图注，然后选择宽高比、分辨率和输出格式。

使用 CLI 执行相同任务：

paperbanana-cn generate \
  --input method.txt \
  --caption "Overview of the proposed architecture" \
  --aspect-ratio 16:9 \
  --resolution 2K \
  --format png

PaperBanana-CN 的新增功能

分离 VLM 和图像连接

这两种模型角色分别拥有独立的协议、Base URL、API 密钥、模型和超时设置。 Studio、CLI 和 MCP 会解析相同的已保存连接。已保存的配置文件包含凭据引用；API 密钥不会存入代码库或运行元数据。

支持官方 API、OpenAI 兼容服务和 Gemini 兼容服务。各提供商的具体差异由适配器处理，不会影响科学工作流。

中英文 Studio

Studio 界面、帮助文本、验证信息、进度消息和错误信息均支持中文和英文。更改界面语言不会改写提示词、论文文本或生成图中的标签。

宽高比和分辨率

支持的宽高比：

1:1 · 4:3 · 3:2 · 5:4 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16

分辨率档位：

1K · 2K · 4K

Studio 会在生成前显示请求尺寸或提供商原生档位。如果适配器无法生成所选组合，验证会停止请求并报告不支持的选项。

Studio 工作流

_{方法论图示工作区}

_{使用合成演示数据的统计图工作区}

CLI、MCP、Docker 和 Colab

{
  "mcpServers": {
    "paperbanana-cn": {
      "command": "uvx",
      "args": ["paperbanana-cn", "mcp"]
    }
  }
}

docker run --rm -p 7860:7860 \
  -v paperbanana-cn-config:/home/paperbanana/.config/paperbanana-cn \
  -v paperbanana-cn-data:/home/paperbanana/.local/share/paperbanana-cn \
  -v paperbanana-cn-outputs:/work/outputs \
  ghcr.io/mituan-ai/paperbanana-cn:2.0.1 \
  studio --host 0.0.0.0

uv tool install paperbanana-cn
paperbanana-cn studio

git clone https://github.com/mituan-ai/PaperBanana-CN.git
cd PaperBanana-CN
uv sync
uv run paperbanana-cn studio

V2 在 main 分支上维护，发行包名为 paperbanana-cn，Python 模块名为 paperbanana_cn，命令名为 paperbanana-cn。

• 浏览冻结的 v1 分支
• 下载 v1.0.0 版本

科学图表生成核心基于 llmsresearch/paperbanana。PaperBanana-CN 是非官方社区实现，与上游作者无关，也未获得其认可。

社区

PaperBanana-CN 由 mituan 根据 MIT 许可证维护。

• 在 Discussions 中咨询使用问题。
• 在 Issues 中报告可复现的错误。
• 通过 Private Vulnerability Reporting 报告漏洞。
• 提交拉取请求前，请阅读 CONTRIBUTING.md。

git clone https://github.com/mituan-ai/PaperBanana-CN.git
cd PaperBanana-CN
uv sync --extra dev
uv run pytest tests/ -q
uv run ruff check paperbanana_cn/ mcp_server/ tests/ scripts/

星标历史