v0.3.0-rc.2

What's Changed

Full Changelog: v0.3.0-rc.1...v0.3.0-rc.2

🚀 Features

• feat: add feed card presentation settings (#467) (b37e560)
• feat: add customizable header layouts (#465) (59ec12c)
• feat(ai-summary): support forced compat backfill (46b9d77)

🐛 Bug Fixes

• fix: resolve blurhash image loading race (#466) (54bc2c0)
• fix: hide uv pv stats when disabled (#461) (c3289c3)
• fix(doc): add Webhook link to navigation (#462) (d9b04c8)
• fix: encode webhook GET template params (#458) (63693f8)
• fix(deploy): sync worker secrets for previews (4bbb2b3)
• fix(webhook): preserve webhook template strings (c83a091)
• fix(feed-card): fill image container after load (029e2fa)
• fix(editor): hide preview in edit mode (e5d14d3)
• fix(ui): space compat task actions and route favicon (51c48b6)
• fix(test): align ai summary compat response type (24cfb9c)
• fix(blurhash): keep image metadata in feed avatars (c007e27)
• fix(favicon): serve favicon.ico route (683c9a3)
• fix(deploy): validate artifact deploy script hash (01e4484)
• fix(favicon): reuse auth and fallback to site avatar (d8dfa54)

📚 Documentation

• docs: expand rc2 changelog (1215599)
• docs: add bilingual rc2 changelog (9c26850)
• docs: remove workers route setup for rss (#464) (1cdbd90)

📝 Other Changes

• chore(release): v0.3.0-rc.2 (b4497b2)

---

📋 Detailed Changelog

Overview

This prerelease expands rc1 with a second round of UI and operability improvements centered on site customization, content maintenance, and deployment reliability. The largest user-facing changes are the new customizable header layouts, feed card presentation settings, and a tighter configuration experience around theme color, favicon, webhook handling, and compatibility backfill tasks.

Added

• Customizable header layouts: Added multiple header layout options with live previews, including a more compact text-first header variant.
• Feed presentation settings: Added configurable feed card styles and feed layout options in settings.
• Editorial card variant: Added a new editorial-style feed card variant with stronger visual hierarchy.
• Shared preview shell: Added a shared settings preview card used by header layout and feed card style previews.
• Theme color controls: Added configurable theme color options and runtime theme color application for the client.
• Forced AI compat backfill: Added support for running compatibility backfill tasks even when AI summary state was already initialized.
• Webhook documentation: Added dedicated English and Chinese webhook guides to the docs.

Changed

• Feed browsing experience: Feed, search, and hashtag pages can now render cards in either a standard list or a two-column masonry layout.
• Settings personalization UI: Reworked the personalization section to cover header layout, theme color, feed card style, and feed layout with shared preview chrome and cleaner option grouping.
• Header architecture: Split the old monolithic header into layout definitions, preview primitives, and reusable primitives so layout changes are easier to extend.
• Favicon handling: Site favicon behavior now prefers the configured favicon route and can fall back to the site avatar more gracefully.
• Visibility of traffic stats: PV/UV display now correctly follows the counter setting and stays hidden when statistics are disabled.

Fixed

• Blurhash and image metadata: Fixed blurhash loading races, preserved image metadata in feed avatars, and ensured feed card images fill their container correctly after load.
• Card rendering polish: Fixed feed card image clipping, preview overflow, compact header preview sizing, and summary length behavior in denser layouts.
• Webhook template handling: Fixed URL encoding for webhook GET template parameters while preserving template strings through configuration save/load flows.
• Deployment workflow reliability: Fixed preview deployments to sync worker secrets correctly and tightened build/release validation around deploy artifacts.
• Compatibility task flow: Fixed AI summary compatibility task response typing and improved compat task action spacing in the UI.
• Editor and route edge cases: Fixed markdown editor preview visibility in edit mode and ensured /favicon.ico is served correctly.

中文版

概览

这个预发布版本在 rc1 的基础上继续推进 UI 与可运维性改进，重点放在站点个性化、内容维护，以及部署可靠性上。最显著的用户侧变化包括可配置的 Header 布局、文章卡片展示设置，以及围绕主题色、网站图标、Webhook 处理和兼容性补齐任务的整体体验打磨。

新增

• 可配置 Header 布局：新增多种 Header 布局选项和实时预览，包括更紧凑的纯文本风格布局。
• 文章列表展示设置：在设置页中新增文章卡片样式和列表布局选项。
• Editorial 卡片样式：新增一个更强调视觉层级的文章卡片主题。
• 共享预览外壳：新增一套共享的设置预览卡组件，用于统一 Header 布局和文章卡片样式预览。
• 主题色控制：新增客户端主题色选项，并支持运行时应用站点主题色。
• 强制兼容性补齐：新增 AI 兼容性任务的强制补齐能力，即使摘要状态已经初始化也可以重新执行。
• Webhook 文档：补充了中英文的专用 Webhook 使用文档。

变更

• 文章浏览体验：文章列表、搜索结果页和标签页现在可以在单列列表与双列瀑布流之间切换。
• 设置页个性化 UI：重构了个性化设置区，统一管理 Header 布局、主题色、文章卡片样式和列表布局，并通过共享预览外壳保持视觉一致。
• Header 架构：将原本较为集中的 Header 实现拆分为布局定义、预览基础组件和可复用 primitive，使后续布局扩展更容易维护。
• 网站图标处理：网站 favicon 的处理流程现在更明确地优先走配置路由，并能更自然地回退到站点头像。
• 访问量显示逻辑：PV/UV 显示现在会正确跟随统计开关，在禁用统计时不再继续展示。

修复

• Blurhash 与图片元数据：修复了 blurhash 加载竞态，保留了 feed 头像中的图片元数据，并确保文章卡片图片在加载完成后正确填满容器。
• 卡片渲染细节：修复了文章卡片图片裁切、预览区域 overflow、极简 Header 预览尺寸，以及高密度布局下摘要长度控制等问题。
• Webhook 模板处理：修复了 Webhook GET 请求模板参数的 URL 编码问题，同时保证模板字符串在配置读写流程中不被破坏。
• 部署流程稳定性：修复了 preview 部署时的 Worker Secret 同步问题，并加强了构建产物部署脚本的校验。
• 兼容性任务流程：修复了 AI 兼容性任务响应类型问题，并优化了兼容性任务操作区的间距表现。
• 编辑器与路由边缘情况：修复了编辑模式下 markdown 预览显示问题，并确保 /favicon.ico 路由可正常访问。

---

📦 Build Artifact

This release includes the attached file build-v0.3.0-rc.2-cloudflare.tar.gz.
Use the release asset URL as artifact_url when triggering deploy.yml manually.

---

🆙 Upgrade Guide

For users who have forked this repository:

1. Go to your forked repository on GitHub
2. Click "Sync fork" to get the latest changes
3. Review the CHANGELOG.md for migration steps
4. Update your environment variables if needed
5. The deployment will run automatically