---

source: "https://github.com/huggingface/skills/tree/main/skills/huggingface-paper-publisher" name: hugging-face-paper-publisher description: 在Hugging Face Hub上发布和管理研究论文。支持创建论文页面、将论文链接到模型/数据集、认领作者身份，以及生成专业的基于Markdown的研究文章。 risk: unknown

概述

何时使用

当用户想要在Hugging Face Hub上发布、链接、索引或管理研究论文时使用此技能。 此技能为AI工程师和研究人员提供全面的工具，用于在Hugging Face Hub上发布、管理和链接研究论文。它简化了从论文创建到发布的工作流程，包括与arXiv的集成、模型/数据集链接和作者身份管理。

与HF生态系统的集成

• 论文页面：在Hugging Face Hub上索引和发现论文
• arXiv集成：从arXiv ID自动索引论文
• 模型/数据集链接：通过元数据将论文连接到相关工件
• 作者身份验证：认领和验证论文作者身份
• 研究文章模板：生成专业、现代的科学论文

版本

1.0.0

依赖

包含的脚本使用PEP 723内联依赖。优先使用 uv run 而非手动环境设置。

• huggingface_hub>=0.26.0
• pyyaml>=6.0.3
• requests>=2.32.5
• markdown>=3.5.0
• python-dotenv>=1.2.1

核心能力

1. 论文页面管理

• 索引论文：从arXiv将论文添加到Hugging Face
• 认领作者身份：验证并认领已发布论文的作者身份
• 管理可见性：控制哪些论文出现在你的个人资料中
• 论文发现：在HF生态系统中查找和探索论文

2. 将论文链接到工件

• 模型卡片：向模型元数据添加论文引用
• 数据集卡片：通过README将论文链接到数据集
• 自动标记：Hub自动生成 arxiv:<PAPER_ID> 标签
• 引用管理：维护正确的归属和参考文献

3. 研究文章创建

• Markdown模板：生成专业的论文格式
• 现代设计：简洁、可读的研究文章布局
• 动态目录：自动生成目录
• 章节结构：标准科学论文组织
• LaTeX数学：支持公式和技术符号

4. 元数据管理

• YAML前置信息：正确的模型/数据集卡片元数据
• 引用追踪：跨仓库维护论文引用
• 版本控制：追踪论文更新和修订
• 多论文支持：将多篇论文链接到单个工件

使用说明

此技能在 scripts/ 中包含用于论文发布操作的Python脚本。

前置条件

• 使用 uv run 运行脚本（依赖从脚本头部解析）
• 设置 HF_TOKEN 环境变量，使用具有写入权限的令牌

所有路径相对于包含此SKILL.md文件的目录。 在运行任何脚本之前，先 cd 到该目录或使用完整路径。

方法1：从arXiv索引论文

从arXiv将论文添加到Hugging Face论文页面。

基本用法：

uv run scripts/paper_manager.py index \
  --arxiv-id "2301.12345"

检查论文是否存在：

uv run scripts/paper_manager.py check \
  --arxiv-id "2301.12345"

直接URL访问： 你也可以直接访问 https://huggingface.co/papers/{arxiv-id} 来索引论文。

方法2：将论文链接到模型/数据集

使用正确的YAML元数据向模型或数据集README添加论文引用。

添加到模型卡片：

uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-id "2301.12345"

添加到数据集卡片：

uv run scripts/paper_manager.py link \
  --repo-id "username/dataset-name" \
  --repo-type "dataset" \
  --arxiv-id "2301.12345"

添加多篇论文：

uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-ids "2301.12345,2302.67890,2303.11111"

使用自定义引用：

uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-id "2301.12345" \
  --citation "$(cat citation.txt)"

链接工作原理

当你向模型或数据集README添加arXiv论文链接时：

1. Hub从链接中提取arXiv ID
2. 标签 arxiv:<PAPER_ID> 自动添加到仓库
3. 用户可以点击标签查看论文页面
4. 论文页面显示所有引用此论文的模型/数据集
5. 论文可通过过滤器和搜索发现

方法3：认领作者身份

验证你在Hugging Face上发布的论文的作者身份。

开始认领流程：

uv run scripts/paper_manager.py claim \
  --arxiv-id "2301.12345" \
  --email "your.email@institution.edu"

手动流程：

1. 导航到你的论文页面：https://huggingface.co/papers/{arxiv-id}
2. 点击"认领作者身份"
3. 使用论文中列出的邮箱验证
4. 论文将出现在你的HF个人资料中