会话之外，OpenCode 还是一个能编程调用的服务。讲清 API/客户端/SDK 的边界、上下文压缩的取舍，以及一套可复制的排障流程。

把它接进真实工程要过四关：权限怎么设才不形同虚设、MCP 怎么接、插件怎么管、以及快照到底能救什么、救不了什么。

三个能自定义的东西经常被混用。用一个比喻理清：agent 是"谁来干"，skill 是"怎么干"，command 是"一键开干"。

provider/model#variant 这套引用怎么用、本地模型怎么被自动发现、变体怎么帮你控成本，以及几个容易配错的地方。

OpenCode 有两套互不相干的配置：管行为和管界面的。分不清它们，你会一直困惑"为什么这个设置没生效"。

OpenCode 不只是一个终端界面，它默认跑着一个后台服务。理解这套架构，后面配权限、插件、API 才不会一头雾水。