@faithfulalabi/agent-lens

中文文档
0.20.0发布于 2026/11/05MITES Module构建来源已验证近 30 天下载 3068

本地第一代理追踪平台:检查您的代理在会话中所做的一切.

中文使用文档
文档目录11 节
  1. 回答的问题
  2. 快速启动
  3. 短暂的旅程
  4. 如何比较
  5. 你所保存的 耐久合同
  6. 明确声明的限制
  7. 保存归档当前
  8. agent-lens doctor ——什么受到保护,什么不是
  9. 启动服务器
  10. 捐款
  11. 许可证

代理贷款

npm version node-current license: MIT CI

回读Claude代码会议所做的一切 提示 推理 工具呼叫 子代理, 投入和产出——在届会结束后很长一段时间内,在一个本地的UI中.

Claude Code过期了自己的笔录 Agent-lens 保存您每次会议的逐字记录 永远运行,在你的机器上, 搜索在来源消失后。 它读了文件 带子 已写入磁盘 : 没有账户, 没有 API 密钥, 也没有添加到您的代理或您的 应用.

The agent-lens session list, showing every archived session with its model, turn count, tokens and estimated cost

回答的问题

  • 三周前我问了什么? 档案里还存有一次会话 Claude代码已经过期了.
  • 那场会议哪里出了问题? 按顺序读出会话: 每个工具呼叫, 其真实 输入,其真实输出,发生地点.
  • 副特工做了什麽? 打开 Agent 调用并阅读副代理人自己的笔录—— 它的推理,它的工具, 以及它回所报道的.
  • 哪个会话触及到这个文件? 横跨提示、工具有效载荷和输出的全文搜索 太大了,不能坐进去.
  • 花了多少钱? 每个会议、每个转会和每个电话的分机和估计费用.

快速启动

npx @faithfulalabi/agent-lens

启动本地服务器和用户界面并打印 URL。 打开它。 您已经运行的会话 新的出现了.

需要节点.js >=24。 。 。 .

短暂的旅程

每一个呼叫, 及其真正的有效载荷. 会话作为对话,工具呼叫 夹入信息之间的活动组。 打开一个,它显示什么 实际进入和 真正回来的是什么.

A session read as a conversation: a prompt, Claude's reply, and an open activity group showing a Read call with its input and its output

副代理人自留笔录. 一个 Agent 直接调用链接到会话 子代理运行,有它自己的消息,它自己的工具呼叫和它自己的成本—— 以及返回的方式 亲子关系.

A sub-agent's own session: a back link to the parent session, the sub-agent's opening message, its Glob and Grep calls with payloads, and the findings it reported

搜索到达有效载荷, 不只是提示. 在载着他们的事件上撞倒了他们 显示匹配位置 。 以下屏幕的搜索范围为一个开放会话; 搜索 从会话列表中获取整个归档.

In-session search results, each hit showing the matched run highlighted inside a prompt or tool payload

如何比较

LangSmith、Langfuse和Arize Phoenix正在追踪您正在构建的应用程序的平台 现在所有三个 也运送一个克洛德代码插件。 下面的每个姿势都是从工具上读取的 现有文件.

工具需要你的帮助数据所在的地方内容
兰斯密斯账户和API密钥 。 追踪来源于您应用程序中的SDK,来自OpenTeleometry,或来自其克洛德代码插件.兰Cha所出云. 自我托管和BYOC是企业计划备选方案.Spans 您的应用程序会发出, 或在会话运行时打开它的 Claude 代码插件报告 .
兰福斯账户——云或自管——和一对密钥. 追踪来源于它的SDK,来自OpenTeleometter,或来自它的克洛德代码插件.兰佛斯云默认. 自宿有文并开源.启动您的应用程序 。 它的Claude代码插件读取了每个转弯的笔录 当转弯完成.
阿里兹·凤凰要发送的凤凰网实例——有记录的默认是本地的,不需要账号. 追踪来源于OpenInference / OpenTeleometry,或其克洛德代码插件.你自己的机器或基础设施默认.OpenTeleometry 横跨您的应用程序 释放出, 或者在会话运行时打开它的 Claude 代码插件报告 .
代理贷款一个命令 没有账户,没有钥匙, 没有添加到您的申请或代理.只有你的机器,在下面 ~/.agent-lens。 。 。 .Claude Code的笔录文件已经写入了磁盘——包括代理-伦斯在机器上之前的会话.

后一列为相. 其余三个观察一个会话的发生,所以记录 当你设置它们。 代理 - 伦斯读到 已经写的东西, 所以第一次运行显示 在克劳德代码过期后 保留它.

你所保存的 耐久合同

运行这个的原因是存档. 克劳德代码过期 ~/.claude/projects 独自一人 时间表; 存档是超过它的复制件, 越过悬崖是那里唯一的复制件 没错 这使得下一部分值得在删除任何内容之前阅读.

三个目录,三个完全不同的承诺.

路径这是什么删掉它的成本
~/.claude/projects这个 来源克劳德代码拥有它,写它, 并过期文件 从它自己的时间表。 经纪人只读.不是你的电话 克劳德・科德已经在做了 这就是这个工具存在的全部原因.
~/.agent-lens/archive这个 记录制度。逐字记录镜:在不同的路径上相同的字节,只有附件,不会写回.所有经过源出崖. 没有其他副本.
~/.agent-lens/cache.dbA 类 一次性 缓存 — 搜索索引和预测, 全部导出 .没什么 它从档案中重建.

rm 缓存.db 毫无损失. rm -rf ~. agent-lens/archive 永久丢失数据.

颠倒为分. 看上去夸张的目录 就是被抹去的目录 你家目录中不可注意的就是 唯一幸存的拷贝.

明确声明的限制

agent-lens只能归档它运行时存在的东西——在上升时间上的漏洞就是记录中的漏洞.

100%的覆盖率为100% 遗属名单任何克劳德代码在 存档已经存在,或者在其中一个很长的空白期间,它已经消失,没有任何工具能够把它带回.

档案馆的存檔会永远保存下去 尽管数字是 而不是:来源随着年龄而消逝,然后停止——几周前经过了悬崖,什么都没有 档案一直保留着 每一个比悬崖更老的会话都只存在 在档案中.

请不要从此页面取出号码 。 你的官司不是作者的, 和两个日常移动. agent-lens doctor 打印您的文件, 包括有多少文件没有活源 只有档案室.

保存归档当前

agent-lens schedule install

那样就成了一个反复不断的工作 agent-lens archive 每15分钟记录一次 地点 agent-lens doctor 读它。 两个支持的平台都为您处理: macOS 获得一个 启动代理, Linux 获得系统d 用户 计时器下 ~/.config/systemd/user。再运行一次 时间——它取代了自己的工作而不是重复. agent-lens schedule status 报告 工作及其最后的合格证书; agent-lens schedule disable 把它关闭干净,离开 存档及其日志未更改 。 在任何其他平台上运行 agent-lens archive 每~15分钟 无论你有什么安排,你都行, 比如说一个cron入口.

一个值得你先知道的警告 取决于间隔时间: 机器睡着了 将间隔视为绑定 醒来 时间,而不是过去的时间.

以及绿色报告与真实档案的区别:

系统化的用户计时器在您被登录时不运行, 除非您的用户仍在运行

agent-lens schedule status 显示您的用户所在的报表,以及 schedule install 打印 一个改变它的命令.. loginctl enable-linger <uid>。命令被打印并永远不运行 : 它写在工具拥有的一切之外 这两个平台在追赶方面也有意有分歧. 启动后在负载时运行一个通过; 系统计时器使用 OnCalendar 与 Persistent=true,所以一个插槽 在机器关机时丢失了一次.

通行证通常可以安全运行:咨询锁意味着第二张同时签发的通行证副本无一例外 0出处,一个不变的单位复制了0字节。 当源已重写时,存档 字节为 保留 文件被标记 diverged 而不是覆写. agent-lens archive --verify 是完整文件完整性审计—— 不为预定的通行证;用手或手操作它 每周日程安排.

agent-lens doctor ——什么受到保护,什么不是

doctor 读取树和报告 档案覆盖、完整性、档案总字节 和克劳德代码自己的保留设置 这个 没有写 -没有 档案,不是日志,不是锁, 从来不属于你的绳子。 报告 保留;不修复.

agent-lens doctor --verify
旗帜含义
--json将报告全文作为 JSON 一行发布
--dataDir <dir>覆盖 ~/.agent-lens
--transcriptRoot <dir>覆盖 ~/.claude/projects
--settingsPath <file>将吊带保留设置从(也) AGENT_LENS_CLAUDE_SETTINGS(中文(简体) )
--verify重算完整前缀散列——真实的审计,而不是被抽样的审计

认真读取诚信行. 它打印出三个数 总计到存档文件的数量: 已核实, (中文(简体) ), 差异 财务报告和审定财务报表 无法核实。当不存在可以检查的文件时,该文件是不可核查的 它的源头已经过期,或者已经封存,没有储存每个文件的散列物 还没有。 这些文件从未被计算为核实。 在一个已经关闭了一个月的机器上,预期 无法证实是大的那个。 这是真实的答案,而不是失败.

doctor 也报道了自档案工作最后成功通过以来的一段时间,从工作上读取 自己的日志( e)~/.agent-lens/logs/cron.log),从不从文件出 mtime——未运行的工作是 不同,更紧急的事实 比一个运行 和发现没有新 复制.

启动服务器

agent-lens start
旗帜含义
--port <n>绑定口(碰撞时自动损坏)
--host <host>绑定主机 。 默认回回转; 任何其它信息都会打印出网络曝光警告, 您的决定是

服务器绑定 127.0.0.1 默认和每个 /api/* 请求带有一个符号。 见 警卫 包括令人惊讶的财产 人:在一个共享的机器上,被追踪的代理也可以读取痕量API.

捐款

见 捐款额 对于dev设置, 渲染循环 相对于一个真正的实体 命令重生此页面上的截图,单门规则每次更改为 记录读取必须满足.

许可证

麻省理工学院.

版本与发布记录

@faithfulalabi/agent-lens 共发布 26 个版本,首次发布于 2026/09/26;过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.20.0latest2026/11/059 天前
0.19.02026/11/0410 天前
0.18.02026/11/0410 天前
0.17.02026/11/0410 天前
0.16.02026/10/3114 天前
0.15.32026/10/3114 天前

关于 @faithfulalabi/agent-lens 的常见问题

@faithfulalabi/agent-lens 是什么?

本地第一代理追踪平台:检查您的代理在会话中所做的一切.

如何安装 @faithfulalabi/agent-lens?

在项目目录运行 npm install @faithfulalabi/agent-lens,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-lens,可以用 npx agent-lens 直接运行。

@faithfulalabi/agent-lens 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/faithfulalabi__agent-lens 是否存在。

@faithfulalabi/agent-lens 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@faithfulalabi/agent-lens 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@faithfulalabi/agent-lens 可以商用吗?

@faithfulalabi/agent-lens 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@faithfulalabi/agent-lens 的下载量有多少?

根据 npm 官方下载统计,@faithfulalabi/agent-lens 在 2026/10/14 – 2026/11/12 这 30 天内被下载 3,068 次,日均约 102 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@faithfulalabi/agent-lens 还在维护吗?

最新版本 0.20.0 发布于 2026/11/05(9 天前);至今共发布 26 个版本,其中过去 12 个月发布了 26 个;首次发布于 2026/09/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。