開始使用

本指南是當前公開 Sounio 工作流程的實踐入口。假設你從已檢入的編譯器 artifacts 開始，使用 souc check 驗證，並將庫存閘道和測試資料視為當前實際支持的來源。

當前合同

• 最安全的文檔入口點是 $(pwd)/bin/souc 的可onical 啟動器。
• 第一件事是信任 check，而不是 run，因為執行路徑因主機 artifact 和後端支援而異。
• 已檢入的啟動器報告 souc 1.0.0-beta.5 今天（README 標誌可能會在版本調和期間讀作 1.0.0-beta.6）。默認公共工作流程是 自托管的本地 ELF/Mach-O — 不是 Rust/Cargo 編譯，也不是 Cranelift JIT 作為上門故事。
• 閘道支持目前強大，標準庫可靠性路徑 (251/251 在提交的 artifact 中)，fmri 和 darwin_pbpk 科學路徑，以及七個必需的高效執行路徑。
• 可選的 omega 配置文件 (Cranelift JIT, GPU) 與默認 bin/souc 合同分開。在文檔中記錄可用之前，使用 souc info 確認能力。

驗證這些文檔使用的序列

• "$SOUC_BIN" check examples/hello.sio 確認基本的 CLI 和標準庫路徑已正確連接到一起。
• "$SOUC_BIN" check tests/run-pass/covid_2020_kernel.sio 驗證當前的科學測試資料。
• "$SOUC_BIN" check tests/run-pass/vancomycin_propagation.sio 驗證當前的信心傳播路徑。
• "$SOUC_BIN" check tests/compile-fail/vancomycin_low_conf.sio 應該以文檔中記錄的信心不匹配失敗，證明拒絕路徑已啟用。

在庫中查看下一步

• examples/ 包含最小的上門程式，但不是每個文件都應該被視為等級生產準備。
• tests/run-pass/ 和 tests/compile-fail/ 是今天語言行為的最佳證據。
• artifacts/stdlib/*.json 記錄標準庫可靠性、科學路徑和超高效執行路徑的閘道支持狀況。
• docs/guide/MINIMUM_VIABLE_SOUNIO.md 解釋了本網站所遵循的保守合同。

最小先進程式

fn main() with IO {
    println("Hello, Sounio!")
}

深入之前注意事項

• 不要將頂級的 Cargo 編譯視為主要的公共上門路徑；它不再是此庫存狀態的最清晰故事。
• 不要僅僅因目錄存在而推斷支援。庫存中同時包含活躍的實現、存根、禁用文件和長期實驗。
• 如果你需要的功能超過了檢入的自托管的啟動器所暴露的範圍，使用 souc info 或重新構建不同的 artifact 配置文件之前，不要文檔中記錄為可用。