OpenCode Zen / Go · DeepSeek 接入

用于给统一 AI 调用层配置 OpenCode 的 DeepSeek Chat Completions 模型。企微粘贴消息回复、客户画像等继续沿用原有场景模型、额度、权限及租户隔离规则。

配置位置与字段

1. 在 PC 后台打开 AI模型管理，新增模型，点击 OpenCode Zen · DeepSeek。
2. 快捷配置填写以下内容；保存前按 OpenCode 控制台核实模型标识。

字段	快捷配置	说明
服务商	OpenCode Zen	表示模型由 OpenCode 提供
模型标识	deepseek-v4-pro	可编辑，须使用账户实际有权限的 DeepSeek 模型 ID
API 地址	https://opencode.ai/inference/openai/v1/chat/completions	Chat Completions 完整端点；也可填写同路径的 /v1 基础地址
API Key	留空，管理员填写	不要放入 H5、源码、截图或聊天
能力	文本、流式输出、工具调用	按所选模型的实际能力调整
输出预算	保留表单已有值	不自动改变原模型的输出预算或系统默认模型

3. 使用 Zen 时填入对应密钥；使用 Go 额度时，将 API 地址改为 https://opencode.ai/inference/go/v1/chat/completions，使用 Go 账户对应的密钥与有权调用的模型，例如本次已验证的 deepseek-v4.1-flash。服务商可标注为 OpenCode Go。保存并按原流程启用模型，新增模型不会自动变成系统默认模型。
4. 为需要的 AI 场景选择此模型。只使用企微回复助手时，优先配置对应场景，避免影响其他业务。
5. 在模型测试工具中发送不含客户资料的问题验证。例如“请计算17加26，只回复数字”，预期43。随后在已绑定客户的 H5 回复助手中验证消息、候选及用量记录。

切换快捷配置会清空表单中的原 API Key；修改已有模型的 API 地址时，后台要求重新填写密钥。只编辑名称等其他字段仍保留原密钥。

本次开发库 Go 验收使用 deepseek-v4.1-flash，上下文窗口 8192、最大输出 4096。画像请求在 2048 和 4096 输出预算时均曾返回 finish_reason=length，日志确认包含推理输出。Go 小请求实测支持 thinking: {"type":"disabled"} 且返回 0 推理 tokens；回复与画像场景因此显式关闭 DeepSeek 推理，适配器对 OpenCode DeepSeek 转发此参数。不要只靠加大预算或无限自动重试解决截断，也不能展示不完整画像。

实际支持范围

• 支持 DeepSeek 的 Chat Completions 同步及 SSE 流式输出、工具调用，以及输入、输出、缓存命中用量解析。
• 兼容 OpenCode 的 /inference/openai/v1（Zen）、/inference/go/v1（Go）及其完整 Chat Completions 地址；历史 /zen/v1、/zen/go/v1 路径在调用时补齐端点，不代表账户一定有这些入口的使用权。
• 仅对 OpenCode 域名补齐路径，现有其他供应商的完整接口地址保持原样。
• Claude Messages、GPT Responses 和 Gemini 原生协议不在本次范围，不能把这些端点填入当前适配器。
• 显式设置的 DeepSeek thinking 开关适用于直连 DeepSeek 及 OpenCode 的 deepseek- 模型；其他供应商及模型不发送此参数。未设置开关的其他场景保留服务商默认行为。回复完整性检查、输出预算和失败处理保留。
• OpenCode Go 官方面向编程代理流量，用途和额度限制须遵循服务商规则。本系统使用真实的 Youyi-AI/1.0 请求身份，不将业务请求伪装为编程流量。企微回复与画像按租户、员工、客户产生稳定且不包含原始内部 ID 的 x-opencode-session，不代表服务商会保留聊天上下文；实际上下文仍由后端显式传入。
• Go 与 Zen 是不同入口，Zen 余额不足时不会自动改用 Go，Go 调用失败也不会自动回退到 Zen。使用情况以 OpenCode 控制台账单为准，本系统用量记录只证明实际调用模型和返回 token。
• 只解析合法且自洽的缓存用量；供应商未返回时保持未知，不写成零命中。缓存明细不等于供应商最终账单，业务计费仍按系统现有规则执行。

验收边界

单元测试通过 HTTP 拦截器模拟供应商同步响应、SSE、工具参数、异常及用量。真实验收须另外核对 H5 的回复、画像和用量记录，不能用模拟结果宣称实际鉴权、计费、模型质量或响应速度通过。

官方参考：模型与接口、Go 用途。模型和端点以控制台最新展示为准。