agentfdr：给AI Agent装上“黑匣子”，调试循环、漂移和Token浪费
agentfdr 是一个专为AI Agent打造的调试工具，能事后逐轮回放执行日志，帮你揪出死循环、目标漂移和Token浪费——无需任何代码注入，完全本地运行。它就像Agent会话的“飞行记录仪”，记录每一次工具调用、上下文窗口组成和输出Token，让失败原因一目了然。工程师终于可以“调试看得见的循环”，把不可见的Agent行为变成可审查的时间线。
适用场景
- 调试无限循环：Agent陷入“编辑→测试失败→再编辑”的40分钟死循环，一抓一个准。
- 检测目标漂移：明明让Agent修Bug，它却偷偷重构了路由器，当场现形。
- 分析Token浪费：巨大的工具结果挤爆上下文窗口，导致缓存失效、每轮重读20万Token，轻松定位。
- 调查“假完成”：Agent说“搞定！”但测试全挂，或者干脆停不下来——原因一目了然。
- CI流水线监控：用
agentfdr assert设置警戒线，自动拦截循环或Token超标。 - 成本追踪：跨项目汇总会话记录，监控各模型用量和预估成本，对比订阅套餐。
- 事后复盘报告：一键生成Markdown版“验尸报告”，直接粘贴到Issue或Slack。
Core Features
时间线视图
单屏展示整个会话——每轮的工具调用、上下文窗口组成、输出Token，附带提示词和压缩标记。
异常检测
自动标记工具循环、错误连续、上下文膨胀、Token峰值、缓存抖动、文件频繁修改和拒绝响应——点击即可查看证据。
逐轮剖析
可调整大小的侧面板，显示用量分解、每个工具调用的耗时、结果大小和片段。用 ←/→ 键逐轮浏览。
实时监控模式
`agentfdr watch` 跟踪正在运行的会话，实时展示上下文攀升过程。
CI关卡
`agentfdr assert --no-loops --max-tokens 2M` 在违规时返回退出码1，作为自动化流水线的警戒线。
Markdown复盘
`agentfdr blame` 将完整分析输出为Markdown，直接粘贴到Issue或Slack。
用量追踪
按项目汇总会话记录，与订阅计量格式一致——当前5小时窗口、每日历史、滚动周报，附带模型细分和预估成本。
预算校准
自动检测你的套餐层级，设置预算，对照Claude Code的/usage页面校准一次，即可在接近上限时收到警告。
目标用户
软件工程师和AI开发者，特别是那些构建或维护自主Agent系统的人。具体来说，包括调试Agent循环、处理不可预测行为、管理生产流水线Token成本的工程师。QA工程师可用它设置CI关卡，团队负责人则能借助它生成Agent故障的复盘报告。
如何使用agentfdr？
agentfdr 是一个命令行工具，主要命令包括：
agentfdr– 打开最新会话的时间线agentfdr list– 列出所有项目中的已记录会话agentfdr watch– 实时跟踪正在运行的会话agentfdr blame 35cb18– 为特定问题生成Markdown复盘报告agentfdr usage– 查看套餐消耗（5小时窗口、每日、每周）agentfdr assert --no-loops --max-tokens 2M– CI关卡，违规时返回退出码1
无需注册，没有网页界面，完全通过终端命令本地运行。
效果评价
agentfdr 切中了一个真实痛点：自主Agent失败的不可见性。作为调试工具，功能相当全面——覆盖时间线可视化、异常检测、实时监控、CI集成和成本追踪。命令行界面表明它面向已在终端环境中工作的开发者。虽然网站未提供用户反馈或质量指标，但“零注入”和“本地运行”的设计使其在生产调试中非常实用，不会增加额外开销。对于还在Agent循环工程中挣扎的团队来说，这是一个专注、务实、不花哨的解决方案。
Frequently Asked Questions
agentfdr 是什么？
agentfdr 怎么工作的？
用 agentfdr 需要给我的智能体加代码吗？
agentfdr 能帮我解决哪些问题？
agentfdr 免费吗？
agentfdr 能用在任何 AI 智能体框架上吗？
agentfdr - AI Tool Detail
agentfdr 来自 kamihork，专为 AI 智能体打造的调试利器。无需任何侵入式配置，就能事后回放每一步执行日志，帮你揪出循环陷阱、目标漂移和 token 浪费，所有操作都在本地完成。
Category：智能体
Visit Link：https://kamihork.github.io/agentfdr/
Tags：AI代理调试工具、执行日志分析、Token浪费检测、目标漂移追踪、本地调试神器