context-lens

一眼看清 AI 到底收到了什么上下文

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 基础设施 🍴 复刻 31 🐛 待处理 15 👀 关注 3
GitHub ↗
GitHub 星标 ★ 405
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无在线服务

项目预览

context-lens 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类基础设施
开发团队larsderidder
定价模式🏷️完全免费
价格说明开源免费,无在线服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
GitHub 星标★ 405
上线时间2026-02-07 00:00:00
代码更新2026-11-16
仓库体积6.3 MB
本站数据更新2026-11-22
维护状态活跃
收录时间2026-10-07
浏览次数3

项目介绍

context-lens 是一个与框架无关的 LLM 上下文窗口可视化工具,用 TypeScript 编写。它解决的是开发者在调试 AI 应用时“看不见模型到底收到了什么”的问题:当提示词、系统指令、历史对话、工具调用结果和检索片段被拼接成一大段上下文时,token 分布、消息顺序和冗余内容往往难以直观检查。context-lens 把这些上下文以可视化方式呈现,帮助定位上下文膨胀、消息被截断、关键信息被淹没等常见问题。它不绑定 LangChain、LlamaIndex 等特定框架,因此可以接入任意自建的 LLM 调用链路,作为调试和优化的辅助面板使用。核心能力包括上下文结构展示、token 占用可视化以及与现有代码的轻量集成,适合在开发阶段快速排查提示工程问题。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 405

使用教程

难度:入门 约 10 分钟 部署方式:本地运行 4 步

环境要求

  • Node.js 22.23.4+ / 24.22.1+ / 26.12.1+
  • 一个走 OpenAI/Anthropic/Google 接口的智能体

安装与启动步骤

  1. 1确认 Node 版本

    对 Node 的补丁版本有硬要求(TLS 信任修复),版本低了装不上

    node --version
  2. 2全局安装

    装完得到 context-lens 命令

    npm install -g context-lens
  3. 3包住你的智能体启动

    命令行前面加 context-lens,它会起本地代理并记录调用

    context-lens -- python my_agent.py
  4. 4看组合拆解

    打开本地面板,看系统提示、工具定义、历史、工具结果各占多少 token

    echo open localhost panel

如何确认成功

面板里能看到本次会话的上下文构成饼图,各分项百分比相加接近 100%。

注意事项

  • 它只做观测,不改请求内容,接上去不会影响原有行为。
  • 默认走本地代理,抓的是 API 调用元数据,敏感提示词会落盘,团队环境注意清理。
  • 支持 Claude Code、Codex、Gemini CLI、Cline、Aider,凡是走标准 API 的都能接。

核心亮点

  • 框架无关,不绑定 LangChain/LlamaIndex,任何自建调用链都能接入
  • 直接可视化上下文窗口的 token 分布,便于定位上下文膨胀和截断问题
  • TypeScript 编写,前端/Node 项目集成成本低

不足之处

  • 项目早期,星标仅 401,生态和文档完善度有限
  • 可视化能力偏调试辅助,缺少自动优化或压缩上下文的闭环功能

适用场景

  • 调试 RAG 应用时检查检索片段是否挤占了过多上下文
  • 排查多轮对话中历史消息被截断或顺序错乱的问题
  • 优化提示词时对比不同拼接策略下的 token 占用

替代项目

LangSmith、Helicone

上一篇:infrahub

下一篇:traccia-py

同类项目推荐

suna 开源

一站式管理你的所有 AI 智能体,让运维更省心

Kortix CompanyOS – the open-source operating system for your company. Multiplayer A···

★ 20783 2026-08-09
slotstream 开源

小内存 Mac 也能跑百 GB 大模型,从 SSD 流式加载

Run a 105 GB AI model on a Mac that can't hold it. Qwen3.8-Flash-Next 4-bit, streame···

★ 674 2026-11-06
memory-lancedb-pro 开源

让智能体记忆更准、更清晰,开箱即用的混合检索与管理工具。

Enhanced LanceDB memory plugin for OpenClaw — Hybrid Retrieval (Vector + BM25), Cro···

★ 4448 2026-08-09
tt-metal 开源

用 Tenstorrent 硬件跑 AI 模型,底层算子与内核编程一手掌控

:metal: TT-NN operator library, and TT-Metalium low level kernel programming model.

★ 138 2026-08-09
llm-d-kv-cache 开源

把大模型KV缓存拆到多机,省显存提吞吐

Distributed KV cache scheduling & offloading libraries

★ 197 2026-09-16
postgres 开源

最可靠的开源关系型数据库,搞定复杂数据场景

Mirror of the official PostgreSQL GIT repository. Note that this is just a *mirror* ···

★ 22901 2026-08-29
xllm 开源

一套引擎,跑遍各类模型和加速器,推理更快更省心。

A high-performance inference engine for LLM, VLM and DiT models, optimized for diver···

★ 1626 2026-08-09
mere-run 开源

在 Mac 上一条命令跑通图像、语音、视频等本地 AI 工作流

Run local image, text, speech, vision, music, and video workflows, plus model manage···

★ 97 2026-08-09
PocketClaw 开源

插上U盘,秒变AI工作站,随处可用

PocketClaw(口袋龙虾)— 装在 U 盘里的随身 AI 助手

★ 63 2026-08-09