# Logo 自定义

## 默认 Logo（内置，26.9 需求 ⑤）

| 项 | 默认值 | 用途 |
|---|---|---|
| 页面导航 Logo | 前端打包本地资源 `/assets/logo-*.svg`（源：`web/src/assets/brand/logo.svg`） | 导航栏 `<img>`；`config.logo_url` 为空时回落使用 |
| favicon / 备用 Logo | 前端打包本地资源 `/assets/favicon-*.png`（源：`web/src/assets/brand/favicon.png`） | `index.html` `<link rel="icon">` + 动态 favicon 回落 |

26.9 起默认不再引用远程 URL：`GET /api/v1/config` 中 `logo_url`/`favicon_url` 默认下发空串，
前端 `displayLogoUrl`/`displayFaviconUrl` 判空后回落到打包的本地资源。
管理端仍可设置任意 URL 全站替换（三步如下）。

## 管理端自定义（三步）

1. **登录后台**：`POST /admin/login` 获取 Bearer 令牌。
2. **保存配置**：`PATCH /admin/config/update` 更新 `logo_url`（与可选 `favicon_url`），值为图片 URL 或经管理端上传后得到的地址。
3. **全站生效**：保存即写入 settings KV 并热更新，前端读取公共配置立即换新 Logo，无需重启。

curl 示例：

```bash
curl -s -X PATCH http://localhost:8466/admin/config/update \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"logo_url":"https://cdn.example.com/logo.svg","favicon_url":"https://cdn.example.com/favicon.png"}'
```

```json
{ "code": 200, "msg": "ok", "data": { "ok": true } }
```

> 也可以在管理界面「系统设置」页操作（上传图片或填写 URL），效果相同。

## 校验生效

```bash
curl -s http://localhost:8466/api/v1/config
```

```json
{
  "code": 200, "msg": "ok",
  "data": { "config": { "logo_url": "https://cdn.example.com/logo.svg", "favicon_url": "https://cdn.example.com/favicon.png" } }
}
```

## 恢复默认

把 `logo_url` / `favicon_url` 置回默认值（空串，前端回落本地打包资源）即可：

```bash
curl -s -X PATCH http://localhost:8466/admin/config/update \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"logo_url":"","favicon_url":""}'
```

## 相关行为

- 前端运行时优先读取配置值；空值回退前端打包的本地资源（`web/src/assets/brand/logo.svg` + `favicon.png`，经 `displayLogoUrl`/`displayFaviconUrl` 判空回落）。
- `site_name` 同样支持运行时自定义（`PATCH /admin/config/update` 的 `site_name` 键）。
- Logo/favicon 仅涉及展示层，修改不影响会话与令牌（不轮换 `jwt_secret`）。