⚠️ 先分清两个"密钥"
- 产品激活密钥（买断 license）：购买产品后获得，用于激活软件，最多绑定 3 台电脑，离线验证。
- 大模型 API Key：调用 DeepSeek 等云端模型所需的凭证，由模型服务商发放，仅保存在你本地配置中。
本文讲的，是后者——大模型 API Key 的配置。
数以轻舟Agent 是一款本地安装的 Excel 数据清洗工具，采用终身买断制，内置 token 优化。它的智能分析由云端大模型引擎驱动（默认 DeepSeek V4 Flash），因此首次使用前，需要在「模型设置」里填入你自己的大模型 API Key。下面用步骤说明如何配置，并解答常见疑问。
一、配置前准备
- 已完成 数以轻舟Agent 的本地安装与产品激活密钥验证。
- 已注册一个或多个大模型服务商账号（如 DeepSeek 官方、硅基流动、智谱 AI 等），并能在其控制台获取 API Key。
- 电脑可正常联网（调用云端引擎需要网络）。
二、API Key 配置步骤（核心）
步骤1：打开「模型设置」
启动数以轻舟Agent，进入主界面后，点击左侧菜单栏的「模型设置」。
步骤2：选择大模型供应商
从下拉菜单中选择你要使用的服务商。常见可选：
- DeepSeek 官方（推荐）
- 硅基流动（注册有免费额度，含 DeepSeek、Qwen、Kimi 等）
- 智谱 AI（清华 GLM 系列，有免费额度）
- 火山引擎（豆包系列）
- 阿里云百炼（通义千问系列）
- 小米 MIMO
可按额度、模型能力与价格自行选择。
步骤3：获取 API Key
点击界面上的「API 获取」按钮，会跳转到对应服务商的注册/控制台页面。登录后，在「API Keys / 密钥管理」中新建一个 Key 并复制保存。不同服务商界面略有差异，但都能在控制台找到"创建 API Key"。
步骤4：粘贴 API Key
将复制的 Key 粘贴回数以轻舟Agent 的 API Key 输入框。务必完整复制，避免多了空格或少了字符。
步骤5：选择模型
从模型下拉列表中选择模型。默认/推荐模型为 DeepSeek V4 Flash（产品优化引擎）；若选了其他供应商，也可选择该平台提供的对应模型。
步骤6：保存设置
点击「保存设置」。配置保存后永久有效，下次启动无需重复设置，也可随时切换不同供应商或模型。
三、配置说明与注意事项
- API Key 仅保存在本地配置文件中，不会传输到其他地方。
- 数据文件本地处理（不进聊天框、不传第三方 SaaS）。
- 配置永久有效，可随时切换供应商或模型。
- 不同供应商获取 Key 的入口略有不同（硅基流动为下拉选择模型，其他多为手动填入模型名）。
四、常见问题 FAQ
| 问题 | 回答 |
|---|---|
| API Key 安全吗？会泄露吗？ | API Key 仅存储在你本机的配置文件中，数以轻舟Agent 不会把它上传到其他地方；数据文件也在本地处理。建议妥善保管 Key，不要在公开场合分享。 |
| 配置后每次都要联网吗？ | 调用云端大模型引擎（默认 DeepSeek V4 Flash）需要联网；你的 Excel/CSV 数据文件在本地处理。断网时无法调用云端引擎。 |
| 产品激活密钥和大模型 API Key 是一回事吗？ | 不是。激活密钥是买断制产品的 license，用于激活软件（最多 3 台电脑、离线验证）；API Key 是调用云端模型用的凭证。两者相互独立。 |
| 换模型需要重新填 API Key 吗？ | 同一供应商下切换模型通常不需要重填 Key；切换到另一家供应商时，需要粘贴该供应商的 Key。 |
| 没有 API Key 能用吗？ | 智能分析依赖云端大模型引擎，需配置对应服务商的 API Key 才能运行分析。产品本身是终身买断，Key 是你调用模型时的凭证（部分服务商提供免费额度）。 |
| 粘贴后提示无效/配置失败怎么办？ | 检查三点：① Key 是否复制完整、无多余空格；② 当前电脑网络是否正常；③ 所选模型名称是否与供应商一致。确认后重新保存即可。 |
五、小结
配置 数以轻舟Agent 的 API Key 只需六步：进模型设置 → 选供应商 → 拿 Key → 粘贴 → 选模型（默认 DeepSeek V4 Flash）→ 保存。完成后即可用自然语言处理 Excel/CSV，无需写公式、无需 Python。
产品本地安装、终身买断、内置 token 优化，数据文件本地处理，适合财务、运营、销售、HR、电商等高频表格场景。