Sidekick
在 Mac 上本地运行、离线优先的 AI 助手，可基于你的文件、文件夹和网页进行对话与深度研究。
证据显示应用是本地优先，数据离线处理，但权限细节未在源码中明确。用户确认机制存在（如专家激活、拖拽文件），但未详细说明。数据流透明度有限，未提供隐私政策或数据流图。敏感数据处理（如联系人、API密钥）未明确说明安全措施。依赖安全性未提供依赖清单或漏洞扫描。外部影响（如发送邮件、生成文件）存在但未说明用户确认。回滚机制未提及。来源归属部分通过README致谢体现。
自洽性：README描述的功能与截图一致，但未提供测试证据。依赖可用性：依赖llama.cpp等，但未提供版本锁定或镜像。失败消息：未提供错误处理或用户提示的文档。
目标受众明确（学生、研究者），场景多样（研究、写作、编程）。能力边界部分说明（如本地模型、API），但未明确限制。触发精度：功能调用和图像生成自动识别，但未说明误触发风险。环境适配：仅支持Apple Silicon，未说明其他平台。
信息架构清晰，有文档链接。安装说明提供Homebrew和手动步骤。命名稳定性：版本号未提及。示例和FAQ：有示例但无FAQ。已知限制：未明确列出。许可证：MIT，但版权人未验证。版本变更日志缺失。维护责任：有联系方式，但未明确维护计划。
输出可用性：提供引用、代码导出等，但未验证。边际价值：本地优先、RAG、函数调用等有独特价值。成本效益：免费开源，但需Apple Silicon和RAM，未提供性能数据。
声明可追溯：README有截图和链接，但未提供测试结果。跨来源验证：未提供第三方验证。事实与推断分离：未明确区分。
- 未提供依赖清单或漏洞扫描，依赖安全性未知。
- 敏感数据处理（如联系人、API密钥）的安全措施未明确。
- 外部操作（如发送邮件、生成文件）的用户确认机制未详细说明。
- 版本变更日志缺失，难以追踪更新。
- 仅支持Apple Silicon，环境适配有限。
这个 Agent 能做什么，适合哪些场景？
Sidekick 是一款原生 macOS 应用，利用内置的 llama.cpp 推理引擎，让用户与本地大语言模型聊天，无需安装其他软件即可访问文件、文件夹和网页中的信息。它支持开源 GGUF 模型（如 Qwen3.5），也可通过 OpenAI 兼容 API 接入远程模型。Sidekick 具备 RAG 专家系统、函数调用、深度研究、记忆、画布、图像生成（需 macOS 15.2+ 和 Apple Intelligence）等功能，所有对话默认离线进行，保障数据隐私。该应用面向 Apple Silicon Mac，可通过 Homebrew 或直接下载安装。
Sidekick 通过内置的 llama.cpp 后端加载和运行本地 GGUF 模型（如 Qwen3.5），并支持通过 API key 调用 OpenAI 兼容的远程模型（如 OpenAI、Anthropic 等预设服务商）。用户可创建“专家”（Expert）并为其配置相关资源（文件、文件夹、网页），Sidekick 采用 RAG 技术检索这些资源来回答查询，并支持拖拽文件到输入框作为临时资源。它还能通过 web 搜索获取最新信息。Sidekick 支持函数调用（Function Calling），可顺序调用工具（如计算、发邮件）直至获得结果；内置 Deep Research 代理，可自主浏览 50-80 个网页并生成研究报告。此外，它具备记忆功能（跨对话记住用户偏好）、画布（编辑和预览代码/网页）、文本生成图像（CoreML 模型自动识别提示）以及高级 Markdown 渲染（LaTeX、图表、代码高亮）。
- 学生：创建多个专家（如英语文学、数学、计算机科学），激活对应专家后，对特定主题进行资料查询和论文写作，可点击引用直接打开原始文献。
- 研究者：使用 Deep Research 功能，输入研究主题，让 Sidekick 自动阅读数十个网页并生成综合研究报告。
- 普通用户：询问 Sidekick 关于本地文件里的问题，或拖拽文件到输入框进行快速问答，无需上传云端。
- 开发者：利用函数调用功能，让 Sidekick 执行代码计算、生成 CSV 文件或起草邮件，实现本地自动化任务。
- 隐私敏感用户：在完全离线的环境下使用本地模型处理敏感文档，避免数据离开设备。
这个 Agent 有哪些优点和局限？
- 真正的本地优先，默认离线运行，数据不出设备。
- 集成多种功能：RAG、函数调用、深度研究、记忆、画布，一站式满足多场景。
- 支持现代 GGUF 模型（如 Qwen3.5），并预设主流云服务商（OpenAI、Anthropic 等），灵活性高。
- 内置 llama.cpp 推理引擎，针对 Apple Silicon 优化，生成速度快。
- 支持拖拽文件作为临时上下文，操作直观。
- 仅支持 Apple Silicon Mac，不兼容 Intel Mac 或非 macOS 平台。
- 图像生成功能依赖 macOS 15.2+ 和 Apple Intelligence，老旧系统无法使用。
- 部分高级功能（如函数调用、深度研究）可能对本地模型性能要求高，在低内存设备上体验受限。
- 虽然支持远程 API，但核心体验仍针对本地模型，远程模型接入可能不如专有应用完善。
- 项目仍处于活跃开发中，可能存在不稳定或文档滞后。
如何安装或部署这个 Agent？
- 确保你拥有 Apple Silicon Mac（RAM ≥ 8GB）。
- 使用 Homebrew 安装：
brew install --cask arcadi4/tap/sidekick。 - 或从 GitHub Releases 下载最新版 DMG 并拖入 Applications。
- 若需开发环境，克隆仓库后运行
./setup.sh <TEAM_NAME>修改 Xcode 项目团队，然后用 Xcode 打开运行。
如何使用这个 Agent？
- 启动 Sidekick，首次运行时会要求选择本地模型（可从 Hugging Face 下载 GGUF 格式模型）或配置远程 API key。
- 创建“专家”（Expert），为每个专家添加相关文件夹或网址，并激活所需专家。
- 在输入框中输入问题，Sidekick 会根据激活的专家资源进行 RAG 检索并生成回答，附有引用供点击溯源。
- 如需最新信息，可启用 Web 搜索功能。
- 如需深度研究，点击“Deep Research”并输入主题，等待其完成多步研究。
- 拖拽文件到输入框可添加临时引用。
- 对于图像生成，直接描述你想生成的图片，Sidekick 会自动识别并调用图像生成模型（需 macOS 15.2+）。