winless-boozing857/agent-lens

# 🧠 agent-lens - 回放与检查 AI agent 运行记录 [](https://github.com/winless-boozing857/agent-lens/releases) ## 🔍 什么是 agent-lens？ agent-lens 是一款用于查看、回放和检查 AI agent 运行记录的 Windows 应用程序。它可以帮助你检查 agent 做了什么、何时做的，以及其决策是如何随时间展开的。 使用它可以： - 打开已保存的 agent 运行记录 - 按顺序单步查看事件 - 查看消息、工具使用和输出 - 并排比较不同的运行记录 - 研究用于安全性和可解释性工作的 agent 行为 它是为研究、审查和 trace 分析而构建的。重点在于发生了什么，而不是繁琐的设置工作。 ## 🪟 Windows 下载 访问发布页面下载并运行该应用： [Download agent-lens for Windows](https://github.com/winless-boozing857/agent-lens/releases) 在发布页面上，找到最新版本并下载与你的系统匹配的 Windows 文件。文件下载完成后，打开它以启动应用。 ## ⚙️ 开始之前 为了确保安装顺利，请检查以下基本条件： - Windows 10 或 Windows 11 - 首次下载需要互联网连接 - 足够的磁盘空间用于存放应用和保存的运行数据 - 在电脑上打开已下载应用的权限 如果你打算查看大型 agent trace，内存较大的电脑有助于保持回放流畅。 ## 📦 如何安装 1. 打开发布页面。 2. 在顶部附近找到最新版本。 3. 下载 Windows 应用文件。 4. 等待下载完成。 5. 从你的 Downloads（下载）文件夹打开该文件。 6. 如果 Windows 请求确认，请选择“打开”或“运行”。 7. 按照屏幕上的步骤操作，直到应用启动。 如果文件位于 ZIP 文件夹中，请右键单击并选择“全部解压缩”，然后再打开应用。 ## 🚀 首次运行 当你首次打开 agent-lens 时，可能会看到一个简单的设置屏幕。在那里，你可以加载已保存的运行文件或打开包含 trace 数据的文件夹。 典型的第一步操作： - 选择一个要检查的运行记录 - 等待数据加载 - 使用时间轴浏览事件 - 点击事件查看详情 - 查看消息、操作和工具结果 如果你已经有导出的 agent 日志，可以将应用指向该文件夹或文件，然后立即开始。 ## 🧭 你可以在应用中做什么 ### 👁️ 查看 agent 活动 按顺序查看 agent 执行的每一步。这有助于你追踪从 prompt 到最终输出的完整路径。 ### ⏪ 回放运行记录 在运行记录中前后移动，以研究 agent 是如何改变方向的。 ### 🧾 检查 trace 详情 打开事件数据以查看消息、工具调用、模型输出和时间戳。 ### 🔎 比较行为 使用多个运行记录来发现决策、顺序和结果方面的差异。 ### 🛡️ 支持研究工作 使用该应用研究对齐、安全性、失败案例和 agent 行为模式。 ## 🗂️ 支持的数据 agent-lens 旨在处理已保存的 agent trace 和回放文件。常见的输入包括： - JSON trace 文件 - 导出的 session 文件夹 - 来自 agent 运行的事件日志 - 来自本地实验的结构化运行数据 为了获得最佳效果，请将文件保存在一个文件夹中，并在导出后避免更改名称。 ## 🧩 常见工作流 一个简单的审查流程如下： 1. 导出或复制 agent 运行数据。 2. 打开 agent-lens。 3. 加载 trace 或文件夹。 4. 从列表中选择一个运行记录。 5. 浏览时间轴。 6. 阅读事件详情。 7. 如有需要，将其与另一个运行记录进行比较。 这使得研究运行记录何时保持在正轨上或何时偏离目标变得更加容易。 ## 🖥️ 界面概览 该应用旨在在普通桌面屏幕上保持清晰易读。 你可能会看到： - 左侧的运行记录列表 - 中间的主回放视图 - 事件详情面板 - 时间轴或步骤栏 - 事件类型或工具的过滤器 - 运行记录内的文本搜索 该布局在保持主要 trace 可见的同时，让你可以访问每一步背后的数据。 ## 🔐 隐私与本地使用 agent-lens 用于本地审查 agent 数据。当你想要检查运行记录而不想跨服务共享它们时，这非常有用。 良好的本地习惯： - 将 trace 文件保存在私有文件夹中 - 将研究数据存储在受信任的位置 - 删除不再需要的文件 - 为测试运行和正式运行使用单独的文件夹 ## 🛠️ 故障排除 ### 文件无法打开 尝试以下步骤： - 确保下载已完成 - 检查你是否打开了正确的文件 - 如果它位于 ZIP 文件中，请先将其解压 - 尝试再次从 Downloads 文件夹运行它 ### Windows 阻止了应用 如果 Windows 显示安全提示，并且你信任下载来源，请选择打开或运行该文件的选项。 ### 应用打开但没有数据显示 检查你是否加载了正确的 trace 文件或文件夹。某些 trace 导出使用嵌套文件夹，因此请先尝试主导出文件夹。 ### 回放感觉缓慢 大型运行记录可能需要时间来加载。关闭其他应用，然后重新打开 agent-lens 并重试。 ### 文字看起来太小 使用 Windows 显示设置或应用缩放控件（如果可用）。较高的屏幕缩放比例可以使 trace 审查更容易。 ## 🧪 示例用例 agent-lens 适用于多种审查工作： - 研究 assistant 如何响应 prompt - 检查工具调用在何处改变了运行路径 - 审查导致失败的步骤 - 比较安全运行与风险运行 - 在研究过程中逐行阅读 agent 输出 - 寻找在可解释性分析中可能重要的行为 ## 📁 文件处理技巧 为了保持你的工作井井有条： - 将每个运行记录存储在各自的文件夹中 - 使用清晰的名称，如 `run-01`、`test-run` 或 `evaluation-set` - 保持原始导出文件不变 - 在编辑或移动重要 trace 之前对其进行备份 这有助于你稍后返回某个案例时仍能需要相同的数据。 ## 🧠 为什么人们使用 agent-lens Agent trace 作为纯文本可能难以阅读。回放工具使它们更容易扫描和比较。 agent-lens 帮助你： - 按顺序跟踪运行记录 - 查看决策过程的形态 - 发现重复的工具使用 - 审查边缘案例 - 比较不同运行的结果 - 在更多上下文中研究行为 这使得它对齐工作、可解释性审查和研究笔记非常有用。 ## 🏷️ 主题 ai, alignment, interpretability, observability, safety ## 📥 下载和设置链接 访问发布页面下载并运行 Windows 应用： [https://github.com/winless-boozing857/agent-lens/releases](https://github.com/winless-boozing857/agent-lens/releases) 下载后，打开文件并按照屏幕上的提示操作 ## 🔗 参考 Repository: agent-lens Description: Agent observability and replay tooling for AI safety & interpretability research

标签：Agent SDK, AI安全, AI智能体, ATIF, Chat Copilot, Claude, CVE检测, Homebrew安装, Windows应用, 事件检查, 可解释性, 多会话追踪, 对齐研究, 文件状态监控, 研究辅助, 轨迹回放