hugging-face-paper-publisher

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Overview

概述

This skill provides comprehensive tools for AI engineers and researchers to publish, manage, and link research papers on the Hugging Face Hub. It streamlines the workflow from paper creation to publication, including integration with arXiv, model/dataset linking, and authorship management.
本技能为AI工程师和研究人员提供了在Hugging Face Hub上发布、管理和关联研究论文的全面工具。它简化了从论文创建到发布的工作流程,包括与arXiv的集成、模型/数据集关联以及作者身份管理。

Integration with HF Ecosystem

与HF生态系统集成

  • Paper Pages: Index and discover papers on Hugging Face Hub
  • arXiv Integration: Automatic paper indexing from arXiv IDs
  • Model/Dataset Linking: Connect papers to relevant artifacts through metadata
  • Authorship Verification: Claim and verify paper authorship
  • Research Article Template: Generate professional, modern scientific papers
  • 论文页面:在Hugging Face Hub上索引和发现论文
  • arXiv集成:通过arXiv ID自动索引论文
  • 模型/数据集关联:通过元数据将论文与相关工件连接
  • 作者身份验证:认领并验证论文作者身份
  • 研究文章模板:生成专业、现代化的科学论文

Version

版本

1.0.0
1.0.0

Dependencies

依赖项

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

Core Capabilities

核心功能

1. Paper Page Management

1. 论文页面管理

  • Index Papers: Add papers to Hugging Face from arXiv
  • Claim Authorship: Verify and claim authorship on published papers
  • Manage Visibility: Control which papers appear on your profile
  • Paper Discovery: Find and explore papers in the HF ecosystem
  • 索引论文:从arXiv将论文添加到Hugging Face
  • 认领作者身份:验证并认领已发表论文的作者身份
  • 管理可见性:控制哪些论文显示在你的个人资料中
  • 论文发现:在HF生态系统中查找和浏览论文

2. Link Papers to Artifacts

2. 将论文与工件关联

  • Model Cards: Add paper citations to model metadata
  • Dataset Cards: Link papers to datasets via README
  • Automatic Tagging: Hub auto-generates arxiv:<PAPER_ID> tags
  • Citation Management: Maintain proper attribution and references
  • 模型卡片:在模型元数据中添加论文引用
  • 数据集卡片:通过README将论文与数据集关联
  • 自动标记:Hub自动生成arxiv:<PAPER_ID>标签
  • 引用管理:维护正确的归属和参考文献

3. Research Article Creation

3. 研究文章创建

  • Markdown Templates: Generate professional paper formatting
  • Modern Design: Clean, readable research article layouts
  • Dynamic TOC: Automatic table of contents generation
  • Section Structure: Standard scientific paper organization
  • LaTeX Math: Support for equations and technical notation
  • Markdown模板:生成专业的论文格式
  • 现代化设计:简洁、易读的研究文章布局
  • 动态目录:自动生成目录
  • 章节结构:标准科学论文组织结构
  • LaTeX公式:支持公式和技术符号

4. Metadata Management

4. 元数据管理

  • YAML Frontmatter: Proper model/dataset card metadata
  • Citation Tracking: Maintain paper references across repositories
  • Version Control: Track paper updates and revisions
  • Multi-Paper Support: Link multiple papers to single artifacts
  • YAML前置元数据:规范的模型/数据集卡片元数据
  • 引用跟踪:在仓库间维护论文参考文献
  • 版本控制:跟踪论文的更新和修订
  • 多论文支持:将多篇论文关联到单个工件

Usage Instructions

使用说明

The skill includes Python scripts in
scripts/
for paper publishing operations.
本技能在
scripts/
目录中包含用于论文发布操作的Python脚本。

Prerequisites

前提条件

  • Install dependencies:
    uv add huggingface_hub pyyaml requests markdown python-dotenv
  • Set
    HF_TOKEN
    environment variable with Write-access token
  • Activate virtual environment:
    source .venv/bin/activate
All paths are relative to the directory containing this SKILL.md file. Before running any script, first
cd
to that directory or use the full path.
  • 安装依赖项:
    uv add huggingface_hub pyyaml requests markdown python-dotenv
  • 设置
    HF_TOKEN
    环境变量,使用具有写入权限的令牌
  • 激活虚拟环境:
    source .venv/bin/activate
所有路径均相对于包含此SKILL.md文件的目录。 在运行任何脚本之前,请先
cd
到该目录或使用完整路径。

Method 1: Index Paper from arXiv

方法1:从arXiv索引论文

Add a paper to Hugging Face Paper Pages from arXiv.
Basic Usage:
bash
uv run scripts/paper_manager.py index \
  --arxiv-id "2301.12345"
Check If Paper Exists:
bash
uv run scripts/paper_manager.py check \
  --arxiv-id "2301.12345"
Direct URL Access: You can also visit
https://huggingface.co/papers/{arxiv-id}
directly to index a paper.
将论文从arXiv添加到Hugging Face论文页面。
基本用法:
bash
uv run scripts/paper_manager.py index \
  --arxiv-id "2301.12345"
检查论文是否存在:
bash
uv run scripts/paper_manager.py check \
  --arxiv-id "2301.12345"
直接URL访问: 你也可以直接访问
https://huggingface.co/papers/{arxiv-id}
来索引论文。

Method 2: Link Paper to Model/Dataset

方法2:将论文与模型/数据集关联

Add paper references to model or dataset README with proper YAML metadata.
Add to Model Card:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-id "2301.12345"
Add to Dataset Card:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/dataset-name" \
  --repo-type "dataset" \
  --arxiv-id "2301.12345"
Add Multiple Papers:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-ids "2301.12345,2302.67890,2303.11111"
With Custom Citation:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-id "2301.12345" \
  --citation "$(cat citation.txt)"
在模型或数据集的README中添加论文引用,并附带规范的YAML元数据。
添加到模型卡片:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-id "2301.12345"
添加到数据集卡片:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/dataset-name" \
  --repo-type "dataset" \
  --arxiv-id "2301.12345"
添加多篇论文:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-ids "2301.12345,2302.67890,2303.11111"
自定义引用:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/model-name" \
  --repo-type "model" \
  --arxiv-id "2301.12345" \
  --citation "$(cat citation.txt)"

How Linking Works

关联机制说明

When you add an arXiv paper link to a model or dataset README:
  1. The Hub extracts the arXiv ID from the link
  2. A tag
    arxiv:<PAPER_ID>
    is automatically added to the repository
  3. Users can click the tag to view the Paper Page
  4. The Paper Page shows all models/datasets citing this paper
  5. Papers are discoverable through filters and search
当你在模型或数据集的README中添加arXiv论文链接时:
  1. Hub会从链接中提取arXiv ID
  2. 仓库会自动添加
    arxiv:<PAPER_ID>
    标签
  3. 用户可以点击标签查看论文页面
  4. 论文页面会显示所有引用该论文的模型/数据集
  5. 论文可通过筛选器和搜索功能被发现

Method 3: Claim Authorship

方法3:认领作者身份

Verify your authorship on papers published on Hugging Face.
Start Claim Process:
bash
uv run scripts/paper_manager.py claim \
  --arxiv-id "2301.12345" \
  --email "your.email@institution.edu"
Manual Process:
  1. Navigate to your paper's page:
    https://huggingface.co/papers/{arxiv-id}
  2. Find your name in the author list
  3. Click your name and select "Claim authorship"
  4. Wait for admin team verification
Check Authorship Status:
bash
uv run scripts/paper_manager.py check-authorship \
  --arxiv-id "2301.12345"
验证你在Hugging Face上发表的论文的作者身份。
启动认领流程:
bash
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. 等待管理员团队验证
检查作者身份状态:
bash
uv run scripts/paper_manager.py check-authorship \
  --arxiv-id "2301.12345"

Method 4: Manage Paper Visibility

方法4:管理论文可见性

Control which verified papers appear on your public profile.
List Your Papers:
bash
uv run scripts/paper_manager.py list-my-papers
Toggle Visibility:
bash
uv run scripts/paper_manager.py toggle-visibility \
  --arxiv-id "2301.12345" \
  --show true
Manage in Settings: Navigate to your account settings → Papers section to toggle "Show on profile" for each paper.
控制哪些已验证的论文显示在你的公开个人资料中。
列出你的论文:
bash
uv run scripts/paper_manager.py list-my-papers
切换可见性:
bash
uv run scripts/paper_manager.py toggle-visibility \
  --arxiv-id "2301.12345" \
  --show true
在设置中管理: 导航到你的账户设置 → 论文部分,为每篇论文切换“在个人资料中显示”选项。

Method 5: Create Research Article

方法5:创建研究文章

Generate a professional markdown-based research paper using modern templates.
Create from Template:
bash
uv run scripts/paper_manager.py create \
  --template "standard" \
  --title "Your Paper Title" \
  --output "paper.md"
Available Templates:
  • standard
    - Traditional scientific paper structure
  • modern
    - Clean, web-friendly format inspired by Distill
  • arxiv
    - arXiv-style formatting
  • ml-report
    - Machine learning experiment report
Generate Complete Paper:
bash
uv run scripts/paper_manager.py create \
  --template "modern" \
  --title "Fine-Tuning Large Language Models with LoRA" \
  --authors "Jane Doe, John Smith" \
  --abstract "$(cat abstract.txt)" \
  --output "paper.md"
Convert to HTML:
bash
uv run scripts/paper_manager.py convert \
  --input "paper.md" \
  --output "paper.html" \
  --style "modern"
使用现代化模板生成基于Markdown的专业研究论文。
从模板创建:
bash
uv run scripts/paper_manager.py create \
  --template "standard" \
  --title "Your Paper Title" \
  --output "paper.md"
可用模板:
  • standard
    - 传统科学论文结构
  • modern
    - 受Distill启发的简洁、网页友好格式
  • arxiv
    - arXiv风格格式
  • ml-report
    - 机器学习实验报告
生成完整论文:
bash
uv run scripts/paper_manager.py create \
  --template "modern" \
  --title "Fine-Tuning Large Language Models with LoRA" \
  --authors "Jane Doe, John Smith" \
  --abstract "$(cat abstract.txt)" \
  --output "paper.md"
转换为HTML:
bash
uv run scripts/paper_manager.py convert \
  --input "paper.md" \
  --output "paper.html" \
  --style "modern"

Paper Template Structure

论文模板结构

Standard Research Paper Sections:
markdown
---
title: Your Paper Title
authors: Jane Doe, John Smith
affiliations: University X, Lab Y
date: 2025-01-15
arxiv: 2301.12345
tags: [machine-learning, nlp, fine-tuning]
---
标准研究论文章节:
markdown
---
title: Your Paper Title
authors: Jane Doe, John Smith
affiliations: University X, Lab Y
date: 2025-01-15
arxiv: 2301.12345
tags: [machine-learning, nlp, fine-tuning]
---

Abstract

摘要

Brief summary of the paper...
论文的简要概述...

1. Introduction

1. 引言

Background and motivation...
背景和动机...

2. Related Work

2. 相关工作

Previous research and context...
先前的研究和背景...

3. Methodology

3. 方法

Approach and implementation...
方法和实现...

4. Experiments

4. 实验

Setup, datasets, and procedures...
设置、数据集和流程...

5. Results

5. 结果

Findings and analysis...
发现和分析...

6. Discussion

6. 讨论

Interpretation and implications...
解释和意义...

7. Conclusion

7. 结论

Summary and future work...
总结和未来工作...

References

参考文献


**Modern Template Features:**
- Dynamic table of contents
- Responsive design for web viewing
- Code syntax highlighting
- Interactive figures and charts
- Math equation rendering (LaTeX)
- Citation management
- Author affiliation linking

**现代化模板特性:**
- 动态目录
- 适用于网页查看的响应式设计
- 代码语法高亮
- 交互式图表
- 数学公式渲染(LaTeX)
- 引用管理
- 作者所属机构链接

Commands Reference

命令参考

Index Paper:
bash
uv run scripts/paper_manager.py index --arxiv-id "2301.12345"
Link to Repository:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/repo-name" \
  --repo-type "model|dataset|space" \
  --arxiv-id "2301.12345" \
  [--citation "Full citation text"] \
  [--create-pr]
Claim Authorship:
bash
uv run scripts/paper_manager.py claim \
  --arxiv-id "2301.12345" \
  --email "your.email@edu"
Manage Visibility:
bash
uv run scripts/paper_manager.py toggle-visibility \
  --arxiv-id "2301.12345" \
  --show true|false
Create Research Article:
bash
uv run scripts/paper_manager.py create \
  --template "standard|modern|arxiv|ml-report" \
  --title "Paper Title" \
  [--authors "Author1, Author2"] \
  [--abstract "Abstract text"] \
  [--output "filename.md"]
Convert Markdown to HTML:
bash
uv run scripts/paper_manager.py convert \
  --input "paper.md" \
  --output "paper.html" \
  [--style "modern|classic"]
Check Paper Status:
bash
uv run scripts/paper_manager.py check --arxiv-id "2301.12345"
List Your Papers:
bash
uv run scripts/paper_manager.py list-my-papers
Search Papers:
bash
uv run scripts/paper_manager.py search --query "transformer attention"
索引论文:
bash
uv run scripts/paper_manager.py index --arxiv-id "2301.12345"
关联到仓库:
bash
uv run scripts/paper_manager.py link \
  --repo-id "username/repo-name" \
  --repo-type "model|dataset|space" \
  --arxiv-id "2301.12345" \
  [--citation "Full citation text"] \
  [--create-pr]
认领作者身份:
bash
uv run scripts/paper_manager.py claim \
  --arxiv-id "2301.12345" \
  --email "your.email@edu"
管理可见性:
bash
uv run scripts/paper_manager.py toggle-visibility \
  --arxiv-id "2301.12345" \
  --show true|false
创建研究文章:
bash
uv run scripts/paper_manager.py create \
  --template "standard|modern|arxiv|ml-report" \
  --title "Paper Title" \
  [--authors "Author1, Author2"] \
  [--abstract "Abstract text"] \
  [--output "filename.md"]
将Markdown转换为HTML:
bash
uv run scripts/paper_manager.py convert \
  --input "paper.md" \
  --output "paper.html" \
  [--style "modern|classic"]
检查论文状态:
bash
uv run scripts/paper_manager.py check --arxiv-id "2301.12345"
列出你的论文:
bash
uv run scripts/paper_manager.py list-my-papers
搜索论文:
bash
uv run scripts/paper_manager.py search --query "transformer attention"

YAML Metadata Format

YAML元数据格式

When linking papers to models or datasets, proper YAML frontmatter is required:
Model Card Example:
yaml
---
language:
  - en
license: apache-2.0
tags:
  - text-generation
  - transformers
  - llm
library_name: transformers
---
将论文与模型或数据集关联时,需要规范的YAML前置元数据:
模型卡片示例:
yaml
---
language:
  - en
license: apache-2.0
tags:
  - text-generation
  - transformers
  - llm
library_name: transformers
---

Model Name

模型名称

This model is based on the approach described in Our Paper.
本模型基于我们的论文中描述的方法。

Citation

引用

bibtex
@article{doe2023paper,
  title={Your Paper Title},
  author={Doe, Jane and Smith, John},
  journal={arXiv preprint arXiv:2301.12345},
  year={2023}
}

**Dataset Card Example:**
```yaml
---
language:
  - en
license: cc-by-4.0
task_categories:
  - text-generation
  - question-answering
size_categories:
  - 10K<n<100K
---
bibtex
@article{doe2023paper,
  title={Your Paper Title},
  author={Doe, Jane and Smith, John},
  journal={arXiv preprint arXiv:2301.12345},
  year={2023}
}

**数据集卡片示例:**
```yaml
---
language:
  - en
license: cc-by-4.0
task_categories:
  - text-generation
  - question-answering
size_categories:
  - 10K<n<100K
---

Dataset Name

数据集名称

Dataset introduced in Our Paper.
For more details, see the paper page.

The Hub automatically extracts arXiv IDs from these links and creates `arxiv:2301.12345` tags.
本数据集在我们的论文中首次提出。
更多详情,请查看论文页面

Hub会自动从这些链接中提取arXiv ID,并创建`arxiv:2301.12345`标签。

Integration Examples

集成示例

Workflow 1: Publish New Research
bash
undefined
工作流1:发布新研究
bash
undefined

1. Create research article

1. 创建研究文章

uv run scripts/paper_manager.py create
--template "modern"
--title "Novel Fine-Tuning Approach"
--output "paper.md"
uv run scripts/paper_manager.py create
--template "modern"
--title "Novel Fine-Tuning Approach"
--output "paper.md"

2. Edit paper.md with your content

2. 编辑paper.md添加你的内容

3. Submit to arXiv (external process)

3. 提交到arXiv(外部流程)

Upload to arxiv.org, get arXiv ID

上传到arxiv.org,获取arXiv ID

4. Index on Hugging Face

4. 在Hugging Face上索引

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

5. Link to your model

5. 关联到你的模型

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

6. Claim authorship

6. 认领作者身份

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

**Workflow 2: Link Existing Paper**
```bash
uv run scripts/paper_manager.py claim
--arxiv-id "2301.12345"
--email "your.email@edu"

**工作流2:关联现有论文**
```bash

1. Check if paper exists

1. 检查论文是否存在

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

2. Index if needed

2. 如有需要则索引

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

3. Link to multiple repositories

3. 关联到多个仓库

uv run scripts/paper_manager.py link
--repo-id "username/model-v1"
--repo-type "model"
--arxiv-id "2301.12345"
uv run scripts/paper_manager.py link
--repo-id "username/training-data"
--repo-type "dataset"
--arxiv-id "2301.12345"
uv run scripts/paper_manager.py link
--repo-id "username/demo-space"
--repo-type "space"
--arxiv-id "2301.12345"

**Workflow 3: Update Model with Paper Reference**
```bash
uv run scripts/paper_manager.py link
--repo-id "username/model-v1"
--repo-type "model"
--arxiv-id "2301.12345"
uv run scripts/paper_manager.py link
--repo-id "username/training-data"
--repo-type "dataset"
--arxiv-id "2301.12345"
uv run scripts/paper_manager.py link
--repo-id "username/demo-space"
--repo-type "space"
--arxiv-id "2301.12345"

**工作流3:更新模型添加论文引用**
```bash

1. Get current README

1. 获取当前README

huggingface-cli download username/model-name README.md
huggingface-cli download username/model-name README.md

2. Add paper link

2. 添加论文链接

uv run scripts/paper_manager.py link
--repo-id "username/model-name"
--repo-type "model"
--arxiv-id "2301.12345"
--citation "Full citation for the paper"
uv run scripts/paper_manager.py link
--repo-id "username/model-name"
--repo-type "model"
--arxiv-id "2301.12345"
--citation "Full citation for the paper"

The script will:

脚本将:

- Add YAML metadata if missing

- 若缺少则添加YAML元数据

- Insert arXiv link in README

在README中插入arXiv链接

- Add formatted citation

添加格式化的引用

- Preserve existing content

保留现有内容

undefined
undefined

Best Practices

最佳实践

  1. Paper Indexing
    • Index papers as soon as they're published on arXiv
    • Include full citation information in model/dataset cards
    • Use consistent paper references across related repositories
  2. Metadata Management
    • Add YAML frontmatter to all model/dataset cards
    • Include proper licensing information
    • Tag with relevant task categories and domains
  3. Authorship
    • Claim authorship on papers where you're listed as author
    • Use institutional email addresses for verification
    • Keep paper visibility settings updated
  4. Repository Linking
    • Link papers to all relevant models, datasets, and Spaces
    • Include paper context in README descriptions
    • Add BibTeX citations for easy reference
  5. Research Articles
    • Use templates consistently within projects
    • Include code and data links in papers
    • Generate web-friendly HTML versions for sharing
  1. 论文索引
    • 论文在arXiv发表后立即索引
    • 在模型/数据集卡片中包含完整的引用信息
    • 在相关仓库中使用一致的论文引用
  2. 元数据管理
    • 为所有模型/数据集卡片添加YAML前置元数据
    • 包含正确的许可信息
    • 使用相关的任务类别和领域标签
  3. 作者身份
    • 认领你作为作者的论文的作者身份
    • 使用机构邮箱进行验证
    • 及时更新论文可见性设置
  4. 仓库关联
    • 将论文关联到所有相关的模型、数据集和Spaces
    • 在README描述中包含论文背景
    • 添加BibTeX引用以便于参考
  5. 研究文章
    • 在项目中一致使用模板
    • 在论文中包含代码和数据链接
    • 生成适合网页分享的HTML版本

Advanced Usage

高级用法

Batch Link Papers:
bash
undefined
批量关联论文:
bash
undefined

Link multiple papers to one repository

将多篇论文关联到一个仓库

for arxiv_id in "2301.12345" "2302.67890" "2303.11111"; do uv run scripts/paper_manager.py link
--repo-id "username/model-name"
--repo-type "model"
--arxiv-id "$arxiv_id" done

**Extract Paper Info:**
```bash
for arxiv_id in "2301.12345" "2302.67890" "2303.11111"; do uv run scripts/paper_manager.py link
--repo-id "username/model-name"
--repo-type "model"
--arxiv-id "$arxiv_id" done

**提取论文信息:**
```bash

Get paper metadata from arXiv

从arXiv获取论文元数据

uv run scripts/paper_manager.py info
--arxiv-id "2301.12345"
--format "json"

**Generate Citation:**
```bash
uv run scripts/paper_manager.py info
--arxiv-id "2301.12345"
--format "json"

**生成引用:**
```bash

Create BibTeX citation

创建BibTeX引用

uv run scripts/paper_manager.py citation
--arxiv-id "2301.12345"
--format "bibtex"

**Validate Links:**
```bash
uv run scripts/paper_manager.py citation
--arxiv-id "2301.12345"
--format "bibtex"

**验证链接:**
```bash

Check all paper links in a repository

检查仓库中所有论文链接

uv run scripts/paper_manager.py validate
--repo-id "username/model-name"
--repo-type "model"
undefined
uv run scripts/paper_manager.py validate
--repo-id "username/model-name"
--repo-type "model"
undefined

Error Handling

错误处理

  • Paper Not Found: arXiv ID doesn't exist or isn't indexed yet
  • Permission Denied: HF_TOKEN lacks write access to repository
  • Invalid YAML: Malformed metadata in README frontmatter
  • Authorship Failed: Email doesn't match paper author records
  • Already Claimed: Another user has claimed authorship
  • Rate Limiting: Too many API requests in short time
  • 论文未找到:arXiv ID不存在或尚未被索引
  • 权限被拒绝:HF_TOKEN缺少仓库的写入权限
  • 无效YAML:README前置元数据格式错误
  • 作者身份认领失败:邮箱与论文作者记录不匹配
  • 已被认领:其他用户已认领该作者身份
  • 请求受限:短时间内API请求过多

Troubleshooting

故障排除

Issue: "Paper not found on Hugging Face"
  • Solution: Visit
    hf.co/papers/{arxiv-id}
    to trigger indexing
Issue: "Authorship claim not verified"
  • Solution: Wait for admin review or contact HF support with proof
Issue: "arXiv tag not appearing"
  • Solution: Ensure README includes proper arXiv URL format
Issue: "Cannot link to repository"
  • Solution: Verify HF_TOKEN has write permissions
Issue: "Template rendering errors"
  • Solution: Check markdown syntax and YAML frontmatter format
问题:“在Hugging Face上未找到论文”
  • 解决方案:访问
    hf.co/papers/{arxiv-id}
    触发索引
问题:“作者身份认领未通过验证”
  • 解决方案:等待管理员审核,或联系HF支持并提供证明
问题:“arXiv标签未显示”
  • 解决方案:确保README包含正确的arXiv URL格式
问题:“无法关联到仓库”
  • 解决方案:验证HF_TOKEN是否具有写入权限
问题:“模板渲染错误”
  • 解决方案:检查Markdown语法和YAML前置元数据格式

Resources and References

资源与参考

Integration with tfrere's Research Template

与tfrere研究模板的集成

This skill complements tfrere's research article template by providing:
  • Automated paper indexing workflows
  • Repository linking capabilities
  • Metadata management tools
  • Citation generation utilities
You can use tfrere's template for writing, then use this skill to publish and link the paper on Hugging Face Hub.
本技能与tfrere的研究文章模板互补,提供:
  • 自动化论文索引工作流
  • 仓库关联功能
  • 元数据管理工具
  • 引用生成实用程序
你可以使用tfrere的模板撰写论文,然后使用本技能在Hugging Face Hub上发布并关联论文。

Common Patterns

常见模式

Pattern 1: New Paper Publication
bash
undefined
模式1:新论文发布
bash
undefined

Write → Publish → Index → Link

撰写 → 发布 → 索引 → 关联

uv run scripts/paper_manager.py create --template modern --output paper.md
uv run scripts/paper_manager.py create --template modern --output paper.md

(Submit to arXiv)

(提交到arXiv)

uv run scripts/paper_manager.py index --arxiv-id "2301.12345" uv run scripts/paper_manager.py link --repo-id "user/model" --arxiv-id "2301.12345"

**Pattern 2: Existing Paper Discovery**
```bash
uv run scripts/paper_manager.py index --arxiv-id "2301.12345" uv run scripts/paper_manager.py link --repo-id "user/model" --arxiv-id "2301.12345"

**模式2:现有论文发现**
```bash

Search → Check → Link

搜索 → 检查 → 关联

uv run scripts/paper_manager.py search --query "transformers" uv run scripts/paper_manager.py check --arxiv-id "2301.12345" uv run scripts/paper_manager.py link --repo-id "user/model" --arxiv-id "2301.12345"

**Pattern 3: Author Portfolio Management**
```bash
uv run scripts/paper_manager.py search --query "transformers" uv run scripts/paper_manager.py check --arxiv-id "2301.12345" uv run scripts/paper_manager.py link --repo-id "user/model" --arxiv-id "2301.12345"

**模式3:作者作品集管理**
```bash

Claim → Verify → Organize

认领 → 验证 → 整理

uv run scripts/paper_manager.py claim --arxiv-id "2301.12345" uv run scripts/paper_manager.py list-my-papers uv run scripts/paper_manager.py toggle-visibility --arxiv-id "2301.12345" --show true
undefined
uv run scripts/paper_manager.py claim --arxiv-id "2301.12345" uv run scripts/paper_manager.py list-my-papers uv run scripts/paper_manager.py toggle-visibility --arxiv-id "2301.12345" --show true
undefined

API Integration

API集成

Python Script Example:
python
from scripts.paper_manager import PaperManager

pm = PaperManager(hf_token="your_token")
Python脚本示例:
python
from scripts.paper_manager import PaperManager

pm = PaperManager(hf_token="your_token")

Index paper

索引论文

pm.index_paper("2301.12345")
pm.index_paper("2301.12345")

Link to model

关联到模型

pm.link_paper( repo_id="username/model", repo_type="model", arxiv_id="2301.12345", citation="Full citation text" )
pm.link_paper( repo_id="username/model", repo_type="model", arxiv_id="2301.12345", citation="Full citation text" )

Check status

检查状态

status = pm.check_paper("2301.12345") print(status)
undefined
status = pm.check_paper("2301.12345") print(status)
undefined

Future Enhancements

未来增强

Planned features for future versions:
  • Support for non-arXiv papers (conference proceedings, journals)
  • Automatic citation formatting from DOI
  • Paper comparison and versioning tools
  • Collaborative paper writing features
  • Integration with LaTeX workflows
  • Automated figure and table extraction
  • Paper metrics and impact tracking
未来版本的计划功能:
  • 支持非arXiv论文(会议论文、期刊文章)
  • 从DOI自动格式化引用
  • 论文比较和版本控制工具
  • 协作论文撰写功能
  • 与LaTeX工作流集成
  • 自动提取图表和表格
  • 论文指标和影响力跟踪