MultipleChat AI Desktop 文档。

快速入门

MultipleChat AI Desktop 是一款适用于 macOS 和 Windows 的独立应用。无需配置服务器，也无需注册账户，所需的一切都已包含在安装包中。

在 macOS 上安装

1. 下载 .dmg 安装包（同时支持 Apple Silicon 和 Intel，需 macOS 12 或更高版本）。
2. 打开 .dmg，将 MultipleChat AI 拖入“应用程序”文件夹。
3. 从“应用程序”中启动。如果 macOS 首次运行时要求确认，请点击打开。

在 Windows 上安装

1. 下载 .exe 安装包（64 位 Windows 10 或 11）。
2. 运行安装包并按提示操作。如果出现 SmartScreen，请点击更多信息 → 仍要运行。
3. 从“开始”菜单启动 MultipleChat AI。

使用云端提供商时，应用非常轻量。如需在本地运行模型，建议配备 16 GB 或以上内存。

连接 AI 提供商

本应用采用 BYOK（自带密钥）模式。首次启动时选择 AI 提供商，之后可随时在以下位置更改，或同时使用多个：Settings → AI Providers → LLM。

云端提供商

1. 在提供商处创建 API 密钥（例如 OpenAI、Anthropic、Google Gemini、Mistral、Groq、OpenRouter、Perplexity、Cohere、Azure OpenAI）。
2. 在 Settings → AI Providers → LLM 中选择提供商，粘贴密钥，然后选择默认模型。
3. 保存。密钥只存储在你的电脑上，仅在对话时发送给对应的提供商。

本地模型（完全离线）

如果完全不想使用云端，可以安装 Ollama 或 LM Studio 并下载模型，然后在 LLM 设置中选择对应的提供商。这样你的对话完全不会接触互联网。

三级模型设置

• System LLM：全局使用的默认模型。
• Workspace LLM：覆盖单个工作空间的默认设置（例如编程空间用这个模型，写作空间用那个模型）。
• Agent LLM：运行 @agent 时使用的模型。请选择支持工具调用的模型。

工作空间

工作空间是独立的项目，拥有各自的聊天记录、文档，还可以选择设置各自的模型。一个空间里的文档和对话在其他空间中不可见，让上下文保持干净，回答更有针对性。

1. 在侧边栏点击 New Workspace 并为其命名。
2. 如果不想使用系统默认值，可以在工作空间设置中指定专用模型。
3. 按工作空间调整行为：系统提示词、聊天模式（普通聊天 vs 基于文档的查询），以及上下文中保留的历史消息数量。

推荐做法：不要把所有内容塞进一个超长对话，而是按项目或客户建立工作空间，例如“合同”“论文”“客服话术”。

与文档对话

每个工作空间都可以存放文档。应用会将文档切分成段落，用本地嵌入模型索引到本地向量数据库中，不会上传到任何地方。提问时，最相关的段落会被检索出来，与提示词一起发送给模型。

1. 打开工作空间，点击上传 / 文档图标。
2. 拖入文件（PDF、Word、文本、Markdown、CSV、代码等），或指定一个文件夹。
3. 将文件移入工作空间，然后点击 Save and Embed。索引在你的电脑上本地运行。
4. 在对话中提问。回答以你的文件为依据，你可以打开引用，查看用到了哪些段落。

获得更好回答的技巧

• 优先使用文本型 PDF，而不是扫描件。扫描文档请先进行 OCR。
• 提问要具体（“第 7.2 条关于解约是怎么规定的？”），而不是“全部总结一下”。
• 无论问什么都需要始终保留在上下文中的文档，可以固定到工作空间。

AI 智能体

智能体让模型不只是回答，而是采取行动。以 @agent 开头发送消息，模型就会规划步骤并自动选择合适的工具。

内置技能

• 网页搜索与抓取：查找最新信息并读取网页。
• 文档检索（RAG）：检索工作空间中已索引的文档。
• 图表：根据对话或文件中的数据生成图表。
• 文件：将结果写入文件并保存到你的电脑。
• 摘要：按需总结长文档。

启用、停用和配置技能：Settings → Agent Skills。也可以在这里设置智能体模型，它需要擅长工具调用（目前大多数前沿模型都能胜任）。

示例：@agent 在网上找 3 篇关于 EU AI Act 的最新摘要，与这个工作空间里的草案 PDF 对比，并把差异保存成文件。

高级功能

桌面助手浮窗

在任何地方按下 Cmd+/（macOS）或 Ctrl+/（Windows），都会在当前应用上方打开一个浮动助手。它可以截取当前窗口或选定的屏幕区域，针对屏幕内容作答，浮窗中的对话会保存到工作空间。

电脑操控（OS 智能体）

设置支持电脑操控的模型（例如 Anthropic 的 Claude）后，智能体就可以操作你的电脑：点击、输入、启动应用、浏览网页、处理本地文件。安全第一：你可以随时在界面中、关闭应用，或使用全局快捷键 Cmd+K / Ctrl+K 暂停或停止。只交给它那些你愿意交给共享屏幕的助手去做的任务。

MCP 与斜杠命令

在智能体设置中，通过 Model Context Protocol（MCP）连接第三方工具和数据源，并定义斜杠命令，一键复用常用提示词。

向量数据库与嵌入

文档索引默认使用本地 LanceDB，文本切分和分块均可配置。你可以在 Settings → AI Providers 中更换向量数据库（Chroma、Pinecone、Qdrant、Milvus、Weaviate、pgvector），并选择本地或云端嵌入模型。

会议助手

本地转录模型（Whisper）采集音频，总结会议并生成行动项。全部在设备上处理，不会有云端机器人加入你的通话。

数据存储位置

应用掌握的所有内容都存储在你电脑上的本地应用文件夹中：聊天记录、工作空间设置、上传的文档、向量索引和 API 密钥。

• macOS：~/Library/Application Support/ 中的应用专属文件夹。
• Windows：%APPDATA% 中的应用专属文件夹。

发送消息时，请求会从你的电脑直接发送到你设置的 AI 提供商（适用该提供商的隐私条款）。中间没有 MultipleChat 服务器，我们不会查看、收集、存储你的对话或文档，也不会将其用于训练。构建版本中的遥测已禁用，应用不会发送任何使用分析数据。

删除应用数据文件夹（或连同应用数据一起卸载），所有内容都会被永久清除。

更新与故障排除

更新

我们会定期发布新版本，纳入上游开源项目的改进和安全更新。直接在旧版本上安装新版本即可，工作空间、对话和设置都会保留。

常见问题

• “API 密钥无效”：重新粘贴密钥（不要带空格），并在提供商控制台确认密钥处于有效状态（如需额度，请确认余额充足）。
• 回答忽略了我的文档：确认文件已索引到当前这个工作空间，且该空间处于查询/文档模式，然后更具体地重新提问。
• 智能体什么都不做：在 Settings → Agent Skills 中确认 Agent LLM 已设置为支持工具调用的模型。
• 下载后应用打不开（macOS）：右键点击应用 → 选择一次打开，以通过 Gatekeeper 的首次运行确认。

还是没解决？请发邮件至 [email protected]，并注明你的操作系统和应用版本。