Research Paper Portal#

为研究人员快速构建个性化的学术论文导航网站。

功能特性#

• 论文自动收集：从 OpenAlex、arXiv、RSS 等源获取最新论文
• AI 背景图生成：使用 Flux2 为每篇论文生成独特背景
• 渐进式图片加载：WebP 格式，预览图→高清图过渡
• 论文数据管理：队列机制、定时发布
• 响应式设计：支持桌面和移动端

快速开始#

第一步：了解用户需求#

在开始部署前，询问用户以下信息：

text

请提供以下配置信息：

1. 研究领域（关键词）
   - 例如：thermoelectric, heat pipe, geothermal
   - 或：machine learning, computer vision
   - 或：cancer research, immunotherapy

2. 网站名称
   - 例如：Thermoelectric.Tech

3. 大语言模型（LLM）资源
   - 推荐：Gemini CLI（免费）或 Claude API
   - 用途：论文摘要翻译、标题生成

4. 绘图模型资源
   - 推荐：ComfyUI + Flux2
   - 服务器地址：例如 http://192.168.1.100:8188

5. Web 服务器
   - 推荐：Caddy（自动 HTTPS）
   - 或：Nginx、Apache

第二步：部署网站#

1. 复制网站模板到用户的服务器目录
2. 配置 Web 服务器
3. 设置定时任务

第三步：配置工作流#

创建配置文件 config.json：

json

{
  "siteName": "YourResearch.Tech",
  "keywords": ["keyword1", "keyword2"],
  "paperSources": {
    "openalex": true,
    "arxiv": true,
    "rss": []
  },
  "llm": {
    "provider": "gemini",
    "command": "gemini -p"
  },
  "imageGeneration": {
    "comfyui_url": "http://YOUR_SERVER:8188",
    "workflow": "flux2_text_to_image"
  },
  "publishSchedule": {
    "updatePapers": "05:00",
    "publishSite": "08:00"
  }
}

工作流程#

text

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  论文收集脚本    │ ──▶ │   发布队列       │ ──▶ │   定时发布      │
│ (每日凌晨运行)  │     │ (待发布论文+图片) │     │  (每日早晨)     │
└─────────────────┘     └──────────────────┘     └─────────────────┘
        │                        │
        ▼                        ▼
  ┌───────────┐            ┌───────────┐
  │ LLM 翻译  │            │ AI 生成图  │
  │ 标题+摘要 │            │ 背景图片   │
  └───────────┘            └───────────┘

资源说明#

assets/#

• index.html - 网站主页面模板
• admin.html - 管理后台模板

scripts/#

• update-papers.py - 论文收集脚本
• generate-bg.py - AI 背景图生成
• convert-images.py - 图片格式转换
• daily-publish.py - 每日发布脚本

references/#

• CONFIG.md - 详细配置说明
• API.md - OpenAlex/arXiv API 使用说明
• COMFYUI.md - ComfyUI Flux2 工作流说明

定时任务配置#

使用 OpenClaw cron 或系统 crontab：

bash

# OpenClaw cron
openclaw cron add --name "论文更新" --schedule "0 5 * * *" --script "update-papers.py"
openclaw cron add --name "网站发布" --schedule "0 8 * * *" --script "daily-publish.py"

# 或系统 crontab
0 5 * * * python /path/to/update-papers.py
0 8 * * * python /path/to/daily-publish.py

注意事项#

1. API 限制：OpenAlex 免费无限制，arXiv 建议每 3 秒一次请求
2. 图片存储：建议每张预览图 <50KB，高清图 <200KB
3. 论文数量：建议每日发布 3-5 篇，保证质量
4. 备份：定期备份 paper-index.json 和 pending-papers.json

故障排除#

问题解决方案论文数据为空检查关键词拼写，确认 API 可访问图片生成失败检查 ComfyUI 服务状态，确认模型已加载网站无法访问检查 Web 服务器配置，确认端口开放中文显示乱码确认文件 UTF-8 编码，检查 Content-Type