用途:在 DNAnexus 上构建、运行和运维基因组学工作负载,涵盖 dx CLI 与 dxpy 自动化、文件/记录/文件夹/项目与元数据、由 dxapp.json 定义的 app 与 applet、作业与分析的重试监控和成本控制,以及原生工作流、经 dxCompiler 的 WDL/CWL 和 Nextflow 导入。文档基线为 dxpy==0.415.0、dxCompiler 2.18.0(2026 年)。
主要能力:数据上传下载与组织(大文件建议用 Upload Agent)、dxpy 精确搜索(find_data_objects 默认精确匹配,需 glob 时传 name_mode="glob")、applet 构建与校验(scripts/validate_dxapp.py、dx build)、带显式目的地和成本上限的作业启动、作业/分析监控与输出引用链式执行。
必要用法:安装 uv tool install "dxpy==0.415.0";交互登录 dx login、dx whoami、dx select、dx pwd;先只读预检(dx --version、dx whoami、dx ls),解析项目名到 project-... ID,确认目标与费用后再变更。启动示例如:dx run "applet-xxxx" --input-json-file "inputs.json" --destination "project-xxxx:/runs/run-001" --cost-limit 25。
限制:涉及计费启动、大量出入流量、归档、删除、权限变更等需先确认;不得打印或持久化 DX_SECURITY_CONTEXT 或 API 令牌,避免在捕获日志中运行 dx env;登录会话默认 2 小时无活动过期,最长 18 小时;作业通常有 30 天运行时限;新配置建议 Ubuntu 24.04;示例需在目标账户测试,本次评审未执行认证平台运行。