PrismCat：无感接入API调用流程，获得全量日志

背景

随着大语言模型（LLM）API 的广泛应用，开发者和重度用户经常面临请求被篡改、错误信息难以追踪的问题。例如，客户端可能偷偷注入额外的 system prompt，导致 context_length_exceeded 等错误，而用户却无法直观了解请求在传输过程中发生了怎样的变化。虽然 Postman 或浏览器 Network 面板可以抓包调试，但这些工具并不适合大规模、长期运行的“无感”复盘。许多用户因此陷入“玄学报错”的困境，深夜调试时苦不堪言。

核心内容

PrismCat（棱镜猫）是一个开源的 LLM API 透明代理 / 中转日志工具。它通过将代码中的 API Base 地址从 api.openai.com 改为 PrismCat 的地址，即可无感记录所有请求及响应的细节，并提供一个 Web UI 界面供用户复盘分析。

技术栈：Go 后端 + React 前端 + SQLite 存储，编译为单文件二进制，无需任何外部依赖。

核心功能：

• 极简透明转发：无需修改请求路径，通过子域名自动对应上游（如 openai.localhost:8080 直接对应 OpenAI 接口）。理论上可无感接入任何支持自定义 base_url 的流程，例如客户端 → PrismCat → NewAPI → PrismCat → 最终上游。
• 视觉化日志分析：内置深度优化的 JSON 渲染器，自动检测内嵌图像的 Base64 编码并智能折叠，避免被数万行 Base64 字符串刷屏，使日志查看体验如同电影回放。
• 一键重放 (Playground)：对于失败记录，可在网页端直接修改 Prompt 或参数重新发送，快速定位问题。
• 本地与安全：数据基于本地 SQLite + 文件存储，不经过任何第三方服务器，隐私完全由用户掌控。
• 自动运维：支持配置日志保留天数，过期自动清理，避免硬盘空间膨胀。
• 跨平台部署：Go 原生二进制，高性能、低占用。Windows 桌面版支持系统托盘、静默运行、开机自启；支持 Docker 及云服务器部署，可作为私有透明转发节点。

快速上手：

• 当前已发布 v1.0.0 版本（Windows 尝鲜版 & Docker 同步支持）。
• Windows 用户：下载 Release 压缩包，解压运行 prismcat.exe。
• 管理后台：浏览器访问 localhost:8080（默认端口可配置）。
• 配置上游：在设置界面填入上游 API 地址。
• 无感接入：将调用地址改为 http://openai.localhost:8080/v1（假设上游名称为 openai）。
• 服务器部署：项目自带 docker-compose.yml，通过环境变量 PRISMCAT_UI_PASSWORD 为管理界面加锁，安全部署到公网。

关键要点

• 透明代理：无需修改请求路径，通过子域名自动映射到对应上游，实现最高兼容度。
• 全量日志记录：自动记录所有请求和响应的完整细节，包括可能被隐藏的 system prompt 注入。
• 智能日志渲染：自动折叠 Base64 编码的图像数据，避免日志被大量冗余信息刷屏。
• 一键重放：直接在 Web UI 中修改 Prompt 或参数并重新发送，便于调试错误。
• 本地数据存储：使用 SQLite 和文件存储，不经过第三方服务器，保障隐私安全。
• 自动清理：支持配置日志保留天数，过期自动删除，避免磁盘占用。
• 跨平台支持：单文件二进制，可运行于 Windows（系统托盘）、Docker 或任意云服务器。
• 开源且免费：代码托管在 GitHub，社区可贡献 Star 和 Issue。

意义与影响

PrismCat 填补了市面上针对个人开发者或小团队的轻量级 LLM API 日志工具的空白。现有日志工具多面向企业级场景，部署复杂、依赖重，且缺乏透明代理能力。PrismCat 以“透明代理 + 可视化日志回放 + 长期运行”为核心，极大降低了用户追踪 API 调用问题的门槛。它的出现让开发者能够无感接入已有工作流，实时观察请求的真实变化，从而快速定位客户端注入、上游错误等“玄学”问题。同时，本地优先的设计理念也契合隐私敏感用户的需求。对于 LLM API 生态的参与者而言，PrismCat 提供了一个简单、高效、可自托管的调试与复盘工具，有望成为社区中常用的辅助基础设施。