PrismCat: vanhemmat versiot ja versiohistoria

What's Changed
- feat(logging): add request path filters and ignored path audit by @oneisall8955 in https://github.com/paopaoandlingyia/PrismCat/pull/8
- fix: trim and validate upstream target URLs by @syfantasy in https://github.com/paopaoandlingyia/PrismCat/pull/10
New Contributors
- @oneisall8955 made their first contribution in https://github.com/paopaoandlingyia/PrismCat/pull/8
- @syfantasy made their first contribution in https://github.com/paopaoandlingyia/PrismCat/pull/10
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.14.0...v1.15.0

PrismCat v1.14.0
中文
PrismCat v1.14.0 带来了一次完整的前端视觉重构，同时加入可切换的上游目标预设，并修复了配置、存储和国际化方面的问题。
主要变化
- 全面重构 Web UI：采用新的语义化设计 token、左侧导航、页面标题和更清晰的层级关系，统一圆角、边框、间距、状态标签、工具提示与焦点样式。
- 改善日志和 Trace 体验：重组日志详情抽屉、优化日志表格选中态、调整 Trace 空状态和详情头部，并让复制操作和 URL 展示更加克制。
- 新增上游目标预设：同一个稳定入口可以配置多个完整目标，在 UI 中切换 URL、超时、出站代理、请求覆盖和 Usage 绑定。切换只影响新请求，进行中的请求继续使用启动时的目标快照。
- 保持配置兼容：原有单目标 upstreams.<name>.target 配置无需迁移，也可以继续使用。
- 提升可靠性：配置文件改用原子写入；避免空引用集合触发 Blob 误清理；修复空日志表统计返回 NULL 导致的扫描失败。
- 改善国际化与可访问性：移除中文兜底文本，补齐英文翻译，并统一焦点指示和最小文字尺寸。
- 更新项目文档、截图和演示数据库生成工具。
升级注意事项
- 新安装的默认监听端口从 8080 改为 8711。
- Docker 镜像的默认暴露端口和健康检查地址也改为 8711。
- 已有配置文件中明确设置的 server.port 不会被覆盖；如果反向代理、健康检查或启动脚本写死了 8080，请同步调整。
English
PrismCat v1.14.0 delivers a full visual refresh of the web UI, adds switchable upstream target presets, and improves configuration, storage, and localization reliability.
Highlights
- Reworked the Web UI with semantic design tokens, a left sidebar, clearer page headers and hierarchy, and consistent radii, borders, spacing, status labels, tooltips, and focus states.
- Improved the log and trace experience: reorganized the log detail drawer, refined table selection states, updated trace empty states and detail headers, and made copy actions and URL presentation more focused.
- Added switchable upstream target presets: one stable route can expose multiple complete targets that can be switched from the UI, including URL, timeouts, outbound proxy, request-override bindings, and usage-extraction bindings. Switching affects new requests only; in-flight requests keep their start-time snapshot.
- Preserved configuration compatibility: the existing single-target upstreams.<name>.target format still works without migration.
- Improved reliability: configuration files are now written atomically; Blob garbage collection no longer clears storage on an empty reference set; and statistics no longer fail to scan NULL from an empty log table.
- Improved localization and accessibility: removed Chinese fallback text, completed English translations, and standardized focus indicators and minimum text sizing.
- Updated documentation, screenshots, and the demo database seeding tool.
Upgrade notes
- The default listen port for new installations changes from 8080 to 8711.
- The Docker image's exposed port and health check URL also change to 8711.
- An explicitly configured server.port in an existing configuration file is not overwritten. Update reverse proxies, health checks, or startup scripts that hard-code 8080.
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.13.0...v1.14.0

中文
- 新增 WebSocket Upgrade 代理支持。
- 重构请求覆盖规则编辑界面，完善规则名称、匹配条件、请求体与请求头编辑。
- 新增请求覆盖中英文文档及仓库级 Agent Skill。
- 示例规则改为安全追加，Usage 默认规则不再覆盖已有配置。
- 修复 exists: false 无法匹配缺失字段的问题。
- 修复敏感请求头覆盖值写入日志的问题。
- 改进上游高级设置、剪贴板兼容性及 Gemini 思考内容展示。
English
- Added WebSocket upgrade proxy support.
- Redesigned request override editing for names, match conditions, body operations, and headers.
- Added bilingual request override documentation and a repository-level Agent Skill.
- Made example insertion non-destructive and preserved existing Usage rules.
- Fixed exists: false matching for missing JSON fields.
- Prevented sensitive header override values from leaking into logs.
- Improved upstream advanced settings, clipboard compatibility, and Gemini thought rendering.

新增
- 新增上游分阶段超时策略：
- 响应头超时
- 响应体首字节超时
- 响应体空闲超时
- 阶段超时不会延长总超时，响应体空闲计时会在每次收到数据后重置。
- 超时策略同时适用于流式与普通响应。
改进
- 重整上游编辑界面，将低频配置集中到高级设置。
- 简化出站代理控件，自定义代理地址可直接在选择框中编辑。
- 将请求日志开关移入高级设置，降低默认界面的认知负担。
- 优化中英文说明与示例配置。
稳定性
- 完善空响应、HEAD、204/304、正常 EOF 及流式分段响应的处理。
- 增加响应头、首字节和响应体空闲超时的覆盖测试。
Added
- Added upstream staged timeout policies:
- Response header timeout
- Response body first-byte timeout
- Response body idle timeout
- Staged timeouts do not extend the total timeout; the response body idle timer resets each time data is received.
- Timeout policies apply to both streaming and normal responses.
Improved
- Reorganized the upstream editing interface, consolidating low-frequency configurations into advanced settings.
- Simplified the outbound proxy control; custom proxy addresses can now be edited directly in the selection box.
- Moved the request log toggle into advanced settings to reduce cognitive load in the default interface.
- Refined Chinese and English descriptions and example configurations.
Stability
- Improved handling of empty responses, HEAD, 204/304, normal EOF, and streaming chunked responses.
- Added coverage tests for response header, first-byte, and response body idle timeouts.
What's Changed
- feat(proxy): 增加响应头与流式首字节超时 by @Jieken in https://github.com/paopaoandlingyia/PrismCat/pull/6
New Contributors
- @Jieken made their first contribution in https://github.com/paopaoandlingyia/PrismCat/pull/6
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.11.1...v1.12.0

New Features
- Added JSONL export for logs matching the current filters.
- Exported records can include complete request and response bodies.
- Improved storage queries and streaming behavior for large log exports to reduce memory usage.
Log Body Search
- Replaced repeated JSON subtree scans with a single-pass search plan.
- Limited rendered highlights to 500 matches, displaying 500+ when the limit is exceeded.
- JSON search now renders only paths leading to matching values.
- Large text bodies display contextual match snippets.
- Collapsed Base64 payloads no longer produce non-navigable “ghost matches.”
- Fixed highlight offsets for Unicode characters whose lowercase representation changes length.
- Searching no longer overwrites manually selected JSON expansion states.
- The unsupported search control is now hidden in Diff view.
- Deferred search computation improves responsiveness for large bodies.
UI Improvements
- Improved the Dashboard’s visual hierarchy and information layout.
- Redesigned Settings pages with a consistent card-based layout.
- Added a sticky save bar for easier configuration updates on long pages.
- Unified global content width and improved Playground alignment.
Compatibility
- No known breaking configuration changes.
- Direct upgrades from v1.10.0 are supported.

Added
- Add per-upstream logging controls for pass-through-only reverse proxy usage.
- Support Base64URL/Fernet-style long payload folding in request and response bodies.
Fixed
- Avoid marking client-canceled streaming responses as proxy errors.
- Filter upstream CORS response headers so PrismCat keeps CORS policy control.
- Preserve original request body details when request override fails.

中文
v1.9.0 引入了基于存储空间上限的自动清理机制、日志快捷导航，以及 Web 界面 JSON 浏览器的多项显示和渲染优化。
- 新增日志存储空间上限限制：支持通过 max_storage_bytes 配置或环境变量 PRISMCAT_MAX_STORAGE_BYTES 限制最大存储。超出时将按时间限制顺序删除未保存的历史日志，并自动触发 WAL checkpoint 和 VACUUM 整理数据库物理空间。可在设置页面直观配置。
- 新增日志快捷导航：在日志详情视图（Dashboard 和 Trace 详情）中增加“上一条 / 下一条”切换按钮，方便了连续排查日志的操作。
- 优化 JSON 浏览器显示与渲染：
- 将 JSON 视图字体大小调整为 13px，修复 Windows ClearType 下 11px 中文字体模糊的视觉问题。
- 去除强行指定的 -webkit-font-smoothing，使 Windows 系统能够保留边缘清晰的 ClearType 渲染。
- 在字体栈中显式增加了 PingFang SC 和 Microsoft YaHei 中文字体。
- 本地化托管 Inter 和 Fira Code 字体，摆脱 Google CDN 字体加载依赖。
- 为 JSON 缩进层级添加垂直辅助线，提升复杂结构下的可读性。
- 修复 SQLite 日志清理锁表问题：日志保留期（Retention）清理逻辑调整为每批次限制删除 2000 条，并在清理后自动进行 WAL checkpoint，避免单次删除海量日志导致 SQLite 长时间锁表。
- 修复流式日志 (SSE) 的 Token 提取解析：处理流式事件时，Token 提取器由原先的“仅保留最后一次匹配”改为“增量合并”方式，避免旧事件的数据被完全覆盖。
- 修复默认超时初始化：统一规范在配置及 UI 修改中的 Upstream 缺省超时时间为 120 秒。
English
v1.9.0 introduces size-based log storage limit cleanup, quick log navigation, and multiple display and font rendering enhancements to the JSON viewer in the Web UI.
- Added log storage size limit: Allows setting a storage limit via max_storage_bytes config or PRISMCAT_MAX_STORAGE_BYTES env var. When exceeded, oldest unsaved logs are deleted, followed by WAL checkpoint and database VACUUM to reclaim physical disk space. Can be easily configured on the settings page.
- Added log navigation: Prev/Next buttons added in log details panel on both Dashboard and Trace Detail pages for seamless traversal of consecutive log records.
- Improved JSON viewer display & rendering:
- Bumped JSON viewer font size to 13px to fix blurry CJK text rendering at 11px under Windows.
- Dropped forced -webkit-font-smoothing so Windows keeps crisp ClearType rendering.
- Added explicit CJK fonts (PingFang SC / Microsoft YaHei) to font stacks.
- Self-hosted Inter & Fira Code fonts via @fontsource, removing Google CDN dependency.
- Added bordered vertical lines for JSON indentation guidelines to enhance readability.
- Fixed SQLite retention cleanup locking: The log retention background worker now deletes logs in batches of 2000 and triggers WAL checkpoint, preventing long-running write transactions from locking the database.
- Fixed SSE token usage parsing: SSE parser now correctly merges input/output token counts from sequential events rather than overwriting them.
- Standardized default upstream timeout: Unified upstream proxy default timeout to 120s across config loader and UI creation.
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.8.0...v1.9.0

v1.8.0 rebuilds the request override system with a more intuitive declarative approach, replacing JSON Patch with gjson/sjson-backed operations, and adds request header override support.
- Breaking: Body override switched from JSON Patch to declarative ops — set, remove, default, append, prepend — using dot-notation paths (e.g. metadata.user_id)
- Added request header override (set / remove) with a visual editor on the settings page
- Override rules now show runtime status (active / blocked / unbound) in the UI, making it easy to see why a rule isn't firing
- Optimized log matching and cloning logic
- Updated README to reflect Trace correlation, Usage tracking, cURL copy, and corrected outdated JSON Patch references
⚠️ If you used Request Override (body patching) in v1.7.0, you will need to reconfigure your rules after upgrading — the old JSON Patch format is no longer supported.
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.7.0...v1.8.0

v1.7.0 brings major improvements to observability and usage tracking in PrismCat, adding Trace correlation with dedicated pages, a Usage extraction rule library, Body keyword search, and a smarter storage strategy for large bodies.
- Added Trace correlation along with Traces / Trace Detail pages for reviewing multiple logs across a full call chain
- Added Usage / token extraction with per-upstream binding rules, managed via a rule library on the settings page
- Expanded built-in Usage templates to OpenAI compatible, OpenAI Responses, Anthropic, and Gemini, covering Responses API, Codex, and other newer workflows
- Added keyword search to the request / response Body viewer
- Improved storage and display of large Bodies, keeping a readable preview in the database while storing full content separately
- Wired Usage extraction results into log detail and summary views
- Continued refinement of text rendering and readability on the log detail page
- Improved handling of formatted Bodies and separately-stored Bodies
- Updated the manual binary release workflow default tag to v1.7.0
- Note: this version changes the Body log storage format. Large-Body logs produced by older versions may fail to load their detached full content after upgrading — please back up or export important historical logs beforehand
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.6.0...v1.7.0

v1.6.0 makes PrismCat better for long-running local, server, and Docker deployments with console authentication, log annotations, resource/storage visibility, and in-app update checks.
- Added console login and first-time password setup to protect logs, settings, and debugging tools
- Improved UI/API/proxy routing for server and Docker deployment scenarios
- Added log annotations, including saved state, review status, notes, and labels
- Improved large log content loading for request and response bodies
- Refined the log detail layout and interaction flow
- Improved the replay Playground for debugging requests from historical logs
- Added a resource usage panel showing process CPU, memory, uptime, and system memory
- Added manual storage usage calculation for database files, Blob files, and total storage size
- Added in-app update checks with links to the latest release and matching platform asset
- Release binary assets now include the version in their filename, e.g. prismcat-v1.6.0-linux-amd64
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.5.0...v1.6.0

v1.5.0 improves PrismCat's debugging workflow with request overrides, per-upstream outbound proxy settings, and cURL export from log details.
- Added request overrides with per-upstream JSON Patch bindings, including original/final request views and diff inspection
- Added per-upstream outbound proxy settings, supporting environment proxies, direct connections, and custom proxy URLs
- Added Copy as cURL in log details so recorded requests can be shared or replayed easily
- Refined the log detail experience with persisted expansion state, better request body placement, and polished toolbar actions
- Improved stream merging by preserving reasoning_content in OpenAI chunks
- Improved logging support for image generation and other large-content requests
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.4.0...v1.5.0

v1.4.0 adds live updates for in-flight requests and moves body formatting work out of the proxy hot path to reduce request-time overhead.
- Added live log detail updates so in-flight requests can now show status, response headers, and response body changes directly in the UI
- Refined the logging pipeline by moving request/response body formatting out of the proxy hot path, reducing extra overhead on normal requests
- Disabled Early Request Body Snapshot by default, since live viewing now covers most early-inspection scenarios while keeping the option available when needed
- Polished the log detail experience, including toolbar actions, UI flow, and live-state presentation
Full Changelog: https://github.com/paopaoandlingyia/PrismCat/compare/v1.3.1...v1.4.0

v1.3.1 is a small patch release focused on compatibility and polish. It improves the merged view for Gemini streaming responses and includes a couple of storage-related fixes.
- Added Gemini streaming merge support so the Merged view now reconstructs candidates / parts / text correctly
- Kept the Raw view unchanged, preserving the original upstream payload for debugging
- Unified log time filtering on UTC unix timestamps to reduce timezone-related inconsistencies
- Improved legacy database migration compatibility for timestamp index upgrades

v1.3.0 brings a more polished UI, a faster log-detail experience, and a more consistent debugging workflow.
- Fixed a legacy global CSS reset that was collapsing spacing and hurting the overall visual polish
- Improved log detail performance by parsing large bodies on demand, reducing lag when opening details
- Unified request/response inspection with Pretty / Raw views, plus Merged for streaming responses, while keeping Raw as the source of truth
- Upgraded Playground with the same response views and automatic gzip / deflate / br decoding for easier debugging
- Added frontend code-splitting and snappier drawer motion to improve perceived responsiveness and reduce initial bundle pressure

v1.2.0 brings better stream merging, a JSON viewer fix, and improved mobile usability.
- Improved OpenAI / Claude streaming merge support
- Enhanced SSE parsing and merged-view display
- Fixed JSON viewer hierarchy/layout issues
- Added a mobile-friendly log card view and improved filters/date controls