groundeffect
本地快速索引Gmail和Google日历，为Claude Code提供邮件和日程搜索能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：groundeffect。 它的用途是：本地快速索引Gmail和Google日历，为Claude Code提供邮件和日程搜索能力。 完整的 Skill 内容见：https://321skill.com/skills/groundeffect/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我找出上周关于项目API设计的讨论邮件”，它会通过 GroundEffect 在本地索引中快速进行混合搜索，并返回相关的邮件内容和链接。或者，你可以说：“查看一下我明天下午的会议安排”，它会查询你本地的 Google 日历数据并给出日程摘要。
介绍
GroundEffect 是一个专为 Claude Code 设计的本地化工具，它解决了用户无法直接在 AI 助手环境中搜索和调用个人 Gmail 与 Google Calendar 数据的问题。通过本地部署，它能够索引你的邮件和日历，让你在编码或工作时，无需离开 Claude Code 界面就能查询相关信息。
使用上，你只需通过 Homebrew 安装，配置好 Google OAuth 凭证并添加账户，GroundEffect 就会在后台自动同步数据。之后，你便可以直接在 Claude Code 中通过自然语言指令搜索邮件、查看日程安排，甚至发送邮件，所有操作都集成在开发环境中，无需切换应用。
它非常适合需要频繁处理邮件和日程，同时又希望保持工作流连贯性的开发者、项目经理或内容创作者。例如，在编写代码时需要参考某封技术讨论邮件，或在规划项目时需查看团队会议安排，GroundEffect 能让你无缝获取这些信息。
需要注意的是，该工具完全在本地运行，数据安全有保障，但初次同步大量历史邮件可能需要一些时间。建议根据需求合理设置同步年限，并确保已正确配置 Google Cloud 项目的 OAuth 桌面应用凭证。
核心特点
核心区别在于其纯本地化部署与混合搜索能力：数据完全存储在本地，无需担心云端隐私问题；同时结合了 BM25 全文检索和向量语义搜索（Reciprocal Rank Fusion），并利用 Metal 加速本地运行嵌入模型，在保证隐私的同时提供了快速精准的搜索结果。
注意事项
不适合需要实时协作或跨团队共享邮件日历数据的场景，因为它主要服务于本地单个用户。
常见问题
GroundEffect 会把我邮件数据上传到云端吗？
不会，所有数据索引和处理均在本地完成，确保隐私安全。
支持除 Gmail 和 Google Calendar 之外的其他邮箱或日历服务吗？
目前仅支持 Gmail 和 Google Calendar，通过标准的 IMAP 和 CalDAV 协议连接。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/groundeffect/raw/index.md 读取 groundeffect 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/groundeffect/raw/index.md（查看排版版本）