文档 · 快速开始
八步，从一个想法到一个可复查的成果
第一次用 Soma 的完整路径。每一步都能停下、回看、撤销。
先装好，再谈方法
Soma 支持 macOS、Windows 与 Linux。安装完成后第一次启动会先检查运行环境，确认 Python 与 R 的执行链路可用。
- 01安装并启动第一次启动会检查运行环境；需要时由 Soma 补齐应用自管的 Python 与 R 环境。
- 02连接模型提供方在设置里选择模型提供方并填入 API Key。密钥保存在本机，优先使用操作系统提供的安全凭据存储。
- 03新建研究，写下目标用一句话描述目标，或者直接选研究模式。写得越具体，后面需要纠正的地方越少。
- 04选择研究模式自动判定、文献研究、流行病学、临床研究、生物信息、实验设计。拿不准就交给自动判定。
- 05授权数据源与文件选择数据源不等于授权访问。取数之前逐项授权，之后随时可以撤回。
- 06看它执行，随时介入Agent 的每一步都显示在时间线里：读了哪个文件、调了什么工具、取回了什么。
- 07验收成果与证据成果中心按真实文件类型分组。从结论点回证据，再点回它来自的那一步。
- 08归档与交付完成的研究可以导出为 .science 包：对话分支、文件版本、Notebook 记录与验证证据随包带走。
一份写得清楚的目标长什么样
目标不需要写成正式的研究方案，但最好交代清楚四件事：要回答什么、数据范围、交付要求与约束。
目标 / 说明 EGFR 突变型非小细胞肺癌的耐药机制 数据 / 文献（近五年）· 表达谱 · 遗传变异 交付 / 带出处的证据表 · 机制图 · 可复现的分析脚本 约束 / 只用公开数据，不引用未经同行评审的结论
默认从最小权限开始：未被授权覆盖的动作会先问你。等一条流程跑顺了，再按需要放宽，而不是一开始就全放开。