Cline 接入数眼智能教程

Cline 是一款极其强大的 VS Code 智能编程插件，它能够在你的授权下自主读取项目、创建/编辑文件、运行终端命令，甚至使用浏览器。

本文将引导你通过 OpenAI 兼容模式，将 Cline 的底层大脑无缝切换为 数眼智能 提供的模型服务。

一、接入前准备（核心 3 要素）

在开始配置前，请先明确以下 3 个核心参数：

配置项	推荐填写内容	注意事项
API Key	`sk-xxxxxxxxxxxxxxxx`	请填写纯文本密钥，不要带 `Bearer` 前缀。
Base URL	`https://platform.shuyanai.com/v1`	必须包含 `/v1`。
模型名称	例如 `deepseek-v3.2-exp`	必须填写数眼智能实际支持且你账号有权限调用的模型名。

打开 VS Code，点击左侧活动栏的 扩展 (Extensions) 图标（或按 Ctrl+Shift+X）。

在搜索框中输入 cline。

找到官方正版 Cline 插件，点击 Install (安装)。

安装完成后，VS Code 左侧导航栏会多出一个小机器人头像的图标。点击它，即可唤出 Cline 的配置与交互面板。

请在弹出的设置页面中，按以下标准严格填写：

API Provider：点击下拉菜单，选择 OpenAI Compatible（极其重要，不要选其他官方专属选项）。

Base URL：填入 https://platform.shuyanai.com/v1。

API Key：粘贴你从数眼智能控制台获取的 sk-... 密钥。

Model ID：手动输入你想使用的数眼智能模型全称（例如 deepseek-v3.2-exp）。

高级选项 (可选)：第一次配置时，建议不要随意修改 Temperature 等高级参数，保持默认即可。

填写完毕后，点击面板最下方的 Done 或直接开始对话，配置会自动保存。

配置完成后，建议先进行一个无破坏性的“最小测试”，以验证接口是否打通。

在 Cline 底部的对话框中，发送以下指令：
请不要修改任何代码，只简单分析一下当前项目 src 目录下的文件结构。

🟢 成功标志：如果 Cline 能正常思考（输出 Thought 过程）并返回项目结构分析，说明接入完美成功！

🔴 失败标志：如果提示 API Error、Fetch Failed 或一直转圈，请参考下方常见问题进行排查。

Q1：为什么提示认证失败 (Authentication Failed) 或 API Key 无效？

请检查填写的 API Key 是否包含多余的空格，或者误填了 Bearer 前缀。这里只需要最原始的 sk-... 字符串。

Q2：为什么一直提示网络连接失败 (Fetch failed)？

最常见的错误：检查 Base URL 是否漏写了结尾的 /v1。必须是 https://platform.shuyanai.com/v1。

检查 API Provider 是否确实选择了 OpenAI Compatible。如果选成了 Anthropic 或 OpenAI 官方，它会无视你的 Base URL，强行连接被墙的海外服务器。

Q3：为什么提示模型不存在 (Model not found)？

Model ID 字段必须与数眼智能平台上真实存在的模型名称一字不差。请勿凭直觉简写（例如把 deepseek-v3.2-exp 写成 deepseek-v3.2）。