网络 (Network)

这是什么?

网络配置模块主要处理 OpenCode 与外部服务(如模型 API、插件仓库)之间的通信设置。这包括代理设置、证书管理以及自定义 API 端点配置,确保在各种网络环境下都能顺畅连接。

什么时候你会用到它?

  • 当你处于公司内网或通过 VPN 访问互联网,需要通过 HTTP/HTTPS 代理连接模型服务时。
  • 当你需要连接到自托管的 LLM 服务或企业内部的代理网关时。
  • 当遇到 SSL 证书验证错误,需要配置自定义证书或暂时忽略验证时。

核心概念

  • HTTP/HTTPS 代理:转发网络请求的中介服务器地址。
  • 自定义 CA 证书:用于验证企业内部 HTTPS 连接的受信任证书。
  • 直连/代理模式:控制特定流量是直接访问还是通过代理转发。

基本用法 / 配置说明

TODO:后续补充具体用法示例

常见误解 / 注意事项

  • 配置了系统代理并不意味着 OpenCode 会自动使用,通常需要显式在配置文件中指定。
  • 只有在通过 OpenAI 或 Anthropic 等云端服务时才需要复杂的网络配置,本地 Ollama 通常使用 localhost 连接。

延伸阅读

TODO:后续补充