模型配置 (三种起步方式)

读完你能：在「填入慧AI登录令牌」、「自定义 API Key」与「本地离线模型 (Ollama)」三种方式中选一条最适合自己的路径，3 分钟内完成模型接入并开始畅聊。

三种接入方式，自由选择

AIPC UP 秉持完全开放的理念：无论你是希望免除繁琐配置的新手用户，自备各大平台 API Key 的进阶极客，还是注重绝对隐私与离线零成本的本地大模型用户，都能自由选择最舒适的起步方式。

---

1. 快速选择你的起步路线

在 AIPC UP 中，开启对话仅需完成大模型接入，你可以根据手头的资源自由三选一：

路线	适合谁	操作入口与步骤
路线 A：填慧AI登录令牌	希望一键开通、不仅免配置开聊，还需使用全套扩展功能的用户	入口：设置 → 慧AI配置 粘贴令牌点击保存，系统自动同步并创建官方模型通道，直接畅享全部高级功能。
路线 B：自定义 API Key	持有 DeepSeek、Kimi、硅基流动、OpenAI、Claude 等 Key 的用户	入口：设置 → 模型 点击「添加模型」，选择对应平台并填入你的 API Key 即可使用全部基础对话功能。
路线 C：本地离线模型 (Ollama)	追求零花费、数据 100% 保留在本地硬盘的用户	入口：设置 → 模型 直接连接本机运行的 Ollama 服务，无需外网，零门槛免费使用基础对话功能。

路线能力与功能对比

配置自定义 API Key 或本地离线模型时，常规 AI 问答、代码辅助、工作区管理等基本功能全部都能正常使用；但若需要使用跨端联动与底层系统操控等进阶扩展功能，则需要配置慧AI登录令牌支持：

功能特性	路线 A：填慧AI登录令牌	路线 B：自定义 API Key	路线 C：本地离线模型 (Ollama)
基础 AI 对话 & 知识问答	✅ 完全支持（官方通道免配置）	✅ 完全支持（使用自备 Key）	✅ 完全支持（本地硬件计算）
代码辅助生成与重构	✅ 完全支持	✅ 完全支持	✅ 完全支持
本地项目工作区与文件管理	✅ 完全支持	✅ 完全支持	✅ 完全支持
多 Agent 协作工作流	✅ 完全支持	✅ 完全支持	✅ 完全支持
🖥️ 桌面自动化（AI 操控本机键鼠）	✅ 已包含	⚠️ 基础会话可用，自动化执行需慧AI令牌	⚠️ 基础会话可用，自动化执行需慧AI令牌
🌐 远程访问工作台 (WebUI)	✅ 已包含	❌ 需配置慧AI登录令牌	❌ 需配置慧AI登录令牌
📱 远程控制屏幕 / 屏幕墙	✅ 已包含	❌ 需配置慧AI登录令牌	❌ 需配置慧AI登录令牌
🎙️ 智能语音输入与转写	✅ 已包含	❌ 需配置慧AI登录令牌	❌ 需配置慧AI登录令牌

---

2. 路线 A：填入慧AI登录令牌（最省心）

如果你获得了慧AI服务令牌，只需一步即可完成开箱即用配置：

开通核心扩展能力说明

特别说明：配置慧AI登录令牌不仅能免去手动配置 BaseURL、平台参数等繁琐步骤，更是解锁 AIPC UP 核心高级功能的必要前提。配置了慧AI登录令牌后，才能使用以下全部扩展功能：

• 🖥️ 桌面自动化：让 AI 操控本机键盘与鼠标，自动执行跨软件协同与复杂桌面任务；
• 🌐 远程访问工作台 (WebUI)：通过手机、平板或其他电脑通过浏览器远程接入并操作本机的 AI 工作台；
• 📱 远程控制屏幕 / 屏幕墙：多台设备屏幕实时投屏与远程控制协作；
• 🎙️ 智能语音输入：高质量语音实时转写与连续语音对话交互。

如果你需要使用上述核心进阶功能，强烈推荐优先选择路线 A。

1. 进入配置页面
   点击主界面左下角的 设置（齿轮图标），进入设置页面的第一项：慧AI配置。

2. 粘贴并保存令牌
   将获取到的登录令牌粘贴到「慧AI登录令牌」输入框中，点击 保存令牌 按钮。

3. 点击检测验证
   点击 检测令牌 按钮，当看到提示 ✓ 令牌有效，连接正常 时，说明配置已经就绪。

4. 直接开始对话
   保存成功后，系统会自动在后台同步并激活官方模型通道。此时返回聊天主窗口，直接发送消息即可收到回复，无需手动做任何模型配置。

安全提醒

令牌是你的身份凭证，请妥善保管，切勿分享给他人或发送到公开网络平台。

---

3. 路线 B：自定义 API Key（自主透明）

如果你自备了国内外各大主流大模型开放平台的 API Key，可以直接接入：

基本功能与扩展功能说明

对比提示：配置自定义 API Key 后，日常 AI 聊天、代码编写、问答分析、项目与工作区管理等基本功能都能完全正常使用。

若后续需要使用桌面自动化、远程访问工作台、远程控制屏幕或语音输入等功能，无需推翻现有模型配置，随时在「设置 → 慧AI配置」中补充填入慧AI登录令牌即可无缝解锁，两者完全兼容、互不冲突。

1. 进入模型管理
   在设置侧边栏中点击 模型（位于通用设置下方）。

2. 添加模型供应商
   点击右上角的 添加模型 按钮（选择「手动添加」）。

3. 选择供应商与填入 Key\

   • 在平台下拉列表中选择对应平台（支持 DeepSeek、Moonshot / Kimi、SiliconFlow、OpenAI、Anthropic / Claude、Zhipu 等主流厂商，也可选择「自定义」填写任意兼容端点）；
   • 填入你获取到的 API Key；
   • 勾选或输入你想使用的具体模型名称。

4. 测试并保存
   点击保存并测试连接，验证通过后即可在会话窗口中选择该模型发起对话。

---

4. 路线 C：本地离线模型（Ollama 零成本）

如果你希望在完全断网的环境下使用，或严格保障本地代码与文档隐私：

• 电脑上运行 Ollama 并下载好本地开源模型（如 DeepSeek-R1、Qwen2.5 等）。
• 在 AIPC UP 的「设置 → 模型」中添加本地端点（默认 http://localhost:11434）。
• 零费用、不消耗外网流量，模型计算全部由本机显卡/CPU 完成。

---

怎样算成功

• 路线 A 用户：在「慧AI配置」检测显示「✓ 令牌有效，连接正常」，回到聊天输入框发问能收到正常回复。
• 路线 B/C 用户：在「模型」列表中新增的提供商显示连接成功，新建对话能自由选择该模型发起交流。

---

相关

第一次对话与界面掌握发送框、界面分区与快捷键，发出第一条提问。

快捷键速查掌握 Ctrl+T、Alt+Q 等常用按键，操作行云流水。

安装与启动便携版解压即用与安装包使用指南。