性能优化: 首页笔记本列表单次API获取 (Vibe Kanban)

[smallnest]

概述

优化首页笔记本列表加载性能，将 API 请求从 1 + 2N 个减少到 1 个（N 为笔记本数量）。

问题背景

原有实现中，首页加载笔记本列表时：

• 首先调用 GET /api/notebooks 获取所有笔记本
• 然后为每个笔记本卡片调用 loadNotebookCardCounts 方法
• 该方法对每个笔记本发起 2 个额外的 API 请求（sources 和 notes 统计）

这导致如果有 10 个笔记本，首页加载需要 21 个 API 请求，严重影响加载性能。

实施的改动

后端

1. 新增类型定义 (backend/types.go:46-56)

   • 添加 NotebookWithStats 结构体，包含 source_count 和 note_count 字段

2. 新增数据库方法 (backend/store.go:250-290)

   • 添加 ListNotebooksWithStats 方法
   • 使用单个 SQL 查询配合子查询，一次性获取所有笔记本及其统计信息

3. 新增 API 端点 (backend/server.go:109, 212-220)

   • 添加 GET /api/notebooks/stats 路由
   • 实现 handleListNotebooksWithStats 处理函数

前端

1. 修改数据获取 (backend/frontend/static/app.js:382)

   • loadNotebooks 方法改为调用 /notebooks/stats API

2. 优化渲染逻辑 (backend/frontend/static/app.js:428-430)

   • renderNotebookCards 直接使用 API 返回的统计信息
   • 移除了对 loadNotebookCardCounts 的异步调用

3. 删除冗余代码

   • 移除 loadNotebookCardCounts 方法（不再需要）

性能提升

笔记本数量	优化前请求数	优化后请求数	改善
1	3	1	67%
10	21	1	95%
50	101	1	99%

实现细节

• 使用 SQL 子查询 (SELECT COUNT(*)...) 在单次查询中计算统计信息
• 保留了原有的 /notebooks 端点以确保向后兼容
• 前端缓存逻辑保持不变，继续使用 5 分钟 TTL

---

This PR was written using Vibe Kanban