LabArchives 实验记录集成

要解决什么问题

研究组日常把实验记录、原始数据和附件放在 LabArchives 这类电子实验记录本（ELN）里，合规备份、批量上传仪器输出、以及和 Protocols.io、Jupyter、REDCap 等工具打通，往往只能依赖 Web 界面手工操作。企业版虽提供 REST API，但认证分区域端点、响应多为 XML/JSON 混用，笔记本 ID、条目与附件的上传流程也不直观，自建脚本容易在权限和限流上踩坑。

技能如何工作

本技能围绕 LabArchives API 集成整理配置、脚本与参考文档，典型路径如下：

1. 身份验证与配置：用 scripts/setup_config.py 生成 config.yaml，写入 API 访问密钥、用户凭据，并选择美国/国际、澳大利亚或英国等区域 api 基址。
2. 用户上下文：通过 users/user_access_info 取得 UID，再用 users/user_info_via_id 拉取后续操作所需的用户信息。
3. 笔记本层：列出可访问笔记本、整本备份（可选含附件）、读取机构 nbid、成员与设置；可配合 notebook_operations.py。
4. 条目与附件：创建条目、评论、部件，上传 PDF/CSV/HDF5 等附件；见 entry_operations.py。
5. 报告与集成：企业版可生成使用、成员、合规类站点报告；集成侧覆盖 Protocols.io 导出、Jupyter 嵌入、OAuth 等新集成方式。

仓库内 references/api_reference.md、authentication_guide.md、integrations.md 对应端点参数与故障场景说明。

适用边界与注意点

• 需 企业版且已开通 API 的 LabArchives 账户，以及管理员下发的访问密钥与用户外部应用密码。
• 站点报告等多为 企业版 能力；调用间应做速率控制、异常日志与凭据外置（环境变量或安全配置）。
• 401/403/404 多与密钥、UID/nbid 参数或笔记本权限有关；大笔记本宜分页与分批处理，备份后建议校验文件完整性。