GStreamer 流水线图优化器

要解决什么问题

GStreamer 媒体流水线本质是一张有向无环图：capsfilter 做格式转换，queue 做缓冲隔离，appsrc/appsink 负责进出内存。线上问题往往不是某个元素单独慢，而是 queue 容量不当引发背压、线程池争抢导致帧堆积、下游阻塞拖垮上游。开发者手里通常只有两个入口：GST_DEBUG_DUMP_DOT_DIR 导出的 DOT 图转储，以及 gst-stats 打印的元素级吞吐数据。单独看都不够——DOT 图只给拓扑不给瓶颈位置，stats 只给速率不给瓶颈在哪段链路上。

技能如何工作

• 解析 DOT 转储：读取 GST_DEBUG_DUMP_DOT_DIR 生成的 .dot 文件，还原完整的元素拓扑与 pad 连接关系，标出 queue、multiqueue 与线程绑定节点。
• 采集吞吐画像：从 gst-stats 输出中提取每个元素的 fps、字节速率与队列占用情况。
• 关联定位瓶颈：把拓扑位置与吞吐数据对应起来，判断背压源头是下游 queue 还是线程池饱和。
• 输出配置建议：针对定位到的节点，给出 queue-size、max-bytes、threads 等参数的调整方向。

适用边界与注意点

• 它提供的是分析与建议，不是自动改配置的守护进程，参数调整仍需人工验证后生效。
• 需要先开启 DOT dump 与 stats，对运行环境有侵入性，建议在压测环境或影子流水线中使用。
• SKILL.md 未附带经过验证的安装与使用说明，运行前应审阅上游项目（gstreamer.freedesktop.org）再决定是否用于敏感流程。