先明确一点：LongCat AI 本身并不直接提供文档关键词监控功能。它本质上更接近一款图像编辑工具，要实现文档内容的实时感知与告警，必须依赖外围的监控体系——首先将文档转化为结构化的日志，再通过日志采集与关键字匹配机制进行抓取，最后才交由 LongCat-Image-Editn 完成标注或可视化告警。换句话说，真正承担“文档关键词实时监控”核心能力的，是部署在它侧畔的日志采集与匹配系统。
具体如何搭建？大致需要以下三个关键步骤。
明确监控对象：先将文档内容结构化
LongCat-Image-Editn 属于图像编辑模型，无法直接读取 PDF 或 Word 原文。因此首要任务是将文档转换为可监控的文本流或日志格式：
- 对于扫描件或图片型 PDF，可借助 OCR 工具（例如 PaddleOCR）提取文字，输出为结构化日志（JSON 或纯文本），写入 /var/log/longcat/doc_events.log。
- 对于电子文档（Word/PDF），可用 Python 脚本定时解析，按固定格式追加至监控日志文件，例如 [TIME] KEYWORD: "涉密" FILE: report.pdf。
- 务必确保日志路径可被采集 Agent（如 bkmonitorbeat 或 filebeat）正常访问，且具备读权限。
这一步的核心在于：日志格式必须统一、可解析，否则后续的匹配工作都将徒劳无功。
配置日志关键字事件（Agent 端匹配）
这是最轻量、延迟最低的方式，尤其适合生产环境。具体实现方案如下：
- 在监控平台新建日志采集任务，日志路径指定为上一步生成的文档日志文件，例如 /var/log/longcat/doc_events.log。
- 关键字正则建议采用：KEYWORD:\s*["'"](?P
[^"'"]+)["'"] ，这样能够准确提取出“涉密”“合同终止”等关键词，并将其作为维度上报。 - 设定统计周期——比如 1 分钟内出现次数 ≥3 次才触发告警，以此避免单次误报；支持多关键词 OR 匹配，如 涉密|违约|终止。
- 告警触发后，可联动执行脚本：自动截取当前文档页面、调用 LongCat-Image-Editn 接口对原图添加红框标注，再通过邮件通知相关负责人。
这里有一条实用技巧：正则表达式务必先用样本日志进行测试验证，否则一旦匹配不到关键词，整条链路就会失灵。
对接 LongCat-Image-Editn 实现可视化响应
当关键词命中后，可借助 LongCat 自动处理关联图像，从而形成完整闭环：
- 准备一张包含文档截图的 PNG 图片（例如从 PDF 中截取一页），上传至 LongCat 服务的 HTTP 入口。
- 发送编辑指令，例如“用红色矩形框标出文字‘涉密’所在位置，保持其余内容不变”。
- 在脚本中使用 requests 库调用其 API，获取结果图后存入指定目录，供告警消息通过链接查看。
- 注意：指令需简洁明确，避免歧义；中文文字定位效果依赖于原图清晰度与字体大小。
这一步的本质是将“检测到问题”与“可视化证据”打通，使告警不再只是干瘪的文字，而是附带红框标注的截图，负责人一眼便能确认问题所在。
补充建议：不要忽略前置验证
上线前务必完成以下三项验证工作：
- OCR 提取是否稳定——抽取几份不同扫描质量的文档进行测试，检查关键词漏提率。
- 日志正则是否准确——使用在线 Golang 正则调试器（如 regex101.com）对样本日志行进行测试。
- LongCat 标注是否可靠——上传包含关键词的测试图片，确认框选位置与语义一致，无偏移、无放大。
这三项验证看似繁琐，却能有效避免上线后出现“漏告警”或“标错位置”的尴尬局面。归根结底，文档关键词监控的可靠度，取决于整条链路中最薄弱的环节。