用途:通过 LabArchives REST API 实现电子实验记录本的自动化操作,包括访问笔记本、管理条目与附件、生成报告及与第三方工具集成。
主要能力:认证与配置(支持美国/国际、澳大利亚、英国区域端点);获取用户 UID 与信息;笔记本操作(列出、备份、获取 ID、成员、设置);条目与附件管理(创建条目、添加评论、上传附件,支持 PDF、DOCX、CSV、XLSX、HDF5、CIF、MOL、PDB、ZIP、7Z 等格式);站点报告与分析(企业版功能,含使用报告、笔记本报告、成员报告、设置报告);第三方集成(Protocols.io、GraphPad Prism、SnapGene、Geneious、Jupyter、REDCap、Qeios、SciSpace,新集成使用 OAuth)。
使用方式:需企业版 LabArchives 许可并启用 API,获取访问密钥 ID 与密码及用户认证凭据。运行 python3 scripts/setup_config.py 生成 config.yaml。备份示例:python3 scripts/notebook_operations.py backup --uid USER_ID --nbid NOTEBOOK_ID;上传附件:python3 scripts/entry_operations.py upload --uid USER_ID --nbid NOTEBOOK_ID --entry-id ENTRY_ID --file /path/to/file.pdf。可安装 labarchives-py:git clone https://github.com/mcmero/labarchives-py 后 uv pip install .。
适用场景:笔记本自动化备份、实验数据上传、机构报告生成、与科研工具集成。
限制:需企业版许可与 API 访问权限;应实施速率限制、错误处理,凭据存于环境变量或安全配置文件;大笔记本需分页与批处理;附件受大小与格式限制。常见错误包括 401、403、404 及空响应。支持邮箱 support@labarchives.com。