hugging-face-paper-publisher
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseOverview
概述
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 for paper publishing operations.
scripts/本技能在目录中包含用于论文发布操作的Python脚本。
scripts/Prerequisites
前提条件
- Install dependencies:
uv add huggingface_hub pyyaml requests markdown python-dotenv - Set environment variable with Write-access token
HF_TOKEN - Activate virtual environment:
source .venv/bin/activate
All paths are relative to the directory containing this SKILL.md file. Before running any script, firstto that directory or use the full path.cd
- 安装依赖项:
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 directly to index a paper.
https://huggingface.co/papers/{arxiv-id}将论文从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:
- The Hub extracts the arXiv ID from the link
- A tag is automatically added to the repository
arxiv:<PAPER_ID> - Users can click the tag to view the Paper Page
- The Paper Page shows all models/datasets citing this paper
- Papers are discoverable through filters and search
当你在模型或数据集的README中添加arXiv论文链接时:
- Hub会从链接中提取arXiv ID
- 仓库会自动添加标签
arxiv:<PAPER_ID> - 用户可以点击标签查看论文页面
- 论文页面会显示所有引用该论文的模型/数据集
- 论文可通过筛选器和搜索功能被发现
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:
- Navigate to your paper's page:
https://huggingface.co/papers/{arxiv-id} - Find your name in the author list
- Click your name and select "Claim authorship"
- 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"手动流程:
- 导航到你的论文页面:
https://huggingface.co/papers/{arxiv-id} - 在作者列表中找到你的名字
- 点击你的名字并选择“认领作者身份”
- 等待管理员团队验证
检查作者身份状态:
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-papersToggle Visibility:
bash
uv run scripts/paper_manager.py toggle-visibility \
--arxiv-id "2301.12345" \
--show trueManage 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:
- - Traditional scientific paper structure
standard - - Clean, web-friendly format inspired by Distill
modern - - arXiv-style formatting
arxiv - - Machine learning experiment report
ml-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 - - 受Distill启发的简洁、网页友好格式
modern - - 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|falseCreate 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-papersSearch 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
模型名称
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.Integration Examples
集成示例
Workflow 1: Publish New Research
bash
undefined工作流1:发布新研究
bash
undefined1. Create research article
1. 创建研究文章
uv run scripts/paper_manager.py create
--template "modern"
--title "Novel Fine-Tuning Approach"
--output "paper.md"
--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"
--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"
--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"
--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"
--arxiv-id "2301.12345"
--email "your.email@edu"
**Workflow 2: Link Existing Paper**
```bashuv run scripts/paper_manager.py claim
--arxiv-id "2301.12345"
--email "your.email@edu"
--arxiv-id "2301.12345"
--email "your.email@edu"
**工作流2:关联现有论文**
```bash1. 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"
--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"
--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"
--repo-id "username/demo-space"
--repo-type "space"
--arxiv-id "2301.12345"
**Workflow 3: Update Model with Paper Reference**
```bashuv run scripts/paper_manager.py link
--repo-id "username/model-v1"
--repo-type "model"
--arxiv-id "2301.12345"
--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"
--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"
--repo-id "username/demo-space"
--repo-type "space"
--arxiv-id "2301.12345"
**工作流3:更新模型添加论文引用**
```bash1. 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"
--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"
--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
保留现有内容
undefinedundefinedBest Practices
最佳实践
-
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
-
Metadata Management
- Add YAML frontmatter to all model/dataset cards
- Include proper licensing information
- Tag with relevant task categories and domains
-
Authorship
- Claim authorship on papers where you're listed as author
- Use institutional email addresses for verification
- Keep paper visibility settings updated
-
Repository Linking
- Link papers to all relevant models, datasets, and Spaces
- Include paper context in README descriptions
- Add BibTeX citations for easy reference
-
Research Articles
- Use templates consistently within projects
- Include code and data links in papers
- Generate web-friendly HTML versions for sharing
-
论文索引
- 论文在arXiv发表后立即索引
- 在模型/数据集卡片中包含完整的引用信息
- 在相关仓库中使用一致的论文引用
-
元数据管理
- 为所有模型/数据集卡片添加YAML前置元数据
- 包含正确的许可信息
- 使用相关的任务类别和领域标签
-
作者身份
- 认领你作为作者的论文的作者身份
- 使用机构邮箱进行验证
- 及时更新论文可见性设置
-
仓库关联
- 将论文关联到所有相关的模型、数据集和Spaces
- 在README描述中包含论文背景
- 添加BibTeX引用以便于参考
-
研究文章
- 在项目中一致使用模板
- 在论文中包含代码和数据链接
- 生成适合网页分享的HTML版本
Advanced Usage
高级用法
Batch Link Papers:
bash
undefined批量关联论文:
bash
undefinedLink 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
--repo-id "username/model-name"
--repo-type "model"
--arxiv-id "$arxiv_id" done
**Extract Paper Info:**
```bashfor 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
--repo-id "username/model-name"
--repo-type "model"
--arxiv-id "$arxiv_id" done
**提取论文信息:**
```bashGet paper metadata from arXiv
从arXiv获取论文元数据
uv run scripts/paper_manager.py info
--arxiv-id "2301.12345"
--format "json"
--arxiv-id "2301.12345"
--format "json"
**Generate Citation:**
```bashuv run scripts/paper_manager.py info
--arxiv-id "2301.12345"
--format "json"
--arxiv-id "2301.12345"
--format "json"
**生成引用:**
```bashCreate BibTeX citation
创建BibTeX引用
uv run scripts/paper_manager.py citation
--arxiv-id "2301.12345"
--format "bibtex"
--arxiv-id "2301.12345"
--format "bibtex"
**Validate Links:**
```bashuv run scripts/paper_manager.py citation
--arxiv-id "2301.12345"
--format "bibtex"
--arxiv-id "2301.12345"
--format "bibtex"
**验证链接:**
```bashCheck all paper links in a repository
检查仓库中所有论文链接
uv run scripts/paper_manager.py validate
--repo-id "username/model-name"
--repo-type "model"
--repo-id "username/model-name"
--repo-type "model"
undefineduv run scripts/paper_manager.py validate
--repo-id "username/model-name"
--repo-type "model"
--repo-id "username/model-name"
--repo-type "model"
undefinedError 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 to trigger indexing
hf.co/papers/{arxiv-id}
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
资源与参考
- Hugging Face Paper Pages: hf.co/papers
- Model Cards Guide: hf.co/docs/hub/model-cards
- Dataset Cards Guide: hf.co/docs/hub/datasets-cards
- Research Article Template: tfrere/research-article-template
- arXiv Format Guide: arxiv.org/help/submit
- Hugging Face论文页面:hf.co/papers
- 模型卡片指南:hf.co/docs/hub/model-cards
- 数据集卡片指南:hf.co/docs/hub/datasets-cards
- 研究文章模板:tfrere/research-article-template
- arXiv格式指南:arxiv.org/help/submit
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
undefinedWrite → 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**
```bashuv 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:现有论文发现**
```bashSearch → 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**
```bashuv 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:作者作品集管理**
```bashClaim → 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
undefineduv 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
undefinedAPI 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)
undefinedstatus = pm.check_paper("2301.12345")
print(status)
undefinedFuture 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工作流集成
- 自动提取图表和表格
- 论文指标和影响力跟踪