MeBox/.workbuddy/memory/2026-05-16.md

# 2026-05-16 工作日志

## 站点管理前端页面迁移

### 新增文件
1. **web/src/api/sites.ts** — 站点管理 API 客户端（list/get/create/update/remove/test/types/authTypes），对接后端 8 个端点
2. **web/src/pages/SitesPage.tsx** — 完整站点管理页面（~400 行）
   - 站点卡片网格布局（响应式 1/2/3 列）
   - 添加/编辑弹窗（类型选择、认证方式、Cookie/API Key/Auth Header）
   - 馒头 M-Team 专用配置提示
   - 启用/停用开关、默认站点开关
   - 高级选项折叠面板（Extra JSON）
   - 测试连接（异步+loading 状态）
   - 删除确认
   - 空状态提示
   - 暗色主题风格

### 修改文件
3. **web/src/types/index.ts** — 新增 Site、SiteTypeInfo、AuthTypeInfo 接口
4. **web/src/App.tsx** — 新增 /sites 路由（RequireAdmin）和 lazy import
5. **web/src/components/Layout.tsx** — 侧边栏管理区新增「站点管理」链接（Globe 图标）
6. **web/src/pages/AdminPage.tsx** — 新增「站点管理」Tab，默认激活，嵌入 SitesPage 组件

### API 验证（8/8 通过）
- GET /api/sites ✅
- POST /api/sites ✅（创建成功）
- GET /api/sites/:id ✅
- PUT /api/sites/:id ✅（更新成功）
- DELETE /api/sites/:id ✅（删除成功）
- POST /api/sites/:id/test ✅
- GET /api/sites/types ✅（6 种类型）
- GET /api/sites/auth-types ✅（3 种认证方式）

### 构建状态
- npm run build ✅（SitesPage-hRHsM4G0.js 14.21 kB）
- go build ./cmd/server ✅
- 服务器运行中（localhost:8080）

---

## UI 修复与优化（第二阶段）

### 搜索页 & 收藏页空白问题修复
- **收藏页根因**：后端 `GET /api/favourites` 无数据时返回 `{"items": null}`（非空数组），前端 `playbackAPI.listFavourites()` 提取 null 后 `items.length` 抛出 TypeError → React 白屏
- **修复**：`FavouritesPage.tsx` 增加 `data ?? []` 空值保护、`.catch()` 错误处理、重试按钮、空状态面板
- **搜索页修复**：`SearchPage.tsx` 增加错误处理、空查询不发请求、idle/empty/error 三态 UI

### AdminPage 去重 & API 配置合并
- AdminPage 新增「外部API」Tab，嵌入新组件 `APIConfigsPanel`
- 原「设置」Tab 重命名「系统设置」，功能独立（key-value 存储）
- 侧边栏移除「API 配置」独立链接
- `/api-configs` 路由改为重定向到 `/admin`
- `APIConfigsPanel.tsx`：紧凑表格布局（Provider | 密钥掩码 | 状态徽章 | 操作），点击编辑行内展开

### 修改文件
- 新增：`web/src/components/APIConfigsPanel.tsx`
- 修改：`FavouritesPage.tsx`、`SearchPage.tsx`、`AdminPage.tsx`、`Layout.tsx`、`App.tsx`
- npm run build ✅（AdminPage 25.38 kB 含 APIConfigsPanel）