Skip to content
Back to search

academic-figure-generator

AI 驱动的学术论文配图生成平台。上传论文 → AI 分析内容生成 Prompt → 一键生成高质量科研配图,还有配套的skill可在主流agent中使用

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ligphidonk--academic-figure-generator/badge.svg)](/listings/ligphidonk--academic-figure-generator)

HTML

<a href="/listings/ligphidonk--academic-figure-generator"><img src="/api/listings/ligphidonk--academic-figure-generator/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 295 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="./logo.png" alt="Academic Figure Generator Logo" width="220" />
  3. </p>
  4. # Academic Figure Generator
  5. ![Python](https://img.shields.io/badge/Python-3.12+-3776AB?logo=python&logoColor=white)
  6. ![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-009688?logo=fastapi&logoColor=white)
  7. ![React](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=black)
  8. [![License](https://img.shields.io/badge/License-MIT-green)](./LICENSE)
  9. AI 驱动的学术论文配图生成工具(个人本地版)。上传论文 → AI 分析内容生成 Prompt → 一键生成高质量科研配图。
  10. > **一句话**:把"写完论文还要画图"的痛点,变成「上传 → 确认 → 下载」三步流程。
  11. ## 示例配图
  12. 以下均为本平台实际生成的学术配图示例:
  13. <table>
  14. <tr>
  15. <td align="center" width="50%">
  16. <img src="docs/images/example-architecture.png" alt="网络架构图示例" />
  17. <br/><sub><b>PMST 预测网络架构图</b></sub>
  18. </td>
  19. <td align="center" width="50%">
  20. <img src="docs/images/example-signal.png" alt="信号处理流程图示例" />
  21. <br/><sub><b>时频域信号处理流程图</b></sub>
  22. </td>
  23. </tr>
  24. <tr>
  25. <td align="center" width="50%">
  26. <img src="docs/images/example-network.png" alt="深度学习模块详图示例" />
  27. <br/><sub><b>深度学习模块详解图</b></sub>
  28. </td>
  29. <td align="center" width="50%">
  30. <img src="docs/images/example-anatomy.png" alt="带标注的解剖图示例" />
  31. <br/><sub><b>带标注的解剖结构图</b></sub>
  32. </td>
  33. </tr>
  34. </table>
  35. ## 功能特性
  36. | 功能 | 说明 |
  37. |------|------|
  38. | 🤖 **智能 Prompt 生成** | 上传 PDF/DOCX/TXT 论文,Claude AI 自动分析内容并生成配图描述 |
  39. | 🖼️ **高质量配图** | 支持 1K/2K/4K 多分辨率,16:9/4:3/1:1 等多种比例 |
  40. | 🎨 **配色方案** | 50+ 预设学术配色(含色盲友好方案),支持自定义配色 |
  41. | ✏️ **图生图编辑** | 基于已有图片 + 文字指令进行二次编辑 |
  42. | ⚡ **实时状态** | SSE 流式推送生成进度,无需手动刷新 |
  43. | 📁 **项目管理** | 按项目组织论文、Prompt 和配图 |
  44. ## 技术栈
  45. | 层级 | 技术 |
  46. |------|------|
  47. | 后端 | FastAPI · SQLAlchemy (Async) · Python 3.12+ |
  48. | 前端 | React 19 · TypeScript · Vite · Tailwind CSS · Radix UI |
  49. | 数据库 | SQLite (自动创建,零配置) |
  50. | 存储 | 本地文件系统 (`backend/data/`) |
  51. | AI (Prompt) | Claude Agent SDK (`claude-agent-sdk`) |
  52. | AI (配图) | NanoBanana / Gemini API |
  53. ## 项目结构
  54. ```
  55. academic-figure-generator/
  56. ├── backend/ # FastAPI 后端
  57. │ ├── app/
  58. │ │ ├── api/v1/ # API 路由 (projects, documents, prompts, images, color_schemes)
  59. │ │ ├── models/ # SQLAlchemy ORM 模型 (SQLite)
  60. │ │ ├── schemas/ # Pydantic 请求/响应 Schema
  61. │ │ ├── services/ # 业务逻辑层
  62. │ │ │ ├── claude_code_service.py # Claude Agent SDK 集成
  63. │ │ │ ├── local_storage_service.py # 本地文件存储
  64. │ │ │ ├── image_service.py # NanoBanana 图片生成
  65. │ │ │ ├── document_service.py # PDF/DOCX/TXT 解析
  66. │ │ │ └── prompt_service.py # Prompt CRUD
  67. │ │ ├── core/ # 中间件、异常处理、Prompt 模板/配色
  68. │ │ ├── config.py # 环境变量配置
  69. │ │ └── main.py # FastAPI 应用工厂
  70. │ ├── data/ # 运行时数据 (SQLite DB, 上传文件, 生成图片)
  71. │ └── pyproject.toml
  72. ├── frontend/ # React SPA 前端
  73. │ ├── src/
  74. │ │ ├── pages/ # 页面组件 (Projects, ProjectWorkspace, Generate, ColorSchemes, Settings)
  75. │ │ ├── components/ui/ # Radix UI 组件库
  76. │ │ ├── store/ # Zustand 状态管理
  77. │ │ └── lib/ # API 客户端
  78. │ ├── package.json
  79. │ └── vite.config.ts
  80. ├── academic-figure-prompt/ # AI Coding Agent Skill (SKILL.md)
  81. ├── .env # 环境变量
  82. └── README.md
  83. ```
  84. ## 快速开始
  85. ### 前置要求
  86. - **Python 3.12+**
  87. - **Node.js 18+**
  88. - **Claude Agent SDK**:本机已安装 Claude Code CLI 并登录
  89. - **API Key**:NanoBanana / Gemini 图片生成 API Key
  90. ### 1. 克隆仓库
  91. ```bash
  92. git clone https://github.com/LigphiDonk/academic-figure-generator.git
  93. cd academic-figure-generator
  94. ```
  95. ### 2. 配置环境变量
  96. 编辑项目根目录的 `.env` 文件:
  97. ```bash
  98. # Claude Agent SDK (用于 Prompt 生成)
  99. ANTHROPIC_API_KEY=your-anthropic-api-key
  100. # NanoBanana / Gemini API (用于图片生成)
  101. NANOBANANA_API_KEY=your-nanobanana-api-key
  102. NANOBANANA_API_BASE=https://api.keepgo.icu
  103. NANOBANANA_MODEL=gemini-3-pro-image-preview
  104. ```
  105. ### 3. 启动后端
  106. ```bash
  107. cd backend
  108. # 创建虚拟环境 (推荐)
  109. python -m venv .venv
  110. source .venv/bin/activate # macOS/Linux
  111. # 安装依赖
  112. pip install -e .
  113. # 启动开发服务器
  114. uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
  115. ```
  116. 首次启动时会自动创建 SQLite 数据库 (`backend/data/app.db`) 和数据目录。
  117. ### 4. 启动前端
  118. ```bash
  119. cd frontend
  120. npm install
  121. npm run dev
  122. ```
  123. ### 5. 访问
  124. | 服务 | 地址 |
  125. |------|------|
  126. | 应用首页 | http://localhost:5173 |
  127. | API 文档 (Swagger) | http://localhost:8000/docs |
  128. ## 使用流程
  129. ### 核心工作流
  130. ```
  131. 上传论文 (PDF/DOCX/TXT)
  132. │
  133. ▼
  134. 后端解析 → 提取文本和章节结构
  135. │
  136. ▼
  137. Claude Agent SDK → 分析论文 → 生成配图 Prompt
  138. │
  139. ▼
  140. 确认/编辑 Prompt → 选择分辨率和比例
  141. │
  142. ▼
  143. NanoBanana API → 生成高质量配图
  144. │
  145. ▼
  146. 下载图片 / 图生图编辑
  147. ```
  148. ### 快捷生成
  149. 除了项目工作流,还支持**快捷生成**模式:直接输入 Prompt 文本,跳过论文上传步骤,快速生成配图。
  150. ## 架构概览
  151. ```
  152. 浏览器 (React SPA)
  153. │
  154. ▼
  155. FastAPI 后端 (localhost:8000)
  156. │
  157. ├── SQLite (项目、文档、Prompt、图片元数据)
  158. ├── 本地文件系统 (上传文件、生成图片)
  159. │
  160. ├── Claude Agent SDK → Prompt 生成 (同步)
  161. └── NanoBanana API → 图片生成 (异步后台任务)
  162. ```
  163. ## 环境变量参考
  164. | 变量 | 必填 | 默认值 | 说明 |
  165. |------|------|--------|------|
  166. | `ANTHROPIC_API_KEY` | 是 | — | Claude Agent SDK API Key |
  167. | `NANOBANANA_API_KEY` | 是 | — | NanoBanana / Gemini API Key |
  168. | `NANOBANANA_API_BASE` | 否 | `https://api.keepgo.icu` | NanoBanana API 地址 |
  169. | `NANOBANANA_MODEL` | 否 | `gemini-3-pro-image-preview` | 图片生成模型 |
  170. | `DATABASE_PATH` | 否 | `./data/app.db` | SQLite 数据库路径 |
  171. | `DATA_DIR` | 否 | `./data` | 数据存储目录 |
  172. | `DEBUG` | 否 | `true` | 调试模式 (启用 API 文档) |
  173. | `CORS_ORIGINS` | 否 | `["http://localhost:3000","http://localhost:5173"]` | CORS 允许来源 |
  174. | `MAX_UPLOAD_SIZE_MB` | 否 | `50` | 最大上传文件大小 (MB) |
  175. ## AI 学术配图 Prompt 技能(AI Coding Agent Skill)
  176. 本项目附带了一个独立的 **AI Coding Agent Skill**——`academic-figure-prompt`,兼容多种 AI 编程助手(Claude Code / Gemini CLI / Cursor 等),无需部署完整平台即可获得顶会级学术论文配图提示词生成能力。
  177. ### 功能简介
  178. `academic-figure-prompt` 是一个专为学术论文设计的 AI 提示词生成器,能够:
  179. - 📄 阅读并分析论文内容(PDF / LaTeX / Word)
  180. - 🎨 提供 **8 种预设学术配色方案**(Okabe-Ito、Blue 单色系、Teal+Amber 等),含色盲友好选项
  181. - 🖼️ 生成极其详细的英文提示词,用于 AI 图片工具生成顶会级别的专业配图
  182. - 📐 覆盖多种图表类型:框架图、网络架构图、模块详解图、对比/消融图、数据模板图
  183. ### 安装方式
  184. #### 方式 1:使用 npx skills 一键安装(推荐)
  185. ```bash
  186. npx skills add LigphiDonk/academic-figure-generator
  187. ```
  188. #### 方式 2:手动安装
  189. ```bash
  190. git clone https://github.com/LigphiDonk/academic-figure-generator.git
  191. # Gemini CLI
  192. cp -r academic-figure-generator/academic-figure-prompt .gemini/skills/
  193. # Claude Code
  194. cp -r academic-figure-generator/academic-figure-prompt .claude/skills/
  195. ```
  196. ### 使用方法
  197. 安装后,在 AI 编程助手对话中直接触发即可:
  198. ```
  199. You: 帮我看一下这篇论文,生成论文配图提示词
  200. AI: [分析论文内容 → 展示配色方案选择 → 生成详细英文提示词]
  201. You: 用 Teal+Amber 配色,帮我画一个网络架构图的提示词
  202. AI: [直接使用方案C生成网络架构图提示词]
  203. ```
  204. ## 开发指南
  205. ### 后端开发
  206. ```bash
  207. cd backend
  208. source .venv/bin/activate
  209. # 运行测试
  210. pytest -v
  211. # 代码检查
  212. ruff check app/
  213. ruff format app/
  214. ```
  215. ### 前端开发
  216. ```bash
  217. cd frontend
  218. npm run dev # 启动开发服务器 (localhost:5173)
  219. npm run build # 生产构建
  220. npm run lint # ESLint 检查
  221. ```
  222. 前端开发服务器会自动将 `/api` 请求代理到 `localhost:8000`。
  223. ## 致谢
  224. 感谢 [Linux DO](https://linux.do/) 社区的支持与帮助 🙏
  225. ## 许可证
  226. 本项目基于 [MIT License](./LICENSE) 开源。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.