awesome-deepseek-integration 集成指南：UOS AI 接入 DeepSeek API 的完整实操（DeepSeek-V3 与 DeepSeek-R1）
【免费下载链接】awesome-deepseek-integrationIntegrate the DeepSeek API into popular software项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-integration
本文基于 awesome-deepseek-integration 仓库中的 UOS AI 集成文档，讲解如何在 Deepin 操作系统的内置 AI 助手 UOS AI 中接入 DeepSeek API。读完本文，你将掌握 UOS AI 的模型添加流程、"默认选项"与"自定义选项"两种接入方式的完整配置步骤、各配置字段（LLM、账号、APIKey、模型名、请求地址）的填写规范，以及 DeepSeek-V3 与 DeepSeek-R1 两个模型对应的模型名标识。
一、UOS AI 是什么
UOS AI 是 Deepin 操作系统中的一个 AI 助手应用（AI assistant application）。与普通的聊天窗口不同，它具备独特的跨应用能力（cross-application capabilities），能够与系统内置的邮箱（email）和浏览器（browser）应用深度集成，为用户提供场景化（contextualized）的 AI 能力——即在邮箱、浏览器等具体使用场景中直接调用 AI，而不是脱离当前上下文单独打开一个对话界面。
这正是 UOS AI 在 awesome-deepseek-integration 这个"将 DeepSeek API 集成到热门软件"的合集里占有一席的原因：DeepSeek 模型的推理能力通过 UOS AI 这一系统级入口，被带入了 Deepin 桌面环境的日常使用流程中。
二、前置准备：获取 DeepSeek API Key
在开始配置之前，你需要先拥有一个 DeepSeek 开放平台的 API key。仓库根目录的 README.md 中明确提示：需要访问 DeepSeek 开放平台（DeepSeek Open Platform）获取 API key。
准备好 key 之后，UOS AI 提供两条接入路径，均从同一个入口开始：
- 打开 UOS AI 应用；
- 进入「设置」（Settings）；
- 在「模型配置」（Model Configuration）下选择「在线模型 - 添加」（Online model - Add），进入模型添加界面。
进入该界面后，根据你想使用的模型选择下文两种方案之一。
三、方式一：默认选项（Default Option）
如果你只打算使用 DeepSeek-R1，走默认预设是最省事的，只需填写 API key。原文档给出的步骤（英文界面字段）如下：
- Open the "Settings" option in UOS AI, select "DeepSeek-R1" in the "Model Configuration" under "Online model-Add" to enter the UOS AI model addition interface. （打开 UOS AI 的"设置"，在"模型配置"下的"在线模型-添加"中选择"DeepSeek-R1"，进入模型添加界面。）
- Select "DeepSeek-R1" in the "LLM".（在"LLM"字段中选择"DeepSeek-R1"。）
- Fill in any name in the "Account".（在"账号"字段中任意填写一个名称。）
- Enter your API key in the "APIKey".（在"APIKey"字段中填入你的 API key。）
对应的中文界面字段对照为：「模型类型」选「DeepSeek-R1」，「账号名称」随意填写，「APIKey」填你的 key。选择 DeepSeek-R1 预设后，端点与模型标识等底层信息已由系统内置，无需再手动填写。
四、方式二：自定义选项（Custom Option）
如果你想在 DeepSeek-V3 和 DeepSeek-R1 之间按需选择，或者希望显式指定请求地址，则使用自定义模式。原文档给出的步骤如下：
- Select "Custom" in the "LLM".（在"LLM"字段中选择"自定义"（Custom）。）
- Enter any name you like in the "Account".（在"账号"字段中填写任意名称。）
- Enter your API key in the "APIKey".（在"APIKey"字段中填入你的 API key。）
- Add the name of the model you want to use in the "Model Name".（在"模型名"字段中填写要使用的模型名称。）
- DeepSeek-V3 填写：
deepseek-chat - DeepSeek-R1 填写：
deepseek-reasoner
- DeepSeek-V3 填写：
- Enter the following request address to "Domain":
https://api.deepseek.com/chat/completions（在"请求地址"（Domain）字段中填写上述地址。）
两个关键取值要点：
- 模型名标识：DeepSeek 开放平台对外提供两个模型标识——
deepseek-chat对应 DeepSeek-V3（常规对话模型），deepseek-reasoner对应 DeepSeek-R1（推理模型）。填错标识会调用到不同的模型能力，需要哪种能力就填对应的名称。 - 请求地址：
https://api.deepseek.com/chat/completions。从该地址的形态看，/chat/completions是 OpenAI 兼容风格的接口路径，即 UOS AI 通过这种兼容接口直接调用 DeepSeek 开放平台的在线服务；填写时请完整照抄，不要漏掉末尾的路径部分。
五、两种接入方式对照
把原文档两种方式的配置项整理成下表，便于快速核对：
| 配置字段（英文界面） | 中文界面对应 | 默认选项 | 自定义选项 |
|---|---|---|---|
| LLM | 模型类型 | DeepSeek-R1 | Custom（自定义） |
| Account | 账号名称 | 任意填写 | 任意填写 |
| APIKey | APIKey | 你的 DeepSeek API key | 你的 DeepSeek API key |
| Model Name | 模型名 | 由预设内置，无需填写 | deepseek-chat（V3）或deepseek-reasoner（R1） |
| Domain | 请求地址 | 由预设内置，无需填写 | https://api.deepseek.com/chat/completions |
选型建议：
- 只想开箱即用 R1：用默认选项，字段最少、不易填错。
- 想用 V3，或在 R1/V3 间切换：用自定义选项，通过 Model Name 字段决定模型；同一套 API key 可以配多个模型条目。
- 需要显式核对/接管请求地址（例如后续排查网络问题）：同样用自定义选项，因为此时端点地址是可见、可编辑的。
六、验证与后续
配置保存后，即可在 UOS AI 中发起对话验证模型是否连通：若配置成功，UOS AI 的回复将由你所选的 DeepSeek 模型生成。若遇到请求失败，优先检查三点：API key 是否复制完整、自定义模式下 Model Name 是否严格等于deepseek-chat或deepseek-reasoner、Domain 是否为完整的https://api.deepseek.com/chat/completions（含https://前缀与完整路径）。
七、本文涉及的仓库文件
- 英文集成文档：docs/UOS AI/README.md
- 中文集成文档：docs/UOS AI/README_cn.md
- 界面与配置截图：docs/UOS AI/assets/ui-en.png、docs/UOS AI/assets/r1-en.png、docs/UOS AI/assets/custom-v3-en.png
- 合集总览（含 DeepSeek API key 获取说明）：README.md
需要说明的是：本文所有内容以当前仓库中的 UOS AI 文档为准，适用于文档所描述的 UOS AI 界面版本；若 Deepin / UOS AI 后续更新了界面字段或预设项，请以应用实际界面为准，接入参数（模型名与请求地址）仍以上文所列值核对。
【免费下载链接】awesome-deepseek-integrationIntegrate the DeepSeek API into popular software项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-integration
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
