EverRoom连接器指南如何接入飞书、Notion、Gmail让工作信息自动流入【免费下载链接】EverRoomEverRoom - A workspace that remembers your projects, decisions, and sources.项目地址: https://gitcode.com/gh_mirrors/ev/EverRoomEverRoom 连接器Connector是本地优先的个人上下文工作区 EverRoom 的自动化能力接入飞书Feishu、Notion、Gmail 等应用后文档、邮件、日历信息会按固定节奏自动同步到本地归一化为 Markdown 并流入「上下文房间」Context Room无需手动复制粘贴。本文将带你快速理解 EverRoom 连接器的原理并给出接入飞书、Notion、Gmail 的操作思路让分散在各处的工作信息真正自动流入你的知识库。为什么需要 EverRoom 连接器你是否也遇到过这样的场景 Gmail 里的客户需求三天后才想起来抄进笔记 Notion 里更新的项目文档本地知识库还是旧版本 飞书维基里的讨论结论散落在不同页面找不到全貌。EverRoom 的解决思路是一条闭环连接信息 → 自动同步归一化 → 沉淀进上下文房间 → Agent 基于上下文推进工作。连接信息来自本地文件、代码仓库、会议以及飞书、Notion、Gmail 等可选服务。见 README.md也就是说你只需要授权一次之后信息会自己流动起来。快速上手3 步接入第一个连接器EverRoom 桌面端内置了托管的 OpenConnector 运行时安装后开箱即用不需要 Docker不需要手动起服务也不需要自己配置 Token详见 OpenConnector 桌面端集成说明。第一步启动应用等待本地网关就绪运行pnpm dev启动桌面端后主进程会自动拉起内置 OpenConnector仅绑定127.0.0.1回环地址侧栏连接器页面会实时显示网关与 CLI 状态。第二步打开连接器页面完成授权侧栏进入连接器页面后选择目标服务如 Gmail / Notion / Feishu走 OAuth 授权流程即可。页面提供四个核心动作搜索 Action查看该服务支持哪些操作查看 Schema了解每个操作的输入参数选择连接确认当前已授权的真实连接▶️执行校验参数后手动触发一次操作。这一页面由 ConnectorConsolePage.tsx 实现同时 Gateway 会为 Agent 注册connector_search、connector_schema、connector_apps、connector_run四类工具。第三步确认同步任务已激活授权成功后Gateway 会自动为该账号创建只读同步任务。同步状态、游标都持久化在本地数据库重启不丢失。自动同步策略全量校准 增量同步连接器同步不是拉一遍就完事而是全量校准 增量同步双任务配合这是保证本地信息始终新鲜的关键机制详见 Notion 与 Google Docs 托管同步说明连接器全量校准增量同步增量依据Notion每 12 小时每 10 分钟last_edited_time水位Google Docs每 24 小时各 5 分钟Drive ChangespageTokenGmail—每次同步historyId增量几个值得了解的设计细节✅幂等写入同步记录按内容哈希去重失败重试不会产生重复数据软删除追踪来源被归档/删除时本地对应记录会走完整的删除链路清理知识、记忆引用、删除 Markdown 产物抖动调度多账号的定时任务带 ±5% 随机抖动避免同时冲击第三方 API。格式自动映射新服务也能无代码接入每个提供者的原始字段格式不同比如 Gmail 和 Outlook 的邮件结构就不一样。EverRoom 不再为每个服务手写解析代码而是内置了一个connector-mapper后台 Agent首次遇到未知格式时它会采样原始数据、对照标准模式canonical schema自动提交 JSONata 映射规则后续同步直接走缓存的快速路径。归一化映射体系的完整数据流说明见 everroom-connectors 模块说明各服务的同步适配器分别位于 sync-providers/ 目录包括feishu.ts、gmail.ts、notion.ts、outlook.ts、google-calendar.ts、google-docs.ts等。信息流入之后上下文房间、知识与记忆同步进来的内容并非简单堆在本地而是进入 EverRoom 的统一摄取Ingest管线归一化为 Markdown 产物ERMD 格式每条记录生成.md 元数据清单字节稳定、可溯源路由决策按记录类型决定它成为房间 Wiki 页面、实体候选、记忆文档还是仅一条链接沉淀进上下文房间项目、人物、主题各有自己的房间来源、决策、任务、记忆聚拢在一起形成有边界的上下文而不是一个无限膨胀的大提示词。对普通用户来说效果就是Gmail 里的一封客户邮件、Notion 里的一页更新、飞书里的一段讨论会在同一个项目房间里各归其位Agent 写总结、做决策时直接引用真实来源而不是凭空生成。安全与隐私本地优先的边界EverRoom 连接器在安全上做了明确的边界设计普通用户也能放心授权详见 docs/open-connector-desktop-integration.zh-CN.md数据不出本地数据库、Markdown 产物、同步游标都存放在本机EverRoom数据目录Token 隔离授权凭据只存在于主进程与 Gateway 子进程中不会传到渲染层仅回环监听内置连接器服务只监听127.0.0.1外部不可达⚖️外部动作受控Agent 执行连接器操作前必须强制读取真实 Action Schema 和真实连接参数校验通过才允许执行失败时还有结构化的恢复策略避免猜参数式的外部调用。常见问题FAQQEverRoom 连接器需要配置自己的 OAuth Client ID 吗A不需要。托管模式下凭据与配置由发行包内置管理普通用户完成 OAuth 授权页确认即可。Q断网了同步会丢数据吗A不会。同步是幂等的游标不前进恢复网络后下个周期继续重试已写入记录不受影响。Q想先自己跑一遍源码试试A可以克隆仓库体验git clone https://gitcode.com/gh_mirrors/ev/EverRoom cd EverRoom pnpm install pnpm devQ连接器页面显示网关不可用怎么办A内置服务启动失败不会阻断其他功能连接器页面会显示具体错误检查日志后重启应用Supervisor 会重新拉起并做健康检查。关键文件与延伸阅读内容路径项目总览与快速开始README.md连接器模块边界与归一化映射gateway-module/README.md各服务同步适配器sync-providers/OpenConnector 桌面集成与安全边界docs/open-connector-desktop-integration.zh-CN.mdNotion / Google Docs 托管同步策略docs/notion-google-docs-managed-sync.zh-CN.md连接器控制台页面源码ConnectorConsolePage.tsx小结EverRoom 连接器把接入飞书、Notion、Gmail 让工作信息自动流入变成了一次性操作授权一次之后全量校准加增量同步自动运转内容归一化后沉淀进上下文房间。配合本地优先的隐私边界你可以把更多精力放在真正的工作推进上而不是信息搬运上。【免费下载链接】EverRoomEverRoom - A workspace that remembers your projects, decisions, and sources.项目地址: https://gitcode.com/gh_mirrors/ev/EverRoom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考