Schema Guide
适合监测记录的 Twitter API JSON 结构，让告警、队列和自动总结能复用同一份记录
监测记录结构是 Twitter / X 流程里最值得花时间设计的一层，因为它会同时影响告警、队列、看板、总结和排查问题。稳的结构，通常都小、稳、清楚。
2026-04-20
1. 先从最小可用记录开始
很多稳定的结构，都是从很小的一组字段开始：来源身份、帖子身份、采集背景和当前状态。
这已经足够支持团队做分发和总结，不需要一上来就造很大的返回结构。
- 把 post id 或 URL 放进核心记录。
- 把来源身份放进核心记录。
- 把命中的搜索和当前状态放进核心记录。
2. 分发字段通常比分析字段更早重要
很多监测任务在早期更需要的是优先级、复核状态或去向队列，而不是一堆更花哨的分析字段。
所以这类结构通常应该先从分发和处理出发，而不是从看板想象出发。
- 尽早加优先级或严重程度字段。
- 让复核状态保持显式。
- 当分发重要时，加目标位置或处理阶段字段。
3. 原始内容和解释结果最好分开
当原始内容、人工备注和自动标签分开时，这份结构往往更容易追溯，也更方便以后重跑。
这会让 QA 和后续复盘都轻松很多。
- 原文和备注分开存。
- 标签和总结单独字段保存。
- 不要把来源数据和复核结论混在一起。
4. 最好让告警和自动总结复用同一份核心记录
很多稳定的监测系统，最后都会让告警、队列和自动总结共用一份核心记录，即使最终输出形式不同。
这会减少转换工作，也让整套方法更容易长期维护。
- 尽量让后续各个使用方复用同一核心记录。
- 只有必要时再加少量任务专用字段。
- 新使用场景出现时，顺手检查结构有没有开始走样。
这条流程跑出第一次结果后，团队接着会问的问题
最小字段结构里最值得放哪些字段？
通常是帖子身份、来源身份、命中的搜索条件，再加一两项说明当前状态和去向的字段。
提醒和自动总结要不要分开用两套结构？
很多时候可以共用同一份核心记录，只在最后给不同使用方输出时再分开。
什么样的字段结构更容易长期维护？
通常是字段名稳定、原始内容和解释结果分得清楚，而且每个字段都能回到真实处理判断上的结构。
通常会一起看的实现页
把 Twitter / X 公开帖子做成团队能反复运行的流程
如果这些问题已经开始频繁出现在你的流程里，可以去验证帖子检索、账号复核或历史发言接入路径，并把输出接进稳定团队循环。