知识库安全合并

要解决的问题

知识库站点经常要把一批新的文章 JSON 并入 content/articles，但生产环境里已经存在历史文章、镜像文件、导出快照和测试文件。直接替换很容易把旧文章丢成零，尤其当 incoming 文件只是增量、缺字段、或 id 不稳定时，问题更隐蔽。

技能如何工作

这个技能把“安全合并”拆成可执行流程：先识别真正被站点读取的正式数据源，区分 incoming 文件和镜像/备份文件；再检查结构是否包含 articles 数组、title、content、稳定 id 等字段。合并规则默认优先按 id 匹配，若 id 不一致则回退到 title + date，未匹配文章追加为新文章，最终按日期倒序和 id 排序。执行前会做 dry-run，输出新增、更新、未变化和合并后总数；正式写入前生成可回滚备份，必要时同步镜像文件。若项目已有导入脚本或数据管道，优先复用现有方案，而不是强行替换成通用脚本。

适用边界

它适合文章型 JSON 知识库、旧站迁新站、增量导入和上线前预演。不适合结构差异过大的数据源：如果根对象不是 JSON object、没有 articles、缺少关键文章字段或 id 完全不稳定，应先做适配和字段映射，再执行合并。涉及线上站点时，不能只看新文章出现，还要校验 JSON 接口、内容页和旧文章仍然存在。