模型配置全攻略：吾智作接入大模型的四个核心概念与完整配置步骤详解

 吾智作为何不生成内容？核心原因在于其本身不自带大模型。本文将详解模型配置入口、供应商类型、协议选择、默认模型设置及本机 opencode 接入方法，并提供密钥管理与避坑指南。

新用户安装吾智作后，常发现界面功能完备（活动树、内容库、发布渠道等），但在执行写作任务时无响应。这是因为吾智作仅作为工具平台，需外接大模型才能运行。如同工作室备齐了桌椅灯光，但尚未邀请“主讲人”入驻。

本文旨在指导用户为吾智作配置高效的“大脑”。

一、核心原理：大模型在系统中的角色

配置前需明确模型的功能定位。吾智作中的智能操作均依赖后端模型处理：

模型是系统的核心引擎。配置得当可确保写作流畅、翻译准确；配置不当则可能导致发布失败或报错“大模型不可用”。

二、配置入口：模型中心

配置路径统一且集中：

系统设置 → 模型中心

尽管系统设置包含网络代理、SMTP、技能路由等多项配置，但所有模型相关设置均集中在模型中心。此处配置直接同步至后台，避免“显示已配置但实际调用失败”的问题。

进入后可见模型供应商列表，典型配置如下：

以下将详细解析关键概念与操作步骤。

三、关键概念解析

1. 供应商（Provider）

供应商指模型服务的接入配置，包含三项核心要素：

• 名称：自定义标识，便于区分。
• 接口地址（Base URL）：服务商提供的 API 端点。
• 密钥（API Key）：身份验证凭证。

出于安全考虑，列表中的密钥均进行脱敏处理（如 sk-****ZuN8）。如需查看或复制完整密钥，需进入编辑弹窗重新输入。

2. 类型：Official 与 Relay

• official（官方直连）：直接对接模型厂商（如 DeepSeek、MiniMax）。稳定性高，权责清晰。
• relay（中转/代理）：通过第三方服务转发请求。优势在于成本低、额度灵活；劣势在于需承担额外的隐私风险及潜在的稳定性波动。

3. 协议选择

协议决定了吾智作与服务端的通信格式：

• openai：通用性最强，兼容绝大多数国产模型及中转服务。新手推荐首选。
• anthropic：适用于 Claude 系列模型。
• gemini：适用于 Google Gemini 系列模型。
• ollama：适用于本地部署的 Ollama 框架模型。

4. 默认供应商

标记为 isDefault 的供应商即为系统默认的 AI 出口。此外，进阶用户可通过技能路由（skill_routing）配置，将不同任务（如写作、分析）分配给特定的模型，以优化成本与性能。

四、添加模型供应商流程

操作步骤

1. 进入 系统设置 → 模型中心。
2. 点击 添加模型供应商。
3. 填写核心信息：
• 名称：便于识别，如“DeepSeek”。
• Base URL：严格复制服务商提供的接口地址，注意保留 /v1 等后缀及斜杠。
• API Key：填入服务商后台生成的密钥。
4. 选择 类型：官方直连选 official，中转选 relay。
5. 选择 协议：不确定时选 openai。
6. 勾选 设为默认（可选）。
7. 保存。

保存成功后，系统将自动同步该供应商下的模型目录（Seed），无需手动录入模型名称。

设置默认模型

配置供应商仅是建立连接，还需在模型目录中指定具体的默认模型，否则写作、翻译等功能无法执行。

五、修改与删除注意事项

可在模型中心编辑现有供应商以更新密钥或地址。

修改密钥提醒：若仅更换 Key，请勿清空 Base URL 字段，以免误删配置。

删除风险提示：删除供应商将同步移除其关联的所有模型。若被删供应商为默认供应商，系统将失去 AI 出口导致功能报错，需立即指定新的默认供应商。

六、本机 Opencode 接入指南

“本机 opencode”是一种特殊的 Relay 类型供应商，利用本地运行的 opencode 服务作为模型网关。其优势包括数据隐私保护、无云端 API 消耗及离线可用性。

6.1 安装 Opencode CLI

Opencode 是一款开源终端 AI 代理，可作为本地模型网关。

Windows 系统：

# 方式一：Chocolatey（推荐）
choco install opencode

# 方式二：Scoop
scoop install opencode

# 方式三：npm（需预装 Node.js）
npm install -g opencode-ai

# 方式四：下载二进制文件
# https://github.com/anomalyco/opencode/releases

macOS / Linux 系统：

# 方式一：一键脚本（官方推荐）
curl -fsSL https://opencode.ai/install | bash

# 方式二：Homebrew（注意版本差异）
brew install anomalyco/tap/opencode

# 方式三：npm
npm install -g opencode-ai

# 方式四：Arch Linux
sudo pacman -S opencode

安装完成后，终端运行 opencode --version 验证安装。

注意：npm 包名为 opencode-ai；Windows 暂不支持 Bun 安装。

6.2 配置 Opencode 模型连接

Opencode 需连接具体模型方可工作，有两种方式：

方式 A：使用 Opencode 官方托管服务

opencode

在交互界面输入 /connect，按指引注册并绑定 API Key。

方式 B：复用已有云端 Key

可配置 MiniMax、DeepSeek 等已有密钥。配置文件位于 ~/.config/opencode/opencode.json （Windows 为 %USERPROFILE%\.config\opencode\opencode.json）。建议使用 /connect 命令交互式配置以减少错误。

6.3 启动本地服务

吾智作需连接固定的本地 HTTP 服务端口（默认 4096）。

# 默认启动
opencode serve

# 指定端口（推荐，避免冲突）
opencode serve --hostname 127.0.0.1 --port 4096

# 启用密码保护（建议）
OPENCODE_SERVER_PASSWORD=your-password opencode serve

关于密码：设置 OPENCODE_SERVER_PASSWORD 后，需启用 HTTP Basic 认证。吾智作中“本机 opencode”的密钥栏应填入此密码。

关于端口：务必使用 opencode serve 指定固定端口，而非 TUI 模式的随机端口。

关于 CORS：若前端直连受阻，可添加 --cors 参数允许特定来源：

opencode serve --cors http://localhost:30008 --cors http://127.0.0.1:30008

（请将 30008 替换为吾智作实际端口。）

6.4 吾智作接入配置

1. 进入 系统设置 → 模型中心。
2. 编辑或新建“本机 opencode”供应商。
3. Base URL：填 http://127.0.0.1:4096。
4. API Key：填入设定的 OPENCODE_SERVER_PASSWORD（若无密码则留空）。
5. 类型：选 relay；协议：选 openai。
6. 保存后，在模型目录中将 opencode 提供的模型设为默认。

6.5 常见故障排查

现象：提示“本机 opencode 不可用”

1. 检查服务状态：终端运行 curl http://127.0.0.1:4096/global/health，应返回 {"healthy":true,...}。
2. 确认端口一致：确保吾智作配置的端口与 opencode serve 指定的端口一致。
3. 核对密码：检查 OPENCODE_SERVER_PASSWORD 是否匹配，注意特殊字符。
4. 检查 CORS：若前端直连，确保启动了 --cors 参数。
5. 确认模型连接：Opencode 自身必须已通过 /connect 连接有效模型。

6.6 关于 Base URL 显示为 “—”

“本机 opencode”为系统内置的本机中转条目，列表界面仅显示类型标记，实际地址存储于配置文件中，不影响功能使用。

6.7 配置总结

安装 CLI → /connect 配置模型 → opencode serve --port 4096 启动服务 → 吾智作填写地址与密码 → 设置默认模型。

七、故障排查指南

遇到 AI 功能报错时，请参照以下症状排查：

报 401 / 未授权：密钥错误或过期。检查复制时是否包含空格或换行，建议重新生成密钥。

报 404 / 找不到接口：Base URL 错误。检查 /v1 后缀及斜杠，建议直接复制官方文档地址。

报超时 / 响应慢：可能是服务商拥堵或模型过大。尝试切换轻量级模型以区分网络问题与模型性能问题。

报“模型不存在”：模型名称拼写错误或该供应商不提供此模型。请核对模型目录中的可用模型名。

AI 功能无反应：通常因未设置默认模型或默认供应商缺失。请检查模型中心的默认标记。

部分功能异常：检查技能路由配置，确认该功能是否被定向至其他供应商。

八、实战搭配建议

为确保稳定高效，建议采用以下分层配置策略：

• 主力模型：选择一个稳定、好用的官方直连模型设为默认，处理日常写作与翻译。
• 备用模型：配置另一厂商的官方供应商，不设默认。当主力模型故障时可快速切换。
• 兜底方案：保留本机 opencode，应对断网或隐私敏感场景。
• 成本优化：通过技能路由，将批量摘要、翻译等机械性任务分配给低成本模型，重要创作使用高性能模型。

九、配图说明

建议在实际操作中截取以下界面以辅助理解：

1. 模型中心列表：展示供应商列表、密钥脱敏效果及默认标记。
2. 添加供应商弹窗：展示名称、Base URL、API Key、类型、协议等字段。

截图技巧：保留浏览器左侧导航栏，以便读者定位“系统设置”入口。

十、参考链接

• Opencode 官方文档：https://opencode.ai/docs/
• Opencode 本地服务配置：https://opencode.ai/docs/server/
• Opencode GitHub Releases：https://github.com/anomalyco/opencode/releases
• Opencode 模型连接指南：https://opencode.ai/docs/providers

结语

优秀的工具应尽量降低用户的认知负担。吾智作通过集中的模型配置页面、自动脱敏及目录同步功能，简化了接入流程。用户仅需明确三点：

1. 模型来源：官方直连还是中转？
2. 默认选择：谁是主力，谁是备胎？
3. 兜底机制：断网或故障时的替代方案。

完成上述配置后，即可专注于内容创作本身。若遇到“同一提示词在不同模型下表现差异大”的情况，建议优先调整提示词而非频繁更换模型。