onescience-installer

输入获取方式

本技能支持两种输入方式：

1. 上下文 handoff（默认）：从调用方传入的 step_handoff 获取任务信息。
2. 文件 handoff（autonomous_mode）：从 .onescience/handoff/step_{step_id}.yaml 读取任务信息。执行后，将结果写入 .onescience/handoff/step_{step_id}_result.yaml。

启动时优先检查 .onescience/handoff/ 目录是否存在对应的交接文件；若存在则使用文件模式，否则使用上下文模式。

文件交接格式参见 skills/onescience-orchestrator/references/file_handoff_contract.md。

OneScience 安装器

主流程

1. 读取根目录 onescience.json。
2. 校验运行站点配置：
   • 必须能从 onescience.json.runtime.execution_profile.run_site 获取 local 或 remote。
   • 当 run_site=remote 时，必须能从 onescience.json.runtime.ssh 获取 SSH 信息。
   • 如果缺少 run_site，或 run_site=remote 但 SSH 信息不完整，读取 ./references/runsite-handoff.md，调用 skills/onescience-runsite 补齐配置；只有 runsite 成功写回或更新 onescience.json 后，才能继续安装流程。
3. 读取 ./references/discover-route.md，识别用户意图、安装领域、Python 包列表、runtime.conda 状态和目标环境路径。
4. 根据“意图 + 环境路径 + conda 状态”读取对应分支文件，并且只读取命中的分支文件。
5. 需要渲染探测、下载、安装、验证命令时，读取 ./references/install_flow.md。
6. OneScience 自身是特殊 bootstrap 目标，不属于普通 Python 包：安装 onescience、OneScience 环境、earth/cfd/bio/matchem/all 时必须先执行 workspace_bootstrap_profiles.json.wheel.download_wheel_command 下载 wheel，再从已下载 wheel 的 METADATA 探测 Provides-Extra，然后按领域 + 加速卡选择匹配 extra，并通过 pip install "onescience[{resolved_extra}]" -i http://mirrors.onescience.ai:3141/pypi/simple/ --trusted-host mirrors.onescience.ai 安装；不得把下载下来的 wheel 当作安装载体，也不得渲染 pip install onescience、python -m pip install onescience 或把 onescience 放入 {python_packages}。
7. 检测成功、安装成功且验证成功后，若 install_intent 为 bootstrap 或 python_packages，读取 ./references/writeback-conda-state.md 写回 onescience.json.runtime.conda。若 install_intent=hpc_software，跳过 conda 写回（HPC 软件不依赖 conda 环境）。
8. 写回成功后，若当前任务带有上游 handoff / resume 信息，则返回调用它的技能继续执行；若没有明确调用方，则交回 onescience-orchestrator 规划后续任务。installer 不得自行推断新的业务 downstream skill；除文档中已明确的 runsite 补齐调用外，后续由谁执行一律由 caller 或 onescience-orchestrator 决定。

必要资产

• ./assets/backend_profiles.json：环境名、Python 版本、module 顺序、verify 口径。
• ./assets/workspace_bootstrap_profiles.json：OneScience wheel 来源、extras 探测与安装入口。
• ./assets/install_domains.json：earth/cfd/bio/matchem/all 到领域意图的映射。
• ./assets/hpc_software_profiles.json：HPC 科学计算软件（GROMACS、LAMMPS 等）的定义、下载地址、安装配置与验证命令。
• ./assets/conda_env.example.json：成功写回格式示例。