Agent 学习第 54 课：项目：文档 diff 解读

今天带大家做个小项目：文档 diff 解读。说白了，就是让程序自己对比两版 Markdown，挑出改了啥，再吐一份人话摘要和结构化 JSON。

核心就三步。先用标准库 difflib 拉出统一 diff，筛出增删改的块；接着遍历这些行，把文件名、起始行号、增减内容扒出来，塞进 Change 结构里；最后照着这个列表写自然语言摘要，比如“第12行加了函数说明”，顺手存成 JSON。

这套东西接进工作流特别顺。摘要直接喂给告警或工单系统，后续自动化全靠它。

不过真用到大仓库，还有几个坑得提前想。怎么避免重复处理老文件？怎么过滤掉格式化这种纯噪音？diff 结果又怎么跟现有系统对接？

下一课我打算聊聊工具 RBAC，也就是给 Agent 加上角色权限控制，顺带盘一盘常见的安全风险。