版本历史

`GET /api/changelog?limit=&offset=` 返回分页对象（`entries`、`total`、`hasMore`、`years`、全局 `latestWeb` / `latestApi`）；支持 `scope`（web/api）与 `kind` 筛选；无查询参数时仍返回完整数组，兼容 Agent 等旧客户端。

版本历史页首屏仅 SSR 最近 8 条发布记录，其余通过「加载更多」按需拉取；筛选切换时从 offset=0 重新请求，避免只过滤已加载片段。

页面布局与交互重构：用户向 Hero 文案、2×2 统计卡片、横向滑动筛选 Chips（更大触控目标）、时间轴移动端年份标题；发布卡片抽至 `changelog-release-card.tsx`。

年份快捷跳转：目标年份未加载时自动连续分页直至可滚动定位；锚点 `scroll-margin` 与桌面侧栏年份 sticky 使用 `--changelog-sticky-offset` 避让吸顶区。

筛选栏吸顶：新增 `.sticky-below-site-nav`，`top` 与 `--nav-pad-top` 同步（随导航折叠动画），`z-index` 低于悬浮 Dock；筛选与年份跳转合并为同一吸顶块，修复移动端被导航遮挡与吸顶留白问题。

Release info（共通）：前端版本升级至 0.1.7；后端版本升级至 0.0.10，并在版本历史中同步记录。Breaking changes：无（分页为可选查询参数）。

窄屏（`< md`）下 `/blog/graph` 使用移动端专属交互：`useMobileViewport` 切换 `PostsGraph` 布局；点选节点打开底部详情 Sheet（系列 / 阅读时长 / 标签 /「阅读全文」），不再依赖 hover 浮卡；系列筛选收入底部 Sheet 多选列表。

移动端画布：`min(72dvh, 560px)` 可视高度、加大节点透明点击区、底部缩放工具条（44px 触控目标）；`useGraphPinchZoom` 双指捏合缩放；节点不进入力导向拖拽，避免与单指平移冲突。

底部 Sheet 打开时 `useBodyScrollLock`（`position: fixed` + 恢复 scrollY）锁定页面滚动；列表区 `useSheetScrollContain` 在顶/底边界拦截 touch 滚动链，修复系列筛选向上滑动时背后页面跟着滚的穿透问题。

抽取 `posts-graph-viewbox.ts` 共享 viewBox / 缩放常量；`posts-graph-mobile.tsx` 承载移动端 UI 与捏合逻辑；图谱页窄屏文案与页头间距适配。

Release info（共通）：前端版本升级至 0.1.6；API 版本保持 0.0.9（无后端发版）。Breaking changes：无。

`/blog/graph`：图谱数据变更时用稳定 `key` remount `<PostsGraph>`，缩放与平移回到默认，避免在数据 effect 内同步改写 viewBox。

力导向画布交互对齐常见白板：空白 / 中键 / 空格+左键拖动画布；触控板双指平移；Ctrl/Meta+滚轮与捏合缩放；Shift+滚轮将纵向滚动转为横向平移；悬浮工具栏与键盘 `+`/`−`/`0`/方向键缩放与复位。

系列筛选支持多选；顶栏胶囊在宽度不足时出现「更多」下拉（`ResizeObserver` 动态测算可容纳数量）。

悬停卡片可捕获指针以点击「阅读全文」；短延迟收起降低误触；Esc 关闭卡片；输入框 / 工具栏 / tooltip 内不误触画布快捷键。

`PostsGraph`：力学迭代封装在 `GraphSimulation`，渲染侧以 snapshot 浅拷贝同步坐标，兼容 React 19 不变性约束。

Release info（共通）：前端版本升级至 0.1.5；API 版本保持 0.0.9（无后端发版）。Breaking changes：无。

窄屏（视口宽度小于 Tailwind `md`，与 `max-width: 767px` 一致）下 Dock 固定为顶栏：`SiteHeader` 与 `applyDockVars` 使用 `effectiveNavDockState`，`public/theme-init.js` 首屏写入的 `--nav-pad-*` / `data-nav-dock` 与之对齐；隐藏抓手与「悬浮位置」菜单；折叠态仅支持点击展开。订阅 `matchMedia` 在横竖屏与窗口缩放时重新应用边距变量。

横栏布局在 `md` 以下内联主导航收入汉堡时，Logo 与工具区之间不再出现两道紧贴的竖向分隔线。

拖拽起手用 `getBoundingClientRect` 计算 Dock 几何中心相对指针的偏移，拖动过程中以中心跟手，避免按下瞬间整条栏跳到指针正下方。

拖拽路径补充 `setPointerCapture` 与抓手/折叠球的 `touch-action: none`，减轻触摸环境下页面滚动与指针丢失导致的拖动中断。

Release info（共通）：前端版本升级至 0.1.4；API 版本保持 0.0.9（无后端发版）。Breaking changes：无。

`public/theme-init.js`（beforeInteractive）在 hydration 前读取 `site-nav-dock-v1`，同步写入 `--nav-pad-*`、`data-nav-dock` 与折叠标记，正文边距与根节点状态首屏即与记忆位置一致。

悬浮导航条在读完 localStorage 并完成 store 同步前保持不可见（`visibility`/`opacity`/`pointer-events`），再在记忆边缘位置显示，避免先出现在默认顶栏再跳动；`layout` 内 `noscript` 样式在无 JS 时强制显示 `[data-site-header]`。

首帧布局对齐后通过 `queueMicrotask`/`requestAnimationFrame` 再开启显隐与位置相关过渡，避免从默认位动画滑向记忆位的不自然感。

在位置设置菜单中选择顶/底/左/右后自动关闭下拉菜单，减少一次手动点击。

更新 `globals.css` 与根布局注释，说明 `--nav-pad-*` 可由首屏脚本与 `SiteHeader` 共同写入。

Release info（共通）：前端版本升级至 0.1.3；API 版本保持 0.0.9（无后端发版）。Breaking changes：无。

文章检索增强：SQLite FTS5 与基于重叠度的 RRF 融合排序；新增 `GET /api/posts/search` 与 Agent 工具 `semantic_search_posts` 对接。

阅读与发现 API：新增 `POST /api/posts/relevant`、`GET /api/posts/:slug/related`、`GET /api/posts/daily-pick` 与 `GET /api/posts/graph`（节点/边供知识图谱页消费）。

Agent RAG：`find_relevant_passages` 扩大候选并取 Top 10；系统提示引导模型先评估相关性再引用，减少误引与幻觉。

博客阅读体验：文章页「相关阅读」与「每日精选」；文末集成 Giscus（GitHub Discussions）评论；主题切换启用 View Transitions。

站内 AI：首页 Hero 可发起对话、文章页 Post Companion；命令面板未命中时转入 Agent；向导工具与后端新检索/相关接口对齐。

PWA：`manifest`、Service Worker 离线缓存（HTML / 静态资源 / 近期文章）与注册组件。

社交分享：`app/blog/[slug]/opengraph-image` 在构建期生成品牌化 OG 图；站点级默认 OG 图补充。

新增 `/blog/graph`：力导向 SVG 可视化文章关联网络。

Release info（共通）：前端版本升级至 0.1.2；后端版本升级至 0.0.9，并在版本历史中同步记录。

首页强化站内 AI 向导露出：探索区新增「AI 向导」Bento 卡、Hero 区主操作与 ⌘I 快捷键提示；底部行动区补充「打开 AI 向导」入口。

SEO：`sitemap.xml` 增加静态路由 `/agent`；页脚导航新增「AI 向导」，并在宽屏说明文案中补充 ⌘I 与 `/agent` 直达链接。

SQLite 种子文章扩充：新增「Java 从基础到精通（初级 · 高级 · 专家路线）」系列多篇示例正文（路线图与基础/进阶/精通各篇），便于本地与 CI 构建拉取完整教程演示数据。

Release info（共通）：前端版本升级至 0.1.1；后端版本升级至 0.0.8，并在版本历史中同步记录。

新增站内 AI 向导（Agent）页面 `/agent`：支持启动/切换会话、展示事件流（模型输出/工具步骤）、以及更贴近“可观测”的交互面板体验。

新增 Agent 组件与运行时：`use-agent` 状态机、消息/工具步骤渲染、快捷操作与启动器组件，便于在站点内快速调用与复用。

新增 Agent Sessions 模块：提供会话管理与持久化（SQLite），支持创建/查询会话，为前端多会话切换与追踪奠定基础。

新增 Agent Memory 模块：提供记忆写入/读取接口与数据库实体，支持把关键上下文沉淀为长期信息以改善后续对话质量。

Release info（共通）：前端版本升级至 0.1.0；后端版本升级至 0.0.7，并在版本历史中同步记录本次 Agent 能力上线。