# @faithfulalabi/agent-lens 中文文档

规范地址：https://npmcn.com/package/%40faithfulalabi/agent-lens/

版本：0\.20\.0
npm 元数据更新时间：2026-11-05T05:02:06.369Z
中文译文更新时间：2026-11-14T09:25:39.874Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40faithfulalabi/agent-lens
原文对照：https://npmcn.com/package/%40faithfulalabi/agent-lens/?lang=original
项目主页：https://github.com/faithfulalabi/agent-lens#readme
源码仓库：https://github.com/faithfulalabi/agent-lens

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：990 kB，79 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：2 个
- 首次发布：2026-09-26T04:03:33.247Z
- 最新版本发布：2026-11-05T05:02:06.037Z
- 近 30 天下载量：3068（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

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

## 安装

```sh
npm install @faithfulalabi/agent-lens
```

也可以使用：`pnpm add @faithfulalabi/agent-lens`、`yarn add @faithfulalabi/agent-lens`、`bun add @faithfulalabi/agent-lens`

## README

# 代理贷款

[![npm version](https://img.shields.io/npm/v/%40faithfulalabi%2Fagent-lens?label=npm)](https://www.npmjs.com/package/@faithfulalabi/agent-lens) [![node-current](https://img.shields.io/node/v/%40faithfulalabi%2Fagent-lens)](https://nodejs.org/) [![license: MIT](https://img.shields.io/badge/license-MIT-blue)](https://npmcn.com/package/%40faithfulalabi/agent-lens/LICENSE) [![CI](https://github.com/faithfulalabi/agent-lens/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/faithfulalabi/agent-lens/actions/workflows/ci.yml)

**回读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](https://raw.githubusercontent.com/faithfulalabi/agent-lens/main/docs/images/01-sessions.png)

## 回答的问题

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

## 快速启动

```bash
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](https://raw.githubusercontent.com/faithfulalabi/agent-lens/main/docs/images/thread-tool-call.png)

**副代理人自留笔录.** 一个 `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](https://raw.githubusercontent.com/faithfulalabi/agent-lens/main/docs/images/thread-subagent.png)

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

![In-session search results, each hit showing the matched run highlighted inside a prompt or tool payload](https://raw.githubusercontent.com/faithfulalabi/agent-lens/main/docs/images/10-search.png)

## 如何比较

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.db` | A 类 **一次性** 缓存 — 搜索索引和预测, 全部导出 . | 没什么 它从档案中重建. |

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

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

### 明确声明的限制

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

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

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

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

## 保存归档当前

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

```bash
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——未运行的工作是 不同,更紧急的事实 比一个运行 和发现没有新 复制.

## 启动服务器

```bash
agent-lens start
```

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

服务器绑定 `127.0.0.1` 默认和每个 `/api/*` 请求带有一个符号。 见 [警卫](https://npmcn.com/package/%40faithfulalabi/agent-lens/SECURITY.md) 包括令人惊讶的财产 人:在一个共享的机器上,被追踪的代理也可以读取痕量API.

## 捐款

见 [捐款额](https://npmcn.com/package/%40faithfulalabi/agent-lens/CONTRIBUTING.md) 对于dev设置, 渲染循环 相对于一个真正的实体 命令重生此页面上的截图,单门规则每次更改为 记录读取必须满足.

## 许可证

麻省理工学院.

## 常见问题

### @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 和提交记录判断。