| name | paper-repo-create |
| description | 引导用户创建新的 GitHub 论文收集仓库(交互式向导) |
| metadata | {"openclaw":{"requires":{"bins":["uv","git","gh"]}}} |
创建论文仓库
引导用户创建一个新的 GitHub 论文收集仓库(如 awesome-xxx-papers)。
创建流程
你是一个论文仓库创建向导。按照以下步骤引导用户完成仓库创建:
第一步:收集信息
向用户询问以下信息(如果用户的消息中已包含部分信息,则跳过对应问题):
- 主题/领域:论文仓库的研究领域(如 "generative recommendation")
- 仓库名:GitHub 仓库名(如 "awesome-gr-papers"),默认从主题自动生成
- 标题:仓库标题(如 "Awesome Generative Recommendation Papers")
- 描述:一句话描述
- 分类:论文分类列表(如 Survey, Model Architecture, Semantic IDs, Others)
- 语言:README 语言(zh/en/both),默认 zh
- 关键词:搜索关键词(逗号分隔)
- 是否有本地论文:如果用户有已收集的本地 PDF 目录,可以导入
第二步:初始化仓库
确认信息后,执行以下命令:
export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-init.py \
--slug <slug> \
--title "<title>" \
--description "<description>" \
--language <language> \
--categories '<categories_json>' \
--keywords "<keywords>"
如果有本地论文目录,加上 --from-local <path>。
第二步半:从已有论文提取关键词(仅本地导入时)
如果用户使用了 --from-local 导入已有论文,运行关键词提取脚本分析论文标题:
export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-extract-keywords.py \
--repo-dir ~/.openclaw/workspace/paper-repos/<slug>
脚本会输出论文标题的分类统计、高频词汇和建议关键词。基于输出结果,结合你对该领域的理解,生成精准的搜索关键词并更新 keywords.md。
第三步:搜索初始论文
export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-collect.py \
--repo-dir ~/.openclaw/workspace/paper-repos/<slug> \
--limit 30
第四步:下载 PDF
export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-download.py \
--repo-dir ~/.openclaw/workspace/paper-repos/<slug> \
--git-dir ~/.openclaw/workspace/paper-repos/<slug>/git-repo \
--max-downloads 30 \
--proxy http://127.0.0.1:7890
第五步:生成 Banner 图片
export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 generate_image.py \
--prompt "Design a clean, modern GitHub repository banner for '<title>'. The banner should feature academic/research aesthetics with subtle paper/document icons. Use a professional color scheme. Size: 1280x640." \
--output ~/.openclaw/workspace/paper-repos/<slug>/git-repo/banner.png \
--proxy http://127.0.0.1:7890
第六步:生成 README
export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-readme.py \
--repo-dir ~/.openclaw/workspace/paper-repos/<slug> \
--git-dir ~/.openclaw/workspace/paper-repos/<slug>/git-repo \
--mode generate
第七步:创建 GitHub 仓库并推送
export PATH=$HOME/.local/bin:$PATH
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
cd ~/.openclaw/workspace/paper-repos/<slug>/git-repo
git init && git branch -m main
git lfs install --local
git add -A
git commit -m "Initial commit: <title>"
gh repo create <slug> --public --description "<description>" --source . --push
第八步:更新注册表
将 GitHub 仓库 URL 更新到 repos.json。
完成
向用户报告:
- 仓库 URL
- 论文数量
- 分类概况
- 提示用户可以通过
paper-repo-manage Skill 管理仓库