Hugging Face 论文发布助手

问题背景

在 Hugging Face 上发布模型或数据集时，论文往往仍停留在 arXiv 或个人主页：Hub 的 论文页面（hf.co/papers/{arxiv-id}）需要单独触发索引，模型卡片里的 YAML 前置元数据 与 BibTeX 引用也容易写错，导致 arxiv: 标签不出现、论文页无法反查关联仓库。作者身份要在论文页手动声明并等待审核，个人资料上的论文可见性也需要单独维护。若还要写可分享的网页版研究文章，还要在 Markdown 模板、目录与 LaTeX 公式之间切换工具链。

技能如何工作

本技能通过 scripts/ 下的 Python 脚本（建议用 uv run 执行，依赖写在脚本 PEP 723 头部）对接 huggingface_hub，在设置具备写入权限的 HF_TOKEN 后完成整条链路：

• 论文页面：从 arXiv ID 索引论文；也可直接访问 https://huggingface.co/papers/{arxiv-id} 触发索引
• 链接工件：在模型/数据集 README 中写入正确引用；Hub 提取 arXiv ID 并自动添加 arxiv: 标签，论文页会列出引用该文的仓库
• 作者与可见性：启动声明流程、检查状态；列出已验证论文并切换是否在个人资料展示
• 研究文章：基于 standard / modern / arxiv / ml-report 等模板生成 Markdown，并可转为 HTML

典型顺序可以是：新论文在 arXiv 上线后尽快索引 → 在相关模型/数据集卡片补全引用与许可元数据 → 对本人署名论文完成作者声明 → 按需生成网页版文章便于对外分享。

适用边界与注意

• 当前工作流以 arXiv ID 为主；非 arXiv 来源、DOI 自动引用等能力在资料中标注为后续计划，不要当作现成能力依赖
• 权限：链接仓库失败多半是 HF_TOKEN 无写权限；无效 YAML 会导致元数据解析失败
• 作者身份：邮箱需与论文作者记录一致，且可能已被他人声明；验证需管理员审核
• 速率限制：短时间大量 API 调用可能被限流；论文尚未被 Hub 索引时，可先访问论文 URL 再重试

与 tfrere/research-article-template 的分工是：用模板写作，用本技能完成 Hub 上的索引、链接与引用维护。