用途:在 Latch 平台上创建与维护生物信息学工作流,涵盖 Python SDK 任务图、Nextflow 与 Snakemake 流水线打包注册、数据与注册表操作、资源与界面配置,以及运行监控。
主要能力:构建 Python SDK 工作流与任务图;打包并注册 Python、Nextflow 或 Snakemake 流水线;配置任务 CPU、内存、存储、GPU、缓存、重试与超时;通过 LPath、LatchFile、LatchDir 或 CLI 操作 Latch Data;读写 Latch Registry 的项目、表与记录;设计工作流表单、启动计划、样本表、消息与结果链接;用 latch register --staging 与 latch develop 暂存和调试镜像;通过 Python 或 Latch MCP 启动与监控工作流;发现并使用现成工作流。
使用方式:目标 SDK 版本为 2.77.1,支持 Python 3.9–3.12。可复现环境示例:uv venv --python 3.12;source .venv/bin/activate;uv pip install "latch==2.77.1"。Windows 上文档化的 Linux 工具链建议使用 WSL。认证走 OAuth:latch login;latch workspace;已知工作区数字 ID 时可用 latch workspace --id 12345 非交互选择。快速路径:latch init covid-wf --template subprocess;latch register --yes --open covid-wf。远程镜像构建为默认,仅在本地有 Docker 守护进程且确需本地构建时用 --no-remote。工作流主体保持声明式,计算与副作用放在任务内,输入输出添加类型标注,用 dataclass 与枚举表达结构化参数。暂存与开发:latch register --staging . 后 latch develop .,改动 Dockerfile 或依赖后需重新暂存注册。注册常用控制:latch register --workspace-id 12345 .、--mark-as-release、--workflow-module wf.custom_entrypoint。普通重复注册退出码 2,暂存重复注册退出码 1;暂存使用当前工作区,不遵循 --workspace-id。启动建议走 Console 或 Latch MCP,Python 自动化优先使用 latch_cli.services.launch.launch_v2,不应把已弃用的 latch launch CLI 作为新集成模式。可运行 scripts/inspect_latch_sdk.py 检查已安装 SDK 符号,仅本地导入、不认证不联网。
适用场景:需要把生物信息学流水线封装为可运行、可注册、可监控的 Latch 工作流,并管理数据、注册表条目与交互式启动表单的场合。
限制:文档部分示例为说明性,刷新期间未执行认证注册、数据变更、启动或 MCP 调用;安装包与变更日志为准。不同版本轨道(尤其 Snakemake v2 教程)的 Python 范围与固定版本不同,不可混用命令与导入。Latch MCP 使用独立 OAuth,凭据不能复用于通用 SDK。启动付费计算(尤其 GPU 或大批量)前应确认;LPath.rmr、latch rmr、Registry 删除或覆盖共享目标前应确认;不得记录密钥、令牌、签名 URL;get_secret() 只在任务内调用且不得作为输出返回;不要用不受信任字符串拼接 shell 命令,优先 subprocess.run(..., check=True);发布应固定 SDK 与依赖版本。