Agent Lens：为你的 AI 对话做复盘

痛点：和 AI Agent 协作，问题总是重复犯

日常用 Claude Code、Codex 这类 AI Agent 干活时，你可能也遇到过：

• 需求目标不清：说了一堆背景，但没告诉它「最终要达成什么」，它做出来自然不对。
• 上下文缺失：没贴关键报错、没交代约束条件，Agent 只能靠猜。
• 反馈模糊：一句「不对，再改改」，既没说哪里不对，也没给方向。

更要命的是，这些问题会反复出现——今天因为目标不清返工，下周还会因为同样的问题再返工一次。没有人复盘，每次沟通质量都靠感觉，没有可积累的量化反馈。Agent Lens 就是来解决这个问题的。

Agent Lens 能做什么

导入

• Web 控制台：直接把对话记录粘贴到输入框，或上传对话文件（单次 ≤20MB）。
• CLI：agent-lens import <file> 导入本地文件。

支持 Claude Code、Codex 的导出记录，也支持手动整理粘贴。

会话管理

导入后以 2 列网格卡片展示所有会话，支持关键词搜索，可按来源（Claude Code / Codex / 手动）、分析状态（已分析 / 未分析）筛选，列表分页浏览。历史对话再多也能快速定位。

分析报告

AI 从 10 个维度诊断这次对话的沟通问题：目标、上下文、约束、验收、反馈、碎片化、歧义等。每个会话生成一份报告：

• 总体评分：这次沟通打多少分，一眼看到质量。
• 逐条问题：每个问题带维度、严重度、原文证据、影响、建议和改写示例——不仅告诉你「哪里不好」，还告诉你「该怎么说」。
• 做得好的地方：值得保持的沟通习惯也会列出来。

趋势看板

所有分析结果沉淀成看板：总分析次数、平均得分、错误类型 Top5，以及「次数 + 均分」的时间趋势双线折线图。复盘不再靠记忆，长期趋势一目了然。

设置

支持 DeepSeek / OpenAI / 通义 / 自定义多种服务商，每种可保存多个配置；切换服务商时自动带出已存的 Key，不用反复粘贴。

CLI 工具

终端里也能完成整套工作流：login（登录）、config（配置模型）、list（列会话）、analyze（分析）、import（导入）。不开浏览器也能一条链跑完。

分析引擎：Function Calling

分析引擎带 function calling 能力——模型在诊断时不是直接下结论，而是可以自主调用工具去收集证据：查历史分析、补取上下文、核对诊断标准，证据齐了再下结论。这让每一条诊断都尽量「有据可查」，而不是凭空猜测。

怎么用：三步上手

Web 路径：

1. 注册登录：打开控制台，创建账号。
2. 配模型 Key：设置页选择服务商（如 DeepSeek），填入你的 API Key。
3. 导入 → 分析 → 复盘：粘贴或上传一段对话 → 点分析，拿到报告 → 定期回看趋势看板，观察自己的沟通质量是否在提升。

CLI 路径：一条链跑完——

agent-lens login
agent-lens config show
agent-lens import ./session.txt
agent-lens analyze --latest

导入即分析，报告直接打在终端里。

你的数据，只在你本地

所有会话与分析结果都存本地 SQLite，分析时只把选中的那段会话发给你自己配置的 LLM，其余数据不出本机。Agent Lens 定位是「面向 AI Agent 使用质量的复盘层」——不替代 Agent，而是帮你看清楚自己和 Agent 沟通得怎么样，然后一点点变好。