从预览到你的工作目录。
打开数据集详情，检查预览，再前往 Hugging Face。在 Files and versions 中选择文件，或复制详情页的命令行下载指令。
先确认格式，再开始实验。
阅读仓库 README 与对应版本的加载说明，结合目标任务检查字段语义、单位、时间戳、数据划分和运行依赖。
LeRobot 轨迹、可编辑 3D 资产、电路工程和终端任务包使用不同加载方式；完成下载不代表训练流程已经验证。
理解数据能支持什么。
每个数据集页面都列明来源、已知质量边界和权利说明。免费访问不扩大许可范围；复用时请保留必要归因，并检查混合权利组件。
仿真、格式检查和小样加载验证各有适用范围，不构成实体机器人安全性、训练收益或 benchmark 成绩的证明。
阅读条款与政策 ↗阅读研究，也带走工作流。
Papers 提供附原文位置的 论文全文关键点。现有每日任务在北京时间 08:00 执行。你也可下载 Paper Search 与 Paper Reader，在自己的 Agent 中使用；定时运行需另行配置。
从小样开始。
检查证据，再沟通需求。
联系前可以检查什么？
可先打开数据集的代表性公开小样，用自己的工具检查格式、字段、来源、质量边界和分组件使用条件。
公开小样包含什么？
每个链接的 Hugging Face 仓库均公开当前发布的所有文件，可直接下载，无需付款或访问审批。这些公开数据集是 Datumwell 的合作评估样本，不再区分 sample/full 访问版本。如需更多数据或定制采集，请联系 allen@datumwell.io；具体内容与使用条件以各仓库说明为准。
公开可访问是否代表可任意使用？
不是。请逐项检查组件条款。Handwriting 与 Foam Tower 保留混合权利和未确立的第三方授权；仓库访问或需求沟通不能补足这些权利。PCB、3D 小样有各自评估条款，EmbodiedTrace 保留来源归因与修改说明。
沟通需求时应说明什么？
请说明任务、用途、格式、所需量与单位、评估标准。所需量是你的需求，可用性、范围与时间须另行沟通。不要提交密码、访问令牌或敏感个人数据。
提交需求会收费或自动授予数据权利吗？
不会。表单保存需求并排队通知 Datumwell，不是结账，也不会自动授予访问、使用权或交付承诺。我们会通过你提供的联系邮箱回复。
如何反馈小样问题？
请邮件联系 allen@datumwell.io，说明数据集、小样版本、相关资产或轨迹 ID、加载器版本及复现示例。既有检查只在说明范围内成立，不证明模型收益、硬件安全或泛化。
为具体任务寻找数据？
告诉我们用途、偏好格式和评估标准。提供邮箱与简短需求即可开始，我们再一起明确范围。
归档：旧 Agent API 参考
先确认接入契约。
公开阅读与私人账户自动化是不同能力。下列旧 API 契约用于迁移参考，不代表 Datumwell Community 现在已经提供这些接口。
此归档记录较早版本的实现。账户关联、Key 发放与运行限流须配置并验证后，才能在本站开放这些端点。现有旧 Key 不会自动成为 Datumwell 凭据。
当前可用
无需账户即可浏览 Community。公开 JSON manifest 指向不可变快照；它来自有限收录窗口，不是实时个人订阅接口，也不是完整 arXiv 档案。
阅读 Community ↗curl --fail 'https://www.datumwell.io/papers/data/manifest.json'manifest 包含 schemaVersion 与 snapshot；从 /papers/data/ 读取该文件。refresh-status.json 表示最近一次刷新尝试。insight 可为空；此入口不承诺定时刷新或已生成双语洞察。
Community 现通过 /community/benchmarks.json 提供依据全文整理的论文关键点。搜寻遵循 paper-search 的前沿 AI 研究方向，每天北京时间 08:00 更新。上面的 /papers/data/ 入口保留历史元数据快照，不是当前已核查的阅读列表。公开浏览无需登录；个人订阅已暂停。
下载 Paper Search 与 Paper Reader ↗账户与 Key
已核对原 Agent 文档路径为 /docs/api。旧实现通过已登录的 Clerk 账户调用 POST /api/integration/key 创建服务端 Bearer Key。Key 对应单一用户，主题读取与写入按该用户隔离。
- 旧 Key 以 pt_live_ 开头；不保存完整 Key，仅保留哈希、前缀与时间记录。同一账户生成新 Key 会立即替换旧 Key，完整新值只在创建时返回。
- Key 只应保存在 Agent 服务端，不要放进公开前端、URL、截图或机器人消息。浏览器登录会话不等于 API Key。
- 旧 Key 迁移及其与新 Datumwell 账户的关系尚未配置。不要向 Datumwell 域名发送旧 Key。
# Legacy contract only. Replace placeholders on your own server.
API_BASE_URL='https://api.example.invalid'
AGENT_API_KEY='<YOUR_SERVER_SIDE_KEY>'
curl --fail "$API_BASE_URL/api/v1/topics" \
-H "Authorization: Bearer $AGENT_API_KEY"创建与管理主题
仅为旧契约：每个账户最多 5 个主题。interest 去除两端空白后须为 3–600 个字符，且包含字母或数字。主题数量上限不是每分钟请求限额。
- GET
/api/v1/topics - 列出当前用户的主题 ID。
- POST
/api/v1/topics - 创建主题，成功返回 201。
- PUT
/api/v1/topics/{topicId} - 更新当前用户拥有的主题。
- DELETE
/api/v1/topics/{topicId} - 删除当前用户拥有的主题，成功返回 204。
curl --fail -X POST "$API_BASE_URL/api/v1/topics" \
-H "Authorization: Bearer $AGENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"interest":"<YOUR_RESEARCH_INTEREST>"}'兼容说明：PUT /api/v1/subscription 接受 interest（或旧 keyword），更新首个主题；无主题时创建一个。多主题 Agent 应优先使用带主题 ID 的接口。Datumwell 尚未实现此兼容端点。
获取论文
/api/v1/papers/latest旧服务中，省略 topicId 会按当前用户的全部主题分组返回；指定正整数 topicId 则返回该用户的一个主题。limit 按每个主题生效，默认 12，范围 1–50。
TOPIC_ID='<YOUR_TOPIC_ID>'
curl --fail "$API_BASE_URL/api/v1/papers/latest?topicId=$TOPIC_ID&limit=5" \
-H "Authorization: Bearer $AGENT_API_KEY"响应包含 generatedAt，以及 topic + papers 或 topics[]。论文字段包括 id、title、authors、authorDetails、abstract、insight、categories、primaryCategory、publishedAt、arxivUrl 和 pdfUrl。generatedAt 是响应时间，不保证刚完成 arXiv 同步。结构化 insight 取决于已存内容，可能不可用。
限制与错误
已核对的旧路由未配置独立每分钟额度或应用层 429 契约。这不代表无限调用：托管平台与上游服务可能另有限制。请限制重试次数，响应带 Retry-After 时遵循其提示。
400- JSON、interest、主题 ID 或 limit 无效。
401- Bearer Key 缺失、无效或已被替换。
404- 没有主题，或主题不属于此 Key。
409- 达到 5 个主题上限。
500- 服务发生意外错误，不构成服务等级保证。
503- 旧本地演示模式禁用 API 访问。
以上示例记录旧实现。阅读本页不会创建 Key、账户或私人订阅；使用正式服务地址前，请先与 Datumwell 确认支持的接入方式。
沟通接入需求 ↗