网络 (Network)
这是什么?
网络配置模块主要处理 OpenCode 与外部服务(如模型 API、插件仓库)之间的通信设置。这包括代理设置、证书管理以及自定义 API 端点配置,确保在各种网络环境下都能顺畅连接。
什么时候你会用到它?
- 当你处于公司内网或通过 VPN 访问互联网,需要通过 HTTP/HTTPS 代理连接模型服务时。
- 当你需要连接到自托管的 LLM 服务或企业内部的代理网关时。
- 当遇到 SSL 证书验证错误,需要配置自定义证书或暂时忽略验证时。
核心概念
- HTTP/HTTPS 代理:转发网络请求的中介服务器地址。
- 自定义 CA 证书:用于验证企业内部 HTTPS 连接的受信任证书。
- 直连/代理模式:控制特定流量是直接访问还是通过代理转发。
基本用法 / 配置说明
TODO:后续补充具体用法示例
常见误解 / 注意事项
- 配置了系统代理并不意味着 OpenCode 会自动使用,通常需要显式在配置文件中指定。
- 只有在通过 OpenAI 或 Anthropic 等云端服务时才需要复杂的网络配置,本地 Ollama 通常使用 localhost 连接。
延伸阅读
TODO:后续补充