DeepSeek 完整接入（大陆首选）
图文分步截图 ｜ 面向零技术背景的学术用户 ｜ 中国大陆用户的推荐路径
如果你在中国大陆，或想用"充值多少花多少"的方式付费，这一篇就是给你的。它手把手带你从 DeepSeek 注册、充值、创建 API key，到在 Scholardo 里把 DeepSeek 跑起来——每一屏都有截图。
为什么大陆用户走 DeepSeek：中国大陆的手机号和银行卡通常无法注册、支付 Claude 订阅和 ChatGPT 订阅。DeepSeek 用国内手机号即可注册、国内常见方式即可充值，是最省心的选择。选择理由详见 P0-2《我该选哪个 AI？》。
前置条件
- 一台装好 Scholardo 的 macOS 电脑（若还没装，先看 P0-1 的第 1 步）。
- 一个能收验证码的手机号（用于在 DeepSeek 开放平台注册）。
- 一笔小额预算用于首次充值（先充一点试水即可；价格以 platform.deepseek.com 当前页面为准）。
一个重要认知：DeepSeek 这类第三方模型在 Scholardo 里是寄生在 Claude Code 上运行的——Claude Code 在这里充当"运载工具"（carrier）。你不需要为此再买一份 Claude 订阅，装的只是运行外壳。
⚠️ 中国大陆用户必看（安装 carrier 的坑）：Scholardo 在 chooser 里那个一键 Install 走的是
claude.ai的官方安装脚本，而claude.ai在中国大陆无法直连——所以在大陆点这个 Install 装不上 carrier。大陆用户请先用 npm 手动把 Claude Code 装好（走国内镜像）：只做 《中国大陆使用 Claude Code》 里的 「第 1 步：安装 Node 和 Claude Code」即可；那篇后面设 env-var 的步骤不用做——你走的是 app 内配置路线，Scholardo 会自动把端点指向 DeepSeek。carrier 装好后再回来做下面的第 4–6 步。
好消息是运行时没有墙的问题：carrier 一旦装上，DeepSeek 通过国内可直连的端点运行，无需 VPN。
第一部分 · 在 DeepSeek 开放平台拿到 API key
第 1 步 · 注册
- 浏览器打开 platform.deepseek.com。
- 用手机号注册并登录。
第 2 步 · 充值
- 进入平台的充值 / 余额页面。
- 充一笔小额即可（够你用几天试水）。价格与计费规则以 platform.deepseek.com 当前页面为准。
💡 建议首次只充一笔小额，用几天后到平台的用量页看看实际消耗，再决定要不要多充。
第 3 步 · 创建 API key，立即复制
- 进入平台的 API keys 页面，点击创建新的 key。
- 系统会生成一串以
sk-开头的字符——这就是你的 API key。
⚠️ 最关键的 callout：这串 key 只会完整显示这一次。请立即点复制并妥善保存（比如先粘到备忘录里）。一旦关掉这个弹窗，平台就不会再让你看到完整的 key 了——丢了只能重新创建一个。
第二部分 · 在 Scholardo 里配置 DeepSeek
打开 Scholardo，进入 设置（Settings）▸ AI Agent。
📌 重要变化：现在 key 和服务都在这一个「AI Agent」tab 里——AI API 和 Agent 已经合并成一个 tab，你不用在多个页面之间来回找了。
第 4 步 · 在「AI providers」段加 DeepSeek，粘贴 key
- 在 AI Agent tab 里找到 「AI providers」 段。
- 点该段的
+，在下拉里选 DeepSeek（若列表里没有现成的，可选 Add custom provider 自定义）。 - 把你刚才复制的
sk-开头的 API key 粘贴到 DeepSeek 的 key 输入框里。
该段脚注原文写道："Keys live in the AI providers section below and are stored only in your Keychain."——意思是你的 key 只保存在本机的 Keychain（钥匙串）里，不会上传。
第 5 步 · 在「CLI agents · Third-party」段启用 DeepSeek
- 在同一个 AI Agent tab 里，往下找到 「CLI agents · Third-party」 段。
- 点该段的
+。因为上一步你已经填好了 key，这里的 DeepSeek 已经就绪（如果 key 还没填，这里会显示 DeepSeek (needs API key) 提示你先去填 key）。 - 选 DeepSeek，把它加进第三方 agent 列表。
🎯 一句话记住这两步：「AI providers」段负责放 key，「CLI agents · Third-party」段负责把它变成一个能在终端跑的 agent。两段都在同一个 AI Agent tab 里。
第 6 步 · 回项目，开新 session，启动 DeepSeek
- 关闭设置，回到你的项目。
- 在右栏终端区新建一个 session（换一个 agent 就开一个新 session）。
- "Choose an agent"（选择 agent） 卡片出现，这次里面能看到 DeepSeek 那一行了。
- 点 DeepSeek 那一行启动。
- 如果这行显示 "Needs Claude Code installed" + 「安装 / Install」：说明运载工具 Claude Code 还没装。海外网络下点 Install 即可自动装好（滚屏正常，装完自动回来）；中国大陆下这个 Install 会失败（
claude.ai被墙），请按上文「中国大陆用户必看」先用 npm 把 carrier 装好，装好后这一行会自动变为就绪。 - 就绪时，这一行会显示类似
deepseek-v4-pro · Claude Code的摘要（模型名 · 运载工具），点它即可启动。
- 如果这行显示 "Needs Claude Code installed" + 「安装 / Install」：说明运载工具 Claude Code 还没装。海外网络下点 Install 即可自动装好（滚屏正常，装完自动回来）；中国大陆下这个 Install 会失败（
- 启动后，终端底部出现空输入框，键入你的第一句学术问题，比如：
总结 sources 里这篇 PDF回车，AI 的回答会一行行流出来。🎉
Shot list（截图清单）
拍摄总则：厂商界面（DeepSeek 开放平台的注册/充值/API key 页）必须如实截取，勿伪造/勿重绘/勿标注具体价格数字。Scholardo 界面用当前发布版、合并后的单个 AI Agent tab 截取。key 截图请打码，切勿泄露真实 key。
| 图号 | 截什么 | 界面来源 | 关键 callout / 圈注 |
|---|---|---|---|
| 1 | platform.deepseek.com 注册/登录页 | 厂商界面（DeepSeek，如实截取） | 圈出手机号注册入口 |
| 2 | 充值 / 余额页 | 厂商界面（DeepSeek，如实截取） | 图注"价格以官网当前页为准；建议先充小额" |
| 3 | 创建 API key 的弹窗，sk- 开头的 key + 复制按钮 | 厂商界面（DeepSeek，如实截取，key 打码） | 🔴 圈红"只显示这一次，立即复制" |
| 4 | Scholardo 设置 ▸ AI Agent tab 全貌，可见「AI providers」与「CLI agents · Third-party」两段 | Scholardo（合并后单 tab） | 圈出这是同一个 tab，字幕"key 和服务都在这里" |
| 5 | 「AI providers」段点 + → 选 DeepSeek → 粘贴 key 的输入框 | Scholardo | 圈出 + 与 key 输入框；引用脚注"只存在本机 Keychain" |
| 6 | 「CLI agents · Third-party」段点 +，DeepSeek 已就绪（对比：未填 key 时显示 needs API key） | Scholardo | 圈出"key 填了这里就亮了" |
| 7 | 回项目开新 session，"Choose an agent" 卡片里出现 DeepSeek 行 | Scholardo | 圈出 DeepSeek 行 |
| 8 | DeepSeek 行的两种状态：Needs Claude Code installed+Install；就绪 deepseek-… · Claude Code | Scholardo | 旁注"首次会自动装 carrier；装完自动回来" |
| 9 | 启动后底部输入框键入 总结 sources 里这篇 PDF，回答流出 | Scholardo | 字幕"第一句 AI 对话" |
关键 callout 汇总
- 🔴 API key 只显示一次：创建后立即复制保存，丢了只能重建。
- key 与服务在同一个 AI Agent tab：「AI providers」放 key，「CLI agents · Third-party」把它变成可跑的 agent。
- DeepSeek 寄生在 Claude Code 上：首次启动会自动装 carrier，无需再买 Claude 订阅。
- key 只存本机 Keychain：不上传（脚注原文佐证）。
常见坑（详见 P0-6 安装/登录 FAQ）
- 终端提示"未检测到可用的 DeepSeek 配置"（原文：⚠️ 未检测到可用的 DeepSeek 配置。请先在 设置 ▸ AI Agent 添加 DeepSeek 提供方并填写 API Key，然后重新启动会话。）→ 说明 key 没配好。回到 设置 ▸ AI Agent ▸ AI providers 段确认 DeepSeek 的 key 已填，然后重新开一个 session 再启动。
- 终端提示"无法从 Keychain 读取 DeepSeek 的 API Key"（原文：⚠️ 无法从 Keychain 读取 DeepSeek 的 API Key。请在 设置 ▸ AI Agent 重新保存 Key。）→ 回同一段重新粘贴并保存一次 key。
- DeepSeek 行一直显示 Needs Claude Code installed：点 Install 等它把 carrier 装完（首次需要网络访问 claude.ai 下载 Claude Code 安装脚本）。
- key 弹窗已经关了、忘了复制：回 DeepSeek 平台的 API keys 页删掉旧 key、重新创建一个，再走第 4 步。
数据隐私披露
当你在 Scholardo 里让 AI 阅读、总结、润色你的 PDF、笔记或草稿时，你的文稿内容会发送给所选 AI 服务商处理。本篇走的是 DeepSeek，相关文本会通过网络传输给 DeepSeek（深度求索） 的服务器，由其按自身隐私政策处理。你的 API key 只保存在本机 Keychain，不会上传；但发送出去的文稿内容如何处理，取决于 DeepSeek 自己的隐私政策——建议在使用前读一眼其官网隐私条款。如果你的研究材料涉及未公开数据、受访者隐私或保密协议，请先确认将其发送给第三方 AI 服务是否符合你所在机构的合规要求。