SuperAPI AI 工具集

alterlab-labarchive

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:本技能用于通过 LabArchives REST API(XML 响应、HMAC 签名请求)自动化电子实验记录本操作,包括访问笔记本、管理页面树、条目与附件、程序化备份,以及将 LabArchives 与第三方工具衔接。

主要能力:用户与笔记本发现(users/user_access_info 返回 UID 与可打开笔记本);笔记本备份(notebooks/notebook_backup 返回 7-Zip 归档,仅笔记本所有者可下载,否则报错 4547);条目与附件操作(tree_tools/insert_node 建页面或文件夹,entries/add_entry 加文本条目,entries/add_attachment 加附件,entries/update_entry 更新,tree_tools/get_entries_for_page 列出条目);企业版站点报告(site_reports,方法名未验证);第三方集成(Protocols.io、GraphPad Prism 8+、SnapGene、Geneious、Jupyter、REDCap 等,多为应用内导出,较新集成使用 OAuth)。

使用方式:提供两个 Python 客户端。labapi(uv pip install "labapi[dotenv]",Python >=3.10)推荐用于新工作;labarchives-py(uv pip install "git+https://github.com/mcmero/labarchives-py")为最小签名 GET 封装。需机构启用 API 访问(企业版许可),访问密钥 ID 与密码来自管理员或 support@labarchives.com;用户邮箱加 LA App 认证令牌(LabArchives 右上角姓名 → "LA App authentication")作为 users/user_access_info 的密码。区域端点:美国/国际 https://api.labarchives.com/api,澳大利亚 https://auapi.labarchives.com/api,英国 https://ukapi.labarchives.com/api。可用 python3 scripts/setup_config.py 生成 config.yaml(隐藏输入、权限 600)。每次调用均签名,客户端附加 akid、expires 与 sig(基于 akid+方法名+expires 的 HMAC),密码本身不发送。备份示例:python3 scripts/notebook_operations.py backup --nbid NOTEBOOK_ID;条目示例:python3 scripts/entry_operations.py create --nbid NOTEBOOK_ID --pid PAGE_ID --content "..."。

适用场景:笔记本自动化、程序化备份、创建文本条目或上传附件、与 Jupyter/REDCap/Protocols.io 等集成、自动化数据上传、生成机构使用报告。

限制:不适用于 Benchling、protocols.io 协议发布、REDCap 工具设计或数据仓库选择(应使用对应技能)。两个客户端均不覆盖评论功能。labarchives-py 不对参数值做 URL 编码,仅传简单值。备份仅所有者可下载。上传前需检查 users/max_file_size。站点报告方法名未验证。LabArchives 未公布固定配额,批量循环需加延迟并退避。ELN 记录可能受 21 CFR Part 11、HIPAA 等监管,未获批准勿上传可识别患者数据。401/签名错误检查密钥与机器时钟;404/空响应确认 nbid/pid 存在且用户可打开笔记本。