用途:数字孪生宇宙(DTU)是按需从声明式 profile 搭建的完整隔离环境,旨在弥合“本机测试通过”与“实际部署可用”之间的差距。库 amplifier_digital_twin_universe 承载全部能力,CLI 只是其薄封装,二者能力一致。
主要能力:确定型能力包括 manifest、check、validate-profile、launch、exec、status、list、check-readiness、update、file-push、file-pull、destroy;模型驱动能力包括 create-profile、install、doctor、manage,需配置模型提供方。写代码前应通过 --help 或库签名确认能力、参数与字段名,不要凭记忆补全。
使用方式:安装 CLI 用 uv tool install git+https://github.com/microsoft/amplifier-smart-tool-digital-twin-universe;作为库用 uv add 同样地址。先运行 check 了解本机能力。启动环境:amplifier-digital-twin-universe launch --profile ./profile.yaml,随后可用 exec、check-readiness、file-pull,最后 destroy。manage 只做计划,需 --confirmed 才执行。
前置与限制:incus 用于运行环境,docker 用于 mock 服务 sidecar,git 供模型能力使用,avahi 发布 .local 主机名;仅支持 Linux。环境长期存活且不会被自动回收,需自行销毁并先取出要保留的数据。每个 CLI 能力只向 stdout 输出一个 JSON 文档,失败返回结构化错误并以非零退出码结束。无提供方时模型能力直接失败,不会降级。