dify知识库自动同步需依赖外部数据源类型及对应机制：github/git用webhook实现增量更新，notion需cron或n8n定时调用api轮询；本地文件不支持自动同步，必须重新上传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Dify 中让知识库内容自动跟随外部文档源（如 Notion、GitHub 仓库、S3 存储桶）保持最新，避免手动重复上传和遗漏更新，需配置定期同步与增量更新机制。Dify 本身不内置定时任务调度能力，必须借助外部工具触发 API 或利用平台原生集成能力完成闭环。
确认知识库数据源类型
进入 Dify 控制台 → 【知识库】→ 点击目标知识库名称 → 查看右上角【数据源】标签页。只有标记为「已连接」且类型为 Notion、GitHub、Git、S3、Web 的知识库才支持自动同步；本地上传的 PDF/DOCX 文件不支持增量更新，【必须重新上传才能更新内容】。
若数据源显示「未连接」或为「本地文件」，后续所有同步配置均无效，需先删除当前知识库并新建时选择可连接的数据源。
启用 GitHub/Git 仓库的增量同步
方法一：使用 Dify 内置 Webhook（推荐）
第一步：在 GitHub 仓库 Settings → Webhooks → Add webhook，Payload URL 填写 【Dify 后端地址 + /v1/knowledge-base/webhook/github】（例如 https://your-dify-domain.com/v1/knowledge-base/webhook/github），Content type 选 application/json，Secret 填写 Dify 知识库设置页中显示的 Webhook Secret。
第二步：在 Dify 知识库设置页勾选「启用 Webhook 自动同步」，保存后即生效。此后每次 push 到指定分支（默认 main），Dify 会比对 commit diff，仅提取变更文件进行解析与向量化更新。
注意：若 GitHub 仓库私有，Dify 必须能访问该仓库的公开 clone 地址或已配置 SSH 密钥；否则同步失败且无明确报错提示。
Dify 3.9.2更新重点增强系统安全性，引入 Chainguard 安全基础镜像并同步社区版 CVE 修复，同时优化 OpenSearch 向量存储兼容性、插件参数传输机制及 Helm 部署配置。新增工作流模型节点缓存能力，可减少重复凭证查询，显著提升复杂工作流初始化速度，为企业级 AI 应用提供更稳定、高效的运行体验。
配置 Notion 数据源的定期同步
Notion 官方不支持主动推送事件，Dify 无法监听页面变更，必须依赖轮询机制。
方法一：用 cron + curl 调用 Dify API 触发同步
在服务器执行 crontab -e，添加一行：0 */6 * * * curl -X POST "https://your-dify-domain.com/v1/knowledge-bases/{kb_id}/sync" -H "Authorization: Bearer {api_key}" -H "Content-Type: application/json" -d '{"type":"notion"}'。这表示每 6 小时拉取一次 Notion 页面最新状态。
方法二：使用 n8n 或 Zapier 创建定时流程，调用 Dify 的 /v1/knowledge-bases/{kb_id}/sync 接口。需确保流程中携带有效的 API Key 和正确的 kb_id，【kb_id 是知识库 URL 路径末尾的 32 位小写字母+数字组合，不可用中文名或显示名称替代】。
验证同步是否成功
进入知识库详情页 → 点击【文档列表】→ 查看每份文档右侧的「最后同步时间」和「状态」图标。绿色对勾表示同步完成，灰色时钟表示正在队列中，红色叉号说明解析失败。
点击失败文档右侧的「查看日志」，若出现 “Failed to fetch page content” 或 “Rate limit exceeded”，说明 Notion token 过期或 GitHub API 配额超限，需更新集成凭据。
