Agent 优先的工程平台：我们为什么用 Rust 把它搭成这样

⭐Terrain 开源地址：https://github.com/sopaco/terrain（MIT License）· 给 AI Agent 铺好「地图 + 道路 + 路标」的工程环境，欢迎 Star / Issue

前几篇我们讲了 Terrain做什么。这一篇，聊聊我们怎么做——以及背后那些值得拿出来讨论的架构取舍。

先说结论：Terrain 是Agent 优先（Agent-First）的架构，而不是「UI 优先」的架构。所有设计都围绕一个问题——如何让 AI Agent 最高效、最正确地理解并使用一个工程。

围绕这个问题，我们做了三件核心的设计决策，逐一展开。

决策一：把「领域核心」和「执行编排」彻底分开

Terrain 的第一层分层，是把系统拆成两个职责完全不同的 crate：

• terrain-core—— 领域核心。扫描、打包、检索、保鲜、注册，全程不碰 LLM；
• terrain-agent—— 执行编排。ChatEngine、知识生成、SDD 工作流、工具调用，负责「和 LLM / 外部 Agent 打交道」。