TraceMotive：面向 AI Agent 执行的本地优先调试器

我一直在做一个叫 TraceMotive 的开源项目。

这个项目源于我反复遇到的一个问题：

当一次 Agent 运行失败时，错误出现的地方并不一定是执行最初开始出错的地方。

这就让调试 Agent 工作流变得比看起来要困难得多。

所以我做了 TraceMotive，一个本地优先的 AI Agent 执行追踪与调试工具。

TraceMotive 的功能

当前 v0.1 版本包含：

• 规范的 traces 和 spans
• 基于 SQLite 的本地 Collector
• 用于检查 Agent 运行的 React UI
• 可选的 OpenAI Agents SDK 集成

TraceMotive 是本地优先的，内容捕获默认关闭。

我有意让第一个版本保持精简。我不打算一开始就加入 replay、自动根因分析、云同步，或者支持所有主流的 Agent 框架。

我更希望在加入大量功能之前获得真实的反馈。

现在我希望真正做 AI Agent 开发的人来试试，告诉我：

• 哪里配置起来让人困惑
• trace 里缺少什么信息
• API 哪里用起来别扭

长期方向是：

"AI Agent 的因果调试器"

最终，我希望 TraceMotive 能帮助定位 Agent 执行是从哪里开始走偏的，而不仅仅是展示最终错误出现在哪里。

但首先，我想先把基础的观测和调试层做好。

pip install tracemotive

https://github.com/doraemonfv-glitch/tracemotive

如果你在做 AI Agent 开发，我非常希望你能花几分钟试试，然后告诉我你遇到了什么。

即便是很小的反馈也很有用。