pxpipe 是什么?

pxpipe 是本地代理和 TypeScript 库,把系统提示、工具文档与较旧的长历史渲染成图片,再把请求转发给模型。它压缩输入请求,不改模型输出;最近轮次和需要精确保留的内容可以继续走文本。

⭐ 5,611 Stars 🍴 481 Forks TypeScript MIT 作者: teamchong
来源:github.com/teamchong/pxpipe 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

用户真正关心的是节省是否可复现、哪些模型能读清图片、精确字符串会不会丢失,以及如何接入 Claude Code 或其他 Agent。

来源:github.com/teamchong/pxpipe/releases/tag/v0.13.2

核心功能

请求级文本转图片

代理按模型配置把大段系统提示、工具文档和旧历史重新排版成 PNG,并附带受限 factsheet。最新对话、开放中的工具调用和不适合图像化的请求可以保持原样。

来源:github.com/teamchong/pxpipe
代理、warp 和离线 export

最短路径是 npx pxpipe-proxy,再把 ANTHROPIC_BASE_URL 指向 127.0.0.1:47821。pxpipe warp 可通过 CONNECT 代理启动 claude、cursor-agent 或 codex;export 则只生成 PNG、factsheet、manifest 和 prompt 文件,不启动代理。

来源:github.com/teamchong/pxpipe
事件日志与节省核算

代理把事件写入 ~/.pxpipe/events.jsonl。pxpipe stats 会汇总压缩比、延迟、缓存命中和基于实际 probe 行的 token 差值;没有测量到的请求不会按零计入。

来源:github.com/teamchong/pxpipe
按模型启用和盈利门槛

项目为不同模型设置渲染尺寸、保留历史和图片上限,并用盈利判断让稀疏文本继续走原文。默认模型范围和 opt-in 模型会变化,部署前应查看当前 README。

来源:github.com/teamchong/pxpipe

技术架构

pxpipe 位于客户端与模型 API 之间,接收 Anthropic Messages、OpenAI Responses/Chat Completions 或 Google generateContent 请求。转换器识别可压缩的大块文本,按模型 profile 排版为 PNG,并保留最近对话、工具调用边界和必要的精确信息;随后用原生协议转发。库接口也可直接调用 renderTextToImages 和 transformAnthropicMessages。

来源:github.com/teamchong/pxpipe

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) npx 或全局安装的 pxpipe-proxynpx 或全局安装… 支持图片输入的目标模型支持图片输入的目… 本地端口 47821 或 pxpipe warp 路由本地端口 47821… 请求级文本转图片 代理、warp 和离线 export代理、warp 和离线 ex… 事件日志与节省核算 按模型启用和盈利门槛 pxpipe 项目本体 核心功能 关键依赖

技术栈

语言TypeScript框架Node.js/纯 JavaScript 运行时、代理路由、Cloudflare Workers 兼容库接口
npx 或全局安装的 pxpipe-proxy支持图片输入的目标模型本地端口 47821 或 pxpipe warp 路由
本地代理、Docker 或库调用;事件默认记录到 ~/.pxpipe/events.jsonl
来源:github.com/teamchong/pxpipe

快速上手

先运行 npx pxpipe-proxy,浏览器打开 http://127.0.0.1:47821/ 查看仪表;另一个终端执行 ANTHROPIC_BASE_URL=http://127.0.0.1:47821 claude。先用非敏感仓库跑短会话,确认 dashboard 中哪些块被转换,再用 pxpipe stats --json 读取测量记录。需要保持第一方连接行为时,再按官方说明评估 pxpipe warp。
来源:github.com/teamchong/pxpipe

使用场景

适合系统提示、工具说明和旧历史很长,而且目标模型能稳定读取对应图片 profile 的 Agent 会话。包含哈希、密钥、ID、十六进制、逐字符补丁或大量稀疏自然语言时,应保留文本或关闭转换。

来源:github.com/teamchong/pxpipe

优势与局限

优势

  • 代理、离线导出和库接口覆盖三种接入方式
  • 仪表和事件日志能看到每次转换与实际测量记录
  • 官方公开了质量测试覆盖、失败样例和小样本限制

局限

  • 图像压缩有损,精确字符串可能被模型静默读错
  • 节省取决于模型视觉计费、缓存命中、文本密度和客户端重发方式
  • 本轮未启动代理,也未使用任何模型或 API 复现官方 benchmark
来源:github.com/teamchong/pxpipe

最新版本

截至 2026-09-23,最新正式 release 是 v0.13.2,发布于 2026-08-21。该版增加 Gemini 3.7 Flash 与 Grok 4.6 相关支持和评估,修复文本截断,调整渲染缓存键,并加入显式 provider router 核心。

来源:github.com/teamchong/pxpipe/releases/tag/v0.13.2

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 只核对官方 README、CHANGELOG 和 GitHub Releases  |  limitations: 未安装 npm 包,未启动代理,未转发任何请求,未验证 token 节省、模型质量、TLS 路由、日志内容或数据边界  |  observed_output: 确认快速启动端口为 127.0.0.1:47821,支持 proxy、warp、export 和 stats;官方明确披露精确十六进制测试会出现静默误读;最新 release 为 v0.13.2

来源:github.com/teamchong/pxpipe/releases/tag/v0.13.2

同类项目对比

pxpipe 与 Microsoft LLMLingua 都压缩长提示,但方法不同。LLMLingua 用小语言模型识别并删除非必要 token,输出仍是文本;pxpipe 把大块上下文变成图片,由目标模型的视觉能力读取。前者要准备压缩模型,后者依赖目标模型的 OCR/视觉表现和图片计费。包含精确字符串时,两者都需要单独验证。

来源:github.com/microsoft/LLMLingua

总结评价

pxpipe 适合上下文很密、能容忍图像读取误差并愿意看日志做 A/B 测试的用户。上线前先用自己的请求比较 token、费用和答案正确率;涉及哈希、ID、密钥和补丁内容时,把精确字段留在文本里。

来源:github.com/teamchong/pxpipe

常见问题

pxpipe 会压缩模型输出吗?

不会。官方 README 说明它只改写发往模型的输入请求,响应仍按原协议流式返回。

哈希、密钥和精确 ID 能放心放进图片吗?

不能。官方测试记录过密集十六进制内容的静默误读。这类值应保留为文本,并用原始工具输出复核。

README 中的节省比例可以直接套到我的账单吗?

不可以。结果会随模型价格、缓存、文本密度、客户端重发方式和会话长度改变。应读取自己的事件日志。

一定要把 Claude Code 的 ANTHROPIC_BASE_URL 改成本地代理吗?

基础代理路径需要这样做。若要保留第一方连接行为,可按官方文档评估 warp;也可以只用 export 离线生成图片。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件