用自己的云模型 API key 构建带引用核验的私有文件问答，并可复用 MCP 连接器

方案简介

本配方展示 IncarnaMind 与云 AI 供应商（OpenAI、Anthropic、Google，或任意 OpenAI 兼容服务器）的组合用法：用户粘贴自己的 API key，让 IncarnaMind 基于本地文件库生成带引用、且引用可自动核验的答案。同时可添加 Connectors（MCP 服务器）扩展工具能力，包括直接复用已在 Claude Desktop 或 Cursor 中配置的连接器，以及标准 SKILL.md 文件夹形式的 Skills。隐私设计上，首次向外部服务发送内容前会展示将发送什么、发给谁并等待确认；对支持不留存的供应商会主动请求不存储请求。适合已有云模型 key、希望在自己文档上做可溯源问答并接入工具生态的用户。

亮点与能力

• 多模型选择：OpenAI、Anthropic、Google key 或任意 OpenAI-compatible 服务器
• 每条答案引用可核验，绿勾/琥珀标记，点击跳转原文高亮
• 发送外部前必先征求同意，展示发送内容与目标
• 请求供应商不存储内容，每个 OpenAI 请求都附此要求
• Connector 工具和 Skill 脚本执行前需逐次或永久授权
• Settings → Tools 列出并随时撤销已设规则
• 导出 Word 引用作脚注或 Markdown

组成与分工

• IncarnaMind：本地笔记与问答应用，负责检索、引用核验、权限控制
• OpenAI / Anthropic / Google：云模型供应商，提供问答生成能力（按用量付费）
• OpenAI-compatible 服务器：可替代云厂商的任意兼容端点
• MCP Connectors：外部工具服务器，可在应用内添加或从 Claude Desktop、Cursor 导入
• Skills（SKILL.md 文件夹）：标准化技能包，三个内置

前置要求

从源码运行：

shell
git clone https://github.com/junruxiong/IncarnaMind.git && cd IncarnaMind
npm install && npm run dev

云模型方案需自备 OpenAI、Anthropic 或 Google 的 API key（按用量向供应商付费），或任一 OpenAI 兼容服务器。

使用与配置要点

• 在设置中粘贴 API key，key 加密存于系统安全存储
• 首次向外部服务发送时确认弹窗；Settings → Privacy 可随时撤回授权
• 在 Settings → Tools 管理连接器/技能的执行规则（允许一次/永久/拒绝），可随时撤销
• 验证成功：提问后答案带引用，绿勾即核验通过；导出时未核验引用标 "[unverified]"

注意事项与常见问题

• 使用云模型需向供应商支付用量费用
• 扫描页等无文本内容无法核验引用（显示 "Can't check"）
• Windows 安装包未签名会触发 SmartScreen，需点 More info → Run anyway；macOS 未公证需在隐私与安全中放行

优缺点

• ✓ 多模型自由选择
• ✓ MCP工具可跨应用复用
• ✕ 云端模型按量付费
• ✕ 需信任厂商不留存

出处

本方案挖掘自开源项目 junruxiong/IncarnaMind，方案内容与实施命令均来自其 README 原文。