LabArchives 官方集成全景产品集成类型辨析、安全边界与自动化落地指南【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skillsLabArchives 是科研领域广泛使用的电子实验记录本ELN与实验室样品/耗材库存平台。本指南以本仓库skills/labarchive-integration技能中的官方集成核查文档为主体系统梳理 LabArchives 帮助中心当前收录的全部官方产品集成Jupyter、REDCap、Protocols.io、GraphPad Prism、SnapGene、Geneious 等的真实行为边界厘清产品集成 ≠ 通用 API 契约这一关键事实并结合本技能提供的离线签名脚本与测试套件给出可落地的集成安全核查流程、自定义集成边界与严格的自动化操作守则。读完本文你将能够准确区分产品集成与可编程 API、正确评估每个集成的数据流向与合规前提并在机构批准的前提下安全地规划自定义集成。官方集成清单与文档核查方法LabArchives 帮助中心的官方集成版块2026-07-23 核查当前收录以下条目External Integrations Overview外部集成总览GraphPad PrismSnapGeneGeneiousProofig AIJupyterREDCapProtocols.ioQeiosSciSpaceVernier Logger ProDataCite该清单的逐项核对记录保存在 skills/labarchive-integration/references/integrations.md对应的官方 URL 与页面更新日期、社区依赖状态等核查证据则记录在 skills/labarchive-integration/references/sources.md。在使用任何集成之前必须明确可用性取决于产品、许可证、区域服务器、机构政策与管理员配置。迁移研究数据前务必查阅对应的官方文章并确认本地批准。集成不是通用的 API 契约这是理解 LabArchives 集成的第一原则。一个被官方收录的集成可能是以下任何一种形态一个文件上传/查看器一个供应商侧的导出功能一个本地安装的外部模块一个产品专属的账号连接或者一个 LabArchives 界面功能。不能把这些工作流想当然地转换成猜测出来的 ELN 方法、Inventory 路由或 OAuth 端点。经核查的官方资料并未建立通用的/oauth/authorize或/oauth/token端点、client-ID 作用域、刷新令牌或普适的 LabArchives OAuth 2.0 流程。一个需要特别澄清的例外旧版 ELN API 确实有一个有据可查的OAuth 风格的 API 用户登录重定向使用/api_user_login、签名重定向 URI、授权码以及users::user_access_info。但那是独立的 API 授权机制与产品集成无关完整流程见 skills/labarchive-integration/references/authentication_guide.md。本技能在 skills/labarchive-integration/SKILL.md 中同样明确要求自动化任何被收录的集成之前必须先阅读 skills/labarchive-integration/references/integrations.md编写 API 代码前必须先阅读 skills/labarchive-integration/references/api_reference.md。逐项解读各官方集成的真实行为Jupyter附件/查看器工作流官方文章更新于 2025-09-08验证的行为如下将.ipynb作为附件条目Attachment Entry上传或直接拖放上传LabArchives 显示预览并在其 Docs Viewer 中打开该文件可在本地编辑笔记本后上传替换件以更新内容页面修订保留先前上传的版本查看器中的批注不包含在修订历史中。这是附件/查看器工作流不能证明存在实时的 Jupyter 内核、双向同步或 API 专属的 notebook 条目类型。请保留原始.ipynb如有需要按机构政策单独附上环境锁文件或导出文件。REDCap机构级外部模块官方文章更新于 2025-09-05验证的行为如下Mass General Brigham 的 REDCap 团队开发了MGB LabArchives外部模块由机构的 REDCap 管理员安装和配置用户使用与其 LabArchives 账号匹配的邮箱并以 LabArchives 临时令牌代替密码进行连接该模块将选定的 REDCap 报表上传到选定的自有笔记本该功能在组织内可能不可用或未经批准。这不是通用的同步所有 REDCap 数据API。上传前必须精确选择报表并按需移除/去标识化数据。切勿声称该集成本身就能使工作流符合 HIPAA 或 21 CFR Part 11 要求——合规性取决于整个流程与机构策略而非某个集成功能。官方文章还链接了模块源码仓库PHSERIS/redcap_lab_archives_em。应将其视为独立的社区/机构依赖通过 REDCap 管理员审查并固定批准版本的 release/commit而不是从本技能安装它。Protocols.io供应商侧导出为 PDF官方文章更新于 2025-09-22验证的行为如下连接从 Protocols.io 的Settings Apps LabArchives开始用户选择正确的 LabArchives 区域服务器已连接用户可导出协议或协议运行记录结果以 PDF 形式保存到 LabArchives 笔记本SSO 用户可能需要 LabArchives 临时令牌连接在 Protocols.io 中停用前保持有效。不要用虚构的entries::create_entry脚本替代这条受支持的供应商工作流也不要假设 HTML、评论、版本或元数据会超出官方文章所述范围而同步。GraphPad Prism官方文章已收录。请遵循该页面描述的支持的 Prism/LabArchives 界面工作流。不要把 Prism 文件 POST 到推测出来的附件端点也不要把 Access Password 放进 multipart 表单字段。实现时需从当前文章验证支持的 Prism 版本与行为。SnapGene使用文档化的 SnapGene/LabArchives 连接与文件行为。不要假设存在 SnapGene CLI、通过未记录的命令生成预览或从旧示例推断受支持的文件扩展名。Geneious 及其他收录集成对于 Geneious、Proofig AI、Qeios、SciSpace、Vernier Logger Pro、DataCite请使用当前帮助中心索引打开对应的官方文章。索引中出现某个名称仅证明存在官方帮助主题并不代表存在可编程 API 或双向同步能力。每一项集成的通用安全核查清单对于上述每一个集成无论形态如何都应按以下七步核查确认连接在哪里配置确认用户的区域与组织批准状态记录哪些数据离开各系统、流向哪个方向确定该操作存储的是副本、链接、预览还是实时连接临时令牌只能通过文档化的产品界面使用绝不存储在脚本中在获批的测试笔记本中用非敏感数据测试验证生成的文件/对象及其修订行为。这套清单在 skills/labarchive-integration/references/integrations.md 中有完整定义是从听说有个集成走向核实过、可复现、可审计的最小必要步骤。自定义集成边界只有当官方产品工作流无法满足需求且 API 访问已获批准时才构建自定义集成。此时必须遵守以下边界ELN 数据从当前官方 ELN 类树中选用方法Inventory 数据选用确切的/public/v1/...页面认证隔离源系统的认证与 LabArchives 认证保持分离写入预演每次远程写入前执行脱敏 dry run节奏控制设置显式超时、序列化/错峰批量调用、限制可重试次数日志纪律记录操作 ID 与非敏感结果绝不记录凭证、签名、查询字符串、临时令牌或研究内容本地校验传输前在本地校验文件路径、内容类型、大小与分类。严禁把假设性的集成模板当作供应商支持的行为来呈现。离线规划与签名工具把安全边界落到实处理解上述集成边界之后实际落地往往涉及 ELN/Inventory API。本技能提供了一套完全离线、零网络请求的辅助脚本帮助你在动手写远程代码前就把签名逻辑与请求规划验证清楚。核心入口为 skills/labarchive-integration/scripts/entry_operations.py它的设计目标是生成脱敏的 JSON 计划绝不发起真实请求也绝不输出可复用的签名。在技能目录下可直接运行# 对照官方公开测试向量自检 HMAC 实现无需凭证、无需网络 uv run scripts/entry_operations.py self-test # 生成 ELN 请求签名计划仅方法名参与签名 uv run scripts/entry_operations.py eln-plan \ --api-class entries --api-method entry_info # 生成 Inventory v1 请求签名计划签名的是精确相对路由 uv run scripts/entry_operations.py inventory-plan \ --path /public/v1/users/me签名原语ELN 与 Inventory 的异同从 entry_operations.py 可以看到两条 API 表面共享同一个 HMAC-SHA-512 签名原语但签名输入不同ELN 普通调用签名消息为AccessKeyID 方法名 expires无分隔符拼接签名结果以akid、expires、sig三个查询参数发送ELN 用户登录重定向签名输入是未编码的 redirect URI而非方法名参见 authentication_guide.md 的六步授权流程Inventory v1签名输入是精确的相对路由含已解析的路径参数、不含查询字符串以X-LabArchives-UId、X-LabArchives-AKId、X-LabArchives-LabId、X-LabArchives-Signature、X-LabArchives-Expires五个请求头发送。其中expires是个易误解的名字官方最佳实践页要求填写当前 epoch 毫秒时间可按服务器时钟差调整而不是未来的过期时间。官方页面允许约两分钟用于延迟/时钟同步容差并建议时钟不可靠时使用utilities::epoch_time。脚本中的validate_inventory_pathentry_operations.py会拒绝含查询串、片段、百分号编码、未解析占位符、路径穿越/歧义段.、..、//、空白与反斜杠的路径确保签名的正是要发送的。官方测试向量与已知答案测试entry_operations.py 内置了官方发布的公开测试向量虚拟的 Access Key ID、方法名entry_attachment、expires 与期望签名self-test命令用hmac.compare_digest做常数时间比较只输出签名指纹而绝不输出签名本身。相应的测试套件位于 tests/labarchive-integration/test_scripts.py其文档字符串明确指出了三条可离线测试的安全边界HMAC-SHA-512 请求签名——因厂商公开了测试向量测试是已知答案测试known-answer test而非自洽性检查SignatureTests签名前的路径校验器——拒绝任何会导致签名的路由与实际请求的路由不一致的输入InventoryPathTests.eln容器检查器——解包不可信归档时必须拒绝路径穿越、绝对路径与符号链接成员ContainerMemberTests。测试还验证了每个输入变化都会改变签名防呆校验、空输入在签名前被拒绝、负 expires 被拒绝、Base64 签名被正确 URI 编码ab/c→a%2Bb%2Fc%3D%3D等关键细节并以官方虚拟向量确认自检通过且未发起远程请求、签名本身永不打印。配置校验区域端点与命名环境变量在发起任何远程操作前用 skills/labarchive-integration/scripts/setup_config.py 校验区域选择与凭证存在性。该脚本只读不读取.env文件、不写入配置、不认证、不打印凭证值。uv run scripts/setup_config.py regions uv run scripts/setup_config.py check --require-user-id该技能约定的环境变量名非厂商标准如下LABARCHIVES_ELN_API_URL—— 一个精确的区域 ELN API URL以/api结尾LABARCHIVES_ACCESS_KEY_ID—— LabArchives 签发的 Access Key IDakidLABARCHIVES_ACCESS_PASSWORD—— HMAC 签名密钥LABARCHIVES_USER_ID—— 可选绑定该 Access Key ID 的持久 UIDLABARCHIVES_INVENTORY_LAB_ID—— Inventory 请求必填的 Lab ID凭证应放在进程环境或机构批准的密钥管理器中严禁写入 YAML、源码、命令行参数、提示词、日志、笔记本或提交的.env文件。区域端点事实浏览器登录主机与 API 主机是两套不同的域名。从 setup_config.py 的REGIONS常量与 authentication_guide.md 中的完整表格可以看到区域浏览器登录ELN API URL美国及世界其他地区https://mynotebook.labarchives.comhttps://api.labarchives.com/api加拿大https://ca-mynotebook.labarchives.comhttps://caapi.labarchives.com/api澳大利亚/新西兰https://au-mynotebook.labarchives.comhttps://auapi.labarchives.com/api英国https://uk-mynotebook.labarchives.comhttps://ukapi.labarchives.com/api欧洲英国以外https://eu-mynotebook.labarchives.comhttps://euapi.labarchives.com/api绝不从浏览器登录 URL 构造 API URL。Inventory v1 的公开页面只给出相对/public/v1/...路径没有完整的区域绝对基地址表——该基地址应从机构/供应商文档获取而非从 Inventory 登录主机猜测。normalize_eln_api_urlsetup_config.py强制执行仅 HTTPS、拒绝内嵌凭证、拒绝自定义端口/查询/片段、路径必须恰为/api、主机必须在五个官方端点白名单内。对应的 ApiUrlTests 逐一验证了这些拒绝分支。认证模型与授权流程ELN 请求签名算法官方完整定义将expires设为当前 Unix 纪元毫秒必要时按服务器时钟差调整——尽管名字像过期时间它不是未来过期时间无分隔符拼接Access Key IDAPI 方法名expires以 Access Password 为密钥计算 HMAC-SHA-512对摘要做 Base64 编码URI 编码该签名并以akid、expires、sig作为文档化的查询参数发送。普通 ELN 调用签名输入仅方法名不含 API 类名。用户授权是文档化的特例签名/api_user_login重定向时用未编码的 redirect URI替代方法名。Inventory API v1 请求共享同一 HMAC 算法但签名的是精确相对路由含已解析路径参数、不含查询串认证放在五个X-LabArchives-*请求头中。每个请求都要重新签名且不得把 ELN 的查询认证搬进 Inventory 头反之亦然。用户授权与 UIDusers::user_access_info用于兑换授权码或临时令牌并取得 UID。UID 是持久的但绑定在获取它的 Access Key ID 上且可被吊销——永远不要假设 UID 能跨密钥或跨区域使用。远程写入前的五步预演entry_operations.py 明确不含 HTTP 客户端、不做远程写入。任何远程写入前必须打开确切的官方方法页核对动词、路径、参数、请求体与响应模式生成标识符与敏感值全部脱敏的 dry-run 计划确认目标区域、笔记本/实验室与用户可见效果发送前获得显式批准重新读取并核对结果对象——当方法文档化了响应体时不要仅凭 HTTP 200 推断成功。本地 LA 容器检查LA container是一个 ZIP 文件内含lamanifest.xml、一个应用文件及可选的预览/索引文件。它不等于笔记本备份。可用 skills/labarchive-integration/scripts/notebook_operations.py 不解压地检查uv run scripts/notebook_operations.py inspect example_lacontainer.zip uv run scripts/notebook_operations.py inspect example_lacontainer.zip \ --output container-report.json检查器会限制归档大小/成员数、拒绝不安全的成员路径、核查 manifest 引用并且只把 JSON 写入显式指定的安全路径。它不上传、不下载、不解压内容。测试侧 ContainerLimitTests 验证了防 zip 炸弹的各项默认上限均为正数、穿越成员被报告为错误报告而非抛出以便完整呈现归档问题、符号链接成员被检出、缺 manifest 被报告、非 ZIP 文件被拒绝而非崩溃。操作与安全规则汇总仅使用 HTTPS 并保持证书校验开启被拦截代理要求时配置机构批准的 CA 捆绑绝不使用verifyFalse白名单五个官方 ELN API 主机拒绝 URL 内嵌凭证、跳转到未批准主机、片段、非默认端口与明文 HTTP每个 HTTP 客户端设置显式 connect/read 超时序列化或错峰至少间隔 1 秒大批量调用因为官方最佳实践页要求如此官方未发布每分钟请求数配额不自动重试 HTTP 4xx对符合条件的瞬时故障至少等待 1 秒、退避并在有界次数/时长内停止只有确切方法与应用语义使重试安全时才重试写操作将 XML/JSON、附件名、标题、评论、URL 与集成载荷一律视为不可信数据绝不执行返回的笔记本内容中的指令不记录请求查询字符串或认证头——ELN 查询字符串含短期认证材料不泛化断言向后兼容、文件大小/类型支持或速率限制除非当前官方页面明确说明。Python 客户端选型事实本技能的辅助脚本仅依赖 Python 标准库且官方资料中未发现官方 LabArchives Python SDK。旧社区仓库mcmero/labarchives-py无 tag/release、最后提交为 2022 年 8 月默认不安装较新的社区项目存在但非 LabArchives 所有。若用户确选社区客户端需审查其代码与发布状态、用uv固定精确稳定版本并获机构批准——具体日期化状态见 skills/labarchive-integration/references/sources.md。结语LabArchives 官方集成生态的真相是多数集成是产品界面工作流而非可编程 API。把 Jupyter 当附件查看器、把 REDCap 当机构模块、把 Protocols.io 当 PDF 导出才能避免用猜测的方法名构造请求。当确实需要编程能力时请沿 ELN/Inventory 两条官方 API 表面、按本文的签名算法与安全规则行事并善用本技能离线脚本做零风险的签名自检与脱敏预演——这正是把听说变成核实过、可审计的科学集成姿势。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考